MODIFY CDRM command


>>-MODIFY-- --procname--,--CDRM--=--+-new_cdrm--------------------+-->
                                    +-(--new_cdrm--)--------------+   
                                    '-(--new_cdrm--,--old_cdrm--)-'   

>--,--ID--=--+-*---------------------+-------------------------->
             +-cdrsc_major_node_name-+   
             '-cdrsc_minor_node_name-'   

   .-,--TYPE--=--NORM------.   
>--+-----------------------+-----------------------------------><
   '-,--TYPE--=--+-IMMED-+-'   
                 '-NORM--'

Abbreviations

Operand	Abbreviation
MODIFY	F
TYPE=IMMED	IMMED or I or TYPE=I
TYPE=NORM	NORM or N or TYPE=N

Purpose

The MODIFY CDRM (cross-domain resource manager) command tells VTAM® which SSCP (CDRM) is the owner of a particular cross-domain resource (CDRSC) or set of CDRSCs. Ongoing sessions of CDRSCs affected by this command are not disrupted. The command changes only the name of the external CDRM responsible for all future session setups with these CDRSCs.

DISPLAY commands issued before a new name takes effect show the old owner CDRM name.

If the cross-domain resource affected by the MODIFY CDRM command was predefined with a CDRM coded on the CDRSC definition statement, the MODIFY CDRM command changes the CDRM that owns the CDRSC for the current and subsequent sessions. If the CDRSC was not predefined with CDRM coded, the change is temporary. After such new or existing sessions terminate, the CDRM is changed back to having no predefined CDRM coded.

Operands

procname

The procedure name for the command. If procname 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 procname.

If procname in the START command was startname, startname must be specified for procname.

CDRM

Specifies the new CDRM to be associated with the CDRSCs, and the CDRM that it replaces.

Note: For a CDRM, you can specify a network-qualified name, but this does not remove the restriction that the non-network-qualified CDRM name must be unique across networks.

CDRM=new_cdrm: Specifies the name of the new CDRM to associate with the CDRSCs.
CDRM=(new_cdrm,old_cdrm): Specifies both the new CDRM to associate with the CDRSCs and the CDRM that was previously associated with the CDRSCs. If old_cdrm is specified, only the CDRM names that match this old cdrm name are changed.

ID

Identifies the CDRSC major or minor node for which the owning CDRM name is to be changed.

ID=cdrsc_major_node_name: Changes the owning CDRM for all CDRSCs in the hierarchy under the major node. The major node name can be specified as a network-qualified name.
ID=cdrsc_minor_node_name: Changes the owning CDRM for only the specified minor node. The minor node name must be specified as a network-qualified name, if the CDRSC represents a real cross network resource.
Tip: If you are specifying a model CDRSC, you can use wildcard characters in the name you specify. The use of wildcard characters on the ID operand does not depend on the value of the DSPLYWLD start option.
ID=*: Changes the owning CDRM for all CDRSCs known to VTAM.

TYPE

Indicates whether CDRM takeover occurs without waiting for any sessions that are present to end.

TYPE=IMMED: Indicates that the CDRM is to be changed immediately, regardless of the presence of sessions.
TYPE=NORM: Indicates that the MODIFY CDRM command waits until all sessions have ended before changing the CDRM. If no session exists for a CDRSC affected by the MODIFY CDRM command, the CDRM is changed immediately (as with TYPE=IMMED).
If sessions are active or queued for a specific CDRSC affected by a MODIFY CDRM command, the current owning CDRM remains in effect until all active and queued sessions with the resource have been terminated. At that time, the owning CDRM name is changed and the new CDRM name takes effect.