HCL Workload Automation, Version 9.4

Defining the JCL

How to define the JCL.

When you define the JCLs in the Dynamic Workload Console or in the composer command line, it is important to remember that:
  • In the JOB card the programmer name can have a maximum length of 19 characters, instead of 20, since the last character (HEX '30x') is reserved for internal use. The job is not processed if the agent detects a longer programmer name and an error message is issued.
  • The name of the JCL must conform to the following syntax rules. It must:
    • Start from column 3.
    • Have length from 1 to 8 alphanumeric (capital A to Z, numbers 0 to 9) or national ($, #, @) characters.
      Note: The system recognizes the following hexadecimal representations of the U.S. National characters in EBCDIC format: 
      • $ (dollar) as X'5B'
      • # (number) as X'7B'
      • @ (at) as X'7C'

      In countries other than the U.S., the U.S. National characters represented on terminal keyboards might generate a different hexadecimal representation and cause an error. 

      For example, in some countries the $ character may generate X'4A'. This implies that, depending on the codepage specified with the CODEPAGE parameter of the TWSOPTS initialization statement for the agent, you must use whatever characters correspond to hex X'7C', X'5B', and X'7B' in EBCDIC format. For example, if IBM_280 is specified as the system codepage in TWSOPTS, then within the job name you can use the £ (pound) character which is coded as hex X'7B'.

    • Start with a letter or national character, but not with a number.
    • Be followed by at least one blank.
  • You can also edit the JCL in the plan and in the database by getting the JCL. for more information see: Editing a JCL