LOGTO

Logs directly to another Reality account without first logging off.

Command Class

TCL-I command.

Syntax

LOGTO account{,password} {(options}

Syntax Elements

account is the name of the account to log to.

password is the password of the account.

If you omit password, but the account you have specified requires a password, you will be prompted to enter it. In this case, the password is not displayed on the screen.

Options

C Bypasses the logon program of the account to which you are logging unless the account has been set up to prevent this.

K When logging to a remote database, keep the original connection and return to it on exit.

Comment

LOGTO only logs to another Reality account (which can be on another database), not to a UNIX or Windows command shell.

Operation

LOGTO performs the following functions.

1. Verifies that the specified account name is defined in the SYSTEM Dictionary.

   Note: If you enter an invalid account-name the PASSWORD prompt is still displayed.

2. Verifies that the password entered is valid.

   If you enter an invalid password, or the account-name is not defined in SYSTEM, LOGTO displays the message:

   Invalid logon attempt

   and returns to TCL.

3. Updates the accounting statistics if they are being kept (indicated by a U in attribute 9 of the account definition item).

4. Reports computer usage accumulated since the last logon. It displays a logoff banner (see example), showing:

   • The current time.
   • How many minutes the user has been logged on.
   • CPU usage in milliseconds.
5. Changes the retrieval and update lock codes and system privilege level to those of the new account, except where a user is assigned lock keys via a user profile (lock keys in the user's profile override any keys defined for the new account), or where a user's privilege level, defined in the SECURITY file, is lower than the new account's privilege level.  The lower of the two privilege levels is assigned.
6. Retains the workspace assignment of the original account logged on to.
7. Also retains the Spooler assignment and devices attached.

8. Initiates the Account Logon Program if one exists in the new account (unless you have used the C option to bypass it). Note, however, that for security reasons you may be prevented from bypassing the logon program.

Example

:LOGTO SYSMAN

****************************************************
***    CONNECT TIME AT 14:37:33 = 582 MINUTES    ***
***    CPU MS.  = 3600                           ***

****************************************************

ERRMSG File Item '340'

The message shown in the example above resides in item '340' in the ERRMSG file. Like other logon messages, you can edit it, as described in the section Editing Logon Prompt and Message. This message is also used by other TCL commands, including OFF, CHARGES and CHARGE-TO.