Return codes for control operator verbs

When you change the state of a CONNECTION or a MODENAME, the LU services manager starts asynchronously.

Some of the errors that may occur are detected by immediately. Other errors are not detected until a later time, when the LU services manager transaction (CLS1) runs.

If CLS1 detects errors, it causes messages to be written to the CSMT log, as shown in Table 1. In normal operation, the CICS master terminal operator may not want to inspect the CSMT log when a command has been issued. So in general, the operator, after issuing a command to change parameters should wait for a few seconds for the request to be carried out and then reissue the INQUIRE version of the command to check that the requested change has been made. In the few cases when an error occurs, the master terminal control operator can refer to the CSMT log.

The message used to report the results of CLS1 execution is DFHZC4900. The explanatory text that accompanies the message varies and is summarized in Table 1. In certain cases, DFHZC4901 is also issued to give further information.
Table 1. Messages triggered by CLS1
APPC RETURN CODE CICS MESSAGE
OK DFHZC4900 result = SUCCESSFUL
ACTIVATION_FAILURE_RETRY DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = 0
ACTIVATION_FAILURE_NO_RETRY DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = 0
ALLOCATION_ERROR SYSTEM NOT ACQUIRED is returned to the operator.
COMMAND_RACE_REJECT DFHZC4900 result = RACE DETECTED
LU_MODE_SESSION_LIMIT_CLOSED DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = 0
LU_MODE_SESSION_LIMIT_EXCEEDED DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = (negotiated value)
LU_MODE_SESSION_LIMIT_NOT_ZERO DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = (negotiated value)
LU_MODE_SESSION_LIMIT_ZERO DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = 0
LU_SESSION_LIMIT_EXCEEDED DFHZC4900 result = VALUES AMENDED + DFHZC4901 MAX = (negotiated value)
PARAMETER_ERROR Checked immediately
REQUEST_EXCEEDS_MAX_ALLOWED Checked immediately
RESOURCE_FAILURE_NO_RETRY The LU services manager transaction (CLS1) abends with abend code ATNI.
UNRECOGNIZED_MODE_NAME DFHZC4900 result = MODENAME NOT RECOGNIZED


dfht12p.html | Timestamp icon Last updated: Monday, 5 June 2017