Print Files
Every print file for a given step gets its printer, distribution
group, number of copies, and save flag values from the JOBSTP-PRINTER
, JOBSTP-DIST-GRP
, JOBSTP-NBR-COPIES
, and JOBSTP-SAVE
fields. This means that every
print file for a step has the same distribution group and printer
setup. Currently, the batch job processing routines provide no means
of setting up different distribution groups for each print file in
a step.
Required Fields
| Field | Type and length | Definition |
|---|---|---|
JOBREQ-CREATE
|
A 1 | Y = Deletes an existing job definition before creating a new one. |
JOBREQ-MODIFY
|
A 1 |
Y = Deletes an existing job definition before creating a new one. Note: If neither
JOBREQ-CREATE
nor JOBREQ-MODIFY
has a value of Y, the routine
sets JOBREQ-MODIFY
to Y.
|
JOBREQ-DELQJB
|
A 1 |
Deletes all Job Scheduler entries for the
job except for running jobs. If the job already exists and it is running,
then the routine fails and returns Y in the WSJR-ERROR
field.
|
JOBREQ-NO-MOD-IF-EXISTS
|
A 1 |
Forces the routine not to update the job if
it already exists. If the job exists, then the routine returns Y in
the WSJR-ERROR
field.
|
JOBREQ-USER-NAME
|
A 10 | Case-sensitive user name used to define the job. |
JOBREQ-JOB-NAME
|
A 10 | Actual job name used to define the job. |
JOBREQ-IS-MULT-STEP
|
A 1 | Y = Multiple-step job. |
JOBREQ-NBR-STEPS
|
N 2 | Number of steps (1-20). |
JOBREQ-STEPS
|
Occurs 20 times | Group label for each step occurrence. The following fields are all subscripted. |
JOBSTP-TOKEN
|
A 10 | Case-sensitive form ID to be run in this step. |
JOBSTP-PROJECT
|
A 14 | Product line, data area, or data ID name for the application form ID. user and environment form IDs have no product line, so in those cases, move spaces to this field. |
JOBSTP-PARAMS
|
A 2000 | The parameters for this step, strung together in contiguous order. Not all steps have parameters. |
Optional Fields
| Field | Type and length | Definition |
|---|---|---|
JOBREQ-DESCRIPTION
|
A 30 | Description for the job. |
JOBSTP-DESCRIPTION
|
A 30 | Description for the job step. |
JOBSTP-DIST-GRP
|
A 10 | Distribution groups you have defined in Distribution Group Maintenance. |
JOBSTP-PRINTER
|
A 10 | Appropriate printer. |
JOBSTP-NBR-COPIES
|
N 2 | Number of copies to print if sent directly to a printer. The default is to 1. |
JOBSTP-SAVE
|
A 1 | Whether or not to save the job definition after it has completed. The default is to Y. |
Unused Fields
| Field | Type and length | Definition |
|---|---|---|
JOBREQ-JOB-QUEUE
|
A 5 | Job queue you want to submit the job through. (If left blank, the default queue is used.) |
JOBREQ-START-DATE
|
N 8 | Date the job should start. (If left blank, the job starts now.) |
JOBREQ-START-TIME
|
N 6 | Time the job should start. (If left blank, the job starts now.) |
Return Value
| Field | Type and length | Definition |
|---|---|---|
WSJR-ERROR
|
A 1 |
Y = Call failed. N = Call successful. |