JSRUNJB - Transfer job to start

General

Application area:	Job scheduler (system administration macro); see "Job scheduler"
Macro type:	Type S, MF format 1: 24-bit interface: standard/E/L form 31-bit interface: standard form; see "S-type macros"

• The JSRUNJB macro can only be called under the TSOS (system administration) ID.

• When using the 31-bit interface, the DJSIPL macro serves to generate a description (DSECT/data list) of the operand list; when using the 24-bit interface, the same function is performed by the DJSI macro.

• JMS = Job Management System; JSS = Job Scheduling Supports. JSS is part of the Job Management System.

Macro description

By means of the JSRUNJB macro the job scheduler requests the class scheduler to start the specified job.
The job is defined by

• its TSN,

• the name of the job class to which the job was assigned and

• start specifications for the job (start indicator).

Note

If the CLASS-LIMIT has been reached for the job class, the job is not started. An appropriate return code is transferred.

Macro format and description of operands

JSRUNJB

{ PARMOD=24 ,STRTINF={addr / (r)} [,MF={L / (E,..)}] / [PARMOD=31] ,PARLIST={addr / (r)} }

STRTINF=

Defines the address of an area with the data of the job to be started. The area must be aligned on a word boundary.

addr
Symbolic address (name) of the area.

(r)
Register containing the address value “addr”.

MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. for a prefix), see "S-type macros". The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.

PARMOD=
Controls macro expansion. Either the 24-bit or the 31-bit interface is generated.
If PARMOD is not specified here, macro expansion is performed according to the specification for the GPARMOD macro or according to the default setting for the assembler (= 24-bit interface).

24
The 24-bit interface is generated. Data lists and instructions use 24-bit addresses. (Address space <= 16 Mb.)

31
The 31-bit interface is generated. Data lists and instructions use 31-bit addresses. (Address space <= 2 Gb.) Data lists start with the standard header.

PARLIST=
Gives the address of the operand list. The list should be aligned on a word boundary and must start with the standard header. The DJSIPL macro generates a description (DSECT/data list) of the operand list; the initialization values for the standard header are entered.

addr
Symbolic address (name) of the operand list.

(r)
Register containing the address value “addr”.

Return information and error flags

During macro processing, register R1 contains the operand list address.

R15:

+---------------+
|   |   |   |   |
|0|0|a|a|a|a|a|a|
+---------------+

A return code relating to the execution of the JSRUNJB macro is transferred in register R15.

X'aaaaaa'	Meaning
X'000000'	Normal execution.
X'000004'	TSN of job to be started is unknown.
X'000008'	Operand error.
X'00000C'	System error.
X'000010'	Unauthorized caller (not TSOS).
X'000018'	Macro called before a JSATTCH macro or after a JSDETCH.
X'00001C'	The job is not in Q1 or has not been marked as “accepted for scheduling” by the Job Management System.
X'000020'	Job class limit exceeded.
X'000024'	Job stream in HOLD state.
X'000028'	Job in HOLD state.

Other return codes which, in accordance with conventions, apply to all macros are given in the table “Standard return codes” (Standard header).