Reducing Session Resources

Bypassing the workbench at session startup lets you reduce session resources. To bypass the workbench, run a rule at session startup:

•

In seamless clients, the name of the rule to run is obtained from the user profile with the same name as the client. The rule is run without arguments. In your Security user profile you must also leave the Menu field blank and/or transfercall to the rule, that is, set the Action field to T.

•

In non-seamless clients, the RULE session parameter is used to execute a rule at session startup. You can run this rule with arguments. Refer to TIBCO Object Service Broker Parameters for information about the RULE parameter.

Operational Characteristics

When the session starts, you do not see the usual workbench menu; the rule named in the Startup Rule field of the User profile for seamless clients or with the RULE parameter for non-seamless clients is run immediately. If the rule fails, the TIBCO Object Service Broker session ends with a traceback and control is returned to the external environment.

Trapping Errors

You can trap any recoverable errors using an exception handler in the rule.

Obtaining Additional Data

For CICS, IMS TM, and the Call Level Interface, you can use MAP tables or the $GETENVCOMMAREA tool to obtain additional data that was passed to the session.

Changing the Invocation Options

You can change the way to invoke a rule with the ACTION parameter or user profile default. Instead of the default EXECUTE, use CALL (C) or TRANSFERCALL (T):


EXECUTE	The rule starts as a child transaction to the TIBCO Object Service Broker login transaction.
TRANSFERCALL	The rule is invoked as a new, separate transaction.
CALL	The rule runs as part of the initial TIBCO Object Service Broker login transaction.

Change other invocation attributes with parameters or user profile defaults such as SEARCH, BROWSE/NOBROWSE, and TEST/NOTEST.

Non-seamless CICS Client

In a non-seamless CICS client you can invoke the HURN transaction with a session startup string as follows:

HURN R=ABC(3,OPEN)

In this example, the ABC rule is passed two arguments: the first argument is the number “3” and the second is the string “OPEN”.