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: Logon Node

- Troubleshooting Logon Errors

- Monitoring the Node Connection Status

- Logoff Function

## Logon Function

To log on a node

1. In the object workspace, select a node instance and choose Logon from the context menu, or press CTRL+ALT+L.

   Or:
   Use the direct command `LOGON` as described in the Direct Commands documentation.

   Or:
   From the General node, choose Monitor Status (only applies if the node is not active yet).

   A Logon Node dialog like the example below opens:

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

2. Choose OK.

## Fields: Logon Node

The Logon Node window contains the following fields:

Field | Description
--- | ---
Short name | Short node name.
Number | Node number.
Node name | Logical (long) node name.
Operating system | 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.
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. Note You can resize the window to enter a long 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).

### 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. In addition, you can add a node to the list of nodes to be monitored.

To monitor the node connection status

1. In the object workspace, select a Node metanode and choose Show Connection Status from the context menu.

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

       STATUS NODES

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

   A Connection Status window like the example below opens:

   The columns and selection options in the window are explained in Columns and Selection Options: Node Connection Status.

2. Choose Clear Entry to remove the selected node status entry from the list or choose Clear All to remove all node status entries.

To add a node to be monitored

- In the object workspace, select a Node instance and open Add to Connection Status from the context menu.

  The node is added to the Connection Status window.

Note
By default, a node connection status is transient and can change when you terminate an Entire Operations session. You can save the status of all node connections for a future session by selecting the Node Connection Status option in the session profile described in the section User Maintenance in the Administration documentation.

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

### Columns and Selection Options: Node Connection Status

The columns, selection options and output fields contained in the Connection Status window are described in the following table.

Column/Section | Description
--- | ---
Operating system class | In this section, check or uncheck single or multiple operating systems (BS2000, z/OS, Windows, and UNIX) defined for the nodes or select All for all operating systems. Unknown selects all nodes for which no operating system has been defined.
Access mode | In this section, check or uncheck single or multiple access modes used by the nodes (network for mainframe nodes, EntireX Broker for UNIX and Windows nodes and local node) or select All for all access modes.
Status | Node status of last Entire System Server call, for example, active or not active. In this section, check or uncheck single or multiple status values or select All for all status values. Other selects all nodes with a status other than active or not active.
Number | Node number.
Short Name | Short node name.
Node Name | Logical (long) node name of the server.
AM | Access mode.
Op.Sys. | Operating system on node.
OS Release | Operating system release.
Op.Sys Class | Operating system class.
Version | Entire System Server version.
Statistics | The output fields in this section show the numbers of active and inactive nodes and the nodes where errors occurred.

## Logoff Function

To log off a node

- In the object workspace, select the required node instance and choose Logoff from the context menu.

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

  The previously selected node is now logged off.

### On this page

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