CEMT PERFORM ENDAFFINITY

End an affinity owned by CICS®.

In the CICS Explorer, the ISC/MRO operations view provides a functional equivalent to this command.

Description

Where CICS is a member of a z/OS® Communications Server generic resource group, PERFORM ENDAFFINITY 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 (as displayed by CEMT INQUIRE/SET CONNECTION) must be NORECOVDATA.

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

Syntax

CEMT PERFORM ENDAFFINITY

Read syntax diagramSkip visual syntax diagramCEMT PERFORM ENDAFFINITYNETNAME( value)NETID( value)

Options

NETID (value)
specifies the 8-character name by which the network containing the connected 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 (value)
specifies the 8-character APPLID of the connected LU. If the connected LU is a member of a generic resource, you must specify its member name, not the generic resource name.
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 you entered the NETNAME or NETID incorrectly, or that you (or CICS) was wrong in supposing that an affinity existed.