Use these selection options to define and narrow your trace data search for DFSMSrmm. You specify the options using JCL as shown in Figure 1.

>>-+---------------------------------------+-------------------><
   '-+-END(date,time)--------------------+-'   
     | .-,---------------------------.   |     
     | V                             |   |     
     +---LOGIC(up_to_10_logic_types)-+---+     
     | .-,-----------------------------. |     
     | V                               | |     
     +---MODULE(up_to_10_module_names)-+-+     
     +-SCAN(data)------------------------+     
     +-START(date,time)------------------+     
     | .-,---------------------------.   |     
     | V                             |   |     
     '---TCB(up_to_10_tcb_addresses)-+---'     

END(date,time)

END is specified as yyddd,hhmmss) and 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 the END option is not specified, the default end date is 99366. 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

LOGIC(up_to_10_logic_types)

The LOGIC option looks at the logic fields of the trace entries and selects only those that match one of the logic types you select. You can specify up to 10 logic types 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.

MODULE(up_to_10_module_names)

The MODULE option selects all trace records that have been requested by the module you specify. For example, if you specify MODULE(MAIN), all the trace records requested by EDGMAIN are selected. You can 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, DFSMSrmm pads the name to equal five characters.

Example: The module name DFSMSrmm traces actually starts on the fourth character of the true name as illustrated in this example.

     ACTUAL MODULE NAME = EDGMAIN
     TRACED MODULE NAME = MAIN

SCAN(data)

The SCAN option selects records that contain any reference to data you specify in the data field. The data can match parameters, such as data set names or a key to a data set record. When you specify SCAN(DSN), for example, you get all of the DSN records plus any other records where the DSN has been traced as another type of parameter.

START(date,time)

START is specified as yyddd,hhmmss) and 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. yyddd is in Julian date format. You can also specify a start time separated from the date by a comma. If the START option is not specified, the default start date is 00001. If a start time in not specified, the default is 000000.

TCB(up_to_10_tcb_addresses)

The TCB option selects records that match any of the TCB addresses you select. Up to 10 TCB addresses can 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.

Example: Byte zero of the TCB trace entry is used for address space identification. X'00' is used for the DFSMSrmm primary address space, as illustrated in this example.

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