Print Files

Every print file for a given step gets its printer, distribution group, number of copies, and save flag values from the E@JSPRINTER, E@JSDISTGRP, E@JSNBRCOPIES, and E@JSSAVE 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
E@JRCREATE A 1 Y = Deletes an existing job definition before creating a new one.
E@JRMODIFY A 1

Y = Deletes an existing job definition before creating a new one.

Note: If neither E@JRCREATE nor E@JRMODIFY has a value of Y, the routine sets E@JRMODIFY to Y.
E@JRDELQJB 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 E@JRERRORfield.
E@JRNOMODIFEX 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 E@JRERROR field.
E@JRUSERNNAME A 10 Case-sensitive user name used to define the job.
E@JRJOBNNAME A 10 Actual job name used to define the job.
E@JRISMULTSTEP A 1 Y = Multiple-step job.
E@JRNBRSTEPS N 2 Number of steps (1-20).
E@JRSTEPS Occurs 20 times Group label for each step occurrence. The following fields are all subscripted.
E@JSTOKEN A 10 Case-sensitive form ID to be run in this step.
E@JSPROJECT 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.
E@JSPARAMS A 2000 The parameters for this step, strung together in contiguous order. Not all steps have parameters.

Optional Fields

Field Type and length Definition
E@JRJOBREQDESC A 30 Description for the job.
E@JSJOBSTPDESC A 30 Description for the job step.
E@JSDISTGRP A 10 Distribution groups you have defined in Distribution Group Maintenance.
E@JSPRINTER A 10 Appropriate printer.
E@JSNBRCOPIES N 2 Number of copies to print if sent directly to a printer. The default is to 1.
E@JSSAVE 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
E@JRJOBQUEUE A 5 Job queue you want to submit the job through. (If left blank, the default queue is used.)
E@JRSTARTDATE N 8 Date the job should start. (If left blank, the job starts now.)
E@JRSTARTTIME N 6 Time the job should start. (If left blank, the job starts now.)

Return Value

Field Type and length Definition
E@JRERROR A 1

Y = Call failed.

N = Call successful.