GENEWS 35 - spawn new job.

Usage:

mme     genews
zero    BUFPTR,JOBLOC
tra     FAIL

Where:

BUFPTR: is a pointer to the first word of a 320-word buffer that MME GENEWS will use for its work.
JOBLOC: is a pointer to a word which indicates where the job is to be found. If the job is contained in a temporary file, the word indicated by JOBLOC must have bits 0-17 zero and must contain the file code of the temporary file in bits 24-35. If the job is contained in the current program's memory space, bits 0-17 of the word indicated by JOBLOC should give the address of the beginning of the job.
FAIL: If MME GENEWS fails due to a transient runtime condition, GENEWS returns to the second word after the MME. Usually this is coded as a transfer to a routine (FAIL), that processes the failure. If the MME GENEWS is successful, it will return to the third word following the MME.

Description:

MME GENEWS spawns a new job. The JCL for the new job may be stored in a temporary file or in memory.

If the spawn operation is successful, MME GENEWS will return to the 3rd location after the MME. In this case, the Q register will contain the SNUMB of the new job (five BCD characters, left-justified and zero-filled).

If the spawn fails, for an error in the MME GENEWS call the job will be aborted. If the spawn fails for a possibly transient runtime condition, GENEWS will return to the second location after the MME. (Usually this is a "tra FAIL" instruction.) In addition, there will be 12 character BCD error message in the AQ register, and a binary error code in the first word of the buffer. The following is a list of the error code (octal) values that the GCOS module defines.

 1   file random or not temporary
 2   file/stream pointer outside calling program
 3   illegal file code
 4   file code not in PAT
 5   device of temporary file not mass storage
 6   non-recoverable I/O error
 7   no mass storage space available
10   beginning of temporary file not $DUMMY
11     (reserved for future use)
12   system scheduler queue full
13   duplicate SNUMB requested
14   end-of-stream flag missing or out of position
15   could not wire page
16   could not unwire page
17   specified SNUMB was all blanks
20   work unit security data could not be retrieved

Not all these codes can be returned by MME GENEWS. However there are are some other spawn calls (PMMES and or privileged entries) that use the same module, and these codes may be returned for those calls.

Notes:

If the job is spawned from a temporary file, the first JCL statement must be a $DUMMY. This will be replaced by a valid $SNUMB statement.

If the job is spawned from memory, the first JCL statement must be a $IDENT or a $SELECT that obtains a file beginning with $IDENT. MME GENEWS will automatically insert a valid $SNUMB statement before the $IDENT. All of the JCL statements in memory must be 14 words long. The end of the JCL statements in memory is indicated by a

zero    -1,0

If a file code specified for MME GENEWS is zero or contains a "*" or "$", the request will fail.

The $SNUMB statement of the spawned job will contain the SNUMB and activity number of the original job, beginning in column 36.

A job spawned from a remote station is returned to that station.

MME GENEWS may not be used in a courtesy call.