Resource Control Table

The OSC system uses a Program List Table (PLT) and Transaction List Table (XLT) among the resource control tables used by previous version of CICS. The user has to write a PLT macro and an XLT macro according to the writing rules. This chapter describes how to write a resource control table.

1. Writing Rules

A resource control table is an IBM assembler macro type and therefore it complies with the IBM assembler macro syntax and conditions.

The following are rules that must be compiled with, in addition to the IBM assembler macro syntax and conditions when creating resource control macro.

  • A name starts from the first column.

  • A command starts from the 10th column. The following are the macro syntax supported by OSC.

    Element Description

    DFHPLT

    Macro that declares PLT.

    DFHXLT

    Macro that declares XLT.

  • After each macro, keywords can follow. The macro and keywords are distinguished by one blank space. The available keywords differ depending on the macro. The valid keyword types for each macro will be explained in the next section.

  • If multiple keywords are used, separate each keyword with a comma ','. A blank space must not be inserted between any of the keywords.

  • For the keyword that contains an optional value, connect the keyword and the option value with an equal sign, '='. In order to specify multiple properties, wrap the start and end of the options with parentheses, '(' and ')'. Between each option, insert a comma, ','. A blank space cannot be inserted between options.

  • Keywords can be written up to the 71st column. If keywords must be written over the 71st column, the row can be divided. The row will be divided with a comma, ',', which separates keywords. In order to show that the next row is connected, in the 72nd column a character excluding a blank space must be entered. When writing a keyword to continue to the next row, write the remainder from the 16th column.

  • Initial values must be enclosed in single quotation marks. The MAP compiler interprets single quotation mark(') and parentheses(()) as special characters and ignores them if they are used in a value. To escape a special character, double the character. For example, use two single quotation marks ('') to represent a single quotation mark.

  • When commenting out one row, use the asterisk, '*', in the first column. Then the columns from the second to 71st can be used for the comment.

  • For all keywords and option values excluding the initial value, only upper case characters can be used.

2. PLT Macro (DFHPLT)

DFHPLT is the macro used to define the fields of PLT. For the DFHPLT macro, the following keywords can be specified.

  • TYPE=INITIAL

    Indicates the start of the macro.

    The following option can be specified.

    Option Description

    SUFFIX

    Describes the SUFFIX as two characters to distinguish specific resource control table.

    		 

  • TYPE=ENTRY

    Indicates one or more programs that are described.

    The following option can be specified.

    Option Description

    PROGRAM

    Describes program names. Program name can be up to 8 characters in length. Each program must be specified in OSC SD. Multiple program names can be specified by using the comma, ','. When setting PROGRAM to DFHDELIM, it only distinguishes the steps to process PLT. All programs must register the PROGRAM resource definition.

    		 

  • TYPE=FINAL

    Indicates the end of the macro.

PLT macro file example

The following is an example of a PLT macro. It defines a program to run during OSC region startup or shutdown. The first step defines the start of the TRAQA, TRAQB, and TRAQC programs, and the second step defines the starting of the TRASA, TRASB, and TRASC programs.

DFHPLT TYPE=INITIAL,SUFFIX=PI
DFHPLT TYPE=ENTRY,PROGRAM=TRAQA
DFHPLT TYPE=ENTRY,PROGRAM=TRAQB
DFHPLT TYPE=ENTRY,PROGRAM=TRAQC
DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM
DFHPLT TYPE=ENTRY,PROGRAM=TRASA
DFHPLT TYPE=ENTRY,PROGRAM=TRASB
DFHPLT TYPE=ENTRY,PROGRAM=TRASC
DFHPLT TYPE=FINAL
END

3. XLT Macro (DFHXLT)

DFHXLT is the macro used to define the fields of XLT. For the DFHXLT macro, the following keywords can be specified.

  • TYPE=INITIAL

    Indicates the start of the macro.

    The following option can be specified.

    Option Description

    SUFFIX

    Describes the SUFFIX as two characters to distinguish specific resource control table.

    		 

  • TYPE=ENTRY

    Indicates one or more transactions that are described.

    The following option can be specified.

    Option Description

    TRANSID

    Describes transaction names. Transaction name can be up to 4 characters in length. Each transaction must be specified in OSC SD. Multiple transaction names can be specified by using the comma, ','. But if a special character is used in the transaction name, only one transaction name can be described in one ENTRY, and must be placed in single quotation marks, like this: 'A,01'.

    		 

  • TYPE=FINAL

    Indicates the end of the macro.

XLT macro file example

The following is an example of an XLT macro. It defines that there are TSSA, TSRA, TDSA, TDRA, and ICSA transactions, which can occur from a terminal during OSC region shutdown.

DFHXLT TYPE=INITIAL,SUFFIX=XL
DFHXLT TYPE=ENTRY,TRANSID=(TSSA,TSRA)
DFHXLT TYPE=ENTRY,TRANSID=(TDSA,TDRA)
DFHXLT TYPE=ENTRY,TRANSID=ICSA
DFHXLT TYPE=FINAL
END