Parameter field

A JOB statement has two kinds of parameters: positional and keyword. All parameters are optional, however, your installation may require the accounting information parameter and the programmer’s name parameter.

Note: The following parameters are not supported on the JOB statement for a started task:

An asterisk indicates that the parameter is ignored. The other parameters listed result in a JCL error and job failure.

If JES detects an error in any parameter on the JOB statement, the error causes a JCL error and a job failure; the system flushes all subsequent JCL statements, including any SYSOUT-specific DD statements directing output to any other class or destination.

Positional Parameters: A JOB statement can contain two positional parameters. They must precede all keyword parameters. You must code the accounting parameter first, followed by the programmer’s name parameter.

POSITIONAL PARAMETERS VALUES PURPOSE 
([account-number]
  [,accounting-information]...)

See section Accounting information parameter

 account-number

,accounting-information: up to 143 characters

 Specifies an account number and other accounting information, formatted as required by the installation. This parameter may be required by the installation. 
programmer's-name

See section Programmer’s name parameter

 programmer’s-name: 1 - 20 characters Identifies the owner of the job. This parameter may be required by the installation.

Keyword Parameters: A JOB statement can contain the following keyword parameters. You can code any of the keyword parameters in any order in the parameter field after the positional parameters.

Table 1. JOB statement keyword parameters
KEYWORD PARAMETERS VALUES PURPOSE 
ADDRSPC= {VIRT}
         {REAL}

See section ADDRSPC parameter

 VIRT: virtual (pageable) storage

REAL: central (nonpageable) storage

 Indicates the type of storage required for the job. 
BYTES={nnnnnn              }
      {([nnnnnn][,CANCEL]) }
      {([nnnnnn][,DUMP])   }
      {([nnnnnn][,WARNING])}

See section BYTES parameter

 nnnnnn: 0 - 999999 Indicates the maximum amount of output to be printed for the job's sysout data sets, in thousands of bytes, and the action the system is to take if the maximum is exceeded. 
CARDS={nnnnnnnn              }
      {([nnnnnnnn][,CANCEL]) }
      {([nnnnnnnn][,DUMP])   }
      {([nnnnnnnn][,WARNING])}

See section CARDS parameter

 nnnnnnnn: 0 - 99999999 Indicates the maximum amount of output, in cards, to be punched for the job's sysout data sets, and the action the system is to take if the maximum is exceeded. 
CCSID=nnnnn
 nnnnn: 1 - 65535 Specifies the coded character set identifier indicating the character code conversion performed on reads from and writes to tapes accessed in ISO/ANSI Version 4 format. 
CLASS=jobclass

See section CLASS parameter

jobclass: 1-8 characters: A - Z, 0 - 9, and some special characters: See Subparameter definition.

 In a non-APPC scheduling environment, assigns the job to a job class. 
COND=((code,operator)[,(code,operator)]...)

See section COND parameter

 code: 0 - 4095 
operator:  GT   Code from
           GE   chart on
           EQ   section
Table 1
           LT
           LE
           NE
 Specifies the return code tests used to determine whether a job continues processing or be terminated. 
GROUP=group-name

See section GROUP parameter

 group-name: 1 - 8 alphanumeric or national characters ($, #, @) In a non-APPC scheduling environment, identifies a group to which a RACF-defined user is to be connected. 
JESLOG= {SPIN}
        {NOSPIN}
        {SUPPRESS}

See section JESLOG parameter

 SPIN: JESLOG is spin-eligible. There is an optional second operand that specifies the time or the time interval.

NOSPIN: JESLOG is not spun.

SUPPRESS: JESLOG is suppressed.

 Has meaning when the subsystem is a version of JES2 or JES3 that supports this function. It specifies whether the JESLOG data set should be spin-eligible and if it should be automatically spun at a particular time or time interval. 
 JOBRC= {MAXRC}
        {LASTRC}
        {(STEP,stepname[.procstepname]}

See section JOBRC parameter

 MAXRC: The job completion code is set to the highest return code of any step in the job, or if the completion of the job fails because of an ABEND, the job completion code is set to the last ABEND code; this is the default parameter.

LASTRC: The job completion code is set to the return code or ABEND code of the last step that is executed in the job.

(STEP,stepname[.procstepname]): The job completion code is set to the return code or ABEND code of the step that is indicated by the stepname.[.procstepname] parameter. If this step does not exist, a JCL error is generated. If this step does not run, the processing is the same as if MAXRC is specified.

stepname: the name of the job step.

procstepname]: the name of the job step within the procedure.

 Use the JOBRC parameter to control how the job completion code (presented by JES2 or JES3) is set. By default (when JOBRC is not specified), the job completion code is set to the highest return code of any step, or if the job's execution fails because of an ABEND, the job completion code is set to the last ABEND code; however, this parameter can be used to request that the job completion code be set to the return code of the last executed step or a particular step that more accurately reflects the success or failure of the job. 
LINES={nnnnnn              }
      {([nnnnnn][,CANCEL]) }
      {([nnnnnn][,DUMP])   }
      {([nnnnnn][,WARNING])}

See section LINES parameter

 nnnnnn: 0 - 999999 Indicates the maximum amount of output to be printed for the job's sysout data sets, in thousands of lines, and the action the system is to take if the maximum is exceeded. 
MEMLIMIT={nnnnnM}
         {nnnnnG}
         {nnnnnT}
         {nnnnnP}
         {NOLIMIT}

See section MEMLIMIT parameter

 nnnnn: 0 - 99999 Specifies the limit on the total number of usable virtual pages above the bar for a single address space. 
MSGCLASS=class

See section MSGCLASS parameter

 class: A - Z, 0 - 9 In a non-APPC scheduling environment, assigns the job log to an output class. 
MSGLEVEL=([statements][,messages])

See section MSGLEVEL parameter

 statements:
0
Only JOB statement
1
All JCL and procedure statements
2
Only JCL statements
messages:
0
Only JCL messages
1
JCL, JES, and operator messages
 Indicates the job control information to be printed in the job log. 
NOTIFY={nodename.userid}
       {userid         }

See section NOTIFY parameter

 nodename: 1 - 8 alphanumeric or national characters ($, #, @)

userid: 1 - 8 alphanumeric or national characters ($, #, @), 1 - 7 alphanumeric or national characters ($, #, @) when userid specified without nodename

 In a non-APPC scheduling environment, requests that the system send a message to a userid when this background job completes. 
PAGES={nnnnnnnn              }
      {([nnnnnnnn][,CANCEL]) }
      {([nnnnnnnn][,DUMP])   }
      {([nnnnnnnn][,WARNING])}

See section PAGES parameter

 nnnnnnnn: 0 - 99999999 Indicates the maximum amount of output, in pages, to print for the job's sysout data sets, and the action the system is to take if the maximum is exceeded. 
PASSWORD=(password[,new-password])

See section PASSWORD parameter

 password or new-password: 1 - 8 alphanumeric or national characters ($, #, @) In a non-APPC scheduling environment, identifies the current RACF® password or specifies a new RACF password. 
PERFORM=n

See section PERFORM parameter

 n: 1 - 999 In WLM compatibility mode (not available on z/OS® V1R3 or later systems), specifies the job’s performance group.

In WLM goal mode, can be used for classification of the job to a service class or report class.

 
PRTY=priority

See section PRTY parameter

 priority (JES2): 0 - 15 priority (JES3): 0 - 14 In a non-APPC scheduling environment, JES2: Assigns the job’s queue selection priority. JES3: Assigns the job’s initiation or selection priority in its job class. 
RD= {R  }
    {RNC}
    {NR }
    {NC }

See section RD parameter

R: restart, checkpoints allowed
RNC: restart, no checkpoints
NR: no restart, checkpoints allowed
NC: no restart, no checkpoints

 In a non-APPC scheduling environment, indicates whether the operator should perform automatic step restart, if the job fails, and controls whether checkpoints are written for CHKPT macros or DD statement CHKPT parameters. 
REGION= {valueK}
        {valueM}

See section REGION parameter

valueK: 1 - 7 digits
  from 1 - 2096128
valueM: 1 - 4 digits
  from 1 - 2047

 Specifies the amount of space in kilobytes or megabytes required by the job. 
RESTART= ({*                    } [,checkid] )
          {stepname             }
          {stepname.procstepname}

See section RESTART parameter

*: at first step
stepname: at named step
procstepname: step is in named
procedure
checkid: at checkpoint in first or
named step

 In a non-APPC scheduling environment, specifies restart of a job at the beginning of a step or from a checkpoint within a step. 
SECLABEL=seclabel-name

See section SECLABEL parameter

 seclabel-name: 1 - 8 alphanumeric or $, #, @, characters In a non-APPC scheduling environment, identifies the security label of the job to RACF. 
SCHENV=schenv-name

See section SCHENV parameter

 schenv-name: 1 - 16 alphanumeric or $, #, @, _ characters In a non-APPC scheduling environment, identifies the name of the WLM scheduling environment associated with this job. 
SYSAFF={MemberName}
       {(MemberName,MemberName,...,MemberName)}
       {(-MemberName,MemberName,...,MemberName)}
       {-MemberName}
       {(MemberName,...,IND)}
       {(-MemberName,...,IND)}
       {ANY}
       {(ANY,IND)}
 Specifies 1-33 JES2 member and JES3 system names. Each is a 1-4 character name. A value of * (asterisk character) indicates the submitting system. A value of IND indicates that the job must run on a member in independent mode. Specifies 1-33 JES2 members and JES3 systems that are eligible to process the job. 
SYSTEM={SystemName}
       {(SystemName,SystemName,...,SystemName)}
       {(-SystemName,SystemName,  ...,SystemName)}
       {-SystemName}
       {ANY}
       {JGLOBAL}
       {JLOCAL}}
       {JLOCAL}
 Specifies 1-32 system names. Each is a 1-8 character valid system name. A value of * (asterisk character) indicates the submitting system. Specifies 1-32 systems that are eligible to process the job. 
TIME= {([minutes][,seconds])}
      {1440                 }
      {NOLIMIT              }
      {MAXIMUM              }

See section TIME parameter

 minutes: 1 - 357912

seconds: 1 - 59

1440: Specifies that the job can use the processor for an unlimited amount of time.

NOLIMIT: Specifies that the job can use the processor for an unlimited amount of time.

MAXIMUM: Specifies that the job can use the processor for the maximum amount of time, 357912 minutes.

 Specifies the maximum time the job is to use the processor and requests messages giving the time used. 
TYPRUN= {COPY   }
        {HOLD   }
        {JCLHOLD}
        {SCAN   }

See section TYPRUN parameter

COPY: copies job stream to sysout
data set (JES2 only)
HOLD:  holds job
JCLHOLD: holds job before JCL
processing (JES2 only)
SCAN: scans JCL for syntax errors

 In a non-APPC scheduling environment, requests special job processing. 
USER=userid

See section USER parameter

 userid: 1 - 7 alphanumeric or $, #, @ characters In a non-APPC scheduling environment, identifies the job’s owner to RACF, SRM, and other system components.
Parent topic: Description