Checking the outcome of GDS commands

The CICS® exec interface block (EIB) is not affected by EXEC CICS GDS commands, and no CICS conditions can be raised when EXEC CICS GDS commands are executed. Instead, you must provide data areas in your application to receive return codes and session status information.

The data areas required are:
  • A 6-byte area to receive RETCODE information
  • A 24-byte area to receive CONVDATA information.
Within the bounds of the programming language you are using, you can give these areas any identifiers you like. They must be named explicitly in most EXEC CICS GDS commands.
Checking the response from a GDS command can be separated into three stages:
  1. Testing for request failure; this involves testing RETCODE.
  2. Testing for indicators received on the conversation. These indicators are found in CONVDATA.
  3. Testing the conversation state.


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