PERFORM ENDAFFINITY

End an affinity owned by CICS®.

PERFORM ENDAFFINITY

Conditions: INVREQ

Description

Where CICS is a member of a z/OS® Communications Server generic resource group, the PERFORM ENDAFFINITY command instructs z/OS Communications Server to end an affinity owned by CICS, whether or not the connection has been deleted. If the connection has not been deleted, it must be out of service and have no recovery information outstanding (that is, its RECOVSTATUS must be NORECOVDATA).

Generic resources and affinities are described in Workload balancing in a sysplex.

Note: There is no facility in z/OS Communications Server for inquiring on affinities, so CICS has no certain knowledge that an affinity exists for a given connection. Whenever there is a possibility that an affinity has been created that you must end explicitly, CICS issues message DFHZC0177. This message gives the NETNAME and NETID to be passed to z/OS Communications Server.

If a request to end an affinity is rejected by z/OS Communications Server because no such affinity exists, CICS issues message DFHZC0181. This may mean either that your program specified an incorrect NETNAME or NETID, or that it (or CICS) was wrong in supposing that an affinity existed.

Options

NETID(data-value): specifies the name by which the network containing the remote LU is known to z/OS Communications Server.
If you do not specify a NETID, CICS takes the value from the installed connection, if it exists. If you do not specify a NETID and the connection does not exist, the command fails.
NETNAME(data-value): specifies the APPLID of the remote LU. If the connected LU is a member of a generic resource, you must specify its member name, not the generic resource name.

Conditions

INVREQ

RESP2 values:

25: The connection is still in service.
26: There may be recovery information outstanding for the connection. RECOVSTATUS has a value other than NORECOVDATA.
32: See message DFHZC0178. z/OS Communications Server could not end the affinity for a reason other than 35 (NOTFOUND) or 36 (SESSIONS ACTIVE).
34: NETID was not specified, and cannot be obtained from the installed connection. This may be because the connection does not exist, or because it does not contain a NETID value.
35: z/OS Communications Server could not find an affinity for the values input.
36: z/OS Communications Server could not end the affinity because the connection had some sessions active.
37: See message DFHZC0176. A z/OS Communications Server error prevented the CHANGE ENDAFFIN macro being carried out.
44: Invalid value defined for GRNAME