VARY NOLOGON command


>>-VARY-- --NET--,--NOLOGON--=--+-*------------+---------------->
                                +-cdrsc_name---+   
                                +-plu_name-----+   
                                '-uservar_name-'   

>--,--ID--=--slu_name------------------------------------------><

Abbreviations

Operand	Abbreviation
VARY	V

Purpose

Use the VARY NOLOGON command to delete an existing automatic logon specification that was established by the VARY LOGON command or the LOGAPPL operand on a definition statement. This command applies to any device-type logical unit, whether channel-attached or link-attached. The device-type logical unit does not have to be active when the VARY NOLOGON command is issued; however, the major node must be active.

The VARY NOLOGON command deletes any existing automatic logon specification for the named logical unit. When the command is issued, any active or pending sessions that resulted from an automatic logon specification will continue. When these sessions end, however, the logical unit will no longer have an automatic logon specification until a VARY LOGON is entered for it.

Note: If you use the VARY NOLOGON command to delete an automatic logon specification that was coded on the LOGAPPL operand of a definition statement, be aware that later use of a VARY ACT,UPDATE=ALL command for dynamic reconfiguration can undo the effects of the VARY NOLOGON command. This is because the LOGAPPL value in the definition file overrides the operator command. To prevent the automatic logon specification from being added back unintentionally, delete the LOGAPPL operand from the definition statement.

Operands

ID=slu_name

Specifies the name of the secondary LU. This name can be one of the following values:

A device-type logical unit
A resource with subordinate device-type logical units
A boundary function CDRSC

Boundary function CDRSCs are subordinate only to the CDRSC major node where they were defined (ISTPDILU or ISTCDRDY). Boundary function CDRSCS are not subordinate to any device type major node (NCP, local SNA, etc.), nor to a line or PU, even if the independent LU was defined within or under these resources.

Because of this, independent LUs are not subordinate to any PU. Therefore, the sift-down to subordinate LUs does not affect independent LUs unless the ID value is a CDRSC major node.

The VARY NOLOGON command affects only LUs. If another resource type is specified, the logical units affected are those subordinate to the resource specified on the command.

The name can be a network-qualified name. If name is an ACB name, and the ACB name matches the name on the APPL definition statement, then you can use a network-qualified ACB name. (See the description of the ID operand on the VARY ACT command for an example of how you can specify a network-qualified application name.)

If the ID operand specifies a model CDRSC, then future clone CDRSCs built using the model are affected by this operation. To affect an existing clone CDRSC, issue the VARY NOLOGON command against that clone CDRSC.

If the ID operand specifies a CDRSC major node, then all the CDRSCs in that major node are affected. That includes conventionally defined CDRSCs, model CDRSCs, and clone CDRSCs.

NOLOGON

Specifies the scope of the VARY NOLOGON command. It can be a network-qualified name. The NOLOGON operand must specify the same name that was used on the LOGON operand or the LOGAPPL definition, with the following exception (because the host's network ID is assumed):

In NETA, LOGON=NETA.CICS can be canceled by NOLOGON=NETA.CICS or NOLOGON=CICS
In NETA, LOGON=CICS can be canceled by NOLOGON=NETA.CICS or NOLOGON=CICS

If the application name is an ACB name, and the ACB name matches the name on the APPL definition statement, then you can use a network-qualified ACB name. (See the description of the ID operand on the VARY ACT command for an example of how you can specify a network-qualified application name.)

NOLOGON=plu_name

Specifies that only logical units that are either:

Identified by slu_name or
Subordinate to slu_name

and have plu_name as their controlling PLU are to have their automatic logon specification deleted.

NOLOGON=cdrsc_name

Specifies the name of a CDRSC minor node within an active CDRSC major node. NOLOGON=cdrsc_name must be specified when the primary LU is an application program in another domain or another network.

NOLOGON=uservar_name

Specifies the name of a USERVAR that VTAM® resolves to be the application with which it is currently associated. If a USERVAR with the specified name is not found, VTAM searches for an application program with that name.

NOLOGON=*

Specifies that all secondary logical units that are either:

Identified by slu_name or
Subordinate to slu_name

are to have their automatic logon specification deleted, regardless of which PLU is currently in control.