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


$ADD LOGON(nn) - Add a logon

z/OS JES2 Commands
SA32-0990-00

Function

To create a new LOGON pseudo-device, which defines JES2 as an application program to VTAM®.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-$ADD--+-LGN---+--+-nn--+------------+-------------------+---->
         '-LOGON-'  |     '- ---+-mm-+-'                   |   
                    |           '-*--'                     |   
                    |    .-,--------------------------.    |   
                    |    V                            |    |   
                    '-(------+-nn-+--+------------+---+--)-'   
                             '-*--'  '- ---+-mm-+-'            
                                           '-*--'              

>--+----------------------+--+--------------------+------------->
   '-,--Applid--=--applid-'  '-,--LOG--=--+-No--+-'   
                                          '-Yes-'     

>--+--------------------------+--------------------------------->
   '-,--Password--=--password-'   

>--+-------------------------------------------------------+---->
   |                  .-No--.                              |   
   '-,--RESTART--=--+-+-Yes-+----------------------------+-'   
                    '-(--+-Yes-+--+-----------------+--)-'     
                         '-No--'  |    .-0--------. |          
                                  '-,--+-interval-+-'          

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

Parameters

APPLID=applid
Specifies the 1 to 8 character name that your installation assigned to JES2. This name is passed to VTAM, and it must match the name defined to VTAM. Although the default name, JES2, will be supplied in the absence of this specification, it must be stressed that 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 appearing in one of the application table (APT) entries defined for the local node (OWNNODE parameter on the NJEDEF statement). Application table entries are created using information provided on the APPLID(avvvvvvv) initialization statement or, by default, using information from the NODE(xxxxxxxx) initialization statement.
LOG={No|Yes}
Specifies whether JES will monitor the VTAM interface and record all SNA events.

If you specify LOG=YES, JES2 issues a $HASP094 message for every transmission on the LOGON APPLID. You should specify LOG=NO if your installation performs extensive networking activity.

This parameter does not have a default.

Password=password
Specifies a 1 to 8 character security password that is presented to VTAM. (Passwords with fewer than 8 characters are padded with blanks.) This password must have been associated with the APPLID= parameter on this statement at VTAM system definition.

If you do not specify a password, none exists.

RESTART=(Yes|No,interval)
Specifies 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. The default RESTART value is No, and the default interval value is 0.
TRaceio={No|Yes}
Specifies whether (Yes) or not (No) JES2 will trace channel-end completions for logons. This is done with trace ID 5.

Authority Required

This command requires device 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 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. The values supplied for this command will be in effect for this member only.

Messages

The $HASP881 message displays the current status of all the parameters that define this LOGON.

Example

 1   $add logon4,appl=jes2n2

  $HASP881 LOGON4
  $HASP881 LOGON4     APPLID=JES2N2,STATUS=DRAINED,LOG=NO,
  $HASP881            PASSWORD=(NOTSET),SESSIONS=,TRACEIO=NO

LOGON 4 is defined to JES2.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014