A Client application requires
one connection object, CclConn, for each CICS® server
with which it will interact.
When a connection object is created, optional data can be specified
which includes:
- The name of the server to be connected. This must be one of the
server names defined in the configuration file ctg.ini. If
this name is omitted, the default CICS server will be used.
- A user ID. Some servers might require that a client application
provides a user ID and password before they permit specific interactions.
- A password.
In this example, a connection object is created with a server name,
user ID and password:
CclConn serv2( "Server2","sysad","sysad" );
Creating a connection object does not, in itself, cause any interaction
with the server. The information in the connection object is used
when one of the following server request calls is issued:
- link—to request the execution of a server program.
- status—to request the status (availability) of the server.
- changed—to request the notification of any change in this
status.
- cancel—to request the cancellation of a changed request.
These are methods of the connection class. There are two other
server request calls; the backout and commit methods
of the unit of work class. More information on the use of all these
methods can be found in following sections.