Evaluating a FEEDBACK record
The diagnostic data for a CICSPlex® SM API command is presented in a FEEDBACK resource table record. The attributes of that resource table provide a variety of information about the completion status of an API command.
- COMMAND
- A numeric code that identifies the command to which this FEEDBACK
record applies. The API commands and their numeric equivalents are
given in Table 1.
Table 1. Numeric codes and API commands Numeric code Mnemonic Command 02 CANCEL Cancel 03 CONNECT Connect 04 COPY Copy 05 CREATE Create 06 DELETE Delete 07 DISCARD Discard 08 DISCONN Disconnect 09 FETCH Fetch 10 GET Get 11 LOCATE Locate 12 MARK Mark 13 ORDER Order 14 PERFSET Perform Set 15 PERFOBJ Perform Object 16 QUALIFY Qualify 17 QUERY Query 18 RECEIVE Receive 19 REMOVE Remove 20 FILTER Specify Filter 21 UNMARK Unmark 22 ADDRESS Address 23 GETDEF Getdef 24 LISTEN Listen 25 REFRESH Refresh 26 SET Set 27 VIEW Specify View 28 TERM Terminate 29 TRANS Translate 30 GROUP Group by 31 UPDATE Update 32 FEEDBACK Feedback 33 EXPAND Expand - OBJECT
- The CICSPlex SM object that the command was issued against.
- OBJECT_ACT
- The action that was being performed against the CICSPlex SM object.
- RSLTRECID
- If the FEEDBACK record applies to a result set, the numeric ID of the result set record associated with this FEEDBACK record.
- ATTRDATAVAL
- Indicates whether attribute data is available for the command.
Attribute data is included only if the command itself did not complete
successfully.
If the ATTRDATAVAL value is Y, the FEEDBACK record identifies as many as five attributes (ATTR_NM1 through ATTR_NM5) that contributed to the error. Each attribute is identified by its name and its offset and relative number within the resource table record. The data type and length of each attribute is also included.
If the ATTRDATAVAL value is N, you can ignore the ATTR_ fields.
- CEIBDATAVAL
- Indicates whether CICS® EIB data is available for
the command. EIB data is included only if the command encountered
a CICS error.
If the CEIBDATAVAL value is Y, the FEEDBACK record includes the EIBFN, RESP, and RESP2 values as provided by CICS. Note that if the RESP value indicates a NOTAUTH condition that was raised due to CICSPlex SM simulated security, EIBFN is not set.
If the CEIBDATAVAL value is N, you can ignore the CEIBFN, CEIBRESP, and CEIBRESP1 fields.
- ERRCODEVAL
- Indicates whether a CICSPlex SM error
code is available for the command. An error code is included only
if the command itself did not complete successfully.
If the ERRCODEVAL value is Y, the FEEDBACK record includes a numeric ERROR_CODE value. Each resource table copy book includes a list of the error codes for that object and their meanings.
If the ERRCODEVAL value is N, you can ignore the ERROR_CODE field, as well as the RESPONSE and REASON fields.