Previous Topic: OUT ExamplesNext Topic: POST Usage Notes


POST Command

The POST command indicates to the CA WA CA 7 Edition system that a preexecution requirement for a job in the request queue has been satisfied. Two categories of requirements can be satisfied, internal and external. The internal requirements are known within the CA WA CA 7 Edition database and CA WA CA 7 Edition controls them. An example of an internal requirement would be the completion of another job that CA WA CA 7 Edition controls whose completion satisfies a requirement for a dependent job. The external requirements are defined in the CA WA CA 7 Edition database but not controlled by CA WA CA 7 Edition. A manual post must satisfy external requirements unless the requirement is cataloged in the CA WA CA 7 Edition catalog before the using job is scheduled into the request queue. This function is available through the QM.2 CPU Job Predecessors Prompt panel.

This command has the following format:

POST,{JOB={jobname|jobnumber}|JOBL=longjobname},{NW=network}
                             {USR=text}
                             {DEPJOB=jobname}
                             {DSN=dataset}[,INTERNAL=YES][,PREQ=(numbers,...)]
JOB

Indicates the unique job name in up to eight characters, or the job number in up to four digits, for which requirements are posted. If the job name is used and multiple jobs with the same name are found in the request queue, the POST is rejected. An error message is issued. In this case, reenter the POST command using the job number. JOB and JOBL are mutually exclusive.

jobname

Indicates a specific job name.

Limits: 1 to 8 alphanumeric characters

jobnumber

Indicates a specific CA 7 job number.

Limits: 1 to 4 numeric characters

JOBL

Indicates the unique long job name in up to 64 characters for which you want to post requirements. If the long job name is used and multiple jobs with the same long name are found in the request queue, the POST is rejected. An error message is issued. The POST command must then be reentered using the JOB keyword and the job number. JOB and JOBL are mutually exclusive.

longjobname

Indicates a specific long job name.

Limits: 1 to 64 alphanumeric characters

NW

(Optional) Identifies an input workstation network requirement to post as satisfied. Mutually exclusive with DEPJOB, DSN, and USR. In normal situations, CA WA CA 7 Edition posts this type of requirement automatically when the network is logged complete with a LOGOUT, OUT, or IO command to the last workstation within this input network.

Limits: 1 to 8 alphanumeric characters

USR

(Optional) Identifies a user-defined description of a requirement to post as satisfied. Mutually exclusive with DEPJOB, DSN, and NW. When used, must match the text that is used to define the requirement on the DB.6 panel or with the ADDRQ command.

Note: If the user requirement text contains commas, it cannot be satisfied with the POST command. Post the text online with the QM.2 panel. USR MEMOs can be entered in mixed case; however, the POST command is case insensitive. You do not need to POST USR MEMOs with the exact case used when they were initially added.

Limits: 1 to 36 alphanumeric characters

DEPJOB

(Optional) Identifies a predecessor job dependency requirement to post as satisfied. Value must be a specific job name. Mutually exclusive with DSN, NW, and USR. In normal situations, CA WA CA 7 Edition automatically posts this type of requirement when the predecessor job completes its execution successfully. A manual posting is only necessary if a job defined as a requirement was not to be run, or ran unsuccessfully and a successor job is to be run.

The DEPJOB must be posted if it is not currently defined to CA WA CA 7 Edition (an external job).

Limits: 1 to 8 alphanumeric characters

DSN

(Optional) Identifies a data set requirement to post as satisfied. Value can be a specific data set name or a CA WA CA 7 Edition data set number. If using a number, only the number can be specified without the DS prefix. Mutually exclusive with DEPJOB, NW, and USR.

dsname

Indicates a specific data set name.

Limits: 1 to 44 alphanumeric characters

dsnumber

Indicates a specific CA WA CA 7 Edition data set number.

Limits: 1 to 8 numeric characters

INTERNAL

(Optional) Valid only with DSN to indicate that the data set being posted is internal to the CA WA CA 7 Edition workload. YES is the only acceptable value. Mutually exclusive with NW, USR, DEPJOB, and PREQ. In normal situations, CA WA CA 7 Edition automatically posts requirements for internal data sets.

PREQ

(Optional) Valid only with DSN to identify up to 11 numeric values to include with other CA WA CA 7 Edition log data logged as a result of the POST command being issued. Mutually exclusive with NW, USR, DEPJOB, and INTERNAL. Code values in sublist form, within parentheses. You can code up to 11 values that are separated by commas between the parentheses. Each value cannot exceed 4 numeric digits. This optional field can be useful for logging any meaningful numbers, such as batch numbers, and so on, which can later be reviewed in the log data set.