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 with RACROUTE REQUEST=VERIFY 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

RACINIT has completed successfully.

04

The user profile is not defined to RACF®.

08

The password is not authorized.

0C

The password has expired.

10

The new password is not valid.

14

The user is not defined to the group.

18

RACINIT was failed by the installation exit routine.

1C

The user's access has been revoked.

20

RACF is not active.

24

The user's access to the specified group has been revoked.

28

OIDCARD parameter is required but not supplied.

2C

OIDCARD parameter is not valid for specified user.

30

The user is not authorized to use the terminal. Register 0 contains one of the following reason codes:

Reason Code: Meaning
00: Indicates a normal completion.
04: Indicates the user is not authorized to access the system on this day, or at this time of day.
08: Indicates the terminal cannot be used on this day, or at this time of day.

34

The user is not authorized to use the application.

64

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

Example 1

Use the standard form of the macro to do the following tasks:

Create an ACEE for the user ID and its default group.
Verify that the user named USERNAME is a valid user.
Verify that the password called PASSWORD is valid.

RACINIT ENVIR=CREATE,USERID=USERNAME,PASSWRD=PASSWORD

Example 2

Use the standard form to do the following tasks:

Verify that the user named USERNAME is a valid user.
Verify that the group named GROUPNAM is a valid group.
Verify that USERNAME is defined to the group.
Create an ACEE for the user and group and put its address in ACEEANCH.
Specify that the user's password is not required.

RACINIT ENVIR=CREATE,USERID=USERNAME,GROUP=GROUPNAM,ACEE=ACEEANCH,    X
          PASSCHK=NO

Example 3

Use the standard form of the macro to delete the ACEE of the current task or address space, or both.

RACINIT ENVIR=DELETE