2-3. INITIATING A BATCH JOB

The MPE/3000 :JOB command is used to initiate a batch job. Note that the colon must be supplied in the first position of a command record in batch mode (MPE/3000 prompts with the colon in interactive mode).

The form of the :JOB command is

         :JOB  [jobname,]usemame[/userpass].acctname[/acctpass]

               [,groupname  [/grouppass] ]



              [;TIME=cpusecs]



     

      {BS

[;PRI= CS

       DS

       ES }]



               ;INPRI=inputpriority

               [                   ]

               ;HIPRI



               [;RESTART]

               [;OUTCLASS= [device] [,outputpriority]

[,numcopies]]

where

jobname: is an arbitrary name used with username and acctname parameters to form a job identity. The parameter contains from 1 to 8 alphanumeric characters, beginning with a letter. Default: no job name is assigned.

    {username

     userpass

     acctname Are the same as described for the :HELLO  command.   See paragraph 2-1.

     acctpass

     groupname

     grouppass}

cpusecs

is the maximum CPU time allowed a job, in seconds; it must be a value from 1 to 32767. When this limit is reached, the job is aborted. To specify no limit, enter a question mark (?) or omit this limit. Default: no limit.

BS,CS,DS,ES

is the execution priority class. BS is the highest priority, ES is the lowest. If a priority is specified that exceeds the highest permitted by the system, for the account or user name, MPE assigns the highest priority possible below BS. Default: DS, unless CS is specified by the System Supervisor with the :JOBPRI command.

inputpriority

is the relative input priority used in checking against access restrictions imposed by jobfence, if one exists; it takes effect when a job is entered. This parameter must be a value from 1 (lowest priority) to 13 (highest priority). If a value is less than or equal to the jobfence set by the Console Operator, the job is deferred. Default: 8.

HIPRI

is the request for maximum input priority, causing the job to be scheduled regardless of current jobfence or execution limit for jobs; it overrides inputpriority. This parameter can be specified only if you have System Manager or System Supervisor Capability. Default: 8 or inputpriority if this parameter is specified.

RESTART

is the request to restart a spooled job interrupted by system termination/restart. This parameter takes effect automatically when the system is subsequently restarted with the WARMSTART option.

This parameter applies only to jobs initiated on spooled input devices, and is ignored for other jobs. Default: spooled jobs are not restarted after system termination/restart.

device

is the class name or logical device number of the device to receive the listing output. It cannot specify a magnetic tape unit. Default: $STDLIST.




	NOTE: A non-sharable device (ND) file access attribute is required in order to use this parameter.

outputpriority

is the output priority for the job list file, if destined for a spooled line printer or card punch. It is used to select the next spooled device file (on disc) for output, among all those contending for a specific printer or punch. The parameter must be a value from 1 (lowest priority) to 13 (highest priority). Note that when outputpriority is 1, output always is deferred. Thus, an outputpriority of 2 or greater should be used for output written from disc.

This parameter applies only to output destined for spooled output devices, and is ignored for other output. Default: 8.

numcopies

is the number of copies of a job listing to be produced. This parameter applies only when listing is directed to a spooled device, and is ignored in other cases. It must be a value from 1 to 255. Default: 1.

For a more detailed description of the :JOB command, see the MPE Commands Reference Manual.

An example of the :JOB command, using only the (required) parameters username.acctname is as follows:

           :JOB JOE.VOLLMER,PUB

           PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS

           JOB NUMBER =         #J2

           TUE, JUN 3,  1980, 1:53 PM

           HP3000 / MPE  III B.01.DC



           (Printed on the standard job listing device by MPE/3000)

Note that the acctname parameter is preceded by a period. This is the required form for this parameter (see the form example). Also note that in a batch job, MPE/3000 prints the groupname (PUB in the example) after the acctname, whether or not this parameter was included in the :JOB command (it was not included in the :JOB card in the example).

2-3. INITIATING A BATCH JOB

Technical documentation

» Table of Contents