Completing the Installation

This section covers the following topics:

Defining Libraries and Users to Natural Security

After you have installed Entire Output Management for the first time and if Natural Security is active, you have to create security profiles in Natural Security for the Entire Output Management libraries and users, as described under Natural Security Definitions in the section Installing and Customizing Entire Output Management on Mainframes.

You have to do this before invoking the SYSPCI utility for Entire Output Management. Otherwise, the initialization with the SYSPCI utility will fail.


On UNIX systems, a migration to Version 3.4.3 is possible from Version 3.3.1 or later versions, but not from earlier versions.

On UNIX systems, a data migration of all data of the system files is required.

UNIX requires an additional FDT option "HF" for some fields. This means that the whole Entire Output Management system file has to be unloaded, decompressed, recompressed, and reloaded. This is done by the installation utility with update installation. Make sure that there is enough free disk space to hold the complete Entire Output Management system file.

You have to perform the following steps for:

  • the system file (NOM-SYSF1_MASTER);

  • the active-data file (NOM-ACTIVE_DATA), if used;

  • the container file (NOM-CONTAINER).

Start of instruction setTo migrate each Entire Output Management file manually:

  1. Create a directory as a work directory and copy $NOM_HOME/INSTALL/mig.bsh and the fdu definition file into it, e.g. nomsysf1.fdu.

    Enter an unused file number for a new Entire Output Management system file in nomsysf1.fdu.

    Make sure you have sufficient space to keep the unloaded and uncompressed system file in that directory.

  2. Backup your database and use it exclusively.

  3. Supposing you are using database 100 and the current system file number is 5, select a free file number (e.g. 15) and change to the created directory.

    Invoke the script as follows: ./mig.bsh 100 5 nomsysf1 15

    mig.bsh will renumber file 5 to 15, call several Adabas utilities which will change and add fields to the current system file, unload and decompress it, and change FDT options.

    Then the file will be recompressed and loaded as file 5. The old file will be left in the system as file 15.

  4. You need not specify a temporary file. If you want to replace the system file in place, invoke the utility as follows:

    ./mig.bsh 100 5 nomsysfl 5.

    mig.bsh will write a log file mig.bsh.log into the install directory which contains the complete output of all Adabas utilities.

After you have performed the above steps for each file, execute the following scripts:

  • $NOM_HOME/INSTALL/migd.bsh

  • $NOM_HOME/INSTALL/migmail.bsh

The execution of the second script may require considerable time.

Setting Up Your Products Using the SYSPCI Utility

After you have installed your product, you need to set up a number of files, parameters and individual settings depending on your environment. These are described below. To set them up, you use the SYSPCI utility. For detailed information on this utility, see SYSPCI Utility - Product Configuration and Initialization in Natural's Tools and Utilities documentation.

Before you can define Entire Output Management system files, the System Automation Tools system file (LFILE 131) has to be defined.

Entire Output Management requires the following Adabas system files:

  • NOM-SYSF1_MASTER, where the logical file number (LFILE) is 206.

  • NOM-ACTIVE_DATA, where the logical file number (LFILE) is 91.

    This is optional; if NOM-ACTIVE_DATA is not specified, NOM-SYSF1_MASTER will also be used for the active data.

  • NOM-CONTAINER without a logical file number.

The database IDs and file numbers of the new/existing files NOM-SYSF1_MASTER and NOM-ACTIVE_DATA which you specify with the SYSPCI utility will be entered into the default parameter files of Entire Output Management (NOMPARM) and Entire Operations (NOPPARM, if available).

The required Adabas files can either be local or remote.

  • Remote Access
    If the file is located in a remote database, Entire Net-Work must be active and the database must be accessible.

  • Existing Local File
    Before you start the SYSPCI utility, make sure that the Adabas database containing the required files is active. With this version, you can continue to use your existing files.

  • New File
    Before you start the SYSPCI utility, make sure that the Adabas database which will contain the required files is active. The SYSPCI utility will load and initialize these files. This should be also done if another file is required for your product.

Before you create new files with the SYSPCI utility, make sure that the ASSO and DATA sizes of your Adabas database are appropriate for these files. It is therefore recommended that you check the Adabas .fdu files in the <install-dir>/<product>/INSTALL/<product-code> directory for the used sizes. If required, change your database setup so that the files can be created.

For Entire Output Management, the SYSPCI utility offers the following optional function:

Option Description
Load NOM data If marked, the Entire Output Management data will be loaded into the Entire Output Management system file NOM-SYSF1_MASTER.

Invoking the SYSPCI Utility

In order to invoke the SYSPCI utility, you must first invoke Natural. You can then invoke the SYSPCI utility using the Direct Command window.

Start of instruction setTo invoke the SYSPCI utility

  1. Enter the following command at the UNIX system prompt to invoke Natural:

  2. Select the Direct menu and press ENTER to invoke the Direct Command window.

  3. Enter the following command in the Direct Command window:


    For more information, see SYSPCI Utility - Product Configuration and Initialization in Natural's Tools and Utilities documentation.

Invoking the SYSPCI Utility Using a Shell Script

It is possible to execute certain functions of the SYSPCI utility with a UNIX shell script. Two shell scripts are available in <install-dir>/Natural/INSTALL directory. They are called and These scripts can be used to automatically call SYSPCI for each installed product to intialize the product.

The scripts can be used for the following tasks:

    This script executes the SYSPCI utility to initialize installed Natural products with already existing Adabas files.

    The necessary conversion of Adabas files to the new version has to be done before starting this script.

    This script executes the SYSPCI utility to initialize installed Natural products and create the required Adabas files.

For more information, see SYSPCI Utility - Product Configuration and Initialization in Natural's Tools and Utilities documentation.


After the installation, all scripts used to run Entire Output Management (nom*.bsh) are contained in the directory $NOM_HOME. Adapt them to suit your requirements.

Script Function
nomarc.bsh Starts the archiving tasks.
nomcdn.bsh Starts the condense tasks.
nomchkpr.bsh Checks for finalized printouts.
nomconfi.bsh Manual confirmation of printouts.
nominit.bsh Loads the initial sample objects of a new Entire Output Management version.
nommon.bsh Starts the monitor tasks.
nomprt.bsh Starts the printer tasks.
nomrev.bsh Starts the revive tasks.
nomrpc.bsh Starts an RPC server to be invoked by the Entire Output Management GUI Client or the Open Print Option (OPO).
nomshut.bsh Can be used to shut down the monitor from outside of Entire Output Management.

Environment Variables

Make sure that the following environment variables are set appropriately:

Environment Variable Function Default Value
EOM_WORK A directory used by Entire Output Management to store intermediate files or log information. $NOM_HOME/work
EOM_ARC The directory in which archive files are stored. $NOM_HOME/archive

The environment variables must be known by the Entire System Server on UNIX which is accessed, not the Entire Output Management monitor itself (unless a monitor of type "L" (local) is used).

Monitor Defaults

The Entire Output Management monitor is accessed using the user ID and the password of a UNIX node definition which can be entered via UNIX Defaults (menu 8.1 > menu entry 13).

This is an addition to the Monitor Defaults (menu 8.1 > menu entry 2) and has to be created for the UNIX node where the monitor is executed.

Entering "M" in the suspend type definition indicates that the node is a monitor and must not be suspended by Entire Output Management. A type "M" monitor accesses Entire System Server on UNIX using EntireX, even if the destination Entire System Server resides on the same machine. However, it is possible to use an Entire System Server on the same machine by entering type "L": This will install the node as a local monitor which invokes Entire System Server as a subprogram in the same address space.

If you use Entire Output Management on UNIX exclusively without accessing any mainframe Entire System Server node, set the node ID to "0" in the Monitor Defaults.

The database ID and file number of the container file (NOM-CONTAINER), as specified with the SYSPCI utility, must also be specified in the UNIX Defaults.

Natural Nucleus

If you wish to use the Export/Import functions (which are described under Transferring Objects in the System Administration documentation) or process XML data in any other way with Entire Output Management, you have to use a Natural nucleus which is able to process XML data, that is, a Natural nucleus built with:

make natural ada=yes sax2=yes

Verifying the Installation

See Installation Verification in the Installation and Customization documentation for mainframes.