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.

Note: This topic provides general information about FEEDBACK records. The FEEDBACK resource table copybook that is supplied by CICSPlex SM provides a detailed description of the contents and structure of a FEEDBACK record. See FEEDBACK Resource Table or the supplied copybook when writing a program that uses the FEEDBACK command.

To identify which API operation to which the FEEDBACK record applies, check the values in these fields:

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.

To determine what type of problem the FEEDBACK record describes, check the values in these fields:

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

Additional diagnostic data for BAS

For some CICSPlex SM API operations that affect BAS resources, the diagnostic data in a FEEDBACK record may not be enough to fully describe an error condition, so the FEEDBACK record might point to an error result set.

An error result set is identified by the following fields:

ERR_RESULT: A 4-byte token identifying an error result set.
ERR_COUNT: The number of records in the error result set referenced by ERR_RESULT.
ERR_OBJECT: The type of records in the error result set referenced by ERR_RESULT. This value is the 1- to 8-character name of a CICSPlex SM resource table, and might be BINSTERR, BINCONRS, BINCONSC, or FEEDBACK. For details of these resource tables, see CICSPlex SM resource tables.