Return and reason codes

IRRENS00 returns the following return and reason codes:

Return code

Meaning

0

Function successful

Reason code
0
4: If Query, the environment is dirty.
8: If Query, the environment is clean but can be made dirty without error.
C: If Query, the environment must stay clean.
20: Indicates that a caller requested a MAIN check through function flag X'00000004', that enhanced program security is in effect in warning mode for the current job, and the current execution environment was not established by a MAIN program.

4

Function not processed; parameter error

Reason code: Meaning
4: Incorrect function code
8: Incorrect function flags for specified function code
C: Incorrect message block for specified function code

8

Function failed

Reason code: Meaning
4: Cannot mark keep-controlled for z/OS® UNIX; already uncontrolled
8: Cannot mark keep-controlled for RACF®; already uncontrolled
C: Cannot mark uncontrolled; marked keep-controlled for z/OS UNIX
10: Cannot mark uncontrolled; marked keep-controlled for RACF
20: Indicates that a caller requested a MAIN check through function flag X'00000004', that enhanced program security is in effect in failure mode for the current job, and the current execution environment was not established by a MAIN program.

Note: Keep-controlled can only fail due to the environment already being marked uncontrolled. Likewise, mark-uncontrolled can only fail because of a previous keep-controlled request. For a mark-uncontrolled request, the z/OS UNIX keep-controlled request is checked first, and if on, return code 8 and reason code C are returned, without additional checking for RACF keep-controlled.

C

Internal error

Reason code
0