IMSAUTH return codes
The IMSAUTH supervisor call (SVC) returns a code in register 15 in form ffnnnnnn.
Function code ff is listed in parentheses next to the function name. The return codes nnnnnn, which are unique to each function, are listed under the function. All codes are hexadecimal numbers.
- IMSAUTH PGFIX (04)
- Return code
- Meaning
- 00
- Storage successfully page fixed/page freed
- 04
- One or more entries in error
- 08
- One or more list prefixes in error
- 0C
- Address validity check error
- 10
- List alignment error
- IMSAUTH PGFREE (08)
-
- Return code
- Meaning
- 00
- Storage successfully page fixed/page freed
- 04
- One or more entries in error
- 08
- One or more list prefixes in error
- 0C
- Address validity check error
- 10
- List alignment error
- IMSAUTH BATALLOC (0C)
- Return code from DFSMDA00
- IMSAUTH SETABND (10)
- This function does not issue any unique return codes.
- IMSAUTH RSETABND (14)
- Return Code
- Meaning
- 14
- Invalid function
- IMSAUTH RSETAUTH (18)
- Return Code
- Meaning
- 00
- Request successful
- 04
- Caller not authorized
- IMSAUTH NOSWAP (1C)
- This function does not issue any unique return codes.
- IMSAUTH SETAUTH (20)
-
- Return Code
- Meaning
- 00
- Request successful
- 04
- Caller not authorized
- IMSAUTH DELSSCT (28)
-
- Return Code
- Meaning
- 00
- SSCT deleted successfully
- 04
- SSCT not found
- 0C
- Caller not authorized
- IMSAUTH BLDMTMWH (2C)
-
- Return code
- Meaning
- 00
- MTMWQHDR built successfully
- 04
- MTMWQHDR exists for another IMS
- 08
- MTMWQHDR exists for caller
- 0C
- Caller not authorized
- 10
- GETMAIN failed for MTMWQHDR in SP 245
- 1C
- SSCT not found
- IMSAUTH DELMTMWH (30)
-
- Return code
- Meaning
- 00
- MTMWQHDR disconnected
- 04
- MTMWQHDR and blocks disconnected and freed
- 08
- MTMWQHDR not found
- 0C
- Caller not authorized
- 10
- FREEMAIN failed for MTMWQHDR in subpool 245
- 1C
- SSCT not found
- IMSAUTH SSCTSCD (34)
-
- Return code
- Meaning
- 00
- SCD address stored successfully
- 0C
- Caller not authorized
- 1C
- SSCT not found
- IMSAUTH IEBCOPY (38)
-
- Return code
- Meaning
- 00
- Link to IEBCOPY completed successfully
- 0C
- Function could not link to IEBCOPY
- Other
- IEBCOPY return code
- IMSAUTH SWAP (3C)
-
- Return code
- Meaning
- 00
- Request Successful
- 04
- Request is not for current address space
- 08
- Request not authorized
- IMSAUTH LOCSSCT (40)
-
- Return code
- Meaning
- 00
- SSCT located successfully
- 04
- SSCT not found
- IMSAUTH ADDPCB (44)
- Return code
- Meaning
- 00
- Function completed successfully
- 08
- GSAM PCB not added to DIRCA
- IMSAUTH BLDSSCT (48)
-
- Return code
- Meaning
- 00
- SSCT successfully built
- 0C
- Caller not authorized
- 10
- GETMAIN failed for SSCT in subpool 245
- 18
- Unable to load module DFSRTMI0
- 20
- Unable to establish a resource cleanup environment for IMS
- IMSAUTH INITSSVT (4C)
- Return code
- Meaning
- 00
- Request successful
- 04
- SSCT not found
- 0C
- Caller not authorized
- IMSAUTH TERMSSVT (50)
-
- Return code
- Meaning
- 00
- Request successful
- 04
- SSCT not found
- 0C
- Caller not authorized
- IMSAUTH BLDIRLM (54)
-
- Return code
- Meaning
- 00
- Request successful
- 04
- IRLM not active
- 08
- IMODULE GETMAIN / GETMAIN failed
- 1C
- SSCT not found
- IMSAUTH CHKSSCT (58)
-
- Return code
- Meaning
- 00
- Subsystem enabled
- 04
- Subsystem disabled
- 08
- SSCT name specified is zero
- IMSAUTH VECTADDR (5C)
-
- Return code
- Meaning
- 00
- Function completed successfully
- 04
- Caller not authorized
- IMSAUTH SSCTIRLM (60)
- Return code
- Meaning
- 00
- Request successful
- 04
- Caller not authorized
- 1C
- SSCT not found
- IMSAUTH RSETIRLM (64)
-
- Return code
- Meaning
- 00
- Request successful
- 04
- Caller not authorized
- 1C
- SSCT not found
- IMSAUTH UAMBSUBP (68)
-
- Return code
- Meaning
- 00
- Function completed successfully
- 04
- Invalid function request or GETMAIN error
- Other
- VSAM Extended Interface (XVI) function return code
- IMSAUTH BDUSRSSI (6C)
-
- Return code
- Meaning
- 00
- SSCT successfully built
- 08
- Parameter list invalid
- 0C
- Caller not authorized
- 10
- GETMAIN failed for SSCT or SSVT in subpool 245
- IMSAUTH BDSSIBLK (70)
-
- Return code
- Meaning
- 00
- Block successfully copied and connected to SSCT
- 04
- SSCT not found
- 08
- Parameter list invalid
- 0C
- Caller not authorized
- 10
- GETMAIN failed for block in subpool 231.
- IMSAUTH RSRINIT (74)
-
- Return code
- Meaning
- 00
- Function completed successfully
- 04
- Storage allocation failed
- 08
- Validation failure, caller not authorized
- 0C
- Validation failure, SSCT not found
- 10
- Open data set (RESLIB) failure
- 14
- IMODULE LOAD failure for DFSLLRN0/DFSFTFX0
- 18
- Close data set (RESLIB) failure
- IMSAUTH T0COPY (78)
-
- Return code
- Meaning
- 00
- Function completed successfully
- 04
- More than one non-MVS TCB present
- 08
- User interface module (UIM) provided but no user area
- 0C
- Non-zero return code from DFSMS
- 10
- Open data set (RESLIB) failure
- 18
- Close data set (RESLIB) failure
- IMSAUTH CALLRTM (7C)
- This function does not issue any unique return codes.
- IMSAUTH SWITCH_AUTH_CONTEXT (80)
- 00
- Request completed successfully
- Other
- Return code from STORAGE request or return code from CTXSWCH service
- IMSAUTH WLM_PBPOOL (84)
- Return code
- Meaning
- 04
- Caller is not under the TCB that issued IDENTIFY.
- 08
- Dependent Region Directory block not located.
- 0C
- Region IDENTIFY block not found.
- 10
- Call made from unsupported region type.
- 14
- Invalid function request.
- 20
- Create caller is not authorized
- 24
- Second Create PB Pool is not allowed.
- 28
- Failed to get storage for DFSWLMPP block.
- 2C
- WLM Get PB blocks failed for CREATE request.
- 40
- No PB Pool block was located for ADD request.
- 44
- ADD request not issued from the same TCB as CREATE.
- 48
- Failed to get storage for ADD PBs request.
- 4C
- WLM Get PB blocks failed for ADD request.
- 60
- DELETE caller is not authorized.
- Other IMSAUTH return codes
-
- Return code
- Meaning
- 14
- Invalid function