IMS Connect responses to errors on RACROUTE calls from the sample exits

If an error occurs on a RACROUTE call from one of the sample user message exits, HWSSMPL0 or HWSSMPL1, IMS Connect decides what error actions to take depending on the RACF® parameter setting in the IMS Connect configuration file, as well as the specific circumstances that cause the error.

The different actions IMS Connect takes are described in the following series of tables.

IMS Connect response when RACF=Y and RACROUTE call parameters are in error

The following table describes the error actions that IMS Connect takes if RACF=Y, based on required RACROUTE call parameters.

Table 1. IMS Connect error actions taken based on RACROUTE call parameters (RACF=Y)

USERID	PASSWORD	GROUPID	Action taken
Non-blanks	Non-blanks	Non-blanks	RACROUTE call issued
Non-blanks	Blanks	Blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNOPW' Password cleared in OTMA header * Security failed, no password *
Non-blanks	Blanks	Non-blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNOPW' Password cleared in OTMA header * Security failed, no password *
Blanks	Non-blanks	Blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNUID' Password cleared in OTMA header * Security failed, no password *
Blanks	Non-blanks	Non-blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNUID' Password cleared in OTMA header * Security failed, no password *
Blanks	Blanks	Non-blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNPUI' Password cleared in OTMA header * Security failed, no password *
Blanks	Blanks	Blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNPUI' Password cleared in OTMA header * Security failed, no password *
Non-blanks	Blanks	Non-blanks	Error message HWSP1503 issued Input rejected RACROUTE call not issued Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFNOPW' Password cleared in OTMA header * Security failed, no password *

IMS Connect responses when RACF=Y and either RACROUTE call fails or OTMA header data is in error

The following table describes the error actions that IMS Connect takes if RACF=Y, either based on OTMA header data, or should the RACROUTE call fail.

Table 2. IMS Connect actions taken for RACROUTE call failure or OTMA header data error and RACF=Y

RACROUTE call failure or OTMA header data	Action taken
No security header	Error message HWSP1503 issued Input rejected Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='NOSECHDR' Password cleared in OTMA header No RACF call made
Security header < X'6A'	Error message HWSP1503 issued Input rejected Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='INVSECHL' Password cleared in OTMA header No RACF call made
Conversation continued	No error message issued Input accepted Password cleared in OTMA header No RACF call made
Response message	No error message issued Input accepted Password cleared in OTMA header No RACF call made
UTOKEN present	No error message issued Input accepted Password cleared in OTMA header No RACF call made
RACROUTE call failed	Error message HWSP1500 issued Input rejected Set OMUSR_RETCODE=X'04' Set OMUSR_RESCODE='SECFAIL' Password cleared in OTMA header RACF return/reason codes in HWSP1500 message
All others	See Table 1

IMS Connect response when RACF=N and RACROUTE call parameters are in error

The following table describes the error actions that IMS Connect takes if RACF=N, based on required RACROUTE call parameters.

Table 3. IMS Connect error actions taken based on RACROUTE call parameters (RACF=N)

USERID	PASSWORD	GROUPID	Action taken
Non-blanks	Non-blanks	Non-blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Non-blanks	Blanks	Blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Non-blanks	Blanks	Non-blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Blanks	Non-blanks	Blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Blanks	Non-blanks	Non-blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Blanks	Blanks	Non-blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Blanks	Blanks	Blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA
Non-blanks	Blanks	Non-blanks	Password cleared Bypass RACROUTE call Pass these parameters to OTMA

IMS Connect response when RACF=N and RACROUTE call fails or OTMA header data is in error

The following table describes the error actions that IMS Connect takes if RACF=N, either based on OTMA header data, or should the RACROUTE call fail.

Table 4. IMS Connect error actions taken for RACROUTE call failure or OTMA header data (RACF=N)

RACROUTE call failure or OTMA header data	Action taken
No security header	Password cleared Bypass RACROUTE call Pass OTMA headers and data to IMS OTMA
Security header < X'6A'	Password cleared Bypass RACROUTE call Pass OTMA headers and data to IMS OTMA
Conversation continued	Password cleared Bypass RACROUTE call Pass OTMA headers and data to IMS OTMA
Response message	No error message issued Input accepted Password cleared in OTMA header No RACF call made
UTOKEN present	Password cleared Bypass RACROUTE call Pass OTMA headers and data to IMS OTMA
RACROUTE call failed	Password cleared Bypass RACROUTE call Pass OTMA headers and data to IMS OTMA
All others	Password cleared Bypass RACROUTE call Pass OTMA headers and data to IMS OTMA