z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$T LOGON(nnn) - Control the JES2/VTAM interface

z/OS JES2 Commands
SA32-0990-00

Function

To perform the following functions:
  • Assign an ID to the JES2/VTAM interface.
  • Assign or delete a password for the JES2/VTAM interface.
  • Diagnose SNA Problems.
  • Specify the characteristics of a logon.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-$T----------------------------------------------------------->

                                       .-,----------------------------.          
                                       V                              |          
>--+-LGN---+--nnn--+-------------+--(------+-nnn-+--+-------------+---+--)-- --->
   '-LOGON-'       '- ---+-nnn-+-'         '-*---'  '- ---+-nnn-+-'              
                         '-*---'                          '-*---'                

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

>--+---------------------------+-------------------------------><
   '-| Modification keywords |-'   

Modification keywords

|--+------------------------+--+--------------------+----------->
   '-,--Applid--=--cccccccc-'  '-,--LOG--=--+-No--+-'   
                                            '-Yes-'     

>--+--------------------------+--------------------------------->
   '-,--Password--=--cccccccc-'   

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

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

Selection limiting keywords

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

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

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

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

Parameters

nnn
The subscript defining the interface(s) affected by this command. You may specify a specific interface using the value of n on the LOGON(n) initialization statement that defines that interface. The subscript can also specify a range of values.
Applid=cccccccc
The application name, 1 to 8 alphanumeric characters, assigned to JES2 to identify JES2 as an application to VTAM®. This name must be defined to VTAM. See z/OS Communications Server: New Function Summary, for more information about VTAM definition.

In the JES2 networking environment, each job entry subsystem must have a unique name by which it is defined to VTAM. For NJE, this name must correspond to an application name in one of the application table (APT) entries defined for the local node (OWNNODE parameter on the NJEDEF initialization statement). See z/OS JES2 Initialization and Tuning Reference, SA32-0992 for information about defining APT entries.

Note: This parameter can only be changed when the session is inactive.
LOG={No|Yes}
Specifies whether JES2 is to monitor the JES2/VTAM interface and record all SNA events on the console with master level authority.
Note: When the JES2/VTAM interface is monitored, activity on all SNA lines is monitored.
Password=cccccccc
The security password, 1 to 8 alphanumeric characters, used to reject unauthorized terminals attempting to use the JES2/VTAM interface. If you specify a null password (P=), JES2 deletes the previously assigned password.
Note:
  1. The password that you assign must be defined to VTAM. See z/OS Communications Server: New Function Summary, for more information about VTAM definition.
  2. You must be certain to make note of the password assigned because there is no facility for displaying the password in effect.
RESTART=(Yes|No,interval)
Specifies whether this logon will be restarted if it is drained. The interval is the time (in minutes) between attempted restarts. The valid range for interval is 0 to 1440. An interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.
TRaceio={No|Yes}
Specifies whether I/O operations on the specified interface are to be traced. Trace ID 5 is used for interface tracing.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned. The $T NODE(nnnn) command sets command authority for a node.

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

Scope

Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Messages

The $HASP881 message displays the current values of the parameters on the LOGON(nnn) initialization statement.

Examples

 1   $t logon(1),p=,a=pgm1

  $HASP881 LOGON(1) APPLID=PGM1,STATUS=DRAINED,
                    LOG=NO,PASSWORD=(NOTSET),SESSIONS=,
                    TRACEIO=NO
JES2 deletes the password for the JES2/VTAM interface, and no password is required. The application ID for this interface is PGM1; no session exists using this interface.
 2   $t logon(1),log=y,tr=y

  $HASP881 LOGON(1) APPLID=JESB,STATUS=INACTIVE,
                    LOG=YES,PASSWORD=(SET),
                    SESSIONS=(MYJES/INACTIVE/LINE3),
                    TRACEIO=YES

JES2 issues a diagnostic message for each SNA event on both this JES2/VTAM interface (LOGON1) and any SNA line. Trace ID 5 traces event completions on this JES2/VTAM interface. The SESSIONS= indicates the SNA session name on this interface (MYJES), the session status (INACTIVE), and the SNA line used for connection (LINE3).

 3   $tlogon1,restart=(yes,2)          

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

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014