Fixed Header Output Section

The fixed header output section contains information that the called subsystem returns to the requesting program. The called subsystem sets all fields, although they may be binary zeros.

The following shows how the master and JES subsystems set the contents of the fixed header output section:

Field Name

Description

SSVIRLEN

A 2-byte binary field that contains either the length of the storage used (if the caller's request was successful), or the length of storage required (if the request failed because the caller did not specify enough storage).

To determine whether the SSVIRLEN field contains returned or required storage, check the return code in SSOBRETN, which indicates:

Decimal Value: Meaning
SSVIOK (0): Request was successful. The SSVIRLEN field contains the length, in bytes, of the returned data.
SSVINSTR (8): Request failed. The caller did not specify enough storage in the SSVIRLEN field. The SSVIRLEN field contains the amount of storage, in bytes, the subsystem requires to return the requested information.

Note that this field is not set when the SSOBRETN field contains return code SSVIPARM (16) or SSVIABLG (24).

SSVIRVER

A 1-byte binary field that contains the version of the SSVI control block used by the subsystem. When the caller's version of the SSVI control block does not match the version used by the called subsystem, the subsystem returns information based on the older of the two versions of the SSVI control block.

SSVIFLEN

A 2-byte integer field that contains the length of the fixed header output section of the SSVI control block the subsystem uses.

SSVIASID

A 2-byte binary field that indicates the ASID of the subsystem. A value of X'FFFF' indicates that the address space abended. This field contains valid information only if the caller-supplied version in field SSVIVER is greater than or equal to 2.

SSVIVERS

An 8-byte character field that specifies the version of the subsystem. For example, JES returns: SP 5.1.0, SP 5.2.1, OS 1.1.0, OS 2.10, z/OS® 1.4, or z/OS 1.9. The master subsystem returns the same value as that contained in CVTPRODN.

SSVIFMID

An 8-byte character field that specifies the FMID of the subsystem (for example, HBB5510, HJE5510, HJS5511, HJE7730, HJS7730, or HBB7730).

SSVICNAM

An 8-byte character field that is left-justified, and padded to the right with blanks and contains the common name of the subsystem. For example, in a poly-JES environment, the secondary JES2 subsystem (for example, JESA) returns: 'JES2'.

The master subsystem of an MVS™ system returns: 'MASTER'.

SSVIPLVL

This 1-byte field contains either zero or a value that indicates the relative subsystem product level. For example, with either JES, the relative subsystem product level value will increase by at least one for each subsequent release of the subsystem. For z/OS Release 7 JES2, the relative subsystem product level value is decimal '36'. For more information, see topic "Determining the JES2 Release Level" in z/OS JES2 Installation Exits. For JES3 SP 3.1.2, the relative subsystem product level value is decimal '1' and for OS/390® Release 1 JES3, the relative subsystem product level value is decimal '6'. For more information, see topic "Determining the JES3 Release Level" in z/OS JES3 Customization.

This field contains valid information only if the caller-supplied version in field SSVIVER is greater than or equal to 2.

SSVISLVL

This 1-byte field indicates the relative service level of the subsystem and contains either zero or the service level of the subsystem. The JES2 relative service level is set to zero for each new product level and will increase by at least one each time significant maintenance or function is added within a release. The JES3 service level can increase by at least one each time significant maintenance or function is added and is maintained across new releases. For additional information concerning this field, see z/OS JES2 Installation Exits or z/OS JES3 Customization.

This field contain valid information only if the caller-supplied version in field SSVIVER is greater than or equal to 2.

SSVIUDOF

A 4-byte integer field that contains the offset from the start of the IEFSSVI DSECT, to the start of the installation variable output data section. The subsystem sets this field to zero if there is no installation variable output data section.

SSVISDOF

A 4-byte integer field that contains the offset from the start of the SSVI control block, to the start of the system variable output data section. The subsystem sets this field to zero if there is no system variable output data section.