JSWAKE - Initiate timer event for job scheduler

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 JSWAKE 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 JSWAKE macro serves to initiate the next timer event for the job scheduler. The time specification for the timer event is transferred in a field.

Macro format and description of operands

JSWAKE

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

JSWAKE=
Gives the address of the field containing the time specification for the timer event. The field must be aligned on a word boundary.

addr
Symbolic address (name) of the field.

(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 JSWAKE macro is transferred in register R15.

X'aaaaaa'	Meaning
X'000000'	Normal execution.
X'000008'	Operand error.
X'000010'	Unauthorized caller (not TSOS).

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