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.

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.