Return codes and reason codes

If the return codes and reason codes you are receiving are not discussed in this macro, refer to the return codes and reason codes described in RACROUTE REQUEST=EXTRACT Return codes and reason codes.

When control is returned, register 15 contains one of the following return codes, and register 0 can contain a reason code.

Hex Code

Meaning

00

The extraction or encoding completed successfully.

Reason Code: For Derive Requests
0: Some of the values are derived from the USER profile, and some might be derived from the GROUP profile.
4: High-level qualifier returned as RESOWNER. It matched a valid USER.
8: DFP data returned from an EXTRACT request from USER profile was actually from the user's default connect group.
0C: High-level qualifier returned as RESOWNER. It matched a valid GROUP.
24: RESOWNER field matched a valid USER.
28: RESOWNER field matched a valid GROUP.
2C: At least one, but not all, of the fields requested failed to be retrieved because of field level access checking.

04

An ESTAE environment was not able to be established, or if register 0 contains a reason code of 1, neither EXTRACT nor ENCRYPT was specified for TYPE=.

08

For TYPE=EXTRACT, TYPE=EXTRACTN, or TYPE=REPLACE the profile cannot be found. The hexadecimal reason codes are:

Reason code: For derive requests
0: No profile found.
4: Field-level access checking failed. The FIELD class might not be active and RACLISTed.
8: Segment not found.
14: Neither the RESOWNER field nor the high-level qualifier matched a valid USER or GROUP.

C

RACF® is inactive.

10

The extract operation failed. Register 0 contains the RACF-manager return code that represents the cause of termination. This return code is not used for the encoding function. The manager return code and reason codes are returned in the low-order and high-order halfwords of register 0.

14

For TYPE=ENCRYPT or TYPE=EXTRACT of user-class data, ENTITY was specified and no ACEE exists, or the ACEE was not for a defined user.

Reason code: For derive requests
0: No ACEE exists.
4: ACEERACF bit is off.

18

A parameter-list error was encountered. The hexadecimal reason codes are:

Reason code

For derive requests

4

For TYPE=REPLACE request, FIELDS= was not specified.

8

Type specified is not valid

C

Number of fields not valid.

10

Class name specified is not valid.

14

Version in parameter list is not valid.

18

Subpool specified is not valid.

1C

Parameter length not valid.

20

For TYPE=REPLACE request, SEGDATA= was not specified.

24

Entity name specified is not valid.

2C

For TYPE=ENCRYPT request, no user-authentication key was specified.

30

Encoding method is not valid.

34

ENTITY= was not specified with TYPE=REPLACE, TYPE=EXTRACTN, or TYPE=EXTRACT with class other than USER.

38

Multiple profiles; no volume specified.

3C

Profile found wrong volume serial number specified.

48

Entity-name length with the ENTITY keyword not valid:

The specified length is one of the following:
- Greater than 44 if CLASS=DATASET
- Greater than 8 if CLASS=USER or GROUP
- Greater than 17 if CLASS=CONNECT
- Greater than the maximum for the specified class as defined in the class descriptor table.
For TYPE=ENCRYPT request, the specified length is not zero or eight.

50

The entity name contains a blank at the beginning or in the middle of the name.

64

Indicates that the CHECK subparameter of the RELEASE keyword was specified on the execute form of the RACXTRT macro; however, the list form of the macro does not have the proper RELEASE parameter. It also indicates that the TYPE parameters specified on the list and execute forms might not be the same TYPE. Macro processing terminates.