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=LIST 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

RACLIST function completed successfully.

Reason code: Meaning
0: Delete request successful. Create request successful and profiles were listed.
4: Create request successful but no profiles were listed.

04

Unable to perform the requested function. Register 0 contains additional codes as follows:

Reason code: Meaning
0: Unable to establish an ESTAE environment.
1: The function code (the third byte of the parameter list) does not represent a valid function. 01 represents the RACF® manager; 02 represents the RACLIST macro.

08

The specified class is not defined to RACF.

0C

An error was encountered during RACLIST processing.

10

RACF or the resource class is not active, or both.

14

RACLIST installation exit error occurred.

18

Parameter-list error.

1C

RACF is not installed, or an insufficient level of RACF is installed.

64

Indicates that the CHECK subparameter of the RELEASE keyword was specified on the execute form of the RACLIST macro; however, the list form of the macro does not have the proper RELEASE parameter. Macro processing terminates.

Note: If the resource class specified by the CLASS= operand is inactive, RACLIST does not build the in-storage profiles and a code of 0C is returned. If the resource-group class is not active, RACLIST builds an in-storage profile but only from the individual resource profiles; resource-group profiles are ignored.

Example 1

Use the standard form of the macro to build in-storage profiles for all the profiles in the DASDVOL class and chain them off the ACEE whose address is pointed to by ACEEADDR.

RACLIST CLASS='DASDVOL',ACEE=ACEEADDR,ENVIR=CREATE

Example 2

Use the standard form of the macro to build in-storage profiles for all the profiles whose names are in a list named PROFLIST and DASDVOL class. Chain them from the task ACEE or address space ACEE.

RACLIST CLASS='DASDVOL',LIST=PROFLIST,ENVIR=CREATE
   ⋮
PROFLIST  DS   0CL35
PROFNUM   DC   XL2'0005'
PROF1     DC   AL1(6),CL6'DASD01'
PROF2     DC   AL1(6),CL6'DASD02'
PROF3     DC   AL1(5),CL5'DASDA'
PROF4     DC   AL1(5),CL5'DASDB'
PROF5     DC   AL1(6),CL6'MYDASD'

Example 3

Use the standard form of the macro to delete the in-storage profiles for the DASDVOL class.

RACLIST CLASS=DASDVOL,ENVIR=DELETE