Why use USRBLTIN functions with TIBCO Object Service Broker (OSB) for z/OS?
Article ID: KB0089263
Updated On:
| Products | Versions |
|---|---|
| TIBCO Object Service Broker for z/OS | - |
| Not Applicable | - |
Description
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
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
Issue/Introduction
Why use USRBLTIN functions with TIBCO Object Service Broker (OSB) for z/OS?
Attachments
Feedback
Yes
No
Powered by
