Function
To create a new LOGON pseudo-device,
which defines JES2 as an application program to VTAM®.
Syntax
>>-$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.