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


Chapter 3 Tools : S6BTRON

S6BTRON
Initiates tracing of rules execution in the current session. (C)
Invocation
CALL S6BTRON(data_set_or_file_name)
 
A character string of syntax V (variable-length character string) containing the name of the data set or file to which trace data is to be output.
Usage Notes
The tracing will capture the entry into, and exit from, each rule or shareable tool into a data set or file, until the invocation of the complementary shareable tool S6BTROFF.
Each entry or exit will be captured in a trace record with a record identifier, an identification of the rule or shareable tool, the library the rule was invoked from, a time-of-day, and an accumulated CPU time value of the entry or exit, and the stream level at which the entry or exit occurred.
The value of data_set_or_file_name is specified as follows:
z/OS data set – Specify a fully qualified sequential data set name, for example, AAAAAA.DATA. Note: PDS members are not supported.
Open Systems file – Specify either the full path or only the filename. If you specify only the filename, the DSDIR Execution Environment parameter must be set to point to the directory to use. Refer to TIBCO Object Service Broker Parameters for more information about this parameter.
On z/OS, the data set must be pre-allocated with record format FB (fixed-block) and logical record length of 44 bytes. The data set must be allocated with one extent and sufficient size to accommodate the expected trace output.
The unit of time on all platforms is that of bit 0 through bit 63 of the z/OS Time-Of-Day (TOD) clock; specifically, a 64 bit integer value where conceptually a 1 is added to bit position 51 every microsecond.
 
Blank-padded EBCDIC character string
8 byte unsigned big-endian integer
The time of the rule/shareable tool entry or exit, measured from an arbitrary point in the past.
8 byte unsigned big-endian integer
On z/OS, the accumulated CPU time in the session at the time of the rule/shareable tool entry or exit. On Open Systems, the same as the preceding value.
Blank-padded EBCDIC character string
The name of the library from which the rule was invoked, or blank if the record refers to a shareable tool.

Exceptions
 
Raised if the trace data set does not exist, if tracing is already in progress, or if the trace file cannot be written to or expanded.
Example
This rule will execute the rule specified by the parameter RULE in a nested transaction, while outputting trace records to the data set or file specified by TRACEFILE.

 
TRACE(TRACEFILE, RULE);
_----------------------------------------------------------
_ CALL S6BTRON(TRACEFILE); | 1
_ CALL $EXECUTE(RULE, 'N', 'N', 'L'); | 2
_ CALL S6BTROFF; | 3
_ ---------------------------------------------------------

 

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