Print with a batch utility job

AB | ABEND

The keyword selects only transactions with a nonzero system or user completion code.

CLASS=(nnn,...nnn)

The keyword selects only transactions from the specified class or classes.

Valid transaction classes are 1 to 999. To specify multiple classes, separate each value with a comma. The specification can extend to multiple lines. For example:

DATABASE=(dbName,... dbName)

The variable represents a database name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by database name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

DATE=ddmmmyyyy| ddmmmyyyy-ddmmmyyyy

The date value is used to select a date range or starting date from the input. The input can be a single date, which defines a starting day, or a date range, which defines starting and ending dates to process.

An asterisk is used to specify current date. To select all entries from yesterday, specify:

The underscore is used instead of a hyphen, since a hyphen is already used for the date range format. If you were to specify DATE=*-1, the date would be interpreted as a range from the current date to day 1 (which is invalid).

To process only one day, specify the date as both the starting day of a date range, such as:

The default is to select all records.

D | DAY=nn | nn-nn

The variable represents a day or a range of days as a relative number from the date of the first trace entry (first date is 1, up to a maximum of 99) in the trace buffer or trace log data set. The keyword selects a subset of the entries by a day or range of days.

If there is only one day's data, the END TIME timestamp is hh:mm:ss. If the trace buffer or trace log data set contains more than one day's data, END TIME changes to dd-hh:mm:ss, where dd is the day number relative to the date of the first record in the trace buffer or trace log data set.

If DAY is not specified, but TIME is, the default is the day of the most current record in the buffer or trace log data set.

DB2C | DB2CNT<nnnnnn | >nnnnnn | =nnnnnn

The variable represents the number of DB2 database calls. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by DB2 database call counts.

You can specify the variable as a single numeric value or as a range. For example:

DB2PLAN=(planName,...planName)

The variable represents a DB2 plan name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by DB2 plan name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

DB2T | DB2TIME<nnnnnn | >nnnnnn | =nnnnnn

The variable represents CPU time in milliseconds. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by DB2 elapsed time.

You can specify the variable as a single numeric value or as a range. For example:

DLIC | DLICNT<nnnnnn | >nnnnnn | =nnnnnn

The variable represents number of DL/I database calls. The parameter selects a subset of the trace entries in the online trace storage buffer or trace log data set by DL/I database call counts.

You can specify the variable as a single numeric value or as a range. For example:

DLIT | DLITIME<nnnnnn | >nnnnnn | =nnnnnn

The variable represents DL/I CPU time in milliseconds. The parameter selects a subset of the trace entries in the online trace storage buffer or trace log data set by DL/I elapsed time.

You can specify the variable as a single numeric value or as a range. For example:

DTRAC=YES | NO

The DTRAC keyword requests that a one-line entry be printed for each detail trace event. For ease of associating the detail data with a transaction, it is recommended that you also request either LTRAC or STRAC. The default is DTRAC=YES.

EL | ELAPSED<nnnnnn | >nnnnnn | =nnnnnn

The variable represents elapsed time in milliseconds. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by elapsed time.

You can specify the variable as a single numeric value or as a range. For example:

ELAPSED=3000, ELAPSED>3000, ELAPSED<3000, or ELAPSED=1-3000.

IOC | IOCNT<nnnnnn | >nnnnnn | =nnnnnn

The variable represents number of total I/Os (READs and WRITEs). The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by total I/O count.

You can specify the variable as a single numeric value or as a range. For example:

LEVEL=1 | 2 | 3 | 4

The keyword specifies the data that will be printed:

• 1 prints DL/I call activity for transaction events.
• 2 prints DL/I call activity and, for IMS calls, prints database I/O events that occurred during call processing (the default).
• 3 prints DL/I call activity and, for IMS calls, prints segment search argument, key feedback, and I/O area data (SSA, KFB, and IOA).
• 4 prints all the information of levels 1, 2, and 3.

LTRAC=YES | NO

The LTRAC keyword is used to request the LTRAC one-line entry for each transaction. If LTRAC is specified in conjunction with STRAC or DTRAC, each transaction starts with the LTRAC line followed by the other displays as requested. The default is LTRAC=YES.

MSW

The keyword selects only transactions that are a result of a message switch.

OTMAMEM=(tjName,... tjName)

The variable represents a TMEMBER or IMS Connect job name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by TMEMBER or JOB name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

PR | PROG | PROGRAM=(pName,... pName)

The variable represents a program name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by program name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

PSB=(psbName,... psbName)

The variable represents a PSB name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by PSB name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

REPORTID=name

Each trace print must have a unique identification provided by REPORTID. This is the only required keyword. REPORTID is also used as the ddname of the output data set. The value can be up to eight characters long, and special characters are allowed.

REGION=(rgnName,... rgnName)

The variable represents a region name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by region name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

RE | RESPONSE<nnnnnn | >nnnnnn | =nnnnnn

The variable represents response time in milliseconds. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by response time.

You can specify the variable as a single numeric value or as a range. For example:

RGNID=(nnn,...nnn)

The keyword selects only transactions from the specified region ID or IDs.

Valid region IDs are 1 to 999. To specify multiple region IDs, separate each value with a comma. The specification can extend to multiple lines. For example:

STRAC=YES | NO

The STRAC keyword is used to request the STRAC transaction summary display. STRAC=NO suppresses the STRAC displays. STRAC=YES (the default) requests only the first section of the STRAC display. These requests can be combined with any of the DTRAC requests.

TERM=(ltcName,... ltcName)

The variable represents an LTERM name, Tpipe name, or CICS terminal ID. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by LTERM name, tpipe name, or CICS terminal ID.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

Additionally, you can use the following keywords instead of specific or qualified names:

• TPIPE; transactions that came from a tpipe
• APPC; transactions that came from APPC
• SYNCLOCK; transactions that originated from systems synchronized to the local IMS clock, including the local system
• MSCCLOCK; nonlocal transactions only from systems synchronized to the local IMS clock
• IMSCON; transactions from IMS Connect as long as the BMC Energizer for IMS Connect product was installed with it
• MQS; transactions from WebSphere MQ

T|TIME=hhmm | hhmm-hhmm

The variable represents a start time or time period. The keyword selects a subset of the trace entries in the online trace buffer or trace log data set by a start time or time period.

When the start time is higher than the end time (for example, TIME=2000-0300), 24 hours are added.

TITLE1=title

The title value is centered on the first line of each page of the report. The value can be up to 60 characters long. If the TITLE1 keyword is not included, the title is left blank on the report.

TITLE2=title

The secondary title is centered on the second line of each page of the report. The value can be up to 60 characters long. If the TITLE2 keyword is not included, the secondary title is taken from the title specified when the trace was created.

TRACEID=id | BLANK

This keyword defines the ID of the trace that is to be matched in a search through the trace directory. All TLDS data sets that meet this requirement, plus any TARGET, TIME, and DATE requirements, are dynamically allocated and processed. To define a trace ID of blank, specify:

The DD statement TRACEDIR must be present before this keyword is processed. If the TRACEDIR DD statement is not present, the TRACEID keyword is ignored.

TRAN=(trnName,... trnName)

The variable represents a transaction name. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by transaction name.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example:

TY | TYPE=xxx

The variable represents a region type. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by region type.

Replace the variable with one of the following region types:

• BMP; batch message processing or Java batch message processing (JBP) region
• CON; conversational MPP or JMP regions
• DBT; DBCTL threads (CICS and ODBA)
• FPU; Fast Path utility regions
• MDP; Fast Path message-driven regions
• MPP; message processing or Java message processing (JMP) regions
• NDP; Fast Path non-message-driven regions
• NOTDBT; exclude DBCTL threads
• TPI; message processing regions currently executing an explicit CPI-C program

TRANTYPE=xxx

The variable represents a transaction type. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by transaction type.

Replace the variable with one of the following transaction types:

• DLI; all DL/I transactions
• DB2; all DB2 transactions
• FP; all Fast Path transactions
• ALL; all types of transactions

US | USER=(id,... id)

The variable represents a user or LTERM ID. The keyword selects a subset of the trace entries in the online trace storage buffer or trace log data set by user or LTERM.

You can use wildcard characters to qualify variables. The + character replaces any single character, and the * character replaces any number of characters at the end of the variable. To specify multiple variables, separate each variable with a comma. The specification can extend to multiple lines. For example: