Space banner

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

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

  1. 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. 

Example 1

You can specify the following command:

LOGON APPLID(BBVTAS)

As a result, the user ID panel is displayed (see Using the logon panels).

Example 2

You can specify the following command:

LOGON APPLID(BBVTAS) DATA(JXM1)

As a result, the password panel is displayed (see Using the logon panels) unless JXM1 is an invalid user ID. If JXM1 is an invalid user ID, the logon terminates.

Example 3

You can specify the following command:

LOGON APPLID(BBVTAS) DATA(MAK1/MARCIE)

If MAK1 is a valid user ID, the default product menu is displayed, unless MARCIE is an invalid password. If MARCIE is an invalid password, the password panel is displayed (see Using the logon panels) so that you can enter the correct password.

Example 4

If the LAS initializes with USS=NO, you specify the following command:

LOGON APPLID(BBVTAS) DATA('$ SXC2')

The password panel is displayed (see Using the logon panels) unless SXC2 is an invalid user ID. If SXC2 is an invalid user ID, the logon terminates.

Example 5

If the LAS initializes with USS=NO, you specify the following command:

LOGON APPLID(BBVTAS) DATA('$ DRP1/DON')

If DPR1 is a valid user ID, the default product menu is displayed, unless DON is an invalid password. If DON is an invalid password, the password panel is displayed (see Using the logon panels) so that you can enter the correct password.

Was this page helpful? Yes No Submitting... Thank you

Comments