z/OS MVS Using the Subsystem Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Output Parameters

z/OS MVS Using the Subsystem Interface
SA38-0679-00

Output parameters for the function routine are:
  • SSOBRETN
  • SSJIRETN
  • IAZDSERV (Checkpoint Versions Information service)
SSOBRETN Contents: When control returns to the caller and register 15 contains a zero, the extended status 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:

When SSOBRETN is SSJIERVR (4):
Value (Decimal)
Meaning
SSJIOLDD (20)
The data may be obsolete
(136)
ALESERV error
When SSOBRETN is SSJIERRU (8):
Value (Decimal)
Meaning
SSJIUNSF (4)
Unsupported subfunction requested
SSJI2OBT (8)
Successive obtains without an intervening release requested
SSJIDISA (12)
Subtask disabled, try again later
SSJIVINA (16)
Versioning inactive, activate it
SSJINTDS (24)
SSJIUSER does not point to the correct data area
SSJIUNSD (28)
SSJIUSER control block version number is not correct
SSJISMDS (32)
SSJIUSER control block length is too small
SSJIINVR (36)
Invalid input data to release. Could be successive releases without an intervening obtain or release without an intervening obtain or release without having done an obtain.
When SSOBRETN is SSJIERRJ (12):
Value (Decimal)
Meaning
(128)
Data space unavailable
(132)
Subtask in PJES2
(136)
ALESERV error
Return codes in SSJIRETN specific to the Checkpoint versions information service: The following return codes are set if the Checkpoint versions information service was requested and SSOBRETN is zero:
Value (Decimal)
Meaning
SSJIOK (0)
Success

Checkpoint version information service, IAZDSERV contents: For the Checkpoint versions information service (function codes SSJIFOBT and SSJIFREL) the following is returned in IAZDSERV:

Field Name
Description
DSRVCVPT
Pointer to Checkpoint version
DSRVCNUM
Version number
DSRVJOTK
JOT token
DSRVJOPT
Pointer to JOT
DSRVJOAL
ALET of JOT
DSRVJQTK
JQE token
DSRVJQPT
Pointer to JQE
DSRVJQAL
ALET of JQE
DSRVQSTK
QSE token
DSRVQSPT
Pointer to QSE
DSRVQSAL
ALET of QSE
DSRVHCTK
HCT token
DSRVHCPT
Pointer to HCT
DSRVHCAL
ALET of HCT
DSRVTIME
Time stamp
DSRVSZE1
Version 1 length
DSRVJNTK
JNT token
DSRVJNPT
Pointer to JNT
DSRVJNAL
ALET of JNT
DSRVSZE2
Version 2 length
DSRVJQXK
JQX token
DSRVJZPT
Pointer to JQX
DSRVJXAL
ALET of JQX
DSRVJTTK
JQE trackgroup extension token
DSRVJTPT
Pointer to JQE trackgroup extension
DSRVJTAL
ALET of JQE trackgroup extension
DSRVDASK
DAS token
DSRVDAPT
Pointer to DAS
DSRVDAAL
ALET of DAS
DSRVSZE3
Version 3 length
DSRVFLG1
DSERV flags
DSRVF1LI
Use live version
DSRVJ2LV
Checkpoint level ($ACTIVATE level)
DSRVSZE4
Version 4 length
DSRVWQSK
WLM Q position token
DSRVWQST
Pointer to WQPOS
DSRVWQSL
ALET of WQPOS
DSRVSZE5
DSERV Version 5 fixed parameter length
DSRVJOXK
JOX token
DSRVOXPT
Pointer to JOX
DSRVOXAL
ALET of JOX
DSRVCNPT
Reserved for subsystem use
DSRVSZE6
DSERV Version 6 fixed parameter length
DSRVSZE
Current version length

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014