HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 4  Command Definition F-K

JOB
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

Defines a job to be activated with the STREAM command or an input spooled device to run in batch mode. (Native Mode)

Syntax

JOB[ jobname,] username [ /userpass] .acctname [ /acctpass] [ ,groupname[ /grouppass]]
[TIME=cpusecs] [;PRI= BS | CS | DS | ES]
[;INPRI=inputpriority ;HIPRI] [ ;RESTART] [;JOBQ=queuename]
[;OUTCLASS=[[DEVICE][,[OUTPUTPRIORITY][ ,NUMCOPIES]]]]
[;TERM={termtype}][ ;PRIVATE][ ;SPSAVE]

Parameters

jobname

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. Default is that no job name is assigned.

username

User name, established by the account manager, that allows you to log on to this account. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character.

userpass

User password, optionally assigned by account manager. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists, but is not supplied in the command syntax, the STREAM command will prompt you for it if:

  • The STREAM command is invoked from a session.

  • Neither $STDIN nor $STDLIST is redirected.

  • The JOB command is a first level JOB command (it is not nested within a second level STREAM command).

If the password is supplied in the command syntax it must be preceded by a slash (/).

acctname

Account name as established by the system manager. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. The acctname parameter must be preceded by a period (.).

acctpass

Account password, optionally assigned by the system manager. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists, but is not supplied in the command syntax, the STREAM command will prompt you for it if:

  • The STREAM command is invoked from a session.

  • Neither $STDIN nor $STDLIST is redirected.

  • The JOB command is a first level JOB command (it is not nested within a second level STREAM command).

If the password is supplied in the command syntax it must be preceded by a slash (/).

queuename

The name of the job queue the job will execute in. The default job queue is HPSYSJQ, which is a global queue for all jobs not associated with an individual job queue

groupname

Group name to be used for the local file domain and for CPU-time charges, as established by the account manager. The name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. Default is home group if one is assigned. (Required if a home group is not assigned.)

grouppass

Group password, optionally assigned by the account manager. The password must contain from one to eight alphanumeric characters, beginning with an alphabetic character. The group password is not needed when you log on to your home group. It is needed when you log on under any other group for which a password exists. If a password is needed, but is not supplied in the command syntax, the STREAM command will prompt you for it if:

  • The STREAM command is invoked from a session.

  • Neither $STDIN nor $STDLIST is redirected.

  • The JOB command is a first level JOB command (it is not nested within a second level STREAM command).

If the password is supplied in the command syntax it must be preceded by a slash (/).

cpusecs

Maximum CPU time allowed job, in seconds. When this limit is reached, the job is aborted. This must be a value from 1 to 32,767. To specify no limit, enter a question mark or UNLIM, or omit this parameter. Default is a system-configured job limit.

BS, CS, DS, or ES

The execution priority queue that the command interpreter uses for your session. This is also the default priority for all programs executed within the session. BS is the highest priority; ES is the lowest. If you specify a priority that exceeds the highest priority permitted for your account or user name by the system, MPE/iX assigns the highest priority possible below BS. DS and ES are intended primarily for batch jobs; their use for sessions is generally discouraged. DS is the default and the maximum priority, unless modified by system management.

NOTE: Use care in assigning the BS queue. Processes in this priority class can lock out other processes.

For information on the guidelines for these priority queues, refer to the TUNE command in this chapter.

inputpriority or HIPRI

Determines the input priority of the job. The inputpriority parameter is the relative input priority used in checking against access restrictions imposed by the jobfence. The inputpriority parameter takes effect 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 set by the system operator, the job is denied access. Default is 8.

The HIPRI option is used for two different purposes when logging on. It can be used to override the system jobfence, or it can be used to override the job limit. When using the HIPRI option to override the jobfence, the system first checks to see if 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. In attempting to override the job limit (to log on after the maximum number of jobs set by the operator has been reached), you can specify HIPRI, but to do so you must have either SM or OP capability. The system does not override the job limit automatically. Use of the HIPRI option without SM or OP capability causes the following warning to be displayed:

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

RESTART

Request to restart a spooled job that has been interrupted by the system termination/restart. This parameter takes effect automatically 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. It is ignored for other jobs. Default is that spooled jobs are not restarted after system termination/restart.

device

Class name or logical device number (ldev) of the device to receive listing output. You cannot specify a magnetic tape unit. If the parameter is not a valid LDEV or class name, an error is generated. Default is defined in the system configuration.

NOTE: Nonshareable device (ND) file access capability is required in order to use this parameter.
outputpriority

The output priority for job list file, if destined for spooled line printer. This parameter is used to select the next spooled device file (on disk) for output, from among all those contending for a specific printer. Must be a value from 1 (lowest priority) to 13 (highest priority). When outputpriority is 1, output is always deferred. To have output printed from disk, use an outputpriority of 2 or greater.

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

numcopies

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

termtype

The TERM= option is obsolete now that the JOB command cannot be used interactively. In order to maintain backward compatability, the termtype parameter is still parsed, but it is not used. If the TERM= option is used, a warning message will be displayed.

PRIVATE

The PRIVATE option forces the job output $STDLIST to be a private spoolfile. The spoolfile is only accessible to privileged users on the system. Private spoolfiles may not be saved or copied. They may only be purged, printed, or (within limits) altered.

SPSAVE

If this option is used, the resulting job output $STDLIST spoolfile is created with an SPSAVE disposition. This means that the spoolfile is not to be purged after the last copy of it has been printed, but is instead retained in the OUT.HPSPOOL group. SPSAVE may not be used if PRIVATE has been specified.

NOTE: The "&" symbol has no meaning to the input spooler when it reads records because the CI is not involved at that point.

Operation Notes

The JOB command is not used at the colon prompt (:). Rather, it is used in interactive mode with the STREAM command at the > prompt, or within an input jobfile, created to define a batch job. The job defined with this command is then activated (executed) with the STREAM command.

The JOB command is preceded by an appropriate substitute prompt character for the colon prompt. By default, MPE/iX expects the exclamation point (!) to be used. The JOB command must be terminated with an EOJ command. Refer to the STREAM command.

When MPE/iX begins the job, it displays the following information on the list device:

  • Job number, as assigned by MPE/iX to identify the job.

  • Date and time.

  • "HP 3000," and the modified and base MPE/iX version.update.fix numbers.

In the JOB command, as in the HELLO command, you must always supply your username and acctname, which you obtain from your account manager. If you omit either of these parameters, or enter them incorrectly, MPE/iX rejects your job and prints error messages on the standard listing device and the console. If your job is accepted, MPE/iX begins job processing. The job is entered with the STREAM command or through a spooled input device. Then the job is copied to an input spoolfile. The job is initiated from that spoolfile rather than the originating diskfile (in the case of the STREAM command) or device (in the case of the input spooled device). If the standard listing file is a line printer, MPE/iX prints a header page prior to listing the JOB command. (The system operator can disable the printing of this header page with the HEADOFF console command.)

The job number assigned by MPE/iX always uniquely identifies your job to MPE/iX and other users. MPE/iX assigns such numbers in sequential order as jobs are accepted. Sometimes, the job acceptance information includes a message from the system operator following the standard display. When present, this is the same message output in the logon information for sessions.

The minimum information needed for job initiation is the user and account name. However, the following also may be required:

  • Logon group name.

  • User, account, and/or group passwords.

The cases in which this information is required, and the rules for supplying it, are the same as those for the HELLO command for sessions, except that:

  • When you enter the JOB command through a device other than a terminal, and the standard input device is different from the standard listing device, MPE/iX does not echo passwords.

  • When the standard listing device is a line printer and you do not specify a file group name, central processor time limit, execution priority, and/or input priority in the JOB command, the default values assigned by MPE/iX for the omitted parameters appear on the job listing.

The STREAM command prompts for any necessary passwords that are not supplied in the command syntax if:

  • The STREAM command is invoked from a session.

  • Neither $STDIN nor $STDLIST is redirected.

  • The JOB command is a first level JOB command (it is not nested within a second level STREAM command).

All UDCs are available from a job. Any subsystem or UDC that expects input from $STDIN requires that input within your job stream file.

Use

This command may be issued only from a job file. It may not be used from a session, program, or in BREAK. Pressing Break has no effect on this command.

Example

The following example illustrates creating and using an ASCII file to define a batch job and then executing it with the STREAM command:

 RUN EDITOR.PUB.SYS
 /ADD
      1 !JOB WXYZ,WRITER.TEC
      2 !EDITOR
      3 TEXT ABC
      4 LIST ALL,OFFLINE
      5 EXIT
      6 !EOJ
       //
 /KEEP MYJOB
 /EXIT
 :
  STREAM MYJOB

The following example shows using the JOB command in interactive mode with the STREAM command:

  STREAM
 >!JOB USER.TECHPUBS;OUTCLASS=12

Related Information

Commands

ABORTJOB, ALTJOB, BREAKJOB, SUSPENDJOB, RESUMEJOB, JOBFENCE, JOBPRI, STREAM, STREAMS, SHOWDEV, NEWJOBQ, LISTJOBQ

Manuals

Using the HP 3000 Series 900: Advanced Skills

MPE/iX Intrinsics Reference Manual



INPUT
  		 


JOBFENCE  
Feedback to webmaster