LOGAPPL

Read syntax diagramSkip visual syntax diagram
>>-+------------------------------------+----------------------><
   '-LOGAPPL--=--controlling_primary_lu-'   

Identifies the name of the primary logical unit that this logical unit will automatically log on to as a secondary logical unit when this logical unit is activated. The name you specify can also be a USERVAR that will be resolved into its current value before being used to establish or redrive the session with the controlling primary logical unit.

For independent logical units, the LOGAPPL operand establishes a session with the primary logical unit designated on the LOGAPPL operand if a session does not currently exist with this logical unit. The session is established regardless of whether sessions with other logical units exist. The LOGAPPL operand cannot contain the name of an independent logical unit because independent logical units cannot be the controlling logical units for an automatic logon session.

To ensure retry of a pending automatic logon, code the AUTORTRY or AUTOTI start options.

You can specify a network-qualified name for LOGAPPL. You cannot specify an LUALIAS name for LOGAPPL.
Note:
  1. If an error occurs for the switched connection (INOP), VTAM® reallocates the LOGAPPL session and attempts to redial the logical unit to recover the connection. In other words, the session will be terminated by breaking the dial connection instead of by normal session termination using LOGOFF and TERMSELF.
  2. If you specify the NetView or TSO program as the application program on the LOGAPPL operand, you will get unpredictable results in recovery situations.

For more information on establishing sessions, see z/OS Communications Server: SNA Network Implementation Guide.