EXEC interface block (EIB) fields
This information describes the fields of the EXEC Interface Block (EIB). An application program can read all the fields in the EIB of the associated task by name, but must not change the contents of any of them.
For each field, the contents and format (for each of the application programming languages, COBOL, C, C++, or PL/I) are given. All fields contain zeros in the absence of meaningful information. Fields are listed in alphabetic sequence.
- EIBAID
- This EIB field contains the attention identifier (AID) that is
associated with the last terminal control or Basic Mapping Support
(BMS) input operation from a display device such as a terminal.
For COBOL:
PIC X(1)For C or C++ : For C:
cics_char_t eibaid;For PL/I: CHAR(1)
- EIBATT
- This EIB field indicates that the request/response unit (RU) contains
attach header data (X'FF').
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibatt;For PL/I: CHAR(1)
- EIBCALEN
- This EIB field contains the length of the communication area that
has been passed to the application program from the last program,
using the COMMAREA and LENGTH options. If no communication area is
passed, this field contains zeros.
For COBOL:
PIC S9(4) COMPFor C or C++ :
cics_ushort_t eibcalen;For PL/I: FIXED BIN(15)
- EIBCOMPL
- This EIB field indicates, on a terminal control RECEIVE or CONVERSE
command, whether the data is complete (X'FF'). If the NOTRUNCATE
option has been used on the RECEIVE or CONVERSE command, CICS® retains data in excess of the amount that is requested
via the LENGTH or MAXLENGTH option. EIBRECV is set to indicate that
further RECEIVE or CONVERSE commands are required. EIBCOMPL is not
set until the last of the data has been received.
EIBCOMPL is always set when a RECEIVE or CONVERSE command without the NOTRUNCATE option is executed.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibcompl;For PL/I: CHAR(1)
- EIBCONF
- This EIB field indicates that the conversational partner has issued
a CONFIRM request (X'FF') and that a response is required.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibconf;For PL/I: CHAR(1)
- EIBCPOSN
- This EIB field contains the cursor address (position) that is
associated with the last terminal control or Basic Mapping Support
(BMS) input operation from a display device such as a terminal.
For COBOL:
PIC S9(4) COMPFor C or C++ :
cics_ushort_t eibcposn;For PL/I: FIXED BIN(15)
- EIBDATE
- This EIB field contains the date the task is started (this field
is updated by the ASKTIME command). The date is in packed decimal
form (0CYYDDD+) where C shows the century with values 0 for the 1900s
and 1 for the 2000s. For example, the dates 31 December 1999 and 1
January 2000 have EIBDATE values of 0099365 and 0100001 respectively.
For COBOL:
PIC S9(7) COMP-3For C or C++ :
cics_char_t eibdate [4];For PL/I: FIXED DEC(7,0)
- EIBDS
-
This EIB field contains the symbolic identifier of the last file that was referenced by a file control request.
For COBOL:
PIC X(8)For C or C++ :
cics_char_t eibds [8];For PL/I: CHAR(8)
- EIBEOC
- This EIB field is set to X'FF' after a successful advanced program-to-program communications (APPC) RECEIVE
or CONVERSE; otherwise it is not set. (An APPC conversation allows
a program to send data to, and receive data from, a program that is
running in a remote system. Programming that uses APPC conversations
is called Distributed Transaction Programming (DTP). For guidance
information on DTP, see Distributed transaction processing (DTP).)
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibeoc;For PL/I: CHAR(1)
- EIBERR
- This EIB field indicates that an abnormal condition has occurred
(X'FF') on an APPC conversation. The error code is in EIBERRCD.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eiberr;For PL/I: CHAR(1)
- EIBERRCD
- This EIB field when EIBERR is set, contains the error code that has been received. The following values can be returned in the first two bytes of EIBERRCD:
- X'0824' SYNCPOINT ROLLBACK was requested.
- X'0864' ISSUE ABEND was received.
- X'0889' ISSUE ERROR was received.
- X'A000' The conversation was lost.
Table 1. Hex values returned with EIBERRCD and their meanings Value Description X'080F6051' The partner transaction failed security check. X'08240000' The partner transaction or system has issued SYNCPOINT ROLLBACK. X'084B6031' The partner system is temporarily unable to start the partner transaction. X'084C0000' The partner system cannot start the partner transaction. X'08640000' The Partner transaction has sent ISSUE ABEND. X'08640001' The Partner system has sent ISSUE ABEND. X'08890000' An ISSUE ERROR command has been received. X'10086021' The partner transaction's name is not recognized by the partner system. X'10086031' PIP data was specified but the remote process does not support it. X'10086032' The PIP data sent with the CONNECT PROCESS was incorrectly specified. X'10086034' The partner system does not support mapped conversations. X'10086041' The partner transaction does not support the synchronization level requested on the CONNECT PROCESS. For COBOL:
PIC X(4)For C or C++ :
cics_char_t eiberrcd [4];For PL/I: CHAR(4)
- EIBFMH
- This EIB field indicates that the user data just received or retrieved
contains an FMH (X'FF'). This cannot arise in TXSeries for Multiplatforms, which
always sets this field toX'00'.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibfmh;For PL/I: CHAR(1)
- EIBFN
-
This EIB field contains a code that identifies the last CICS command to be issued by the task (updated when the requested function has been completed).
For COBOL:
PIC X(2)For C or C++ :
cics_char_t eibfn [2];For PL/I:CHAR(2)
Table 2. EIBFN code that contains the last CICS command to be used Code Command 0202 ADDRESS 0204 HANDLE CONDITION 0206 HANDLE AID 0208 ASSIGN 020A IGNORE CONDITION 020C PUSH HANDLE 020E POP HANDLE 0402 RECEIVE 0404 SEND 0406 CONVERSE 040C WAIT TERMINAL 041E ISSUE SIGNAL 0420 ALLOCATE 0422 FREE 042C WAIT CONVID 042E EXTRACT PROCESS 0430 ISSUE ABEND 0432 CONNECT PROCESS 0434 ISSUE CONFIRMATION 0438 ISSUE ERROR 0436 ISSUE PREPARE 043E EXTRACT ATTRIBUTES 0602 READ 0604 WRITE 0606 REWRITE 0608 DELETE 060A UNLOCK 060C STARTBR 060E READNEXT 0610 READPREV 0612 ENDBR 0614 RESETBR 0802 WRITEQ TD 0804 READQ TD 0806 DELETEQ TD 0A02 WRITEQ TS 0A04 READQ TS 0A06 DELETEQ TS 0C02 GETMAIN 0C04 FREEMAIN 0E02 LINK 0E04 XCTL 0E06 LOAD 0E08 RETURN 0E0A RELEASE 0E0C ABEND 0E0E HANDLE ABEND 1002 ASKTIME 1004 DELAY 1008 START 100A RETRIEVE 100C CANCEL 1204 ENQ 1206 DEQ 1208 SUSPEND 1402 JOURNAL 1404 WAIT JOURNAL 1602 SYNCPOINT 1802 RECEIVE MAP 1804 SEND MAP 1806 SEND TEXT 1812 SEND CONTROL 1A02 TRACE 1A04 ENTER 1C02 DUMP 3416 PUT CONTAINER 3414 GET CONTAINER 3412 DELETE CONTAINER 3440 MOVE CONTAINER 4A02 ASKTIME ABSTIME 4A04 FORMATTIME 4C02 INQUIRE FILE 4C04 SET FILE 4E02 INQUIRE PROGRAM 4E04 SET PROGRAM 5002 INQUIRE TRANSACTION 5004 SET TRANSACTION 5202 INQUIRE TERMINAL 5204 SET TERMINAL 5206 INQUIRE NETNAME 5402 INQUIRE SYSTEM 5802 INQUIRE CONNECTION 5804 SET CONNECTION 5C02 INQUIRE TDQUEUE 5C04 SET TDQUEUE 5E02 INQUIRE TASK or INQUIRE TASK LIST 5E1A INQUIRE_TRANCLASS 5E1C SET_TRANCLASS 5E04 SET TASK 5E06 CHANGE TASK 6002 INQUIRE JOURNALNUM 6004 SET JOURNALNUM 7002 INQUIRE STATISTICS 7004 SET STATISTICS 7006 PERFORM STATISTICS RECORD 7008 COLLECT STATISTICS 7402 SIGNON 7404 SIGNOFF 7406 VERIFY PASSWORD 7408 CHANGE PASSWORD 7E02 DUMP TRANSACTION 820C FEPI REQUEST PASSTICKET 820E FEPI AP NOOP 8210 FEPI ALLOCATE PASSCONVID|POOL 8212 FEPI CONVERSE FORMATTED 8214 FEPI CONVERSE DATASTREAM 8216 FEPI EXTRACT CONV 8218 FEPI EXTRACT FIELD 821A FEPI EXTRACT STSN 821C FEPI EXTRACT FREE 821E FEPI ISSUE 8220 FEPI RECEIVE FORMATTED 8222 FEPI RECEIVE DATASTREAM 8224 FEPI SEND FORMATTED 8226 FEPI SEND DATASTREAM 8228 FEPI START 840E FEPI SP NOOP 8422 FEPI INQUIRE PROPERTYSET 8428 FEPI INSTALL PROPERTYSET 8430 FEPI DISCARD PROPERTYSET 8442 FEPI INQUIRE NODE 8444 FEPI SET NODE|NODELIST 8448 FEPI INSTALL NODELIST 844A FEPI ADD POOL 844C FEPI DELETE POOL 8450 FEPI DISCARD NODELIST 8462 FEPI INQUIRE POOL 8464 FEPI SET POOL|POOLLIST 8468 FEPI INSTALL POOL 8470 FEPI DISCARD POOL 8482 FEPI INQUIRE TARGET 8484 FEPI SET TARGET|TARGETLIST 8488 FEPI INSTALL TARGETLIST 8490 FEPI DISCARD TARGETLIST 84A2 FEPI INQUIRE CONNECTION 84A4 FEPI SET CONNECTION - EIBFREE
- This EIB field indicates that the application program cannot continue
using the facility. The receiver must issue a FREE command for the
conversation.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibfree;For PL/I: CHAR(1)
- EIBLABEL
- This field, which is used for COBOL programs only, is used to
contain values that relate to handled conditions or abends. The values are:
- 0: RETURN or XCTL
- 1: Abend
- 2 to nn: A value that identifies a label for a handled condition or abend
- EIBNODAT
- This EIB field indicates that no data has been sent by the remote
application (X'FF'). A message has been received from the
remote system that conveyed only control information. For example,
if the remote application executed a SEND command with a WAIT option,
any data would be sent across the link. If the remote application
then executes a SEND INVITE command without using the FROM option
to transmit data at the same time, it would be necessary to send the
INVITE instruction across the link by itself. In this case, the receiving
application finds EIBNODAT set. The use of this field is restricted
to application programs that are holding conversations across APPC
links only.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibnodat;For Pl/I: CHAR(1)
- EIBRCODE
- This EIB field contains the CICS response
code that is returned after the function that was requested by the
last CICS command to be issued by the task has been
completed.
For a normal response, this field contains hexadecimal zeros (X'00'). For COBOL programs only, almost all the information that is in this field can be used within application programs by the HANDLE CONDITION command.
For COBOL:
PIC X(6)For C or C++ :
cics_char_t eibrcode [6];For PL/I: CHAR(6)
The following list shows the EIBRCODE values that correspond to the conditions that can occur for each group of commands (as indicated by byte 0 of EIBFN), together with the names of the associated conditions.
For some conditions, further information is provided in EIBRCODE. This is indicated by a note that follows the list of values.
For some commands (for example, INQUIRE and SET), byte 3 of EIBRCODE contains the hexadecimal equivalent of the value in EIBRESP. Any further information that relates to conditions that are occurring on these commands can be found in EIBRESP2 rather than EIBRCODE. The RESP2 values are given in the descriptions of the individual commands.Table 3. EIBRCODE values and corresponding conditions EIBFN EIBRCODE Conditions 02 -- E0 -- -- -- -- -- INVREQ 04 -- D0 -- -- -- -- -- SYSIDERR 3 04 -- D3 -- -- -- -- -- SYSBUSY 04 -- D5 -- -- -- -- -- NOTALLOC 04 -- EB -- -- -- -- -- CBIDERR 04 -- E0 -- -- -- -- -- INVREQ 4 04 -- E1 -- -- -- -- -- LENGERR 5 04 -- E5 -- -- -- -- -- SIGNAL 04 -- F1 -- -- -- -- -- TERMERR 06 -- D0 -- -- -- -- -- SYSIDERR 3 06 -- D1 -- -- -- -- -- ISCINVREQ 06 -- D6 -- -- -- -- -- NOTAUTH 06 -- E1 -- -- -- -- -- LENGERR 06 -- 0C -- -- -- -- -- NOTOPEN 06 -- 0D -- -- -- -- -- DISABLED 06 -- 0F -- -- -- -- -- ENDFILE 06 -- 01 -- -- -- -- -- FILENOTFOUND (or DSIDERR) 06 -- 02 -- -- -- -- -- ILLOGIC 1 06 -- 08 -- -- -- -- -- INVREQ 06 -- 80 -- -- -- -- -- IOERR 1 06 -- 81 -- -- -- -- -- NOTFND 06 -- 82 -- -- -- -- -- DUPREC 06 -- 83 -- -- -- -- -- NOSPACE 06 -- 84 -- -- -- -- -- DUPKEY 08 -- C0 -- -- -- -- -- QBUSY 08 -- D0 -- -- -- -- -- SYSIDERR 3 08 -- D1 -- -- -- -- -- ISCINVREQ 08 -- D6 -- -- -- -- -- NOTAUTH 08 -- E1 -- -- -- -- -- LENGERR 08 -- 01 -- -- -- -- -- QZERO 08 -- 02 -- -- -- -- -- QIDERR 08 -- 04 -- -- -- -- -- IOERR 08 -- 08 -- -- -- -- -- NOTOPEN 08 -- 10 -- -- -- -- -- NOSPACE 1A -- E0 -- -- -- -- -- INVREQ 10 -- D0 -- -- -- -- -- SYSIDERR 3 10 -- D1 -- -- -- -- -- ISCINVREQ 10 -- D6 -- -- -- -- -- NOTAUTH 10 -- E1 -- -- -- -- -- LENGERR 10 -- E9 -- -- -- -- -- ENVDEFERR 10 -- FF -- -- -- -- -- INVREQ 10 -- 01 -- -- -- -- -- ENDDATA 10 -- 04 -- -- -- -- -- IOERR 10 -- 11 -- -- -- -- -- TRANSIDERR 10 -- 12 -- -- -- -- -- TERMIDERR 10 -- 20 -- -- -- -- -- EXPIRED 10 -- 81 -- -- -- -- -- NOTFND 12 -- E1 -- -- -- -- -- LENGERR 12 -- 32 -- -- -- -- -- ENQBUSY 14 -- D6 -- -- -- -- -- NOTAUTH 14 -- 01 -- -- -- -- -- JIDERR 14 -- 02 -- -- -- -- -- INVREQ 14 -- 05 -- -- -- -- -- NOTOPEN 14 -- 06 -- -- -- -- -- LENGERR 14 -- 07 -- -- -- -- -- IOERR 14 -- 09 -- -- -- -- -- NOJBUFSP 16 -- 01 -- -- -- -- -- ROLLEDBACK 18 -- 01 -- -- -- -- -- INVREQ 18 -- 04 -- -- -- -- -- MAPFAIL 18 -- 08 -- -- -- -- -- INVMPSZ2 2 4A -- -- -- -- 01 -- -- ERROR 4C -- -- -- -- 0C -- -- FILENOTFOUND (or DSIDERR) 4C -- -- -- -- 10 -- -- INVREQ 4C -- -- -- -- 11 -- -- IOERR 4C -- -- -- -- 15 -- -- ILLOGIC 4C -- -- -- -- 46 -- -- NOTAUTH 4C -- -- -- -- 53 -- -- END 4E -- -- -- -- 01 -- -- ERROR 4E -- -- -- -- 1B -- -- PGMIDERR 4E -- -- -- -- 10 -- -- INVREQ 4E -- -- -- -- 15 -- -- ILLOGIC 4E -- -- -- -- 46 -- -- NOTAUTH 4E -- -- -- -- 53 -- -- END 5C -- -- -- -- 10 -- -- INVREQ 5C -- -- -- -- 11 -- -- IOERR 5C -- -- -- -- 15 -- -- ILLOGIC 5C -- -- -- -- 2C -- -- QIDERR 5C -- -- -- -- 46 -- -- NOTAUTH 5C -- -- -- -- 53 -- -- END 5E -- -- -- -- 10 -- -- INVREQ 5E -- -- -- -- 5B -- -- TASKIDERR 50 -- -- -- -- 1C -- -- TRANSIDERR 50 -- -- -- -- 10 -- -- INVREQ 50 -- -- -- -- 15 -- -- ILLOGIC 50 -- -- -- -- 46 -- -- NOTAUTH 50 -- -- -- -- 53 -- -- END 52 -- -- -- -- 0B -- -- TERMIDERR 52 -- -- -- -- 01 -- -- ERROR 52 -- -- -- -- 10 -- -- INVREQ 52 -- -- -- -- 15 -- -- ILLOGIC 52 -- -- -- -- 53 -- -- END 58 -- -- -- -- 10 -- -- INVREQ 58 -- -- -- -- 15 -- -- ILLOGIC 58 -- -- -- -- 35 -- -- SYSIDERR 58 -- -- -- -- 53 -- -- END 60 -- -- -- -- 10 -- -- INVREQ 60 -- -- -- -- 11 -- -- IOERR 60 -- -- -- -- 15 -- -- ILLOGIC 60 -- -- -- -- 2B -- -- JIDERR 60 -- -- -- -- 46 -- -- NOTAUTH 60 -- -- -- -- 53 -- -- END 70 -- -- -- -- 0D -- -- NOTFND 70 -- -- -- -- 10 -- -- INVREQ 70 -- -- -- -- 46 -- -- NOTAUTH 0A -- D0 -- -- -- -- -- SYSIDERR 3 0A -- D1 -- -- -- -- -- ISCINVREQ 0A -- D6 -- -- -- -- -- NOTAUTH 0A -- E1 -- -- -- -- -- LENGERR 0A -- 01 -- -- -- -- -- ITEMERR 0A -- 02 -- -- -- -- -- QIDERR 0A -- 04 -- -- -- -- -- IOERR 0A -- 08 -- -- -- -- -- NOSPACE 0A -- 20 -- -- -- -- -- INVREQ 0C -- E1 -- -- -- -- -- LENGERR 0C -- E2 -- -- -- -- -- NOSTG 0E -- D0 -- -- -- -- -- SYSIDERR 3 0E -- D6 -- -- -- -- -- NOTAUTH 0E -- E0 -- -- -- -- -- INVREQ 0E -- 01 -- -- -- -- -- PGMIDERR Notes®:- 1
- When ILLOGIC or IOERR occur during file control operations, further
information is provided in EIBRCODE as follows:
-- xx xx xx xx -- error codeBytes 1 and 2 indicate the major component that detected the error; bytes 3 and 4 indicate an error code that belongs to that component.
The following are CICS generated EIBRCODE values:- -- 01 23 90 01 --
RRN zero or negative was used.
- -- 01 23 90 02 --
An RRN value was used that is greater than the maximum RRN value that is defined for the file.
- -- 01 23 90 03 --
The file has been redefined on the file manager after it was opened.
- -- 01 23 90 04 --
Key segment is not defined.
- -- 01 23 90 05 --
A variable length field was specified when the file was created on the file manager, but it was not the last field.
- -- 01 23 90 06 --
A variable length relative record file was specified. This is ignored on TXSeries for Multiplatforms.
- -- 01 23 90 07 --
A file with a record length greater than 65535 bytes was opened.
- -- 01 23 11 08 --
A variable length field was specified in an index. This is ignored on TXSeries for Multiplatforms.
- -- 01 23 90 09 --
The record length that is specified on a write or rewrite to a variable length file is less than the maximum keyspan of the file and its alternate indexes.
- -- 01 23 90 0A --
The implicit key that was specified on a rewrite was not the same as the key read in on a read update command.
- -- 01 23 90 0B --
For a variable length ESDS file, the length that was rewritten was different from the length read.
- -- 01 23 90 0C --
Record not found in ESDS file.
- -- 01 23 90 01 --
- 2
- When INVMPSZ occurs during BMS operations, byte 3 of EIBRCODE contains the terminal code.
- 3
- When SYSIDERR occurs, further information is provided in byte
1 of EIBRCODE, as follows:
- D0 04 -- -- -- --
Modename is not found or invalid.
- D0 08 -- -- -- --
SYSID is out of service.
- D0 0C -- -- -- --
SYSID definition error.
- D0 04 -- -- -- --
- 4
- When INVREQ occurs during APPC conversations, further information
is provided in byte 3 of EIBRCODE as follows:
- -- -- 00 08 -- --
FREE command: Conversation is in wrong state.
- -- -- 00 0C -- --
CONNECT PROCESS command: SYNCLVL 2 has been requested, but cannot be supported on the conversation that is in use.
- -- -- 00 14 -- --
SEND command: CONFIRM option has been specified, but conversation is SYNCLVL 0.
- -- -- 00 20 -- --
An invalid command has been issued for the APPC conversation type that is in use.
- -- -- 00 08 -- --
- 5
- When LENGERR occurs during terminal control operations, further
information is provided in byte 1 of EIBRCODE as follows:
- E1 00 -- -- -- --
Input data is overlong and has been truncated.
- E1 04 -- -- -- --
On output commands, an invalid (FROM)LENGTH has been specified, either less than zero or greater than 32767.
- E1 08 -- -- -- --
On input commands, an invalid (TO)LENGTH has been specified that is greater than 32767.
- E1 00 -- -- -- --
- EIBRECV
- This EIB field indicates that the application program is to continue
receiving data from the facility by executing RECEIVE commands (X'FF').
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibrecv;For PL/I: CHAR(1)
- EIBREQID
- This EIB field contains the request identifier that is assigned
to an interval control command by CICS;
this field is not used when a request identifier is specified in the
application program.
For COBOL:
PIC X(8)For C or C++ :
cics_char_t eibreqid [8];For PL/I: CHAR(8)
- EIBRESP
- This EIB field contains a 32-bit binary number that corresponds to the condition that has occurred. These numbers are listed in Table 4 (in decimal) for the conditions that can occur on local requests during execution of the commands described in CICS API command reference.
For COBOL:
PIC S9(8) COMPFor C or C++ :
cics_slong_t eibresp;See Data types used in C or C++.
For PL/I: FIXED BIN(31)
Table 4. RESP values in decimal Dec Hex Condition 00 X'00' NORMAL 01 X'01' ERROR 11 X'0B' TERMIDERR 12 X'0C' FILENOTFOUND (or DSIDERR) 13 X'0D' NOTFND 14 X'0E' DUPREC 15 X'0F' DUPKEY 16 X'10' INVREQ 17 X'11' IOERR 18 X'12' NOSPACE 19 X'13' NOTOPEN 20 X'14' ENDFILE 21 X'15' ILLOGIC 22 X'16' LENGERR 23 X'17' QZERO 24 X'18' SIGNAL 25 X'19' QBUSY 26 X'1A' ITEMERR 27 X'1B' PGMIDERR 28 X'1C' TRANSIDERR 29 X'1D' ENDDATA 31 X'1F' EXPIRED 36 X'24' MAPFAIL 38 X'26' INVMPSZ 42 X'2A' NOSTG 43 X'2B' JIDERR 44 X'2C' QIDERR 45 X'2D' NOJBUFSP 53 X'35' SYSIDERR 54 X'36' ISCINVREQ 55 X'37' ENQBUSY 56 X'38' ENVDEFERR 59 X'3B' SYSBUSY 61 X'3D' NOTALLOC 62 X'3E' CBIDERR 69 X'45' USERIDERR 70 X'46' NOTAUTH 81 X'51' TERMERR 82 X'52' ROLLEDBACK 83 X'53' END 84 X'54' DISABLED 91 X'5B' TASKIDERR 110 X'6E' CONTAINERERR 112 X'70' TOKENERR 122 X'7A' CHANNELERR 123 X'7B' CCSIDERR - EIBRESP2
- This EIB field contains more detailed information that can help
explain why the condition that is indicated by EIBRESP has occurred.
For TXSeries for Multiplatforms, this field contains meaningful values for SET commands
only. The relevant values are documented with each command as applicable.
For COBOL:
PIC S9(8) COMPFor C or C++ :
cics_slong_t eibresp2;See Data types used in C or C++.
For PL/I: FIXED BIN(31)
Table 5 gives, in general terms, the meaning of the RESP2 values that are used by FEPI. These values are used in the EVENTVALUE area of CICS transient data queue records and returned by the RESP2 option of CICS commands. For details of the error conditions and related RESP2 values for each CICS command, see the CICS command definitionsTable 5. RESP2 values Value Description 1 INQUIRE START, NEXT, or END command not valid here: - START
- Browse of this resource type already in progress
- NEXT
- INQUIRE START not issued
- END
- INQUIRE START not issued.
2 All resource definitions have been retrieved. 10 Command bypassed by user exit. 11 FEPI not installed or not active. 12 CICS shutting down, command not allowed. 13 FEPI not available. 14 FEPI busy or cannot get storage. 15 Unknown command. 16 Internal problem. 17 FEPI cannot get storage for user exit parameters. 18 Command failed because of operator or system action. 30 POOL name not known. 31 POOL name out of service. 32 TARGET name not known. 33 TARGET name out of service. 34 TARGET name required but not specified. 35 Pool name is unsuitable for temporary conversations. It has CONTENTION(LOSE) or INITIALDATA(INBOUND) but no begin-session handler. 36 No suitable session available and in service. 40 [FROM]FLENGTH value is negative, zero, or more than MAXFLENGTH value for pool. 41 ESCAPE value not valid. 50 Inbound data with ‘begin bracket’ to be received. 51 Attention identifier (AID) not valid. 52 Cursor position not valid. 53 Code points in formatted data not valid. 54 Attribute positions or values in send data not valid. 55 Key stroke escape sequence in send data not valid. 56 Field validation (mandatory fill, mandatory enter, trigger) failed. 57 Input is inhibited. 58 VTAM® SEND failed. 59 DBCS data rules violated. 60 MAXFLENGTH value negative, or greater than MAXFLENGTH value for pool. 61 FLENGTH value negative or greater than 128. 62 TRANSID name not valid. 63 TERMID name not valid. 70 FIELDLOC or FIELDNUM value negative or not valid. 71 VTAM RECEIVE failed. 72 RECEIVE FORMATTED processing found invalid, or unexpected data while interpreting the 3270 data steam for a WRITE, ERASE/WRITE, ERASE/WRITE ALTERNATE, or WRITE STRUCTURED FIELD command code. 80 CONTROL value not valid. 81 VALUE not valid: omitted when required; included when not required; or unsuitable for specified CONTROL. 82 SENSEDATA option omitted when required, or specified when not required. 90 Definite response type did not match what was required. 91 Only NORMALRESP or EXCEPTRESP allowed at this point in conversation. 92 Response to STSN SET was not positive. 93 Only STSN allowed at this point in conversation. 94 Only STSN or NORMALRESP allowed at this point in conversation. 95 CONTROL value not allowed at this point in conversation. 100 Not authorized to issue command. 110 SERVSTATUS value not valid. 111 ACQSTATUS value not valid. 115 POOL name not known. 116 TARGET name not known. 117 NODE name not known. 118 Unknown connection (TARGET and NODE names known, but not in a common POOL). 119 Request failed for one or more items in list. Detailed errors reported to TD queue for monitor to handle. 130 TARGETNUM value negative, zero, or not valid. 131 NODENUM value negative, zero, or not valid. 132 POOLNUM value negative, zero, or not valid. 140 DEVICE value not valid. 141 CONTENTION value not valid. 142 INITIALDATA value not valid. 143 UNSOLDATACK value not valid. 144 MSGJRNL value not valid. 145 DEVICE value not supported. 146 MSGJRNL value not supported. 150 FORMAT value not valid or unsuitable for specified device. 153 STSN name not valid or STSN unsuitable for specified device. 154 BEGINSESSION value not valid. 155 UNSOLDATA value not valid. 156 EXCEPTIONQ value not valid. 157 FJOURNALNUM value not valid. 158 MAXFLENGTH value not valid. 159 ENDSESSION name not valid. 160 PROPERTYSET name not valid. 162 POOL name not valid. 163 NODE name not valid. 164 TARGET name not valid. 167 APPL name not valid. 170 PROPERTYSET name already exists. 171 PROPERTYSET name not known. 172 POOL name already exists. 173 NODE name already exists in specified POOL. 174 TARGET name already exists in specified POOL. 175 Connection already exists. 176 VTAM OPEN NODE failed. 177 VTAM APPLID already known. 178 FJOURNALNAME value not valid. 179 NODE name already exists in another POOL. 180 TARGET limit exceeded for specified POOL 182 Session unbound, unrecoverable. 183 Session unbound, recoverable. 184 Session unbound, error. 185 Session unbound, bind coming. 186 Session unbound. 187 Lost terminal. 188 CLEANUP, abnormal. 189 CLEANUP. 190 UNBIND error. 191 SETUP error. 192 SSCP error. 193 SLU error. 194 PLU error. 195 BIND error. 196 CINIT error. 197 REQSESS error. 198 REQSESS inhibited. 199 REQSESS not available. 210 Option not valid for SLU P. 211 Option not valid for SLU 2. 212 Wrong data format for conversation. 213 Command has timed out. 214 CICS shutting down, conversation should be ended. 215 Session lost. 216 Error occurred on previous SEND command. 220 SEND or CONVERSE command not allowed at this point in conversation. 221 RECEIVE command not allowed at this point in conversation. 223 START command not allowed at this point in conversation. 224 Only ISSUE or FREE allowed at this point in conversation. 230 SNA CLEAR command received. 231 SNA CANCEL command received. 232 SNA CHASE command received. 233 Exception response received. 234 Exception request received. 240 Conversation ID unknown or not owned by task. 241 TIMEOUT value negative or not valid. 250 Passticket not built successfully. 251 CICS ESM interface not initialized. 252 Unknown return code in ESMRESP from the ESM. 253 Unrecognized response from CICS security modules. 254 Function unavailable. 259 No signed-on user. - EIBRLDBK
- This EIB field indicates that the remote transaction has sent
SYNCPOINT ROLLBACK in response to a SYNCPOINT request (X'FF'). The transaction that issued the SYNCPOINT command has been rolled
back.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibrdbk;For PL/I: CHAR(1)
- EIBRSRCE
- This EIB field contains the symbolic identifier of the resource that is being accessed by the
last API command to be issued by the task. Refer to Table 6. (n
represents the number of characters.)
Table 6. EIBRSRCE that specifies resource being accessed Type of Command Resource n Temporary storage control TS queue name 8 Terminal control Terminal identifier or APPC conversation identifier (see note) 4 Transient data control TD queue name 4 Note:- In TXSeries for Multiplatforms, APPC conversation identifiers are unprintable.
- Temporary storage queues greater than eight characters in length are truncated to 8 characters.
For COBOL:
PIC X(8)For C or C++ :
cics_char_t eibrsrce [8];For PL/I: CHAR(8)
- EIBSIG
- This EIB field indicates that the conversation partner has issued
an ISSUE SIGNAL command (X'FF').
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibsig;For PL/I: CHAR(1)
- EIBSYNC
- This EIB field indicates that CICS syncpointing
is in progress and that the application should issue a SYNCPOINT command.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibsync;For PL/I: CHAR(1)
- EIBSYNRB
-
This EIB field indicates that CICS syncpointing is in progress and that the application program should issue a SYNCPOINT ROLLBACK command (X'FF'). This field is set only in application programs that are holding a conversation on an APPC link.
For COBOL:
PIC X(1)For C or C++ :
cics_char_t eibsynrb;For PL/I: CHAR(1)
- EIBTASKN
- This EIB field contains the task number that is assigned to the
task by CICS. This number appears in trace entries that
are generated while the task is in control.
For COBOL:
PIC S9(7) COMP-3For C or C++ :
cics_char_t eibtaskn [4];For PL/I: FIXED DEC(7,0)
- EIBTIME
- This EIB field contains the time at which the task is started
(this field is updated by the ASKTIME command). The time is in packed
decimal form (0HHMMSS+).
For COBOL:
PIC S9(7) COMP-3For C or C++ :
cics_char_t eibtime [4];For PL/I: FIXED DEC(7,0)
- EIBTRMID
- This EIB field contains the name of the principal facility that
is associated with the task. For a back-end transaction, it is the
conversation identifier (CONVID). This name must be acquired if the
program states explicitly the CONVID for the principal facility.
For COBOL:
PIC X(4)For C or C++ :
cics_char_t eibtrmid [4];For PL/I: CHAR(4)
- EIBTRNID
-
This EIB field contains the symbolic transaction identifier of the task.
For COBOL:
PIC X(4)For C or C++ :
cics_char_t eibtrnid [4];For PL/I: CHAR(4)