Deactivate an NCP major node: >>-VARY-- --NET--,--INACT--,--ID--=--ncp_name-------------------> .-,--CDLINK--=--ACT-------. .-,--RMPO--=--NO------. >--+-------------------------+--+---------------------+---------> '-,--CDLINK--=--+-ACT---+-' '-,--RMPO--=--+-NO--+-' '-INACT-' '-YES-' >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ +-REACT--+ '-UNCOND-'
Deactivate an NCP line: >>-VARY-- --NET--,--INACT--,--ID--=--line_name------------------> >--+--------------------------+-------------------------------->< '-,--TYPE--=--+-FORCE----+-' +-GIVEBACK-+ +-IMMED----+ '-UNCOND---'
Deactivate a CDRM major node: >>-VARY-- --NET--,--INACT--,--ID--=--node_name------------------> >--+-------------+--+------------------------+----------------->< '-,--SAVESESS-' '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate a CDRM minor node: >>-VARY-- --NET--,--INACT--,--ID--=--node_name------------------> >--+--------------------+--+-------------+----------------------> '-,--IDTYPE--=--SSCP-' '-,--SAVESESS-' >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate a CDRSC minor node: >>-VARY-- --NET--,--INACT--,--ID--=--node_name------------------> .-,--DELETE--=--NO------. >--+-----------------------+--+------------------+--------------> '-,--DELETE--=--+-NO--+-' '-,--IDTYPE--=--CP-' '-YES-' >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate the dynamic XCF local SNA major node: >>-VARY-- --NET--,--INACT--,--ID--=--ISTLSXCF-------------------> >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate a dynamic XCF local SNA PU: >>-VARY-- --NET--,--INACT--,--ID--=--name-----------------------> >--+---------------------+--+------------------------+--------->< '-,--IDTYPE--=--XCFCP-' '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate a dynamic switched PU: >>-VARY-- --NET--,--INACT--,--ID--=--pu_name--------------------> >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate a dependent LU requester (DLUR): (1) (2) >>-VARY-- --NET--,--INACT--,--ID--=--dlur_name------------------> .-,--FINAL--=--NO------. >--+----------------------+--+--------------------------+------>< '-,--FINAL--=--+-NO--+-' '-,--TYPE--=--+-FORCE----+-' '-YES-' +-GIVEBACK-+ +-IMMED----+ '-UNCOND---'
Deactivate a PU supported by a DLUR: >>-VARY-- --NET--,--INACT--,--ID--=--pu_name--------------------> >--+--------------------------+-------------------------------->< '-,--TYPE--=--+-FORCE----+-' +-GIVEBACK-+ +-IMMED----+ +-REACT----+ '-UNCOND---'
Deactivate RTP PUs: >>-VARY-- --NET--,--INACT--,--ID--=--rtp_pu_name----------------> >--+----------------------+--,--TYPE--=--FORCE----------------->< '-,--FINAL--=--+-NO--+-' '-YES-'
Deactivate other PUs: >>-VARY-- --NET--,--INACT--,--ID--=--pu_name--------------------> .-,--FINAL--=--NO----------------------------------. >--+--------------------------------------------------+-------->< '-,--FINAL--=--+-NO--+------------------------+--+-' | '-,--TYPE--=--+-FORCE--+-' | | +-IMMED--+ | | +-REACT--+ | | '-UNCOND-' | '-YES--+------------------------+-' '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate a model application and all the APPLs created from it: >>-VARY-- --NET--,--INACT--,--ID--=--model_appl_name------------> >--+------------------------+--+------------------+------------>< '-,--TYPE--=--+-FORCE--+-' '-,--SCOPE--=--ALL-' +-IMMED--+ +-REACT--+ '-UNCOND-'
Deactivate a group under an Enterprise Extender XCA major node: >>-VARY-- --NET--,--INACT--,--ID--=--group_name-----------------> >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-'
Deactivate other resources: >>-VARY-- --NET--,--INACT--,--ID--=--name-----------------------> >--+------------------------+---------------------------------->< '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ +-REACT--+ '-UNCOND-'
Deactivate a model CDRSC and, optionally, all the clone CDRSCs created from it: >>-VARY-- --NET--,--INACT--,--ID--=--model_cdrsc_name-----------> >--+------------------------+--+------------------+-------------> '-,--TYPE--=--+-FORCE--+-' '-,--SCOPE--=--ALL-' +-IMMED--+ '-UNCOND-' .-,--DELETE--=--NO------. >--+-----------------------+----------------------------------->< '-,--DELETE--=--+-NO--+-' '-YES-'
Deactivate a clone CDRSC: >>-VARY-- --NET--,--INACT--,--ID--=--clone_cdrsc_name-----------> >--+------------------------+-----------------------------------> '-,--TYPE--=--+-FORCE--+-' +-IMMED--+ '-UNCOND-' .-,--DELETE--=--value_of_DELETE_operand_on_model_CDRSC-. >--+------------------------------------------------------+---->< '-,--DELETE--=--+-NO--+--------------------------------' '-YES-'
Operand | Abbreviation |
---|---|
VARY | V |
DELETE=YES | DELETE or DELETE=Y |
FINAL=YES | FINAL or FINAL=Y |
NO | N |
RMPO=YES | RMPO or RMPO=Y |
SAVESESS | S |
TYPE=FORCE | F or FORCE |
TYPE=GIVEBACK | G or GIVEBACK |
TYPE=IMMED | I or IMMED |
TYPE=REACT | R or REACT |
TYPE=UNCOND | U or UNCOND |
YES | Y |
When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for TYPE=IMMED, code only I or IMMED. Do not code TYPE=I.
The VARY INACT command deactivates VTAM resources. For SDLC switched and nonswitched links in a multiple-domain network, it can also return ownership of the line and its associated resources to the original SSCP without disrupting LU-LU sessions. This is done as part of error recovery procedures after one SSCP has taken over a failed SSCP's resources. For information about the deactivation of links and link stations, see the z/OS Communications Server: SNA Network Implementation Guide.
Figure 1 shows each resource type for which the command is valid and which operands can be used on the command. A large dot means that the operand applies to that resource. An I or F in the table shows what value is substituted if an IMMED, UNCOND, FORCE, or REACT operand is specified for a resource to which it does not apply.
This option is effective only on the VARY INACT or VARY REL command that begins the deactivation of an NCP. For example, if a second VARY INACT (perhaps with the IMMED operand specified) is entered before the first VARY INACT command completes, CDLINK does not apply to the second command and is ignored if specified.
If the CDRSC exists in ISTCDRDY, DELETE=NO is not applicable. If DELETE=NO is specified, it is ignored.
FINAL=YES is ignored for type 2.1 physical units if ACTPU is not sent.
If you enter FINAL=YES, you cannot enter TYPE=REACT.
The FINAL= YES operand can be issued for a DLUR CDRSC. See the description of TYPE=GIVEBACK for more information.
To deactivate the dynamic local SNA major node for XCF connections, specify ID=ISTLSXCF.
Network addresses for the boundary function CDRSC are reclaimed from the terminated sessions if appropriate (for example, if the cross-domain resource is a switched LU), but the RDTE remains intact.
For any dynamic application program built from the model, when CLOSE macro processing for the dynamic application program is complete, the definition of the dynamic application program is deleted. The dynamic application program will no longer be known to VTAM and will not appear in the output of any DISPLAY commands.
After you deactivate a CDRM with SAVESESS, the active sessions that remain are no longer associated with the CDRM. Therefore, subsequent activations and deactivations of the CDRM have no effect on these sessions.
The SAVESESS operand is not required during normal deactivation, and if specified, does not change the normal deactivation.
During normal deactivation, queued and pending sessions fail; the VARY INACT command is queued until all active sessions are terminated.
If TYPE=FORCE, sessions involving the resources are disrupted, and VTAM might have to wait (depending on how a given application program is coded) for application programs being deactivated, or for application programs in session with resources being deactivated, to formally end their sessions (that is, issue CLSDST) before completing the deactivation. A forced deactivation might cause VTAM to enter the wait state. It could then be necessary to deactivate an associated resource in order to free the system.
The TYPE=FORCE operand can be specified on a VARY INACT command entered while a normal or immediate deactivation or a VTAM HALT is in progress.
If the link does not support giveback, VTAM waits for the session to terminate before giveback is completed.
Preventing the DLUR from coming back to this DLUS:
In some cases, the DLUR may immediately try to reconnect to the DLUS which just performed the GIVEBACK. If this is not the required result the DLUS can prevent the DLUR from opening the pipe again. This is handled by way of an additional switch on the VARY INACT. If FINAL=YES is added to the command VTAM will save an internal indicator that will prevent the DLUR from opening a CPSVMGR session with VTAM. Any attempt to establish a DLUS/DLUR CPSVRMGR session will be rejected with sense code 080A000D. The operator can enable the DLUR again by issuing a VARY ACT for the DLUR CDRSC.
If TYPE=IMMED or TYPE=UNCOND, sessions involving the affected resources are disrupted. However, before completing the deactivation, VTAM waits for application programs being deactivated, or for application programs in session with resources being deactivated, to formally end their sessions (that is, issue CLSDST).
If this command is issued for an NCP, the SSCP-PU session between VTAM and the NCP is disrupted. VTAM does not terminate any LU-LU sessions; they might or might not be disrupted, depending on what the NCP does for automatic network shutdown (ANS). LU-LU sessions involving type 2.1 PUs generally stay up.
A second VARY INACT command with TYPE=REACT issued before the first one has time to complete has the same effect as specifying the TYPE=FORCE option.
Any type of deactivation request (normal, immediate, or forced) can be entered while a forced reactivation is in progress if you want termination of the reactivation. As previously stated, forced deactivation might be the only effective deactivation method if a resource fails to respond to the forced reactivation.