DISPLAY AUTOLOG command


>>-D-- --NET--,--AUTOLOG--+----------------------------+-------->
                          '-,--ID--=--controlling_appl-'   

   .-,--SCOPE--=--ONLY-----.   
>--+-----------------------+------------------------------------>
   '-,--SCOPE--=--+-ALL--+-'   
                  '-ONLY-'     

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
>--+----------------------------------------+------------------><
   '-,--MAX--=--+-*-------------------+-----'   
                '-number_of_resources-'

Purpose

The DISPLAY AUTOLOG command displays information about controlling applications that have pending autologon requests. By default, this command displays each controlling application for which there is at least one pending autologon request and the condition (or conditions) that will cause the pending autologon request or requests to be initiated again. Optionally, this command also displays a list of secondary logical units that have pending autologon requests for each controlling application displayed.

See z/OS Communications Server: SNA Network Implementation Guide for more information about AUTOLOGON.

The following operands can be used to control the output that is generated by this command.

Operands

ID=controlling_appl

Specifies the real or alias name of a controlling application for which pending autologon requests may exist. Controlling_appl can be network qualified. If controlling_appl is not network qualified, then the network ID of the host from which the command was issued is used.

SCOPE

Specifies whether the display output includes the names of secondary logical units that have pending autologon requests for each controlling application.

SCOPE=ALL: A list of secondary logical units that have pending autologon requests is displayed for each controlling application that is displayed.
SCOPE=ONLY: A list of secondary logical units that have pending autologon requests is not displayed.

MAX

Specifies the maximum number of resources to be displayed by this command.

MAX=*: Specifies that the value of the DSPLYMAX start option is used to limit the display output.
MAX=number_of_resources: Specifies the maximum number of resources to be displayed by this command. The valid range is from 1 up to an including the value of the DSPLYMAX start option. The default is the value specified for the DSPLYDEF start option.
Specifying the MAX operand limits the display output. VTAM® searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer resources are found than you have specified on the MAX operand, VTAM displays only the resources that are found.

Resulting display

The resulting display shows:

For ID= and SCOPE=ONLY, if pending autologon requests exist for the controlling application specified on the ID= operand, the controlling application name is displayed, along with the condition or conditions that will cause these pending autologon requests to be initiated.
For ID= and SCOPE=ALL, if pending autologon requests exist for the controlling application specified on the ID= operand, the controlling application name is displayed, along with the condition or conditions that will cause these pending autologon requests to be initiated. A list of secondary logical units that have autologon requests pending for this controlling application is also displayed.
For SCOPE=ONLY, every controlling application that has at least one pending autologon request is displayed, along with the condition or conditions that will cause these pending autologon requests to be initiated.
For SCOPE=ALL, every controlling application that has at least one pending autologon request is displayed, along with the condition or conditions that will cause these pending autologon requests to be initiated. A list of secondary logical units that have autologon requests pending for each controlling application is also displayed.

Examples

d net,autolog,id=appl1
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = AUTOLOG
IST1990I PENDING AUTOLOGON REQUESTS FOR:
IST1991I NETA.APPL1 - WAITING FOR CDRM ACTIVATION
IST1996I     OR AUTOTI TIMER
IST314I END

The following sample output is displayed if an autologon request is pending for APPL1. The host on which the command was issued has the AUTOTI start option set to a nonzero value, the AUTORTRY=CDRM start option is set, and the host network ID is NETA. In this case, the pending autologon request for APPL1 was created when an autologon request found APPL1 to be in a connectable state (not enabled for sessions). The host that contains APPL1 sends a notification when APPL1 becomes session capable:

d net,autolog,id=appl1
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE =  AUTOLOG
IST1990I PENDING AUTOLOGON REQUESTS FOR:
IST1993I NETA.APPL1 - WAITING FOR PLU NOTIFICATION
IST314I END

The following sample output is displayed if SCOPE=ALL is included on the previous command:

d net,autolog,id=appl1,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE =  AUTOLOG
IST1990I PENDING AUTOLOGON REQUESTS FOR:
IST1993I NETA.APPL1 - WAITING FOR PLU NOTIFICATION
IST1997I   NETA.L3A3278A      NETA.L3A3279C
IST314I END

The following sample output is displayed if autologon requests are pending for APPL1, APPL2, and APPLBA1. In this case, the real network ID is known for APPL1 and APPLBA1, but not for APPL2. The host on which the command was issued has AUTOTI defined with a nonzero value and AUTORTRY=ALL. The pending autologon request for APPL1 was created when an autologon request found APPL1 to be in a connectable state (not enabled for sessions). The pending autologon requests for APPL2 and APPLBA1 were created when these autologon requests failed to find the controlling applications.

d net,autolog
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE =  AUTOLOGON
IST1990I PENDING AUTOLOGON REQUESTS FOR:
IST1991I NETA.APPL1 - WAITING FOR PLU NOTIFICATION
IST1994I APPL2 - WAITING FOR CDRM OR CPCP ACTIVATION
IST1996I     OR AUTOTI TIMER
IST1994I NETB.APPLBA1 - WAITING FOR CDRM OR CPCP ACTIVATION
IST1996I     OR AUTOTI TIMER
IST314I END

The following sample output is displayed when two LUs in this host have logged off their controlling application (APPL1), which is in a different host and is session-capable:

d net,autolog,id=appl1,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE =  AUTOLOG
IST1990I PENDING AUTOLOGON REQUESTS FOR:
IST2100I NETA.APPL1 - NORMALLY LOGGED OFF LUS
IST1997I   NETB.L3B3278A      NETB.L3B3279C
IST314I END