Logging on and off an Operating System Server Node

#### Search Results

Search

# Logging on and off an Operating System Server Node

This section provides instructions for logging on or off an Entire System Server node.

This document covers the following topics:

- Logon Function

- Fields: Node Logon

- Troubleshooting Logon Errors

- Monitoring the Node Connection Status

- Logoff Function

## Logon Function

To log on a node

1. Use the direct command `LOGON` or `LOGIN` as described in the Direct Commands documentation.

   Depending on the operating system of the specified node, a Node Logon window like the examples below opens:

   For a mainframe node:

       +---------------------------------------------------------------------+
       |                                                                     |
       |                                                                     |
       |                          Entire Operations                          |
       |                              Node Logon                             |
       |                                                                     |
       |  Node       ===> N0042 (42)                                         |
       |                                  Locl Nd DQA V134                   |
       |  OpSys      ===> MVS/ESA                                            |
       |  User ID    ===> SAGTEST_                                           |
       |  Password   ===>                                                    |
       |                                                                     |
       |                                                                     |
       |                                                                     |
       |  PF3 End                                                            |
       +---------------------------------------------------------------------+

   For a UNIX node:

       +--------------------------------------------------+
       |                                                  |
       |                                                  |
       |                 Entire Operations                |
       |                     Node Logon                   |
       |                                                  |
       |  Node     ===> N0517 (517)                       |
       |                            npr_pcsn01            |
       |  OpSys    ===> Linux                             |
       |  User ID  ===> SAGTEST_____________              |
       |  Group    ===> ____________________              |
       |  Password ===>                                   |
       |                                                  |
       |  PF3 End                                         |
       +--------------------------------------------------+

   For a Windows node:

       +--------------------------------------------------+
       |                                                  |
       |                                                  |
       |                 Entire Operations                |
       |                     Node Logon                   |
       |                                                  |
       |  Node     ===> N0401 (401)                       |
       |                            npr_pcsn02            |
       |  OpSys    ===> Windows7                          |
       |  User ID  ===> SAGTEST_____________              |
       |  Domain   ===> eur_________________              |
       |  Password ===>                                   |
       |                                                  |
       |  PF3 End                                         |
       +--------------------------------------------------+

   In the input field(s), enter the required information. All fields are described in Fields: Node Logon.

2. Press ENTER.

   A Node Status screen like the example below appears:

        07.12.16                ***** Entire Operations *****                17:40:34
                                     Node Status at 17:40
        ------------------------------------------------------------------------------
         Node Server Name      Op.Sys.  Version     L LogonUID Status   Checked  Usage
        N0123 NOP Test1        MVS/ESA  3.6.1                  active     16:32      1
        N0456 NOP Prod1        MVS/ESA  3.6.1       X SAG      active     17:40  1

        ******************************* Bottom of Data *******************************

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        End         Check       Up    Down

   You can choose PF5 (Check) to refresh the status display if last check was made some time ago.

   The screen columns are explained in Columns: Node Connection Status.

3. Choose PF3 to return to the Main Menu.

## Fields: Node Logon

The Node Logon window contains the following fields:

Field | Description
--- | ---
Node | Node number.
OpSys | Operating system on node.
User ID | Valid user ID. If you logon to a mainframe node, input text is converted to uppercase letters. If you logon to a UNIX or Windows node, input text is not converted to uppercase letters. Therefore, make sure an exact spelling in mixed case. See also Field Defaults.
Domain | Input field for Windows or UNIX nodes: Enter a Windows domain or UNIX group, respectively. Windows: If this field is left blank, the logon will be carried out without domain. Otherwise, this field must contain a valid domain. The default user ID and domain can be used (see the Administration documentation) for combinations of Entire Operations users and operating system servers (nodes). UNIX: If this field is left blank, the user's default UNIX group (from `/etc/passwd`) is used. Otherwise, this field must contain one of the UNIX groups, which is visible in the output of the UNIX groups command.
Group | Input field for UNIX nodes: Enter a UNIX group. If this field is empty, the user's default UNIX group (from `/etc/passwd`) is used. Otherwise, this field must contain one of the UNIX groups, which is visible in the output of the UNIX groups command. See also Field Defaults.
Password | Input field for the password of the user specified in the User ID field. Logon to BS2000 nodes: The password can have up to 32 characters. Input text is converted to uppercase letters. Logon to z/OS nodes: This field can be used for both a password (up to 8 characters) and a password phrase (9 to 32 characters). A password is converted to uppercase letters depending on the setting of the password mode for the node (see the Administration documentation). A password phrase is always treated as a case-sensitive text string. Password restrictions: For user passwords used for nodes in ESM products, some restrictions apply. German Umlauts must not be used. The characters `|` (pipe), `[`, `]`,`{`, `}`, `\` (backslash), `~` (tilde) must not be used (code points 91 – 93, 123 – 126). Password mode: The text below the Password Field indicates the password mode set: `upper case` or `case-sensitive`. You can set the password mode for a node in the Node Modification window described in Displaying, Modifying and Adding a Node Definition in the Administration documentation.

### Field Defaults

The default user ID - and perhaps also the group or domain - for logging on to a node can be defined for any combination of Entire Operations users and nodes (see User Definitions and Profile Settings in the Administration documentation). In this case, these values are displayed as defaults during the logon process.

They serve to simplify the logon process. If you want to logon with another user ID and/or group or domain, then these fields may simply be overwritten.

## Troubleshooting Logon Errors

If a logon to a node fails, the error message returned by Entire Operations usually indicates that the data entered collides with the Entire Operations user security definitions. For example:

`EOR0254 - Invalid User ID or Password.`

The Entire Operations log file can contain additional error information returned from the underlying security system of an operating system, such as RACF for z/OS. For example:

`Logon failed, Node 146 User ID SAG1`

`... IRR013I VERIFICATION FAILED. INVALID PASSWORD GIVEN.`

## Monitoring the Node Connection Status

You can view a list with the current status of nodes defined in your environment.

To monitor the node connection status

- In the Command line, enter the following direct command:

      STATUS NODES

  (See also the `STATUS` command described in the Direct Commands documentation.)

  A Node Status screen appears.

  You can choose PF5 (Check) to refresh status display if last check was made some time ago.

  The screen columns are explained in Columns: Node Connection Status.

For further information, see also the API `NOPUST3N` described under Inquire Network and Job Status, Symbol Table in the section API Routines.

### Columns: Node Connection Status

The columns contained on the Node Status screen are described in the following table.

Column | Description
--- | ---
Status | Node status of last Entire System Server call, for example, active or not active.
Node | Node number or short node name.
Server Name | Logical (long) node name of the server.
Op.Sys. | Operating system on node.
Vers | Entire System Server version.
L | If marked: logon was made to the node. If no user ID is shown in the LogonUID column, `AUTOLOG=YES` is active on the node.
LogonUID | User ID used to log on to the node.
Checked | Time of last status check.
Usage | Usage access count for the node for the current user only.

## Logoff Function

To log off a node

- Use the direct command `LOGOFF` as described in the Direct Commands documentation.

### On this page

- Logon Function
- Fields: Node Logon
- Troubleshooting Logon Errors
- Monitoring the Node Connection Status
- Logoff Function