MODIFY GR command

Abbreviations

Operand	Abbreviation
MODIFY	F
DELETE	DEL
OPTION	OPT

Purpose

The MODIFY GR command causes VTAM® to delete information about a generic resource locally at this host and from the generic resource's coupling facility structure. If VTAM has lost access to the generic resource's coupling facility structure, local generic resource information can still be deleted. This command has dependencies that must be met for the command to succeed. Every application instance of the generic resource must perform the following actions:

Delete itself as an active instance of the generic resource
End all of its sessions
Delete all of its generic resource affinities
Close its ACB

If these dependencies are met on the host where the MODIFY GR command is issued, but are not met for generic resource applications that are on other hosts, then local generic resource information can still be deleted. In order for a generic resource to be deleted from all hosts in a sysplex, this command must be issued at every host in a sysplex, and at least one host must have connectivity to the generic resources structure in the coupling facility. See z/OS Communications Server: SNA Network Implementation Guide for a description of how and why a generic resource should be deleted from a sysplex.

Tips:

You can display affinities using the D NET, GRAFFIN command. All generic resource instances can be displayed with the D NET,ID=grname,IDTYPE=GENERIC command.
Use the D NET,RSCLIST command to determine where the representation of the generic resource exists. A type of GENERIC RESOURCE indicates that it exists in the generic resource coupling facility structure. A type of GENERIC USERVAR indicates that it exists on the local VTAM where the display command is issued.

Operands

procname: The procedure name for the command. If the procname value in the START command was specified as startname.ident, where startname is the VTAM start procedure and ident is the optional identifier, either startname.ident or ident can be specified for the procname value in this command.
If the procname value in the START command was startname, startname must be specified for the procname value in this command.
GNAME=netid.generic_resource: A required parameter that specifies the generic resource name to be deleted. The name can be a network-qualified name. If a netid value is not specified, the default network ID is that of the host where the command is issued.
OPTION=DELETE: A required parameter that specifies the operation to be performed. DELETE is the only valid value. It specifies that the generic resource should be deleted.