JSATTCH - Attach job scheduler to Job Management System

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 JSATTCH 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

The JSATTCH macro indicates to JMS that the job scheduler is ready to process JSS events.
JMS confirms by returning a date entry in the form of the minutes that have elapsed since 1.1.1980 (0.00 hours).

Note

It is essential to use this macro in order that JSS can support the job scheduler (receive job start requests, transfer JSS events).

Macro format and description of operands

JSATTCH

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

CLOCK=
Defines the address of an area in which the date entry is made. The area must be aligned on a word boundary. This operand can be specified only for the 24-bit interface.

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, see "S-type macros".
The valid MF values and default settings for this macro are given at the start of the macro description.

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 area containing the date entry. The area should be aligned on a word boundary and must start with the standard header. This operand can be specified only for the 31-bit interface.
The DJSIPL macro generates a description (DSECT/data list) of this area; the initialization values for the standard header are entered.

addr
Symbolic address (name) of the area.

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

Return information and error flags

R15:

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

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

X'aaaaaa'	Meaning
X'000000'	Normal execution.
X'000008'	Operand error.
X'00000C'	System error.
X'000010'	Unauthorized caller (not TSOS).
X'000018'	Macro was carried out after a JSATTCH macro or job stream has already terminated.

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