>>-MODIFY-- --procname--,--GR----------------------------------->
>--,--GNAME--=--netid.generic_resource--,--OPTION--=--DELETE---><
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.