Control operator verbs

The way in which CICS® implements APPC control operator verbs is shown in a set of tables.

See Return codes for control operator verbs for details of the corresponding return code mapping.

Note: Wherever CEMT is shown, the equivalent form of EXEC CICS command can be used.
CICS Explorer graphicTip: In CICS Explorer®, the ISC/MRO Connections view provides a functional equivalent to the SET and INQUIRE CONNECTION commands. The Terminals, Local Transactions, and Remote Transactions views provide functional equivalents to the INQUIRE TERMINAL and INQUIRE TRANSACTION commands, respectively. See CICSPlex SM Operations views in the CICS Explorer product documentation.
Table 1. CHANGE_SESSION_LIMIT
CHANGE_SESSION_LIMIT CEMT SET MODENAME
LU_NAME(vble) CONNECTION( )
MODE_NAME(vble) MODENAME( )
LU_MODE_SESSION_LIMIT(vble) AVAILABLE( )
MIN_CONWINNERS_SOURCE(vble) CICS negotiates a revised value, based on the AVAILABLE request and the MAXIMUM attribute of the SESSIONS resource.
MIN_CONWINNERS_TARGET(vnle) Not supported.
RESPONSIBLE(source) Yes.
RESPONSIBLE(target) Not supported. CICS does not support receipt of RESP(TARGET).
RETURN_CODE Supported.
Table 2. INITIALIZE_SESSION_LIMIT
INITIALIZE_SESSION_LIMIT Specified in SESSIONS resource
LU_NAME(vble) CONNECTION( )
MODE_NAME(vble) MODENAME( )
LU_MODE_SESSION_LIMIT(vble) MAXIMUM(value1,)
MIN_CONWINNERS_SOURCE(vble) MAXIMUM( ,value2)
MIN_CONWINNERS_TARGET(vnle) Not supported.
RETURN_CODE Supported.
Table 3. PROCESS_SESSION_LIMIT
PROCESS_SESSION_LIMIT Automatic action by CICS-supplied transaction CLS1 when CNOS is received by a target CICS system.
RESOURCE(vble) Connection resource.
LU_NAME(vble) Passed internally.
MODE_NAME(vble1,vble2) Passed internally.
RETURN_CODE Supported.
Table 4. RESET_SESSION_LIMIT
RESET_SESSION_LIMIT CEMT SET MODENAME (for individual modegroups) or CEMT SET CONNECTION RELEASED (to reset all modegroups)
LU_NAME(vble) CONNECTION( )
MODE_NAME(ALL) SET CONNECTION( ) RELEASED
MODE_NAME(ONE(vble)) MODENAME( ) AVAILABLE(0)
MODE_NAME(ONE('SNASVCMG')) SET CONNECTION( ) RELEASED
RESPONSIBLE(SOURCE) Yes.
RESPONSIBLE(TARGET) Not supported.
DRAIN_SOURCE(NO|YES) CICS supports YES.
DRAIN_TARGET(NO|YES) CICS supports YES.
FORCE(NO|YES) Not supported.
RETURN_CODE Supported.
Table 5. ACTIVATE_SESSION
ACTIVATE_SESSION CEMT SET MODENAME ACQUIRED (for individual modegroups) or CEMT SET CONNECTION ACQUIRED (for SNASVCMG sessions)
LU_NAME(vble) CONNECTION( )
MODE_NAME(vble) MODENAME( ) ACQUIRED
MODE_NAME('SNASVCMG') Activated when CEMT SET CONNECTION ACQUIRED is issued.
RETURN_CODE Supported.
Table 6. DEACTIVATE_CONVERSATION_GROUP
DEACTIVATE_CONVERSATION_GROUP Not supported.
 
Table 7. DEACTIVATE_SESSION
DEACTIVATE_SESSION Not supported.
 
Table 8. DEFINE_LOCAL_LU
DEFINE_LOCAL_LU SESSION resource and system initialization parameters
FULLY_QUALIFIED_LU_NAME(vble) Cannot be specified. CICS uses the network LU name (APPLID on DFHSIT).
LU_SESSION_LIMIT(NONE) Not supported.
LU_SESSION_LIMIT(VALUE(vble)) Total of MAX(nn) on all sessions.
SECURITY(ADD USER_ID(vble)) In an external security manager (ESM).
SECURITY(ADD PASSWORD(vble)) Not supported; defined in an ESM.
SECURITY(ADD PROFILE(vble)) Not supported; defined in an ESM.
SECURITY(DELETE USER_ID(vble)) Supported in an ESM.
SECURITY(DELETE PASSWORD(vble)) Not supported; defined in an ESM.
MAP_NAME(ADD(vble)) Not supported.
MAP_NAME(DELETE(vble)) Not supported.
BIND_RSP_QUEUE_CAPACITY(YES|NO) Not supported.
Table 9. DEFINE_MODE
DEFINE_MODE EXEC CICS CONNECT PROCESS + MODEENT macro (ACF/Communications Server systems definition) + SESSIONS resource
FULLY_QUALIFIED_LU_NAME(vble) Cannot be specified. LU identified via CONNECTION on SESSIONS.
MODE_NAME(vble) MODENAME on SESSIONS is mapped to LOGMODE on MODEENT.
SEND_MAX_RU_SIZE_LOWER_BOUND (vble) Fixed at 8.
SEND_MAX_RU_SIZE_UPPER_BOUND (vble) SENDSIZE on SESSIONS.
PREFERRED_RECEIVE_RU_SIZE (vble) Not supported.
PREFERRED_SEND_RU_SIZE (vble) Not supported.
RECEIVE_MAX_RU_SIZE_LOWER _BOUND (vble) Fixed at 256.
RECEIVE_MAX_RU_SIZE_UPPER _BOUND (vble) RECEIVESIZE on SESSIONS.
SINGLE_SESSION_REINITIATION OPERATOR Not supported.
SINGLE_SESSION_REINITIATION PLU Not supported.
SINGLE_SESSION_REINITIATION SLU Not supported.
SINGLE_SESSION_REINITIATION PLU_OR_SLU Not supported.
SESSION_LEVEL_CRYPTOGRAPHY (NOT_SUPPORTED) Default.
SESSION_LEVEL_CRYPTOGRAPHY (MANDATORY) Not supported.
SESSION_LEVEL_CRYPTOGRAPHY (SELECTIVE) Not supported.
CONWINNER_AUTO_ACTIVATE_LIMIT (vble) MAXIMUM(,value2) on SESSIONS.
SESSION_DEACTIVATED_TP_NAME (vble) Not supported.
LOCAL_MAX_SESSION_LIMIT (vble) MAXIMUM(nn,) on SESSIONS.
Table 10. DEFINE_REMOTE_LU
DEFINE_REMOTE_LU CONNECTION resource
FULLY_QUALIFIED_LU_NAME(vble) Cannot be specified.
LOCALLY_KNOWN_LU_NAME(NONE) Not supported.
LOCALLY_KNOWN_LU_NAME (NAME(vble)) CONNECTION(name)
UNINTERPRETED_LU_NAME(NONE) Defaults to CONNECTION(name).
UNINTERPRETED_LU_NAME (NAME(vble)) NETNAME on CONNECTION.
INITIATE_TYPE(INITIATE_ONLY) Not supported.
INITIATE_TYPE(INITIATE_OR_QUEUE) Not supported.
PARALLEL_SESSION_SUPPORT(YES|NO) SINGLESESS(NO|YES) on CONNECTION.
CNOS_SUPPORT(YES|NO) Always YES.
LU_LU_PASSWORD(NONE) Default on CONNECTION.
LU_LU_PASSWORD(VALUE(vble)) BINDPASSWORD on CONNECTION, or SESSKEY in RACF® APPCLU profile.
SECURITY_ACCEPTANCE(NONE) ATTACHSEC(LOCAL)
SECURITY_ACCEPTANCE (CONVERSATION) ATTACHSEC(VERIFY)
SECURITY_ACCEPTANCE (ALREADY_VERIFIED) ATTACHSEC(IDENTIFY) or ATTACHSEC(PERSISTENT).
Table 11. DEFINE_TP
DEFINE_TP TRANSACTION resource
TP_NAME(vble) TRANSACTION(name)
STATUS(ENABLED) STATUS(ENABLED)
STATUS(TEMP_DISABLED) Not supported.
STATUS(PERM_DISABLED) STATUS(DISABLED)
CONVERSATION_TYPE(MAPPED|BASIC) Supported for all TPs (determined by choice of command).
SYNC_LEVEL(NONE|CONFIRM∨SYNCPT) SYNCPT for all TPs (actual level specified on CONNECT PROCESS).
SECURITY_REQUIRED(NONE) Not supported; defined in an ESM.
SECURITY_REQUIRED(CONVERSATION) Not supported; defined in an ESM.
SECURITY_REQUIRED (ACCESS(PROFILE)) Not supported.
SECURITY_REQUIRED (ACCESS(USER_ID)) Not supported; defined in an ESM.
SECURITY_REQUIRED (ACCESS(USER_ID_PROFILE)) Not supported.
SECURITY_ACCESS(ADD(USER_ID(vble))) Transaction can be redefined.
SECURITY_ACCESS(ADD(PROFILE(vble))) Transaction can be redefined.
SECURITY_ACCESS (DELETE(USER_ID(vble))) Transaction can be redefined.
SECURITY_ACCESS (DELETE(PROFILE(vble))) Transaction can be redefined.
PIP(NO) Specified for all TPs.
PIP(YES(vble)) Specified on CONNECT PROCESS.
PIP(NO_LU_VERIFICATION) Default for all PIP data.
DATA_MAPPING(NO|YES) DATA_MAPPING(NO) for all TPs.
FMH_DATA(NO|YES) FMH_DATA(YES) for all TPs.
PRIVILEGE(NONE) Not supported.
PRIVILEGE(CNOS) Not supported.
PRIVILEGE(SESSION_CONTROL) Not supported.
PRIVILEGE(DEFINE) Not supported.
PRIVILEGE(DISPLAY) Not supported.
PRIVILEGE(ALLOCATE_SERVICE_TP) Not supported.
INSTANCE_LIMIT(vble) Not supported.
RETURN_CODE Supported.
Table 12. DELETE
DELETE EXEC CICS DISCARD
LOCAL_LU_NAME(vble) Not supported.
REMOTE_LU_NAME Not supported.
MODE_NAME Not supported.
TP_NAME DISCARD TRANSACTION( )
RETURN_CODE Supported.
Table 13. DISPLAY_LOCAL_LU
DISPLAY_LOCAL_LU CEMT INQUIRE CONNECTION + CEMT INQUIRE MODENAME + CEMT INQUIRE TRANSACTION
FULLY_QUALIFIED_LU_NAME(vble) Cannot be specified in CICS. The APPLID on DFHSIT serves as identifier for the local LU. Specific information can be had by identifying the remote LU. Otherwise, the universal ID * can be used.
LU_SESSION_LIMIT(vble) MAXIMUM on INQ MODENAME.
LU_SESSION_COUNT(vble) ACTIVE on INQ MODENAME
SECURITY(vble) Not available.
MAP_NAMES(vble) Not supported.
REMOTE_LU_NAMES(vble) INQ CONNECTION(*)
TP_NAMES(vble) INQ TRANSACTION(*)
BIND_RSP_QUEUE_CAPABILITY(vble) Not supported.
RETURN_CODE Supported.
Table 14. DISPLAY_REMOTE_LU
DISPLAY_REMOTE_LU CEMT INQUIRE CONNECTION + CEMT INQUIRE MODENAME
FULLY_QUALIFIED_LU_NAME(vble) Cannot be specified; CONNECTION or MODENAME may be used.
LOCALLY_KNOWN_LU_NAME(vble) CONNECTION name.
UNINTERPRETED_LU_NAME(vble) NETNAME on INQ CONNECTION.
INITIATE_TYPE(vble) Not supported.
PARALLEL_SESSION_SUPPORT(vble) SINGLESESS(Y|N) attribute.
CNOS_SUPPORT(vble) Always YES.
SECURITY_ACCEPTANCE_LOCAL_LU (vble) Not available.
SECURITY_ACCEPTANCE_REMOTE_LU (vble) Not available.
MODE_NAMES(vble) MODENAME attribute of the SESSIONS resource.
RETURN_CODE Supported.
Table 15. DISPLAY_MODE
DISPLAY_MODE CEMT INQUIRE MODENAME + CEMT INQUIRE TERMINAL
FULLY_QUALIFIED_LU_NAME(vble) Cannot be specified.
MODE_NAME(vble) MODENAME attribute of the SESSIONS resource.
LOCAL_MAX_SESSION_LIMIT(vble) AVA on CEMT INQ MODENAME.
CONVERSATION_GROUP_IDS(vble) Not supported.
SEND_MAX_RU_SIZE_LOWER_BOUND (vble) Fixed at 8.
SEND_MAX_RU_SIZE_UPPER_BOUND (vble) Not available.
RECEIVE_MAX_RU_SIZE_LOWER_BOUND (vble) Fixed at 256.
RECEIVE_MAX_RU_SIZE_UPPER_BOUND (vble) Not available.
PREFERRED_SEND_RU_SIZE(vble) Not supported.
PREFERRED_RECEIVE_RU_SIZE(vble) Not supported.
SINGLE_SESSION_REINITIATION(vble) Not supported.
SESSION_LEVEL_CRYPTOGRAPHY(vble) Not available.
SESSION_DEACTIVATED_TP_NAME Not supported.
CONWINNER_AUTO_ACTIVATE_LIMIT (vble) Not available.
LU_MODE_SESSION_LIMIT(vble) MAXIMUM on INQ MODENAME.
MIN_CONWINNERS(vble) Not supported.
MIN_CONLOSERS(vble) Not supported.
TERMINATION_COUNT(vble) Not supported.
DRAIN_LOCAL_LU(vble) Not supported.
DRAIN_REMOTE_LU(vble) Not supported.
LU_MODE_SESSION_COUNT(vble) ACTIVE on INQ MODENAME.
CONWINNERS_SESSION_COUNT(vble) Not available.
CONLOSERS_SESSION_COUNT(vble) Not available.
SESSION_IDS(vble) INQ TERMINAL(*).
RETURN_CODE Supported.
Table 16. DISPLAY_TP
DISPLAY_TP CEMT INQUIRE TRANSACTION
TP_NAME(vble) TRANSACTION(tranid)
STATUS(vble) ENABLED/DISABLED.
CONVERSATION_TYPE(vble) CICS TPs allow both types.
SYNC_LEVEL(vble) CICS TPs allow all sync levels.
SECURITY_REQUIRED(vble) Not available.
SECURITY_ACCESS(vble) Not available.
PIP(vble) CICS TPs allow PIP YES and NO.
DATA_MAPPING(vble) Always NO.
FMH_DATA(vble) Always YES.
PRIVILEGE(vble) Not supported.
INSTANCE_LIMIT(vble) Not supported.
INSTANCE_COUNT(vble) CEMT INQ TRAN( )
RETURN_CODE Supported.


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