This document covers the following topics:
This documentation contains all information relevant to Entire Systems Management Adapter users. Before you start reading the following sections, you are advised to read the background information contained in the Entire Systems Management Adapter Concepts and Facilities documentation.
For the sake of convenience, however, a brief system overview and a description of how Entire Systems Management Adapter works is given in the following subsections. Some hints as to how the different types of Natural users can make use of Entire Systems Management Adapter are also included.
Subsequent sections cover the following topics:
Describes the statements to access the Entire Systems Management Adapter, and gives some examples illustrating the use of the Entire Systems Management Adapter.
Describes the online tutorial delivered with Natural on Linux x64.
Lists the Entire Systems Management Adapter views and gives a detailed description of addressable fields.
Describes the operator commands that can be used to control the Entire Systems Management Adapter.
The Software AG product Entire Systems Management Adapter is a self-contained software package that provides BS2000 Operating System services to a Natural environment on Linux x64.
The Entire Systems Management Adapter makes data center management facilities available to Natural users (system programmers, application developers, computer operators). Entire Systems Management Adapter services include:
access to jobs;
submission of batch jobs;
access to system console and operator command input;
disk management;
catalog management;
read and write access to conventional files;
the ARCHIVE utility function;
Entire Systems Management Adapter provides operating system information and services in the form of views. Depending on the type of service requested, displayed items can be further processed using operator commands, or used by a Natural program.
Entire Systems Management Adapter views consist of fields which are given a name. A Natural program can use this name to reference the associated item.
For example, Entire Systems Management Adapter provides a view of
CATALOG information, in which the various items are identified by field name.
You can use the Natural FIND statement in a Natural program to
select CATALOG information. In the request, you can specify a volume serial
number to identify the volume, a DSNAME to limit the result list, and a node
number to identify the particular Entire Systems Management Adapter in a
computer network. Individual items are requested by specifying their field
names. The following Natural program snippet illustrates this for Volume
VOL001 and Node 148:
FIND CATALOG WITH DSNAME='*' AND NODE=148
IF ERROR-CODE NE 0
WRITE ERROR-CODE ERROR-TEXT
ELSE
WRITE DSNAME
END-IF
END-FIND
Internally, the presentation of such Operating System information is implemented as follows:
Each Entire Systems Management Adapter in the network is assigned a database ID (node number) which is specified for the views it provides. This database ID is mapped to a BS2000 host name and the port number of the Entire Systems Management Adapter.
The Natural FIND statement (as in the above example)
results in an Adabas call which the Entire Systems Management Adapter
recognizes and intercepts based on the database ID. The Adabas call is passed
via TCP/IP to the BS2000 Entire Systems Management Adapter. Instead of database
records, Operating System information and system services are returned.
In other words, Natural behaves as if the view addressed by the
FIND statement were an Adabas file: Natural builds the various
Adabas control blocks and issues Adabas calls. The Entire Systems Management
Adapter handles Adabas calls in the same way as Adabas itself.
Natural programs can access the Entire Systems Management Adapter using either of the following statements:
| Natural Statement | Meaning |
|---|---|
FIND
|
Select Operating System information for the specified view(s). |
PROCESS
|
Perform Operating System activities using the specified view(s). |
The Entire Systems Management Adapter in turn accesses the requested Operating System service. Each Operating System service is presented as a view defined to the Entire Systems Management Adapter.
When directed at Entire Systems Management Adapter, the Natural statements listed above can be used with some additional options. These are described in the section Getting Started.
A detailed description of each view available through Entire Systems Management Adapter is given in the section View Descriptions.
Example Natural programs with calls to the Entire Systems Management Adapter can be found in the online tutorial delivered with the Entire Systems Management Adapter.