Using the LOGON command
After the VTAM application major node is activated and the LAS is initialized, use the LOGON command to log on to a VTAM session from a VTAM terminal.
An alternative to the LOGON command is the abbreviated logon command (see Using-the-abbreviated-logon-command). The abbreviated logon command is available only if your site has completed customization for either the VTAM USS table or the logon interpret table; check with your VTAM administrator.
To use the LOGON command
Issue the following command at the VTAM terminal logon screen.
The default configuration allows you to type the LOGON command in all uppercase characters or in all lowercase characters; however, your site might have changed this default during customization.LOGON APPLID(<applid>)[DATA(<userID>[/<password>])]In the command:
Parameter
Description
APPLID(applid)
(Required) Can be one of the following items:
- The minor node root name that was defined in the VTAM application major node definition (the default value is BBVTAS)
- The VTAM generic name that was specified for the GNAME LAS initialization parameter, as described in Understanding-LAS-initialization-parameters
DATA(userID/password)
(Optional) Defines the session user ID and password
If you do not use the DATA parameter, the logon panels are displayed (see Using-the-logon-panels)
userID
(Required if the DATA parameter is used) Is the user ID to be associated with your session. Any standard ID that TSO supports is supported by MainView Alternate Access; however, the ID must be defined to your external security manager to be accepted by MainView Alternate Access.
If you specify DATA(userID) without password, and a password, passphrase, or IBM Multi-Factor Authentication for z/OS (IBM MFA) is required, the password panel is displayed.
If you are not required to provide a password, passphrase, or IBM MFA for the user ID, the logon panels are skipped and the default product menu is displayed.
/password
(Optional if the DATA parameter is used) Specifies the password that is associated with the user ID. When you define the password value, you must define the userID value, and you must separate userID and password with a / (slash) character.
If you specify DATA(userID/password), the logon panels are skipped, and the default product menu is displayed. However, you might not want to define the password because it is visible on the screen when specified in the LOGON command.
If you are using passphrases or IBM MFA, do not use password. You must enter the information manually on the password panel as explained in Using the password panel.
Note:
If the LAS initializes with USS=NO (see Understanding-LAS-initialization-parameters), be sure to define extra characters when specifying the DATA parameter. The correct syntax is:
DATA('$ userID/password')
The password value is optional, but a single quotation mark-dollar sign-blank space (‘$ ) must be specified before the userID value and an end single quotation mark ( ‘ ) must be specified at the end of the DATA parameter value.
The following message appears when the LOGON command is issued:
MainView ALTERNATE ACCESS LOGON IN PROGRESS
Then, depending on how you issue the LOGON command, the MainView Alternate Access logon panels might be displayed (see Using-the-logon-panels).
Examples of using the LOGON command
The following examples show how the LOGON command can be defined for a VTAM terminal session logon.
The default values are used in these examples, but your site might have defined other values.
Related topic