PERFORM ENDAFFINITY

End an affinity owned by CICS.

Read syntax diagramSkip visual syntax diagramPERFORM ENDAFFINITY
 
>>-PERFORM ENDAFFINITY--NETNAME(data-value)--------------------->
 
>--+-------------------+---------------------------------------><
   '-NETID(data-value)-'
 

Conditions: INVREQ

Description

Where CICS is a member of a VTAM generic resource group, the PERFORM ENDAFFINITY command instructs VTAM 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 the CICS® Intercommunication Guide.

Note:
There is no facility in VTAM 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 VTAM.

If a request to end an affinity is rejected by VTAM 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 VTAM.

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. VTAM 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
VTAM could not find an affinity for the values input.
36
VTAM could not end the affinity because the connection had some sessions active.
37
See message DFHZC0176. A VTAM error prevented the CHANGE ENDAFFIN macro being carried out.
[[ Contents Previous Page | Next Page Index ]]