Command mapping for APPC basic conversations
The APPC verbs for basic conversations are implemented by equivalent CICS application programming commands.
The following tables show the mapping between APPC verbs and CICS® commands for basic conversations. See Return codes for APPC basic conversations for details of the corresponding return code mapping.
|
|
|---|---|
| LU_NAME(vble) | SYSID on ALLOCATE |
| MODE_NAME(vble) | MODENAME on ALLOCATE |
| MODE_NAME('SNASVCMG') | MODENAME on ALLOCATE |
| TPN(vble) | PROCNAME on CONNECT PROCESS (with PROCLENGTH) |
| TYPE(BASIC_CONVERSATION) | Supported by GDS |
| TYPE(MAPPED_CONVERSATION) | Not supported |
| 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 |
| SECURITY(NONE) | Not supported |
| SECURITY(SAME) | Default on ALLOCATE |
| SECURITY(PGM(USED_ID(vble) | Not supported |
|
|
| PIP(NO) | Supported by PIPLENGTH(0) |
| PIP(YES(vble1,vble2 ... vblen)) | Supported by PIPLIST+PIPLENGTH |
| RESOURCE | Returned by GDS ASSIGN |
| RETURN_CODE | Supported |
| BACKOUT | EXEC CICS SYNCPOINT ROLLBACK |
| RETURN_CODE | Supported |
| CONFIRM | EXEC CICS GDS CONFIRM |
| RESOURCE | CONVID |
| RETURN_CODE | Supported |
| REQUEST_TO_SEND_RECEIVED | Returned in CDBSIG |
| CONFIRMED | EXEC CICS GDS ISSUE CONFIRMATION |
| RESOURCE | CONVID |
| RETURN_CODE | Supported |
| DEALLOCATE | EXEC CICS GDS SEND LAST |
| TYPE(SYNC_LEVEL) None | EXEC CICS GDS SEND LAST WAIT |
| TYPE(SYNC_LEVEL) Confirm | EXEC CICS GDS SEND LAST CONFIRM |
| TYPE(SYNC_LEVEL) Syncpt | EXEC CICS GDS SEND LAST |
|
|
|
|
|
|
|
|
|
EXEC CICS GDS FREE |
| TYPE(ABEND_SVC) | Not supported at API (option set 11) |
| TYPE(ABEND_TIMER) | Not supported at API (option set 11) |
| TYPE(LOCAL) | EXEC CICS GDS FREE |
| LOG_DATA(vble) | Not available at API. CICS inserts the appropriate values |
| RETURN_CODE | Supported |
| FLUSH | EXEC CICS GDS WAIT |
| GET_ATTRIBUTES | EXEC CICS GDS EXTRACT PROCESS |
| RESOURCE | CONVID |
| SYNC_LEVEL | SYNCLEVEL on GDS EXTRACT PROCESS |
| UOW_IDENTIFIER | See note |
| OWN_FULLY_QUALIFIED_LU_NAME | See note |
| PARTNER_LU_NAME | GDS ASSIGN PRINSYSID |
| PARTNER_FULLY_QUALIFIED_LU_NAME | See note |
| MODE_NAME | See note |
| USERID | ASSIGN USERID |
Note: These values are not normally
required in CICS applications and are not available at the API.
|
|
| RETURN_CODE | Supported |
| GET_TYPE | EXEC CICS GDS ASSIGN (+ return code test) |
| RESOURCE | PRINCONVID |
| TYPE(vble) | RETCODE |
| POST_ON_RECEIPT | Not supported |
| PREPARE_FOR_SYNCPT | EXEC CICS GDS ISSUE PREPARE |
| RESOURCE | CONVID |
| RETURN_CODE | Supported |
| PREPARE_TO_RECEIVE | EXEC CICS GDS SEND INVITE |
| TYPE(SYNC_LEVEL) none | EXEC CICS GDS SEND INVITE WAIT |
| TYPE(SYNC_LEVEL) confirm | EXEC CICS GDS SEND INVITE CONFIRM |
| TYPE(SYNC_LEVEL) syncpt | EXEC CICS GDS SEND INVITE |
| TYPE(FLUSH) | EXEC CICS GDS SEND INVITE WAIT |
| TYPE(CONFIRM) | EXEC CICS GDS SEND INVITE CONFIRM |
| LOCKS(SHORT) | Defaulted |
| LOCKS(LONG) | Not supported |
| RETURN_CODE | Supported |
| RECEIVE_AND_WAIT | EXEC CICS GDS RECEIVE |
| RESOURCE | CONVID field |
| FILL(BUFFER) | BUFFER option |
| FILL(LL) | LLID option |
| LENGTH(vble) Input | MAXFLENGTH option |
| LENGTH(vble) Output | FLENGTH option |
| RETURN_CODE | Supported |
| REQUEST_TO_SEND_RECEIVED | Returned in CDBSIG |
| DATA | INTO or SET option |
|
|
Notes:
|
|
| REQUEST_TO_SEND | EXEC CICS GDS ISSUE SIGNAL |
| RESOURCE | CONVID field |
| RETURN_CODE | Supported |
| SEND_DATA | EXEC CICS GDS SEND |
| RESOURCE | CONVID field |
| DATA | FROM option |
| LENGTH | FLENGTH option |
| RETURN_CODE | Supported |
| REQUEST_TO_SEND_RECEIVED | Returned in CDBSIG |
| ENCRYPT | Not supported |
| SEND_ERROR | EXEC CICS GDS ISSUE ERROR |
| RESOURCE | CONVID field |
| TYPE(PROG) | Default |
| TYPE(SVC) | Not supported |
| LOG_DATA | Not supported |
| RETURN_CODE | Supported |
| REQUEST_TO_SEND_RECEIVED | Returned in CDBSIG |
| SYNCPT | EXEC CICS SYNCPOINT |
|
|
Notes:
|
|
| TEST | Check CDB flags |
| RETURN_CODE | Not supported |
| TEST(POSTED) | Check CDB flags |
| TEST(REQUEST_TO_SEND_RECEIVED) | Check CDBSIG |
| WAIT | Not supported |