Change the ownership of APPN resources in the directory database: >>-MODIFY-- --procname--,--DIRECTRY--,--FUNCTION--=--UPDATE-----> >--,--ID--=--+-cdrsc_major_node_name-+--------------------------> '-resource_name---------' >--+-,--CPNAME--=--+-new_cp_name-----------------------+-----------------------------+->< | '-(--new_cp_name--,--old_cp_name--)-' | +-,--NETSRVR--=--server_name------------------------------------------------------+ '-,--CPNAME--=--+-new_cp_name-----------------------+--,--NETSRVR--=--server_name-' '-(--new_cp_name--,--old_cp_name--)-'
Delete a resource from the directory database: >>-MODIFY-- --procname--,--DIRECTRY--,--FUNCTION--=--DELETE-----> >--,--ID--=--+-cdrsc_major_node_name-+------------------------->< '-resource_name---------'
Operand | Abbreviation |
---|---|
MODIFY | F |
FUNCTION=DELETE | DELETE |
FUNCTION=UPDATE | UPDATE |
The information in the directory database is updated automatically when VTAM® receives new information about a resource. For example, if you specify a new end node as the owner of an LU, and then VTAM finds that the LU has moved to a different location, the database is updated with the LU's new location.
You cannot change the resource type with this command. For example, you cannot turn a network node into an end node. If the resource specified by CPNAME or NETSRVR has a resource type that conflicts with the resource specified by ID, the update fails and an error message is issued.
The CPNAME and NETSRVR operands can specify the same resource name. For example, a logical unit can be owned by a network node, in which case the network node serves as both the control point and the network node server for the logical unit.
This command has no effect on corresponding CDRSC major nodes or minor nodes that have the same name as the resource specified by the ID operand. That is, the directory representation of the resource is changed, but the subarea representation of the resource is not changed.
This command is valid only when it is issued at a network node or an interchange node.
If procname in the START command was startname, startname must be specified for procname.
The name specified on CPNAME or NETSRVR cannot match the name specified on ID, unless ID is a major node. If ID is a major node, then the name specified for ID can match the name specified for CPNAME or NETSRVR; however, if there is a minor node with the same name as the major node, the update will fail for that minor node.
If the resource specified on the ID operand is not found in the database, an error message is issued.
You can specify a network-qualified name on the ID operand. If you do not, the host's network ID is used as the network qualifier.
F procname,DIRECTRY,UPDATE,ID=CDRSC2A,CPNAME=SSCP2A
where
CDRSC2A is the name of a CDRSC major node that contains several resources
that are now owned by control point SSCP2A. Model CDRSCs do not have
a directory representation, but any model CDRSC in a CDRSC major node
will be updated so that future clone CDRSCs built from that model
CDRSC will be affected by this command.You can specify a network-qualified name on the NETSRVR operand. If you do not, the host's network ID is used as the network qualifier.