Establish a connection with CICSPlex® SM, defines an API processing thread, and provides default settings to be used by the thread.
>>-CONNECT--VERSION(data-value)---------------------------------> >--+----------------------------------------------+-------------> '-USER(data-value)--+------------------------+-' '-SIGNONPARM(data-value)-' >--+--------------------------------------------+---------------> '-CONTEXT(data-value)--+-------------------+-' '-SCOPE(data-value)-' >--THREAD(data-ref)--RESPONSE(data-ref)--REASON(data-ref)------><
The specifics of the connection process depend upon the environment in which your program is running. For a complete description of the connection process, see CICSPlex System Manager Application Programming Guide.
DISCONNECT, QUALIFY, TERMINATE
The default context is in effect for all commands issued against the thread unless you override it for a specific command or change it by issuing the QUALIFY command. As an alternative to specifying a default context for the thread, you can specify the context for individual commands as they are processed.
If you do not specify the CONTEXT option, the default context for the thread is the CMAS to which the thread is connected.
The SCOPE option qualifies the CONTEXT option. When the context is a CICSplex, the scope can be:
When the context is a CMAS, this option has no meaning and is ignored.
The default scope is in effect for all commands issued against the thread unless you override it for a specific command or change it by issuing the QUALIFY command. If you do not specify the SCOPE option, no default scope is assumed.
If CMAS security is active and CICSPlex SM finds no security defined in the environment where the API program is running, it passes the USER and SIGNONPARM values from the CONNECT command to EYU9XESV. For more information about API security, see CICSPlex System Manager Application Programming Guide.
This identifying token must be specified on all subsequent commands issued against this thread.
If CMAS security is active and CICSPlex SM finds no security defined in the environment where the API program is running, it passes the USER and SIGNONPARM values from the CONNECT command to EYU9XESV. For more information about API security, see CICSPlex System Manager Application Programming Guide.
The following is a list of the RESPONSE values that can be returned by the CONNECT command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.