$D LOGON(nnn)

Function

To display the status of the specified JES2/VTAM interface(s) and their current characteristics.

Syntax


>>-$D--+-LGN---+--+------------------------------------+-------->
       '-LOGON-'  +-n--+-----------+-------------------+   
                  |    '- ---+-n-+-'                   |   
                  |          '-*-'                     |   
                  |    .-,------------------------.    |   
                  |    V                          |    |   
                  '-(------+-n-+--+-----------+---+--)-'   
                           '-*-'  '- ---+-n-+-'            
                                        '-*-'              

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+-----------+--+--------+--+-------------+--+------------+--->
   '-,--Applid-'  '-,--LOG-'  '-,--Password-'  '-,--RESTART-'   

>--+-------------+--+-----------+--+------------+---------------|
   '-,--SESsions-'  '-,--STATUS-'  '-,--TRaceio-'   

Selection limiting keywords

|--+----------------------------------+------------------------->
   '-,--+---+--Applid--+-=--+--applid-'   
        '-/-'          +-^=-+             
                       +->--+             
                       '-<--'             

>--+--------------------------------+--------------------------->
   '-,--+---+--LOG--+-=--+--+-No--+-'   
        '-/-'       '-^=-'  '-Yes-'     

>--+-------------------------------------------------------------+-->
   '-,--+---+--RESTART--+-=--+--+-+-YES-+----------------------+-'   
        '-/-'           '-^=-'  | '-NO--'                      |     
                                '-(--+-YES-+--+-----------+--)-'     
                                     '-NO--'  '-,interval-'          

>--+----------------------------------------+------------------->
   '-,--+---+--STATUS--+-=--+--+-ACTIVE---+-'   
        '-/-'          '-^=-'  +-DRAINED--+     
                               +-DRAINING-+     
                               '-INACTIVE-'     

>--+------------------------------------+-----------------------|
   '-,--+---+--TRaceio--+-=--+--+-No--+-'   
        '-/-'           '-^=-'  '-Yes-'

Parameters

LGN|LOGON(n|*)

The $HASP881 message displays the status of the specified JES2/VTAM interface(s) and their current characteristics. The subscript can also specify a range of values.

Applid=applid

Specifies the 1 to 8 character name that your installation assigned to JES2.

LOG={No|Yes}

Specifies whether JES will monitor the VTAM® interface and record all SNA events.

Password

Specifies a 1 to 8 character security password that is presented to VTAM.

RESTART=(Yes|No,interval)

Displays whether this logon will be restarted if it is drained. The interval is the approximate time (in minutes) between attempted restarts. The valid range for interval is 0 to 1440. A value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used. A third positional displays the approximate time (yyyy.ddd,hh:mm) when the next attempt is made.

SESsions

Displays the VTAM application interfaces and their corresponding status associated with this SNA line.

STATUS[=ACTIVE|DRAINED|DRAINING|INACTIVE]

Displays the current status of the device. The following types of status can be displayed:

Type: Meaning
ACTIVE: JES2 is using the device for job processing and will continue to do so as long as jobs are both available and eligible for the device.
DRAINED: JES2 does not use the device until you start it with a $S command.
DRAINING: JES2 is using the device to process jobs, but will stop using this device once the current function has completed.
INACTIVE: JES2 is not using the device, but would do so if a job were both available and eligible for the device.

TRaceio={Yes|No}

Specifies whether (Yes) or not (No) JES2 will trace channel-end completions for logons.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. The response to this command will be a display of information about this member only.

Messages

$HASP881 command response.

Examples

 1   $D LOGON
            $d logon(*)
            $HASP881 LOGON20
  $HASP881 LOGON20    APPLID=POK,STATUS=DRAINED,LOG=NO,
  $HASP881            PASSWORD=(NOTSET),SESSIONS=,TRACEIO=NO
            $HASP881 LOGON998
  $HASP881 LOGON998   APPLID=JES2,STATUS=DRAINED,LOG=NO,
  $HASP881            PASSWORD=(NOTSET),SESSIONS=,TRACEIO=NO
            $HASP881 LOGON999
  $HASP881 LOGON999   APPLID=JES2N1,STATUS=DRAINED,LOG=NO,
  $HASP881            PASSWORD=(NOTSET),SESSIONS=,TRACEIO=NO

The $HASP881 message indicates logon characteristics.

 2   $dlogon1          
  
  $HASP881 LOGON1    APPLID=JESA,STATUS=DRAINED,RESTART=(YES,2),  
  $HASP881           LOG=NO,PASSWORD=(NOTSET),SESSIONS=,TRACEIO=NO