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


Chapter 3 Tools : $SETOPT

$SETOPT
Sets the value of a session parameter or option. (C)
Invocation
CALL $SETOPT(parameter, value)
 
Available Parameters and Options
Only the parameters and options identified are accepted by this tool. The checkmark indicates that the parameter or option is effective for the indicated platform. For compatibility purposes, some parameters or options are accepted on all platforms, but are effective only on the ones indicated.
Parameter or Option Type
Win / UNIX
The default national character set.
Execution Environment
Specifies whether the VSAM server should issue SYNCPOINTs under CICS.
Execution Environment
The character to be used as the decimal separator.
Execution Environment
The code page used to display the TIBCO Object Service Broker data.
The file type used to process calls to the @READDSN and @WRITEDSN tools and the load/unload to external files tools.
Execution Environment
The field separator for LINE_SEPARATED_ASCII type import and export tables.
Execution Environment
The file type used to process import and export tables.
Execution Environment
The quote character used for LINE_SEPARATED_ASCII import tables.
Execution Environment
The response to the CICS end message that is issued when a TIBCO Object Service Broker session ends.
Execution Environment
Execution Environment
The size of the rules executor runtime stack in bytes.
Execution Environment
Specifies whether terminals with sessions established under this IMS TM client or Native Execution Environment have the extended data stream or extended attribute support.
Execution Environment
The language used to display the TIBCO Object Service Broker user interface.
The default JES SYSOUT class for output generated using TIBCO Object Service Broker print facilities.
Execution Environment
The number of copies to print of a report generated by TIBCO Object Service Broker.
Execution Environment
The name of a file or existing data set to which a TIBCO Object Service Broker generated report is written.
Execution Environment
The default printer destination for output generated by TIBCO Object Service Broker.
Execution Environment
The default option for printing or not printing the TIBCO Object Service Broker workbench information logs in a multi-user Execution Environment, that is, CICS or Native Execution Environment.
Execution Environment
The name of a Forms Control Buffer (FCB) to be used when printing output generated by TIBCO Object Service Broker.
Execution Environment
The name of a form on which JES SYSOUT output generated by TIBCO Object Service Broker is to be printed.
Execution Environment
The name of a universal character set (UCS) to be used to print the JES SYSOUT output generated by TIBCO Object Service Broker.
Execution Environment
The name of an external writer (XWTR) to be used to print output generated by TIBCO Object Service Broker.
Execution Environment
The maximum amount of display and transfer (DISPLAY & TRANSFERCALL rules language statement) screen rows storage allowed for a user session.
Execution Environment
The difference in minutes between the time shown on the workbench and the base system installation time.
The maximum amount of display and transfer (DISPLAY & TRANSFERCALL rules language statement) screen rows storage allowed for a transaction.
Execution Environment
The character to be used as the left delimiter for enclosing substituted variables in @SCHEDULEMODEL.
Execution Environment
The character to be used as the right delimiter for enclosing substituted variables in @SCHEDULEMODEL.
Execution Environment
Usage Notes
Exceptions
 
Invalid argument OPTION-NAME ===> (xyz) <=== for $SETOPT
RANGERROR raised if the parameter name, for example, invalid argument, is not supported
Invalid value for OPTION-NAME ===> (xyz) <=== of $SETOPT
RANGERROR raised if the value, for example, invalid value, is out of range for the given parameter
See Also
TIBCO Object Service Broker Parameters for information about these parameters.
TIBCO Object Service Broker Programming in Rules for information about exceptions.
Example
The following example uses $SETOPT to reset the DECIMALSEPARATOR parameter, then retrieves the new setting with $GETOPT and displays it on the end message:

 
RULE EDITOR ===> SCROLL: P
DECIMAL(SEPARATOR);
_ LOCAL DEC;
_ ---------------------------------------------------------------------------
_ ------------------------------------------------------------+--------------
_ CALL $SETOPT('DECIMALSEPARATOR', SEPARATOR); | 1
_ DEC = $GETOPT('DECIMALSEPARATOR'); | 2
_ CALL ENDMSG('DECIMALSEPARATOR IS: ' || DEC); | 3
_ ---------------------------------------------------------------------------

 
When the DECIMAL rule is run using the argument ',' the end message reads: DECIMALSEPARATOR IS: ,

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