Output Parameters

Output parameters for the function routine are:

SSOBRETN
SSJIRETN
IAZCVDEV (Convert Device ID service)

SSOBRETN Contents: When control returns to the caller and register 15 contains a zero, the job information services function places one of the following decimal values in the SSOBRETN field:

Value (Decimal): Meaning
SSJIOK (0): Request successful.
SSJIERVR (4): Request completed with possible errors, see SSJIRETN for reason code.
SSJIERRU (8): Request cannot be completed because of user error, see SSJIRETN for reason code.
SSJIERRJ (12): Request cannot be completed, SSJIRETN contains internal reason code.
SSJIPARM (16): The parameter list, ie, the SSJI extension is an invalid format - it is not an SSJI, the service version number is not supported, or the SSJI is not large enough.

SSJIRETN Contents: In addition to the return code in SSOBRETN, the field SSJIRETN contains the service related error or more specific information about the error. SSJIRETN will be set to one of the following decimal values:

Value (Decimal): Meaning
SSJIUNSF (4): Unsupported subfunction requested
SSJINTDS (24): SSJIUSER does not point to the correct data area
SSJIUNSD (28): SSJIUSER CB version number is not correct
SSJISMDS (32): SSJIUSER CB lenght is too small

Return codes in SSJIRETN specific to the Convert Device ID service: The following return codes are set if the Convert Device ID service was requested and SSOBRETN is zero:

Value (Decimal): Meaning
CVDVK (0): Success

Convert Device ID service, IAZCVDEV contents: For the Convert Device ID service (function code SSJICVDV) the following is retunred in IAZCVDEV:

Field Name: Description
CVDVVERO: Subsystem version number (currently 1)
CVDVNAME: Convert device name in EBCDIC. If the device type is not known, then this will be set to 'UNKNOWN'
CVDVSZE: Size of IAZCVDEV