The APPC verbs for mapped conversations are implemented by equivalent CICS application programming commands.
See Return codes for APPC mapped conversations for details of the corresponding return code mapping.
This table has two columns. The headers are in the first row.
MC_ALLOCATE | EXEC CICS ALLOCATE |
---|---|
LU_NAME(vble) | SYSID on ALLOCATE |
MODE_NAME(vble) | MODENAME on ALLOCATE |
TPN(vble) | PROCNAME on CONNECT PROCESS (with PROCLENGTH) |
RETURN_CONTROL(WHEN_SESSION_ALLOCATED) | Default on ALLOCATE |
RETURN_CONTROL(WHEN_CONWINNER_ALLOCATED) | Not supported |
|
|
RETURN_CONTROL(IMMEDIATE) | NOQUEUE/NOSUSPEND on ALLOCATE |
SYNC_LEVEL | SYNCLEVEL on CONNECT PROCESS 0 ─ None |
CONVERSATION_GROUP_ID | Not supported |
SECURITY(NONE) | Not supported |
SECURITY(SAME) | Default on ALLOCATE |
SECURITY(PGM(USED_ID(vble) | Not supported |
(PASSWORD(vble))) | Not supported |
PIP(NO) | Supported by PIPLENGTH(0) |
PIP(YES(vble1,vble2 ... vblen)) | Supported by PIPLIST+PIPLENGTH |
RESOURCE | Returned in CONVID field |
RETURN_CODE | Supported |
BACKOUT | EXEC CICS SYNCPOINT ROLLBACK |
RETURN_CODE | Supported |
MC_CONFIRM | EXEC CICS CONFIRM |
RESOURCE | CONVID |
RETURN_CODE | Supported |
REQUEST_TO_SEND_RECEIVED | Returned in EIBSIG |
MC_CONFIRMED | EXEC CICS ISSUE CONFIRMATION |
RESOURCE | CONVID |
RETURN_CODE | Supported |
MC_DEALLOCATE | EXEC CICS SEND LAST |
RESOURCE | CONVID |
TYPE(SYNC_LEVEL) None | EXEC CICS SEND LAST WAIT |
TYPE(SYNC_LEVEL) Confirm | EXEC CICS SEND LAST CONFIRM |
TYPE(SYNC_LEVEL) Syncpt | EXEC CICS SEND LAST |
TYPE(FLUSH) | EXEC CICS SEND LAST WAIT |
TYPE(CONFIRM) | EXEC CICS SEND LAST CONFIRM |
|
|
EIBFREE = X'00 |
EXEC CICS ISSUE ABEND |
EIBFREE = X'FF |
EXEC CICS FREE |
TYPE(LOCAL) | EXEC CICS FREE |
RETURN_CODE | Supported |
MC_FLUSH |
|
RESOURCE | CONVID |
RETURN_CODE | Supported |
MC_GET_ATTRIBUTES |
|
RESOURCE | CONVID on EXTRACT PROCESS |
SYNC_LEVEL | SYNCLEVEL on EXTRACT PROCESS |
PARTNER_LU_NAME | ASSIGN PRINSYSID |
PARTNER_FULLY_QUALIFIED_LU_NAME | See note |
MODE_NAME | See note |
CONVERSATION_STATE(vble) | STATE on EXTRACT PROCESS |
CONVERSATION_CORRELATOR | See note |
CONVERSATION_GROUP_ID | Not supported |
Note: These values are not normally
required in CICS applications and are not available at the API.
|
|
RETURN_CODE | Supported |
GET_TYPE | (Examine EIBRSRCE) |
RESOURCE | EIBRSRCE |
TYPE(vble) | EIBRSRCE set - mapped |
MC_POST_ON_RECEIPT | Not supported |
MC_PREPARE_FOR_SYNCPT | EXEC CICS ISSUE PREPARE |
RESOURCE | CONVID |
RETURN_CODE | Supported |
MC_PREPARE_TO_RECEIVE | EXEC CICS SEND INVITE |
TYPE(SYNC_LEVEL) none | EXEC CICS SEND INVITE WAIT |
TYPE(SYNC_LEVEL) confirm | EXEC CICS SEND INVITE CONFIRM |
TYPE(SYNC_LEVEL) syncpt | EXEC CICS SEND INVITE |
TYPE(FLUSH) | EXEC CICS SEND INVITE WAIT |
TYPE(CONFIRM) | EXEC CICS SEND INVITE CONFIRM |
LOCKS(SHORT) | Defaulted |
LOCKS(LONG) | Not supported |
RETURN_CODE | Supported |
MC_RECEIVE_AND_WAIT |
|
RESOURCE | CONVID field |
LENGTH(vble) Input | MAXFLENGTH option |
RETURN_CODE | Supported |
REQUEST_TO_SEND_RECEIVED | Returned in EIBSIG |
DATA | INTO or SET option |
MAP_NAME | Not supported |
|
|
Notes:
|
MC_REQUEST_TO_SEND | EXEC CICS ISSUE SIGNAL |
RESOURCE | CONVID field |
RETURN_CODE | Supported |
MC_SEND_DATA | EXEC CICS SEND |
RESOURCE | CONVID field |
DATA | FROM option |
LENGTH | LENGTH option |
FMH_DATA(NO) | Default |
FMH_DATA(YES) | See note |
MAP_NAME(NO) | Not supported |
MAP_NAME(YES) | Not supported |
ENCRYPT(NO) | Not supported |
ENCRYPT(YES) | Not supported |
RETURN_CODE | Supported |
REQUEST_TO_SEND_RECEIVED | Returned in EIBSIG |
Note: FMH_DATA(YES)
permits the sending of LU6.1 FMHs within an APPC conversation (for
example, when running a CICS program which was originally written
for use on LU6.1). An LU6.1 FMH may be built either by using the EXEC
CICS BUILD ATTACH command, before issuing the EXEC CICS SEND command,
or by building the FMH within the program, putting it in the output
area, and specifying the FMH option on the SEND command. Either of
these two actions is equivalent to specifying FMH_DATA(YES)
|
MC_SEND_ERROR | EXEC CICS ISSUE ERROR |
RESOURCE | CONVID field |
RETURN_CODE | Supported |
REQUEST_TO_SEND_RECEIVED | Returned in EIBSIG |
SYNCPT | EXEC CICS SYNCPOINT |
RETURN_CODE | Zero - Control returned to program. |
Note: For certain specialized
applications, the PREPARE flow (the first flow in syncpoint exchanges)
may be sent for a particular conversation by using the command:
This
enables any outstanding messages in the network (for example, SEND
ERROR) to be received before proceeding, or deciding not to proceed,
with the full syncpoint. |
MC_TEST | Check EIB flags |
RESOURCE | EIBRSRCE |
TEST(POSTED) | Check EIB flags |
TEST(REQUEST_TO_SEND_RECEIVED) | Check EIBSIG |
RETURN_CODE | Not supported |
WAIT | Not supported |