JSINFO - Access STREAM-PARAMETER values

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 JSINFO 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 STREAM-PARAMETER (S-PAR) values of the stream definition are accessed with the JSINFO macro.
The JSINFO macro should be called before the JSATTCH macro.

Macro format and description of operands

JSINFO

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

JSINF=
Defines the address of an area in which the STREAM-PARAMETER values are entered. 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 JSINFO 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).