Testing for request failure

The RETCODE area is used to detect any errors that occur when an EXEC CICS GDS command is executed. These errors correspond to CICS exception conditions, such as NOTALLOC, that can be raised when EXEC CICS commands are executed.

These errors usually reflect failure of the request. Figure 1 shows the possible hexadecimal values for the first three bytes of RETCODE. These values are structured so that the first byte indicates the general error description and subsequent bytes provide the detail.

Figure 1. RETCODE values
00 .. .. Normal return code
01 .. .. ALLOCATE failure (applicable only to GDS ALLOCATE)



01 04 .. SYSBUSY, unknown modename, task cancelled
01 04 04 No bound contention winner available (SYSBUSY)
01 04 08 Modename not known on this system
01 04 0C Attempt to use reserved modename SNASVCMG, or no COS
table in z/OS Communications Server for the modename
01 04 10 Task cancelled during queuing of ALLOCATE
01 04 14 The requested modegroup is closed
01 04 18 The requested modegroup is draining
01 08 .. SYSID is out of service
01 08 00 Connection out of service or in quiesce state, no
free sessions in requested modegroup, or z/OS
Communications Server ACB is closed
01 08 04 Maximum number of queued ALLOCATE requests specified
on QUEUELIMIT CONNECTION parameter exceeded
01 08 08 ALLOCATE queue purged because MAXQTIME would be
exceeded
01 0C .. SYSID is not known in TCT
01 0C 00 SYSID name is not known
01 0C 04 SYSID name is not that of an APPC connection
01 0C 14 NETNAME specified in PARTNER definition is not known
02 0C 00 PARTNER is not known
03 .. .. INVREQ error
03 00 .. Session is either not defined as APPC, in use by
CPI Communications, or (for EXTRACT PROCESS) not
the principal facility
03 04 .. GDS command issued on a conversation that is not basic
03 08 .. Command issued in wrong state
03 0C .. Sync level cannot be supported or cannot support the
command issued
03 10 .. LL error on a GDS SEND
03 14 .. SEND CONFIRM or ISSUE CONFIRMATION used at sync level 0
03 24 .. GDS ISSUE PREPARE used in wrong state
04 .. .. NOTALLOC error (CONVID specifies an unallocated session)
05 .. .. LENGERR error (FLENGTH, MAXFLENGTH, PROCLENGTH, PIPLENGTH,
or MAXPROCLEN error)
06 00 00 PROFILE specified in PARTNER definition is not known


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