Installing Entire Output Management

#### Search Results

Search

# Installing Entire Output Management

To install Entire Output Management on z/OS, perform the following steps:

- Step 1: Prepare, Convert, Assemble and Link the License File

- Step 2: Load the Data File - for First-Time Installation Only

- Step 3: Load the Container File

- Step 4: Activate Index Compression (optional)

- Step 5: Scratch NOM Libraries - for Update Installation Only

- Step 6: Adapt Parameter Modules and Link Jobs for Batch and Online Natural

- Step 7: Load the INPL File

## Step 1: Prepare, Convert, Assemble and Link the License File

#### (Job I007, Steps 2801, 2802, 2804)

You have to install a valid Entire Output Management license file. For detailed information on license files and product licensing, see the Software AG Mainframe Product Licensing documentation.

1. Copy the license file from the installation medium to disk, or transfer it from the PC as described under Transferring a Licence File from PC to z/OS Host Using FTP in the Software AG Mainframe Product Licensing documentation.

2. Step 2801 - Check the license file (here named) `NOMLIC`. This job executes the CHECK function of the LICUTIL license utility.

3. Step 2802 - Convert the license file into an assembler source. This job executes the MAKE function of the LICUTIL license utility.

4. Step 2804 - Assemble and link the assembler source to generate load module `NOMLIC`. This module is then linked to the nucleus in Job I060 (see below).

The functions and option settings provided by LICUTIL are described under Using the License Utility LICUTIL in the Software AG Mainframe Product Licensing documentation.

## Step 2: Load the Data File - for First-Time Installation Only

#### (Job I050, Step 2800)

If you are installing Entire Output Management for the first time, use the Adabas load utility to load the `NOMvrs.SYSF` file. The data file contains some examples and initializations.

## Step 3: Load the Container File

#### (Job I050, Step 2801)

When working with container files, load one or more files using NOMvrs.SYS2 with `NUMREC=0`. For more information on how to use container files, see Defining Container Files in the System Administration documentation.

## Step 4: Activate Index Compression (optional)

In large environments, it may be useful to activate Adabas index compression for the Entire Output Management system files. This will result in less space required in the Adabas ASSO container, as Entire Output Management uses several similar descriptors which can be compressed very efficiently.

If you decide to perform this step, it is recommended to do so now during the installation. However, it is also possible to perform it later if desired.

To activate Adabas index compression, invoke the Adabas reorder utility as follows:

    ADAORD REORFASSO FILE=NOM-system-file-number INDEXCOMPRESSION=YES

## Step 5: Scratch NOM Libraries - for Update Installation Only

#### (Job I051, Step 2800)

If Entire Output Management has been installed before, scratch all objects from the libraries `SYSNOM`, `SYSNOMS`, `SYSNOMH1` and `SYSNOMH2`.

## Step 6: Adapt Parameter Modules and Link Jobs for Batch and Online Natural

Monitors of the System Automation Tools product family run as a Natural subtask. For further information, see the section Monitor Defaults in the System Administration documentation, and the sections Installing System Automation Tools and Starting a Server in the System Automation Tools documentation.

For 3GL programs, `NOMPUT`, `NOMADA` and `NOMCOMPR` must be linked to the 3GL program itself.

In addition to the specifications described in the System Automation Tools Installation documentation, you have to adapt and link the following:

1. Adapt the Batch Natural Parameter Module (Job I060)
   Add or change the following parameters in your Natural parameter module:

       CSTATIC=(ESFCLOS,ESFOPEN,ESFPURG,
                ESFREAD,ESFROUT,ESFSTAT,ESFWRIT)
   | Optional; required only if CA Spool is installed. Note If you wish to access TCP/IP printers directly, you also have to specify the module `ESMLPR` in the `CSTATIC` list. See the section TCP/IP Direct Printing in the Concepts and Facilities documentation.
   `NTLFILE 91,dbid,fnr` | The database ID and file number of the Entire Output Management active data file. If you wish to keep all data in a single Entire Output Management data file, specify the same database ID and file number as for `NTLFILE 206` (see below).
   `NTLFILE 206,dbid,fnr` | The database ID and file number of the Entire Output Management data file.
   `NTLFILE 131,dbid,fnr` | The database ID and file number of the System Automation Tools system file (mandatory).
   `NTSORT WRKSIZE=30,STORAGE=MAIN,EXT=OFF` | Sort program specifications. Note The Natural SORT statement may optionally invoke an external sort program. In this case, `EXT=ON` must be specified. For further information, see the section External Sort Programs in the Natural Operations documentation.
   `RUNSIZE=64` | Required for the correct execution of the Entire Output Management monitor.

2. Link the Natural Batch Module (Job I060)

   #### z/OS:

   Take the link job as described in the System Automation Tools Installation documentation and adapt the following libraries for the linkage:

       //NOMLIB DD DISP=SHR,DSN=SAGLIB.NOMvrs.LOAD
   | Supplied Entire Output Management load library.
   `//CMALIB DD DISP=SHR,DSN=CMASPOOL.LOAD` | Supplied CA Spool load library (optional).
   `INCLUDE NOMLIB(NOMCOMPR)` | Compression.
   `INCLUDE NOMLIB(NOMPUT)` | Install Natural Advanced Facilities printer type "NOM".
   `INCLUDE NOMLIB(NOMADA)`
   `INCLUDE NOMLIB(NATAM12)` | Install Natural printer type "NOM".
   `INCLUDE CMALIB(AESFPRIV)` | Optional. Only if CA Spool is installed.

3. Adapt the Online Natural Parameter Module (Job I080)
   Add or change the following parameters in your Natural parameter module:

   `NTLFILE 91,dbid,fnr` | The database ID and file number of the Entire Output Management active data file. If you wish to keep all data in a single Entire Output Management data file, specify the same database ID and file number as for `NTLFILE 206` (see below).
   `NTLFILE 206,dbid,fnr` | The database ID and file number of the Entire Output Management data file.
   `NTLFILE 131,dbid,fnr` | The database ID and file number of the System Automation Tools system file (mandatory).
   `NTSORT WRKSIZE=30,STORAGE=MAIN,EXT=OFF` | Sort program specifications. Note The Natural SORT statement may optionally invoke an external sort program. In this case, `EXT=ON` must be specified. For further information, see the section External Sort Programs in the Natural Operations documentation.

4. Link the Online Natural Parameter Module (Job I080)
   Take the link job as described in the System Automation Tools Installation documentation and adapt the following:

   #### z/OS:

   Take the link job as described in the System Automation Tools Installation documentation and adapt the following libraries for the linkage:

   `//NOMLIB DD DISP=SHR,DSN=SAGLIB.NOMvrs.LOAD` | Supplied Entire Output Management load library.
   `INCLUDE NOMLIB(NOMCOMPR)` | Compression.
   `INCLUDE NOMLIB(NOMPUT)` | Install Natural Advanced Facilities printer type "NOM".
   `INCLUDE NOMLIB(NOMADA)`
   `INCLUDE NOMLIB(NATAM12)` | Access method AM=NOM.

#### Additional Steps

If you want to print from Natural to Entire Output Management directly (without a spooling system), additional steps are required; see the section Printing from Natural to Entire Output Management Directly.

If you want to print from Natural Advanced Facilities to Entire Output Management directly, additional steps are required; see the section Using NOMPUT.

## Step 7: Load the INPL File

#### (Job I061, Step 2800)

Load the INPL file. The following libraries are loaded:

Library | File | Contents
--- | --- | ---
`SYSNOM` | FNAT | Entire Output Management application.
`SYSNOMH1` | FNAT | Entire Output Management help system (English).
`SYSNOMH2` | FNAT | Entire Output Management help system (German).
`SYSNOMS` | FNAT | JCL skeletons and separator examples.

### On this page

- Step 1: Prepare, Convert, Assemble and Link the License File
- Step 2: Load the Data File - for First-Time Installation Only
- Step 3: Load the Container File
- Step 4: Activate Index Compression (optional)
- Step 5: Scratch NOM Libraries - for Update Installation Only
- Step 6: Adapt Parameter Modules and Link Jobs for Batch and Online Natural
- Step 7: Load the INPL File