►►─ SUBmit PACkage ─ package-id ──────────────────────────────────────────────►
►─┬──────────────────────────────────────────────────────────────┬───────────►
└─ JOBCard ─┬─ DDName ─┬─ JCLIN ◄ ─┬─────────────────────────┬─┘
│ └─ ddname ──┘ │
└─ DSName ─ 'dsname' ─┬────────────────────────┬─┘
└─ MEMber ─ member-name ─┘
►─┬──────────────────────────────────────────────────────┬───────────────────►
└─ TO ─┬─────────────────────────────────────────────┬─┘
├─ INTernal ─ REAder ─ DDName ─┬─ JCLOUT ◄ ─┬─┤
│ └─ ddname ───┘ │
└─ CA7 ───────────────────────────────────────┘
►─┬───────────────────────────────────────────────────────────────────────┬─ . ─►
└ OPTions ─ ¤ ┬───────────────────────────────────────────────────┬─ ¤ ─┘
│ ┌───── OR ───────┐ │
│ │ │ │
├ WHEre PACkage STATus ─┬────┬ ▼ ┬ APPROVED ◄ ─┬┴───┤
│ └ IS ┘ └─ EXECFailed─┘ │
├─ MULtiple JOBStreams ─────────────────────────────┤
├─┬─ INCrement JOBName ◄ ──────┬────────────────────┤
│ └─ DO NOT INCrement JOBName ─┘ │
└ JCL PROcedure ┬────────┬─┬──────┬─┬─ ENDEVOR ◄ ─┬─┘
└─ NAMe ─┘ └─ IS ─┘ └─ procname ──┘
►─┬─────────────────────────────────────────────────┬─ . ────────────────────►◄
└─ CA7 ─ OPTIONS ─┬─────────────────────────────┬─┘
└─ DEPEndent ─ JOB ─ jobname ─
SUBMIT PACKAGE package-id
The SUBMIT PACKAGE clause identifies the package you are submitting for execution. You can use a fully specified, partially wildcarded, or fully wildcarded package ID. When the package-id is fully specified, the WHERE PACKAGE STATUS clause will be ignored and the parser will issue a warning message.
JOBCARD DDNAME JCLIN
DDNAME ddname
DSNAME dsname
MEMBER member-name
The JOBCARD clause identifies the location of the data set that contains the JCL jobcard. The location be either a DDname or data set name. If you do not specify the JOBCARD clause, the JCLIN DD statement is used by default as the JCL jobcard location. If you specify this clause, the clause must identify either a sequential or a partitioned data set with an explicitly specified member name. The data set must have fixed length records and the record length (LRECL) must be exactly 80.
INTERNAL READER DDNAME
The INTERNAL READER DDNAME clause identifies the name of a pre-allocated DD statement to which the JCL is written. Generally, this is allocated as DD SYSOUT=(class,INTRDR). The DD statement can also reference any sequential or partitioned data set with an explicit member that has a record length (LRECL) of 80. If you do not specify the INTERNAL READER DDNAME clause, the SUBMIT PACKAGE action writes the JCL to the JCLOUT DD statement.
CA7
If the TO CA7 clause is specified, neither the MULTIPLE JOBSTREAMS nor the INCREMENT JOBNAME parameters may be specified.
If the TO CA7 clause is not specified, any specifications for CA7 options will be ignored.
OPTIONS
OPTION clauses allow you to further specify package actions.
WHERE PACKAGE STATUS -Specifies the statuses of the packages you want to submit. You can only use this clause when you wildcard the package-id. The default is to submit packages that have a status of Approved. Use the WHERE PACKAGE STATUS IS EXECFAILED clause to re-execute packages that have previously failed. Use the OR clause to indicate that packages of either status should be submitted.
MULTIPLE JOBSTREAMS-Use the MULTIPLE JOBSTREAMS clause to submit a separate, unique job for each package. This clause is equivalent to the C1BM6000 MULTJOBS JCL parameter. If you do not specify this clause a single job that has a unique job step for each package is submitted. A maximum of 200 packages can be processed in a single job stream. If more than 200 packages meet the selection criteria, the SUBMIT action submits additional jobs, each with up to 200 steps, until all of the eligible packages have been submitted.
Note: C1BM6000 has been replaced by the Batch Facility (ENBP1000). Users of C1BM6000 must migrate from C1BM6000 to ENBP1000.
INCREMENT JOBNAME-The INCREMENT JOBNAME clause directs the Batch Package Facility to increment the last character in the jobcard you provide. In general, use the INCREMENT JOBNAME clause with the MULTIPLE JOBSTREAM clause to increment the last character in the JCL jobcard for each job stream you submit.
You can also use the INCREMENT JOBNAME clause when you submit a single job stream and more than 200 eligible packages are found. If an additional job stream is created, the INCREMENT JOBNAME clause controls whether the additional job names are incremented. The SUBMIT action uses the following rules when incrementing the last character in the job name:
JCL PROCEDURE NAME-The JCL PROCEDURE NAME clause identifies the name of the JCL procedure you wish to invoke in the SUBMIT PACKAGE action JCL. The name must be one to eight characters long and constructed to accept the package ID as the only parm. The symbolic to pass the package ID is PKGID. For example:
//ENDEVOR PROC PKGID= //PSO1 EXEC PGM=NDVRC1,PARM=(C1BM3000,,&PKGID).
If you do not specify the JCL procedure name the SUBMIT PACKAGE action creates JCL to invoke the ENDEVOR procedure. A sample JCL procedure is supplied in iprfx.iqual.CSIQJCL member ENDEVOR. Copy this procedure into an existing PROCLIB defined to JES on your system, or use it as a model for your own JCL batch package PROC.
CA7 OPTIONS DEPENDENT JOB jobname
DEPENDENT JOB Specifies a single predecessor job which must complete while demanded job is waiting.
For example: CA7 OPTIONS DEPENDENT JOB CICSDOWN-This means that package ENDEVOR will not run until jobname cicsdown is successfully completed.
SCL Example:
SUBMIT PACKAGE 'ENDEVOR'
JOBCARD DSNAME 'BST.ENDEVOR.JCLLIB'
MEMBER 'JOBCARD'
TO CA7
OPTIONS WHERE PACKAGE STATUS IS APPROVED
JCL PROCEDURE NAME IS ENDEVOR
CA7 OPTIONS DEPENDENT JOB CICSDOWN.
CA7 translates the above SCL into CA7 syntax similar to this:
DEMAND,JOB=PILRO01C,DEPJOB=CICSDOWN,
SET=NDB,JCLLIB=&ENDEVOR.
Note: For more information about CA 7 DEMAND, see the CA7 commands manual or contact you local CA7 Support.
Example: Submit Package SCL
The following is an example of SUBMIT PACKAGE SCL. The SCL submits for execution all packages that begin with PAYROLLPKG. Each package will have a unique jobstep, the jobname will not be incremented.
SUBMIT PACKAGE PAYROLLPKG* OPTIONS DO NOT INCREMENT JOBNAME.
|
Copyright © 2014 CA.
All rights reserved.
|
|