$T LOGON(nnn) - Control the JES2/VTAM interface
Function
- 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
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 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:
- The password that you assign must be defined to VTAM. See z/OS Communications Server: New Function Summary for more information about VTAM definition.
- 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.
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
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