$ADD APPL

Function

To dynamically define a VTAM® application to JES2 at the specified JES2 node.

Syntax


>>-$ADD--APPL--+-'--appl--'---------------+--------------------->
               |    .-,--------------.    |   
               |    V                |    |   
               '-(----+-appl-------+-+--)-'   
                      '-'--appl--'-'          

>--+------------------------+----------------------------------->
   '-,--COMPACT--=--compact-'   

>--+-------------------------------------------------------+---->
   |                  .-DEFAULT-.                          |   
   '-,--CONNECT--=--+-+-YES-----+------------------------+-'   
                    | '-NO------'                        |     
                    '-(--+-YES-+--+-----------------+--)-'     
                         '-NO--'  |    .-0--------. |          
                                  '-,--+-interval-+-'          

>--+------------------+--+------------------------+------------->
   '-,--LINE--=--line-'  '-,--LOGMODE--=--logmode-'   

>--+--------------------+--+------------------+----------------->
   '-,--LOGON--=--logon-'  '-,--NODE--=--node-'   

>--+------------------+----------------------------------------><
   '-,--REST--=--rest-'

Parameters

appl: Specifies the 1 to 8 alphanumeric or special ($, #, or @) character application name by which JES2/NJE is known to VTAM at the indicated node.
COMPACT=compact: The compaction table number (0-99) that is used for outbound compaction in communicating with this application at the specified node. Zero denotes no compaction.
Default: The value for COMPACT specified on the NODE(nnnn) initialization statement that defines the node indicated by the NODE=node parameter on this command.
CONNECT=(Yes|No|DEFAULT,interval): Specifies whether an NJE connection is automatically attempted for this appl. The default value DEFAULT uses the CONNECT=(YES|NO) value that is specified on the associated NODE statement. The interval is the approximate time (in minutes) between attempted connections. The valid range for interval is 0 to 1440. The default interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.
LINE=line: A dedicated line used for the SNA NJE session associated with this application. Specify only when the application is inactive.
Default: 0 (No line is dedicated.)
LOGMODE=logmode: The 1 to 8 character name of the logon mode table entry that is used for this VTAM application. The parameter input must adhere to the VTAM naming conventions for a logon mode table entry name. A logon mode table entry determines which entry in the VTAM application logon mode table will be used. If the program participates as the secondary end of a session (SLU), the table entry provides a set of session parameters. This parameter is used only for NJE applications. If it is specified for non-NJE applications, the parameter is ignored. Specify only when the application is inactive.
Default: If you omit the parameter, the system uses the VTAM defaults.
LOGON=logon: Specifies the number (1-999) of the local LOGON DCT which should be used when specifying connections to the application. The default value of 0 indicates that the LOGON DCT defined with the lowest number is to be used.
NODE=node: The number (1-32767) or the 1 to 8 alphanumeric or special ($, #, or @) symbolic name (xxxxxxxx) of the node at which the JES2 application is defined to VTAM.
Note: The symbolic name must have been specified on the NAME= parameter of the NODE initialization statement for the referenced node, or must have been defined on the DESTID initialization statement.
REST=rest: An integer (0-2000), which represents the resistance rating of the connection as viewed by the installation manager and coordinated with other installations. For information about selecting resistances, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.
Default: The value for REST specified on the NODE(nnnn) initialization statement that defines the node indicated by the NODE=nnnn parameter on this command.

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.

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.

Processing Considerations

When you dynamically define JES2 as an application to VTAM, its specifications are not checkpointed and are not carried across a restart of JES2. If you want to permanently define the new application, you must add a new APPL initialization statement before restarting JES2.

Scope

Single Member. The values supplied for this command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP821 message displays the current values of all the parameters that define this application.

Examples

 1 $add appl(jesc),node=33

  $HASP821 APPL(JESC)      NODE=33,COMPACT=0,CONNECT=(DEFAULT),
  $HASP821                 LINE=0,LOGMODE=,LOGON=0,REST=0

The application named JESC is known to VTAM at node 33.