Define XID Options Using the List Command

Commands › DEFINE Command—Define ID Options and Variables › Define XID Options Using the List Command

Define XID Options Using the List Command

Defining a new ID Option using the LIST command lets you display any text that you specify instead of displaying the SMF record value.

Follow these steps:

In LIST subcommand, specify the input-type, input-length, and then continue with list of value-text pairs.
If a value read from RECORD= matches one from the LIST=, the corresponding text is used instead of this value.
Use the UNKW keyword at the end of the list. UNKW specifies the text to print when the SMF record field value does not meet any of values in the list.

The Define XID option using the LIST command has the following syntax:

DEFINE XID name PRODUCT=EXPC RECORD=rectype,
          [SUBTYPE=subtype] [TRIPLET=triplet-offset],
          OFFSET=dataoffset [HDR1=header1],
          [HDR2=header2],
          LIST=(IT=input-type, IL=input-length,
                value1,text1,
                value2,text2,
                value3,text3,
                …  
                valueN,textN,
                [UNKW,unknown])

For a description of the common keywords, see the section Define ID Options or Variables.

input-type

Specifies the data type of DEFINE XID command with LIST subcommand. Specify one of the following input types:

BIN – Indicates binary
DEC – Indicates decimal value in PACKED format
NUM – Indicates numeric value in character format
CHAR - Indicates character

input-length

Specifies the length of the data field.

value1

Specifies the value in the SMF record corresponding to text1.

text1

Specifies text that prints in the report when value1 is met in the SMF record. Text is limited to 16 characters.

UNKW

Is a keyword, used for specify UNKW-unknown pair corresponding to all values that are not specified in the list. Notice that if UNKW-unknown pair is not specified then blank is used for all unknown values.

unknown

Specifies text that prints when the value from SMF record does not match any from the list. Text is limited to 16 characters.

Example: Using Define XID Options Using LIST Command.

This example defines the IDoption OWNER from record type 255x4.

DEFINE XID XOWNER PRODUCT=EXPC RECORD=4,
       OFFSET=X78 HDR1=OWNER,
       LIST=(IL=1,IT=BIN,
              0,MVS,
              1,MQSERIES,
              2,IMS,
              3,TCP/IP,
             UNKW,UNKNOWN)

TAB DATE SORT ALPHA STARTTIME SORT ALPHA XOWNER,
    COMMON STATE EXCEPTION STATUS
END
RUN

The following report generates:

START OWNER DATE TIME STATUS -------- ------------ -------- -------- 07/01/09 00.53.54.005 IMS HIGH 00.55.54.035 IMS NORMAL 07.25.24.438 MVS WARNING 07.25.24.937 MVS WARNING 07.25.24.951 MVS WARNING -------- ------------ -------- -------- -------- ------------ -------- --------