z/OS MVS Installation Exits
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Text Format for JDT-defined JCL

z/OS MVS Installation Exits
SA23-1381-00

  • JDT-defined verbs
    //OUTPUT1 OUTPUT  .....
Verb Key Number Parameters Verb Length Verb Label Length Label
BE 02 06 OUTPUT 07 OUTPUT1
    • The JDT-defined verb is the first parameter on the verb key (X'BE').
    • The statement label is the second parameter on the verb key (X'BE').
  • JDT-defined keywords
    //DD1     DD  ACCODE=A

Long Parameters: The length of some parameters, such as a pathname for an hierarchical file, can be up to 255 bytes. Any parameter with a maximum length that is over 127 bytes is represented in the key entry format as a subparameter list within the key for the parameter. Each subparameter has a maximum length of 127 bytes.

The PATH parameter is used to specify the pathname:
   //ddname DD PATH=pathname
Example 1: In the following example, the PATH parameter has 6 characters:
 //DD2  DD PATH='/name1'

Even though the pathname parameter is only 6 bytes, it must be represented as a subparameter list because the maximum length of the pathname can be 255 bytes.

Table 1. Text Format for Long Parameters: Example 1
Key Number Parameters Key Length JDT-Defined Key for Specified Keyword Number Sub-parameters Parameter Length Parameter Value
1A 02 02 X'8017' 81 6 X'61D5C1D4C5F1'
Example 2: In this example, the PATH parameter has 130 characters:
 //DD2 DD PATH='/NAME11111/NAME22222/NAME33333/NAME44444/NAME55555/NAME6
 //             6666/NAME77777/NAME88888/NAME99999/NAME00000/NAME11111/N
 //             AME22222/NAME33333'
It would be represented as shown in Table 2.
Table 2. Text Format for Long Parameters: Example 2
Key Number Parameters Key Length JDT-Defined Key for Specified Keyword Number Sub-parameters Parameter Length Parameter Value
1A 02 02 X'8017' 82 7F X'61D5C1D4C5F1F1F1F1F1,,,61D5C1D4C5F3F3'
          03 X'F3F3F3'
Because only 127 characters can fit in a single subparameter field, the parameter must be represented as two subparameters. Therefore, the Num of Subparameters field is 82.
  • The first subparameter is X'7F' (127 decimal) bytes long, and its value in the C/I text is the hex string representing the first 127 characters of the PATH parameter value in the JCL.
  • The second subparameter is 3 bytes long, and its value in the text is the hex string representing the last 3 bytes of the PATH parameter value.

Pre-MVS/ESA SP 4.1: For JCL converted on a pre-MVS/ESA SP 4.1 system, the JDT-defined keyword is the first parameter on the JDT key (X'1A').

Key Number of Parameters Keyword Length Keyword Parameter Length Parameter
1A 02 06 ACCODE 01 A
  • The parameter on the JDT-defined keyword is the second parameter on the JDT key (X'1A').

MVS/ESA SP 4.1: For JCL converted on an MVS/ESA SP 4.1 system, the JDT-defined key for the specified JDT keyword is the first parameter on the JDT key (X'1A'). For JDT-defined keywords on the DD statement, refer to the macro IEFSJKEY. For JDT-defined keywords on the OUTPUT statement, refer to the macro IEFDOKEY.

Key Number of Parameters Key Length JDT-Defined Key for the Specified Keyword Parameter Length Parameter
1A 02 02 X'8001' 01 A
  • The parameter on the JDT-defined keyword is the second parameter on the JDT key (X'1A').

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014