Installation of Output Management GUI Client (NGC)

#### Search Results

Search

# Installation of Output Management GUI Client (NGC)

See the Natural documentation for information on how to start the installation; then follow the instructions of the installation program.

- Prerequisites

- Installation Notes

- Installation Procedure

- Initializing the Output Management GUI Client

- Customizing ESM Configuration for Natural

- Starting the Output Management GUI Client

- Customizing the Output Management GUI Client Startup

## Prerequisites

See Release Notes for the current version.

## Installation Notes

### Broker Access

Ensure that your desired broker is accessible. This means that your installation requires the correct RPC server (`SRVNAME`) and broker (`SRVNODE`) names to be entered in your Natural parameter module (usually `SYSESM2`). Alternatively, you can add the parameter Specify RPC Client's Default Server Address (DSF) dynamically at your startup shortcut.

### Logical Files

Ensure that your RPC server has got the definitions for logical files 206, 91 and 131.

LFILE 206 must point to your Entire Output Management system file, LFILE 91 must point to your Entire Output Management active data file. If you did not split the Entire Output Management system file, LFILEs 206 and 91 will both point to your Entire Output Management system file, because in this case the system file and the active data file are the same file.

LFILE 131 must point to your System Automation Tools log file.

For the editing of separation exit pages, the RPC server has to be started with the Natural profile parameter `EDPSIZE` being set.

### Natural Security

If Natural Security is installed on the server and the server library `SYSSAT` is protected, the Output Management GUI Client user has to be linked to the library `SYSSAT` or has to be a member of a group which is linked to `SYSSAT`.

## Installation Procedure

The Output Management GUI Client may already have been installed together with Natural Windows (Development version or Runtime version).

If not, proceed as follows:

1. Start the Software AG Installer and specify all required information on the different panels.

2. When the product selection tree is displayed, expand the Natural Products > Natural node.

3. Select Development environment and/or Runtime environment.

4. Select Entire Systems Management.

   This installs Mainframe Navigation, Output Management GUI Client and Entire Operations GUI Client. In addition, it installs the EntireX Miniruntime (if it is not installed already).

5. Choose Next to continue with the installation.

## Initializing the Output Management GUI Client

When the Software AG Installer has finished to installation, you have to initialize the Output Management GUI Client.

To do so:

1. Select All Programs > Software AG > Administration > ESM Configuration for Natural n.n (n.n = the current version number) from the Windows Start menu.

   Note
   By default, the Start menu group name is Software AG, but this may have been changed by the installation.

2. A dialog box will be displayed, in which you open the drop-down list box next to Output Management GUI Client and deselect the products you do not want to be initialized.

   Save configuration for updates: Select this option, if the configuration of selected/deselected products is to be used again automatically after an INPL of the Natural system library `SYSSATGF`. Deselect this option, if you wish this dialog to be displayed again to specify a different configuration.

3. Choose OK.

   The Output Management GUI Client will be shown in the Entire Systems Management application window when Entire Systems Management is started again.

## Customizing ESM Configuration for Natural

As an administrator, you may customize the dialog of the ESM Configuration for Natural n.n utility. You can change the following:

- the default setting for the initialization of a GUI component,

- the default language,

- the silent initialization.

To do so, you place an XML file named `esminit.xml` in the `prof` directory of the Natural installation used (typically, this is `C:\SoftwareAG\Natural\prof`).

The basic version of `esminit.xml` contains:

    <?xml version="1.0" ?>
    <!-- language="1" English -->
    <!-- language="2" German -->
    <esmInit silent="false" language="2">
    <!-- Mainframe Navigation -->
    <app short="AND" action="remove" />
    <!-- Output Management -->
    <app short="NOM" action=" " />
    <!-- Entire Operations -->
    <app short="OPC" action="initialize" />
    </esmInit>

If you run `ESINIT-D` with the above configuration, the German-language version of the dialog shows the following three actions:

- Initialize for Output Management with default action,

- Initialize for Entire Operations,

- Remove if already installed, or no action for Mainframe Navigation.

#### Attributes of esminit.xml:

Attribute | Explanation
--- | ---
Optional Entity `<esmInit>`
`silent` | `silent="false"` | The dialog is shown for the user action (default).
`silent="true"` | The action is performed, but the dialog is not shown.
If this attribute is not specified, the dialog is shown (as with `false`).
`language` | `language="1"` | Set dialog language to English (default).
`language="2"` | Set dialog language to German.
If this attribute is not specified, the current language of the installed Natural is used.
`update` | This attribute can be used to save the configuration which will be used for an automatic restore after an INPL of the Natural system library `SYSSATGF`. A file named `esminitsave.xml` containing the selected profile settings will be saved in the `prof` directory of the Natural installation used (typically, this is `C:\SoftwareAG\Natural\prof`).
`update="true"` | Save the configuration (default).
`update="false"` | Do not save the configuration.
Mandatory Entity `<app>`
`short` | `short="AND"` | GUI component Mainframe Navigation.
`short="NOM"` | GUI component Entire Operations.
`short="OPC"` | GUI component Output Management.
If a GUI component defined by the system is not specified here, its default system settings are used.
`action` | `action="initialize"` | Initialize the GUI component.
`action="remove"` | Remove the GUI component.

Note
Previous versions used the program `ESINIT-P` to configure the GUI components. It can still be used. The initialization is then done depending on the existence of the GUI-component-specific Natural library.

## Starting the Output Management GUI Client

To start the Output Management GUI Client:

- Select Entire Systems Management for Natural from the Start Menu, or select the corresponding desktop icon.

## Customizing the Output Management GUI Client Startup

It is possible to disable the display of specific applications in the Entire Output Management tree view, even if the applications are installed and shown during normal startup.

To modify your startup:

- Change the `STACK` parameter of your Natural parameter module (usually `SYSESM2`) as follows:

  If you want to start ... | STACK Parameter Specification
  --- | ---
  NGC only | `"LOGON SYSSATGF;ESSTRPCD NGC;FIN"`
  OGC only | `"LOGON SYSSATGF;ESSTRPCD OGC;FIN"`
  OGC and NGC | `"LOGON SYSSATGF;ESSTRPCD OGC+NGC;FIN"`
  OGC and MN | `"LOGON SYSSATGF;ESSTRPCD OGC+MN;FIN"`

  Or:
  Make a copy of the Entire Systems Management shortcut (desktop icon) generated by the installation procedure. That is, rename the desktop icon as desired.

  Then open the properties of the shortcut and add the following at the end of the target parameter:

  If you want to start ... | Target Parameter Specification
  --- | ---
  NGC only | `"STACK=(LOGON SYSSATGF;ESSTRPCD NGC;FIN)"`
  OGC only | `"STACK=(LOGON SYSSATGF;ESSTRPCD OGC;FIN)"`
  OGC and NGC | `"STACK=(LOGON SYSSATGF;ESSTRPCD OGC+NGC;FIN)"`
  OGC and MN | `"STACK=(LOGON SYSSATGF;ESSTRPCD OGC+MN;FIN)"`

  See the description of the `STACK` parameter in the Natural Parameter Reference documentation for details.

### On this page

- Prerequisites
- Installation Notes
- Installation Procedure
- Initializing the Output Management GUI Client
- Customizing ESM Configuration for Natural
- Starting the Output Management GUI Client
- Customizing the Output Management GUI Client Startup