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.
| 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 |