IBM Support

InfoMan CHECKID HL40 transaction gives a return code 20

Technote (troubleshooting)


CHECKID (HL40) transaction was introduced for use with the Web Access client to SAF/RACF for authentication, but it gives a RC=20


The API returns RC 20 and no reason code


The RC=20 can occur when you have not set up the environment by running the HL01 transaction to initialize the API.

Resolving the problem

To resolve this issue, setup your routine to first verify if there is an existing BLG_ENVP variable, if not, setup the environment before invoking the INIT (HL01) transaction. After that, run the CHECKID (HL40) transaction to authenticate your user ID followed by a termination routine that does the TERM (HL02).

Document information

More support for: Tivoli Information Management for z/OS

Software version: 7.1

Operating system(s): z/OS

Reference #: 1569662

Modified date: 18 August 2015