VARY TERM command using name or name pair: >>-VARY-- --NET--,--TERM----------------------------------------> >--+-,--LU1--=--lu_name--+--------------------+---+-------------> | '-,--LU2--=--lu_name-' | +-,--LU2--=--lu_name--+--------------------+---+ | '-,--LU1--=--lu_name-' | +-,--PLU--=--plu_name--+---------------------+-+ | '-,--SLU--=--slu_name-' | '-,--SLU--=--slu_name--+---------------------+-' '-,--PLU--=--plu_name-' .-,--TYPE--=--UNCOND-----. .-,--SCOPE--=--ACT-----. >--+------------------------+--+----------------------+---------> '-,--TYPE--=--+-COND---+-' '-,--SCOPE--=--+-ACT-+-' +-FORCE--+ +-ALL-+ '-UNCOND-' '-Q---' .-,--NOTIFY--=--YES-----. >--+-----------------------+----------------------------------->< '-,--NOTIFY--=--+-NO--+-' '-YES-'
VARY TERM command using session ID: >>-VARY-- --NET--,--TERM--,--SID--=--session_id-----------------> .-,--TYPE--=--UNCOND-----. .-,--SCOPE--=--ACT------. >--+------------------------+--+-----------------------+--------> '-,--TYPE--=--+-COND---+-' '-,--SCOPE--=--+-ACT--+-' +-FORCE--+ +-ALL--+ '-UNCOND-' +-Q----+ '-APPN-' .-,--NOTIFY--=--YES-----. >--+-----------------------+----------------------------------->< '-,--NOTIFY--=--+-NO--+-' '-YES-'
Operand | Abbreviation |
---|---|
VARY | V |
You can use the DISPLAY SESSIONS command to display the sessions that are to be terminated with this command. If a session is displayed with an A- session state, you may be able to terminate the session at this host by issuing the VARY TERM command with the SCOPE=APPN operand coded. If this is unsuccessful, issue VARY TERM from one of the session endpoints.
VTAM® overrides persistence and terminates the application and sessions normally.
Issuing a VARY TERM command to terminate the CP-CP session with an adjacent node might cause later session establishment requests to fail. To resolve the problem, reactivate the CP-CP session or else reactivate the link with CPCP=NO so that it will no longer be used in directed search routing.
lu_name can be a network-qualified name. If the name is network-qualified, it is considered to be the real name of the resource. If a non-network-qualified name is specified, the name can be an ACB name, an alias name, or the real name of a local resource.
If a cross-network CDRSC is to be specified on the LU1 operand and the CDRSC is defined using NQNMODE=NQNAME (either by definition or start option), it must be specified as a network-qualified name.
lu_name can be a network-qualified name. If the name is network-qualified, it is considered to be the real name of the resource.
If a cross-network CDRSC is to be specified on the LU2 operand and the CDRSC is defined using NQNMODE=NQNAME (either by definition or start option), it must be specified as a network-qualified name.
The value for plu_name can be a network-qualified name. If the name is network-qualified, it is considered to be the real name of the resource. If a network-qualified name is not specified, the default network identifier will be from the network where the command was issued.
If a cross-network CDRSC is to be specified on the PLU operand and the CDRSC is defined using NQNMODE=NQNAME (either by definition or start option), it must be specified as a network-qualified name.
Note that the termination of an active session between a device-type logical unit and its controlling primary LU terminates the session (unless the session is terminated using TYPE=FORCE) but does not alter the basic controller relationship between them.
Deactivation and reactivation of the logical unit (including error recovery procedures), or use of the logical unit by another primary LU, results in the re-establishment of the logical unit's session with its controlling application program. If this is not the case, the controller session can be reestablished with a VARY LOGON command or by a specific session request from the primary LU.
Use the DISPLAY SRCHINFO,LIST=ALL command to determine the session identifier of the search to be terminated.
Note that the termination of a queued session between a device-type logical unit and its controlling primary LU does not alter the basic controller relationship between them.
slu_name can be a network-qualified name. If the name is network-qualified, it is considered to be the real name of the resource.
If a cross-network CDRSC is to be specified on the SLU operand and the CDRSC is defined using NQNMODE=NQNAME (either by definition or start option), it must be specified as a network-qualified name.
If this command applies to active sessions, they might be disrupted. PLUs involved in such sessions are notified of the operator's request for termination and can terminate the session.
If the PLU is an independent LU, the session remains active because independent LUs cannot perform orderly termination. If the session remains active, it is marked "session end pending" in each SSCP that knows of the termination request.
If a controlling relationship is set up for the logical unit, the session redrives because the termination was of an abnormal type.
If this command applies to active sessions, they are disrupted. PLUs involved in such sessions are notified of the disruption.