Resolution:
User builtin routines are user-written assembler routines that are similar to external routines. They can be packaged and link-edited directly into TIBCO Object Service Broker, providing a very fast execution path to implement specialized high-use or complex processing that your application might require. With user-written builtins, customer specific operations can be invoked conveniently and efficiently from an OSB application rule.

Restrictions:
=============
While user builtins provide efficient, customized processing, they do come with some restrictions as outlined in the "TIBCO® Object Service Broker for z/OS External Environments" manual, including:
• must be written in z/OS assembler
• must be fully re-entrant with AMODE31 and RMODE ANY
• must use standard assembler linkage conventions

Once implemented, invoking a user builtin from a rule is similar to invoking an OSB shareable tool.

Environment:
============
• TIBCO® Object Service Broker for z/OS

Sample User Builtin:
====================
A sample file called USERBLTN.txt is attached to this solution. You can view this file by logging on to
  https://support.tibco.com/esupport/
and viewing the attachment for SOL1-BKD6ST. The sample provided illustrates a user builtin designed to scrub a user string field of unwanted characters. Read the comments provided throughout the sample to gain knowledge of how to write a user builtin and avoid some of the problems in defining the arguments to OSB.

Implementing the User Builtin:
==============================
The user builtin is implemented by executing the OSB sample USERMOD8 job in your OSB JCL library. This is discussed in the "TIBCO® Object Service Broker for z/OS: Installing and Operating" manual. Information on planning and implementing the user builtin is found in the "TIBCO® Object Service Broker for z/OS: Installing and Operating" chapter "Using User Builtin Routines" manual.


References:
===========
• TIBCO® Object Service Broker for z/OS: External Environments manual
• TIBCO® Object Service Broker for z/OS: Installing and Operating manual