Definition of Nodes

Nodes are Entire System Server nuclei or Entire System Server/UNIX servers and refer to machines or CPUs on which requests to the operating system are executed. They are distinguished by numerical identifiers in the same way as database IDs distinguish between different Adabas databases.

Within Entire Operations, each UNIX and Windows server is assigned a node number. More than one operating system server node can reside in one physical machine. The machines identified by node IDs can run different target operating systems.

Entire Operations recognizes the operating system, thus allowing cross-operating-system job control. Communication paths between otherwise isolated nodes are provided by the Software AG products Entire Net-work and EntireX Broker, which allow a transparent connection of nodes, irrespective of how they are physically linked.

This document covers the following topics:

Related Topic:

See also the section Logging on and off an Operating System Server Node in the User's Guide.


Available Functions: Node Instance

Start of instruction setTo list all available functions for a Node instance

This section covers the following topic:

Trace Levels for UNIX and Windows Nodes

The Trace Level function only applies to UNIX and Windows nodes.

It is used to specify whether a trace is written to the log file and to determine the trace level (complexity) of the trace if written to the file. Valid input values:

Trace Level Description
0 No trace is written to the log file.
1 - 99999 A trace is written to the log file with different complexity levels from 1 (low) to 99999 (high).

Available Functions: Metanode Node

Start of instruction setTo list all available functions for Node

  1. In the object workspace, select the Node metanode and open the context menu.

    The following table lists in alphabetical order each function available:

    Function Shortcut Description
    List F8 See Listing all Nodes.
    New CTRL+N See Creating a Node Definition.
    Refresh F5 See Refreshing Object Lists - Refresh Functions in the User's Guide.
    Filter F3 See Filtering Objects - Filter Function in the User's Guide.
    Logoff -- Logs off all nodes to which you are currently connected.
    Show Connection Status --- See Monitoring the Node Connection Status in the User's Guide.
    Export --- Opens the Export Objects window to export all items of the metanode Node: see Exporting Objects in the Import/Export Functions documentation.
    Set Drag And Drop Function -- See Drag & Drop in the User's Guide.
  2. Select a Node and invoke the context menu.

This section covers the following topic:

Listing all Nodes

Start of instruction setTo list all nodes

  1. In the object workspace, select the Node metanode.

  2. From the context menu, choose List.

    Or:
    Press F8.

    A Node List window similar to the example below opens:

    graphics/node_list.png

    The list is sorted by the Number column (default) in ascending order.

    You can click on the column by which you want to sort the list. A triangle in the column indicates the column by which a list is sorted (in the example above, the SSU column).

    All columns are shown by default.

    The columns are explained in Column Headings: Operating System Server Table.

  3. If you want to reorder columns or reduce the number of columns shown in the Node List window, choose Columns from the context menu:

    graphics/column_order.png

  4. Uncheck the column(s) you want to hide from the list and choose Hide.

    Or:
    Select the column you want to shift and choose Move Up or Move Down to move the selected column left or right in the list.

    You cannot move or hide the Number column.

  5. When you are finished, choose OK to save and apply your changes.

    Any column changes are persistent and retained for future sessions. If required, you can reset to the default settings.

    Or:
    Choose Cancel to undo all changes.

    Or:
    Choose Reset to restore the default settings for the columns.

Listing Operating System Server Nodes

If you are using Entire Operations in a multi-CPU environment, you must define node numbers for machines. Networks and jobs can thus be defined to run under Entire Operations control on different nodes.

Column Headings: Node List

The columns contained in the Node List window are explained in the following table.

Column Description
Number Entire System Server or UNIX node number.
Short Name Short node name.
Node Name  User-defined (long) node name.
AM Access mode:
N Use Entire Net-Work for Mainframe nodes.
B Use EntireX Broker for UNIX and Windows nodes.
L Local node (invoked directly on the machine where Entire Operations is running; for Entire Operations on UNIX and Windows only).
Op. Sys.  Operating system under which the node is running as received from the last SYSTEM-INFO call to Entire System Server or UNIX/Windows system information.
Wait a.Err. Wait after error. Time in minutes to wait until next node access after a temporary error.
VSE SysID  The SYSID defined for a z/VSE node is added to the job card of jobs submitted on this node.
SSU  Submit Security User Type: see Fields: Monitor Defaults.

If empty, the system-wide default is in effect for this node.

TD  Time difference between local time and GMT in hours if node is in a different time zone.
Valid  Possible values:
yes  Node can be used.
no  Node has been disabled.
Cl. Operating system class:
B BS2000
M z/OS
V z/VSE
W Windows
X UNIX, Linux
JV Applies to BS2000 nodes only.

Indicates whether a BS2000 job variable is supported. Possible values:

Y Variable is supported.
(empty column) Variable is not supported.

The value is returned by Entire System Server for each BS2000 node defined in your environment.

Note:
Information on job variable support is only provided in the JV field.

Default user ID The UNIX or Windows user ID the Monitor uses for operations that are independent of a specific network or job.
Default group UNIX: If this column is empty, the default group name as defined in /etc/passwd is used. Otherwise, this column contains the name displayed when you issue the UNIX command groups.

Windows: The domain name used to log on to the server.

Broker ID Attributes of the EntireX Broker service definition for the node.

See also Node - Broker in Modifying a Node Definition.

Server Name
Service
User ID

Adding and Modifying a Node Definition

Creating a Node Definition

Start of instruction setTo create a new node definition

  1. In the object workspace, select the Node metanode.

  2. From the context menu, choose New, or press CTRL+N.

    A Create new Node window similar to the example below opens:

    graphics/new_node.png

  3. Enter the required definitions. The input fields and tabbed pages available in the window correspond to the fields and tabbed pages in the Maintenance Node window:

  4. When you have finished entering the required definitions, select OK to save the new node definition.

Modifying a Node Definition

Start of instruction setTo modify a node definition

  1. In the object workspace, select a Node instance.

  2. From the context menu, choose Open, or press CTRL+O.

    A Maintenance Node window with an open General page similar to the example below appears:

    graphics/open_node.png

  3. Now you can change the definitions for the selected node.

    The fields in the upper section of the window and on the tabbed page General are used to specify general definitions for the node. They are explained in Fields: Node Definition - General.

    The fields on the other tabbed pages available are explained in the following section.

    Node - Specials

    The tabbed page Specials specifies user- and group-specific information for the node.

    graphics/open_node_specials.png

    The fields available on the Specials page depend on the access mode selected on the General page and the operating system of the server node. They are described in the following sections:

    Node - Broker

    If use Broker is specified as the access mode, the additional tab Broker is displayed which contains EntireX Broker details for UNIX and Windows nodes.

    graphics/new_node2.png

    The fields contain the current attributes of the EntireX Broker service definition for the node.

    The EntireX Broker service definition can only be modified in the SATSRV text object in the Natural SYSSATU system library on the server. If you change the service definition, choose Refresh to force a re-read of the service definition from SYSSATU/SATSRV into Entire Operations.

    Choose Delete if you want to delete all fields of an EntireX Broker service definition in Entire Operations at once.

    Note:
    This does not delete any entries in SYSSATU/SATSRV.

    Node - SAP Definitions

    If local node is specified as the access mode, the additional tab SAP Definitions is displayed which contains SAP settings for UNIX and Windows nodes.

    graphics/open_node_SAP.png

    The fields on the tabbed page are explained in Fields: Node - SAP Definitions.

  4. Choose OK.

    Your changes are saved.

Fields: Node Definition - General

The fields in the upper section of a Create new Node or Maintenance Node window and on the tabbed page General are explained in the following table.

Field Description
Node Number The node number can be in the range from 1 to 99900.
Short Name A mnemonic short name for the node. The mnemonic short name can be used instead of the node number in various locations. This can be defined in a user profile setting.
Node Name Unique, user-defined node name.

For nodes with access mode Use Network: enter a short description to help the user select an appropriate node for network or job run.

For nodes with access mode Use Broker: enter the name of a UNIX or Windows node (server) as it appears in System Automation Tools and EntireX Broker definitions in the Natural SATSRV object in the SYSSATU library.

This field is case-sensitive.

NPR Version (Information field only)

Version of the Entire System Server (NPR) currently installed.

Operating System (Information field only)

Operating system that hosts the server node.

OS Release (Information field only)

Detailed information (where available) on the operating system installed.

Access Mode Possible selection options:
use Network Use Entire Net-Work for Mainframe nodes (default for node numbers 1 - 255).
use Broker Use EntireX Broker (default for node numbers 256 - 999).
local node Use the local node (invoked directly on the machine where Entire Operations is running; for Entire Operations on UNIX and Windows only).
Time Difference Difference between local time and GMT in hours if node is in a different time zone. Input format: xn, where:
x is a plus or minus sign (+ or -) and
n is any number from 0 to 12.
z/OS Password Mode This setting is evaluated for nodes on z/OS only.

Conversion mode to be used for password entries. Possible selection options:

Upper case Passwords are converted to upper case (default for mainframe nodes).
Case-sensitive Passwords in lower or mixed case are not converted to upper case (default for UNIX and Windows nodes).
z/VSE SysID This ID is added to the job cards of jobs submitted on this node. Range: 1 to 9.
Wait after Error Time in minutes to wait until next node access after a temporary error.

Default: 5 minutes.

Submit Security User Type The submit security user type can be set individually for each node. If this field is left blank, the global default applies to this node: see the Submit Security User Type field described in Monitor Defaults for the possible values of this field.
Valid You can disable the use of a node. Possible check box settings:
checked Allow use of node.
unchecked Disable use of node.

UNIX and Windows Node Definitions

UNIX and Windows nodes (i.e. on Entire System Server) must be defined in the following locations as well:

  • SYSSATU/ SATSRV (see the section Definitions for Entire System Server in the Installation documentation of System Automation Tools.)

  • EntireX Broker parameters. You can omit these definitions for the Monitor node, if this node is accessed in local mode.

  • Entire System Server/UNIX or Windows initialization file npr.ini (see Customize the NPR Server in the section Completing the Installation in the Entire System Server documentation).

    Note:
    For each combination of UNIX or Windows node and user ID, at least one successful login (by LOGON NODE) must have been made, before this combination can be used within the Entire Operations Monitor. These LOGON NODE commands must be repeated after a password modification on a UNIX or Windows system.

Special Definitions for a Node (Mainframe)

Fields: Node Definition - Specials (Mainframe)

The fields on the tabbed page Specials of a Node definition window for mainframes are explained in the following section:

Field Meaning
Default Userid This user ID will be used by the monitor for actions, for which no specific user ID is available on the job or network level.
Spool Class to be set Spool class to be set after job completion. You can enter any valid z/OS or z/VSE spool class to which the job spool class will be set after job completion.

Usage Precedence:

  1. Spool class defined for an Entire Operations job.

  2. Spool class defined here in this field (Spool Class to be set).

  3. Spool class defined in the Entire Operations defaults for z/OS or z/VSE.

Note:
If you enter a minus sign (-) here, the global default will not be applied.

E-Mail Code Page E-Mail Host Code Page (z/OS and OSD)

For Entire System Server versions >= 3.2.1:

The host code page to be used for e-mail sending.

Refer to the description of the field HOST-CODE-PAGE of the Entire System Server view SEND-EMAIL.

For Entire System Server versions < 3.2.1:

The destination to be used for e-mail messages, which are sent from z/OS via SMTP.

E-Mail SYSOUT Class  (z/OS only, Entire System Server versions less than 3.2.1 only).

The SYSOUT class to be used for e-mail messages, which are sent from z/OS via SMTP.

E-Mail Sender Default sender name for e-mails which are sent via this node. The commercial at sign (@) can also be coded as (a).
E-Mail Reply-To Return address for e-mails which are sent via this node. The commercial at sign (@) can also be coded as (a). The name specified in E-Mail Sender is used by default.

Special Definitions for a Node (UNIX and Windows)

Fields: Node Definition - Specials (UNIX and Windows)

The fields on the tabbed page Specials of a Node definition window for UNIX or Windows are explained in the following section:

Field Meaning
Default User ID  The (UNIX or Windows) user ID will be used by the monitor for actions which do not depend on a specific network or job.
Default Group UNIX: If this field is empty, the default group name as defined in /etc/passwd is used. Otherwise, this field contains the name displayed when you issue the UNIX command groups.

Windows: The domain name used to log on to the server.

Note:
You can replace symbols in network and job definitions.

Print Command  The print command (UNIX or Windows) for SYSOUT files on this node. :f: will be replaced by the file name.

Example: lp -dxxxx :f:

Message Command The message send command (Windows only). This command is used to send a user message out of Entire Operations.

Replacements:

  • :s: sender name (optional)

  • :u: subject (title of the message, optional)

  • :r: recipient

  • :f: name of the file containing the message

Entire Operations automatically makes these replacements.

Example: blat ":f:" -s ":u:" -i ":s:" -t ":r:" (parameters must be enclosed in quotes, if they contain blanks)

E-Mail Sender Default sender name for e-mails which are sent via this node. The commercial at sign (@) can be coded as (a).
E-Mail Reply-To Return address for e-mails which are sent via this node. The commercial at sign (@) can also be coded as (a). The name specified in E-Mail Sender is used by default.

SAP Definitions (UNIX and Windows)

Definition of some SAP-specific default values are required to set environment variables required for job type SAP, using jexa4S. All definitions are mandatory to run jobs of type SAP.

Fields: Node - SAP Definitions

The fields on the tabbed page SAP Definitions of a Node definition window are explained in the following section:

Field Description
JEXA4S_EXE Full path name of the jexa4s executable.

Example:

/opt/softwareag/nop/jexa4s/bin_x86_64/jexa4S

JEXA4S This path will be set as JEXA4S environment variable prior to the invocation of jexa4s.

Example:

/opt/softwareag/nop/jexa4S/ini

RFC_INI This path will be set as RFC_INI environment variable prior to the invocation of jexa4s.

Example:

/opt/softwareag/nop/jexa4S/ini/saprfc.ini