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 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.