Input Parameters

Input parameters for the function routine are:

SSOB
SSIB
IAZSSJI
IAZMOND (JES2 Health Monitor Information)

SSOB Contents: The caller sets the following fields in the SSOB control block on input:

Field Name: Description
SSOBID: Identifier 'SSOB'
SSOBLEN: Length of the SSOB (SSOBHSIZ) control block
SSOBFUNC: SSI function code 71(SSOBSSJI)
SSOBSSIB: Address of the SSIB control block or zero (if this field is zero, the life-of-job SSIB is used). See Subsystem Identification Block (SSIB) for more information on the life-of-job SSIB
SSOBINDV: Address of the function-dependent area (IAZSSJI control block)

Set all other fields in the SSOB control block to binary zeros before issuing the IEFSSREQ macro.

SSIB Contents: If you don't use the life-of-job SSIB, the caller must provide an SSIB and set the following fields in the SSIB control block on input:

Field Name: Description
SSIBID: Identifier 'SSIB'
SSIBLEN: Length of the SSIB (SSIBSIZE) control block
SSIBSSNM: Subsystem name — name of the subsystem to which this Job Information Services request is directed

Set all other fields in the SSIB control block to binary zeros before issuing the IEFSSREQ macro.

IAZSSJI Contents: The caller must set the following fields in the IAZSSJI control block on input:

Field Name

Description

SSJIID

Eyecatcher for the control block (set to 'SSJI')

SSJILEN

Length of the IAZSSJI (SSJISIZE) control block

SSJISVRN

Input version of the IAZSSJI control block. Set to SSJISVR# for version 1 of the control block

SSJIFREQ

Function to be performed on this request. Valid functions and their related SSJIUSER area are:

Field Value: SSJIUSER Description
SSJIMNOD: IAZMOND JES2 Health Monitor information, obtain data
SSJIMNRS: IAZMOND JES2 Health Monitor information, release storage

SSJIUSER

Pointer to service specific data area (IAZMOND)

Set all other fields in the IAZMOND control block to binary zeros before issuing the IEFSSREQ macro.

JES2 Health Monitor Information, IAZMOND contents: For the JES2 Health Monitor information service (function code SSJIMNOD) the caller must set the following fields in the IAZMOND control block on input to a SSJIMNOD function call:

Field Name

Description

MONDSSID

Eyecatcher of the control block (set to 'MOND')

MONDLEN

Length of the IAZMOND (MONDSZE) control block

MONDVER

Input version and modifier of the IAZMOND control block. Set to MONDV020 for version 2 of the control block. Set to MONDCVRL and MNDCVRM for the current (latest) version and modifier.

MONDVERL: Version level
MONDVERM: Version modifier

MONDSTRP

Storage management anchor for use by the subsystem that responds to this request. It is expected that the caller will set this field to zero the first time IAZMOND is used and from that point on the field will be managed by the subsystem.

MONDSEL1

Information selection flag byte 1

MONDSRES: Resource usage statistics
MONDSMTS: Main task CPU statistics
MONDSERR: JES2 ERROR statistics
MONDSWTS: Main task WAIT statistics
MONDSJSA: JES2 Alerts
MONDSJSN: JES2 Notices
MONDSJST: JES2 Tracks
MONDSSTO: JES2 storage usage statistcs

MONDSEL2

Information selection flag byte 2

MONDSMNS: Monitor status information

MONDHSTC

History count limit.

The JES2 Health Monitor maintains a history for some statistics (resource usage, CPU statistics, and error statistics). In general, these statistics are reset at the beginning of each hour and hourly statistics are maintained for as long as the JES2 Health Monitor is running. The amount of history returned can be limited by setting MONDHSTC to the number of history elements to return. Setting MONDHSTC to 0 or 1 will return only the current data. Setting it to 5 will return the 5 most recent history elements. Setting it to X'FFFF'' will return all history elements.

MONDHSTC only applies when setting MONDSRES, MONDSMTS, or MONDSERR in MONDSEL1.

MONDRSNM

Resource name filter.

If MONDSEL1 is set to MONDSRES, them MONDRSNM can be set to the resource name for which information is to be returned (left justified and padded with blanks). Generics (* and ?) are allowed. Setting the first byte of MONDRSNM to zero or blanks is the same as setting MONDRSNM to '* '. All resources are returned.

Set all other fields in the IAZMOND control block to binary zeros before issuing the IEFSSREQ macro.

For the JES2 Health Monitor Information service function codes SSJIMNRS (release storage), the caller should set MONDSTRP in the IAZMOND control block to indicate the storage to be released.