HPlogo Commands Reference HP 3000 Series 9X8LX Computer Systems > Chapter 2 MPE/iX Commands

JOB
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

The JOB command is used in conjunction with the STREAM command. You can create an input job file that contains the JOB command. This file defines a batch job that you submit with the STREAM command. The JOB command initiates the batch processing and must be the first command line in the job file.

Syntax



   JOB [jobname,]username[/userpass].acctname[/acctpass]

   [,groupname[/grouppass]]

   

   [;INPRI=inputpriority

    ;HIPRI]             [;RESTART]

   

   [;OUTCLASS=[ [device][,[outputpriority][,numcopies]]]]

Parameters

jobname

Specifies an arbitrary name used with username and acctname parameters to form a job identity. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. The default is that no job name is assigned.

username

Specifies your user name, established by your system administrator, that enables you to log on to this account. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character.

userpass

Specifies your user password, optionally assigned by your system administrator. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. If you have a password but you do not supply it in the command syntax, the STREAM command prompts for it if you:

  • Enter the STREAM command from a session.

  • Do not redirect either $STDIN or $STDLIST.

  • Do not nest the JOB command within a second-level STREAM command. (The JOB command is specified as a first-level JOB command.)

acctname

Specifies the account name that the system administrator establishes. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. A period (.) must precede this parameter.

acctpass

Specifies the account password that the system administrator can optionally assign. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists but you do not supply it in the command syntax, the STREAM command prompts you for it if you:

  • Enter the STREAM command from a session.

  • Do not redirect either $STDIN or $STDLIST.

  • Do not nest the JOB command within a second-level STREAM command. (The JOB command is specified as a first-level JOB command.)

groupname

Specifies the group name to be used for the local file domain and for CPU-time charges, as established by the system administrator. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. The default is the home group if one is assigned. This parameter is required if a home group is not assigned.

grouppass

Specifies the group password that the system administrator optionally assigns. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. You do not need the group password when you log on to your home group. You need it when you log on in any other group for which a password exists. If a password is required but you do not supply it in the command syntax, the STREAM command prompts you for it if you:

  • Enter the STREAM command from a session.

  • Do not redirect either $STDIN or $STDLIST.

  • Do not nest the JOB command within a second-level STREAM command. (The JOB command is specified as a first-level JOB command.)

INPRI

Specifies the input priority of the job. The inputpriority value is the relative input priority used to check against access restrictions imposed by the jobfence. The inputpriority value becomes effective at logon time and must be from 1 (lowest priority) to 13 (highest priority). If you supply a value less than or equal to the current jobfence, the job is denied access. The default is 8.

HIPRI

Overrides the system jobfence, or overrides the job limit. When using the HIPRI parameter to override the jobfence, the system first determines whether you have system manager (SM) or system operator (OP) capability. If you have either of these capabilities, you are logged on, and your INPRI defaults to the system's jobfence and execution limit. If you do not have either of these capabilities, the system attempts to log you on using INPRI=13 and succeeds if the jobfence is 12 or less, and if the job limit is not exceeded.

You can also specify HIPRI to override the job limit, but you must have either SM or OP capability. The system does not override the job limit automatically. If you use the HIPRI parameter without SM or OP capability, the following warning message appears:

MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI, MAXIMUM INPRI OF 13 IS USED (CIWARN 1460)

RESTART

Restarts a spooled job that was interrupted by a system termination/restart. This parameter automatically becomes effective when the system is subsequently restarted with the START RECOVERY option. The effect is to resubmit the job in its original form. This parameter applies only to jobs initiated on spooled input devices. The default is that spooled jobs are not restarted after a system termination and restart.

OUTCLASS

Specifies the output class with one or more of the following values:

device

Indicates the class name or logical device number (LDEV) of the device to receive listing output. You cannot specify a magnetic tape unit. If the value is not a valid LDEV or class name, an error occurs. The default is defined in the system configuration. You can only supply a device if you have nonshareable device (ND) file access capability.

outputpriority

Indicates the output priority for the job list file, if destined for a spooled line printer. You can use outputpriority to select the next spooled device file (on disk) for output from among all those contending for a specific printer. This parameter applies only to output destined for spooled output devices and is ignored for other output.

The value must range from 1 (lowest priority) to 13 (highest priority). When outputpriority is 1, output is always deferred. To print output from disk, use an outputpriority of 2 or greater. The default is 8. If spooling logging is disabled, the default is 13.

numcopies

Indicates the number of job listing copies to be produced. The numcopies parameter only applies when the listing is directed to a spooled device, and it is ignored in other cases. The default value is 1. If the number of copies is less than 1, a warning appears; however, the command still executes with the default value of 1. If the number of copies is greater than 127, an error message appears, and 127 copies are printed.

Operation Notes

  • Usage

    You can enter this command only from a job file. You cannot enter it from a session, a job, a program, or in break mode. Pressing Break does not affect this command.

  • Requirements

    To properly use this command, you must adhere to the following requirements:

    • Terminate the JOB command with an EOJ command.

    • Precede the JOB command and EOJ command with an appropriate substitute prompt character for the colon prompt. By default, the system expects you to use an exclamation point (!).

    • Supply your username and accountname. If you omit either of these parameters or enter them incorrectly, the system rejects your job and prints error messages on the standard listing device and the console. Depending on how your system administrator has set up users on the system, you may also have to supply a logon group name as well as user, account, and/or group passwords.

  • Command process

    If the system accepts your job, the system displays the following information on the list device:

    • job number, as assigned by the system to identify the job

    • date and time

  • Job number

    The job number that the system assigns always uniquely identifies your job to the system and other users. The system assigns these numbers in sequential order as jobs are accepted.

Examples

  • To create a job file and submit it for processing, do the following:

    1. Enter the following command to invoke the EDIT subsystem:

         :EDITOR

    2. Enter the ADD command, then add job file commands, as shown:

         /ADD

             1 !JOB SMITH,USER.TECH

             2 !COMMENT  THIS JOB RUNS THE MONTHLY UPDATE PROGRAM

             3 !FILE INPUT01=TRANS.DATA.ENGR

             4 !FILE MASTER;DEV=TAPE

             5 !FILE OUTPUT=NEWFILE.PUB.TECH

             6 !RUN UPDPROG

             7 !EOJ

             8 //

      Note that the first command is the JOB command and that an exclamation point (!) precedes each command.

    3. Enter the KEEP and END commands to save your file and terminate the EDITOR subsystem:

         /KEEP MYJOB,UNN

   /END

    4. Submit the job file for processing by using the STREAM command:

         :STREAM MYJOB

    Note that the file MYJOB remains on disk after you stream it. Consequently, you can stream it again at any time, if desired.

Related Commands



   EOJ

   JOBFENCE

   LIMIT

   STREAM

   STREAMS


HELP
  		 


JOBFENCE  
Feedback to webmaster