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