Selection options

The various selection options listed here are useful for narrowing and defining your trace data search. These options are used within examples later in this section.

The START(yyddd[,hhmmss]) option allows you to select records for output starting from the specified date until the end of the data, or until an end date is reached, as specified by the END option. A start time can also be specified and is separated from the date by a comma. If you do not specify the START option, the system selects records that begin at the start of the ARCPDOX or ARCPDOY data set. If a start time is not specified, the default is 000000.

The END(yyddd[,hhmmss]) option selects records until the date, and optionally time, are reached. A comma separates the date and time. The end date must be the same as, or after, the start date. If the start and end dates are the same, the end time must be the same as, or after, the start time. If you do not specify the END option, the system selects records through the end of the file. If an end time is not specified, the default is 235959.

With both START and END options:

yy: Must be a number from 00 through 99
ddd: Must be a number from 001 through 366
hh: Must be a number from 00 though 23
mm: Must be a number from 00 through 59
ss: Must be a number from 00 through 59

The TCB(aaaaaa[,bbbbbb,cccccc,....]) option selects records that match any of the TCB addresses you select. Up to 10 TCB addresses may be specified in this option. The TCB addresses are identified under the AS/TCB column in the trace output display.

Each address must contain six characters, and each address must be separated by a comma. Actually, only bytes two and three of the actual TCB address are used in the trace address field, and these are placed in byte positions one and two. Byte zero of the TCB trace entry is used for address space identification. For activity that is recorded in the ABARS secondary address space, use the last two digits (in hex) of the ABARS address space identifier (ASID). The following example helps illustrate this:

     ACTUAL TCB ADDRESS = 00F823C0
     TRACED TCB ADDRESS = xxF823  (xx is an address space identifier)

The MODULE(aaaaa[,bbbbb,ccccc.....]) option selects all trace records that have been requested by the module you specify. For example, if you specify MODULE(CTL), all the trace records requested by ARCCTL are selected. You may specify up to ten module names for this option. Each name can contain up to five characters, with each name separated by a comma. Whenever you specify a module name of less than five characters, DFSMShsm pads the name to equal five characters. The module name DFSMShsm traces actually starts on the fourth character of the true name. The following examples help illustrate this:

     ACTUAL MODULE NAME = ARCSELTV
     TRACED MODULE NAME = SELTV
      
     ACTUAL MODULE NAME = ARCCTL
     TRACED MODULE NAME = CTL

The LOGIC(aaaa[,bbbb,cccc,....]) option looks at the logic fields of the trace entries and selects only those that match one of the logic types you select. Up to 10 logic types may be specified in this option. Each type must contain four characters, with each type separated by a comma in the case of multiple entries. Three especially useful ones are MESG, TIME, and ENTR. Logic types are displayed under the LOGIC column in the trace output display.

The SCAN(data) option selects records that contain any reference to data you specify in the data field. The data may match parameters, such as data set names or a key to a data set record. For example, to select all records in which a particular data set name appears, specify the following parameter: SCAN(your.data.set.name).

The RECYCLE option selects records related only to RECYCLE activity.