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:

1. 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.

2. 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
-------- ------------ -------- --------
-------- ------------ -------- --------