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.


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 and 91. 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, both, LFILEs 206 and 91 will point to your Entire Output Management system file, because in this case Entire Output Management system file and active data file are one and the same file.

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).

Start of instruction setIf 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.

Start of instruction setTo 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.

    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" />

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.

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

Start of instruction setTo start the Output Management GUI Client:

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