![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
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.
• 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.
• On Open Systems, the file will be created if it does not exist. Tracing will fail if the file cannot be written to or expanded.
• 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. 2 byte big-endian integer 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.
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.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.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |