Connection object

A Connection object is used to represent communication links between CICS® systems. For work to be routed from one CICS system to another, a pair of Connection objects must be defined. Each half of the Connection pair is associated with a SystemClone object, which is the CICS system from which the connection is defined. The two half-connections must be related to each other so that CICS WLM can detect that both halves of the relationship are present and correct. A relationship is defined from one half of the connection to its other half. The reverse relationship does not need to be coded, because CICS WLM detects this. For routing to occur through a Connection object, both halves of the Connections must be defined as being in service. It is possible to set the InService attribute for one half of the Connection to zero. In that case, work is not routed to the region because the CICS WLM utility does not see a healthy communication path to it.

The entries that are made for Connection objects in the CICS WLM configuration file do not replace or affect the CICS Communications Definitions (CD). The CICS WLM utility uses the Connection object entries to build the internal object model.

Attributes for Connection objects

Connection objects have attribute values to describe the cost of communicating over the Connection object relative to the cost of using other Connection objects in the configuration, and to indicate whether the Connection object is in service or not. Table 1 shows the attributes and defaults for a Connection object.

Table 1. Attributes and defaults for a Connection object
Attribute	Default	Description
load	0.1	The weighting factor that is applied to the object that is using this Connection. Increasing this number biases the WLM algorithm away from the connected system.
inService	0	A switch to specify whether this Connection object is currently enabled (1) or not (0). Note that both Connections must be inService for routing to occur between two systems.

Relationships for Connection objects

Connection objects have a my_other_half relationship to other Connection objects.

Contents for Connection objects

Connection objects contain no objects.