Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 TIBCO Object Service Broker Sessions Under TSO : How to Set Session Parameters

How to Set Session Parameters
A number of options are available to you for determining the operational characteristics of your session. You can also require additional facilities to start a session. This section describes where to specify the options, the order of evaluation for these options, and the additional facilities you require.
Establishing Session Parameter Values
The following table describes where to specify the values for your session parameters and their order of evaluation, from highest to lowest:
Priority of Evaluation
CLIST parameters are written to a parameter input file allocated to DDname HRNIN.
The TIBCO Object Service Broker user profile is used unless the session parameter NOPROFILE is specified.
The installation default module is loaded from the STEPLIB. Default configuration name is S6BDRCT0, except when overridden by the CONFIGURATION Execution Environment parameter.
TIBCO Object Service Broker default
Refer to TIBCO Object Service Broker for z/OS Installing and Operating for TIBCO Object Service Broker-supplied default values.
Using a CLIST to Invoke TIBCO Object Service Broker
When you use parameters with your CLIST invocation of TIBCO Object Service Broker under TSO, the syntax is:
CLIST_NAME [{parameter[(value)]}]
where:
 
You can use the USER CLIST to specify the Execution Environment load library and the external routine load library as follows:
 
LOADLIB(libname)
libname is the Execution Environment load library.
EXLIB(libname)
libname is the external routine load library allocated to DDname HRNEXTR. The programs in this library are written in a language other than the rules language and can be called by TIBCO Object Service Broker rules. You can specify or concatenate your own external library containing your own external routines. Refer to Chapter 14, Introduction to the Call Level Interface to Chapter 17, Multiple-Session Execution Environments in Batch for more information.
Example Invocation
The following example invokes a CLIST called OSTAR:
OSTAR NOBROWSE L(DEV00) RULE('TEST2(''A STRING'')') EXLIB(USR30.OSTAR.ROUTINE)
In this example, the following takes place:
This session starts with the parameters NOBROWSE (a parameter that does not require a value), and LIBRARY (abbreviated to L), which has a value of DEV00.
If the USER CLIST does not provide the user ID to S6BTSO, the user ID is set to the TSO ID.
Specifying or Concatenating a Load Library
If your installation does not have a common external routine load library, or if you want to use your own load library, you can define your own library. To identify your external routine load library to TIBCO Object Service Broker, specify or concatenate a load library in the CLIST to invoke TIBCO Object Service Broker.
To specify a load library, provide its full name to the EXLIB parameter in the CLIST. For example:
EXLIB(USR30.OSTAR.ROUTINE)
In this example, TIBCO Object Service Broker searches the data set USR30.OSTAR.ROUTINE for external subroutines.
The order of the libraries determines the search order when you invoke an external routine, and the block size of the first library determines the block size for the others. If you cannot put the library with the largest block size first, use the BLKSIZE argument to specify a sufficient block size for all concatenated libraries.
Your Execution Environment should run authorized and your Data Object Broker must run authorized. (If you concatenate an authorized library with an unauthorized library, the resulting load library concatenation becomes unauthorized.)
See Also
TIBCO Object Service Broker for z/OS Installing and Operating for information on using HRNLIB to make sure that the TIBCO Object Service Broker load library is authorized.
USER CLIST Distributed with TIBCO Object Service Broker
The USER CLIST, distributed with TIBCO Object Service Broker in the CLIST data set, runs a TIBCO Object Service Broker TSO client. The list of parameters that you can specify when you start your session—and the default values for some of the parameters—should be customized for your installation usage.
See Also
TIBCO Object Service Broker for z/OS Installing and Operating about installation.
TIBCO Object Service Broker Programming in Rules about rules libraries and rules.
TIBCO Object Service Broker Shareable Tools about the use of the tools.
The TIBCO Object Service Broker Parameters about parameters.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved