Elements of the Main Application Window

When you start the Output Management GUI Client, its main application window is displayed:

Main Application Window

This window contains:

  • the object workspace on the left, and

  • the content pane on the right.

To modify the size of a pane, move the mouse pointer over the border separating the panes until the pointer changes, showing two arrows pointing in opposite directions graphics/ic_dbl_arrows.png. Then drag the border using the mouse until the panes have the desired size.

The main application window also contains:

  • above the object workspace: the menu bar and the tool bar,

  • below the object workspace: the command line and the status bar.

From a list of objects in the object workspace or content pane, you can invoke a context menu, containing a list of commands for a selected object.

The navigation with F-keys and other function keys corresponds closely to that of the Windows Explorer.

The individual components are explained below:


Object Workspace

The object workspace is on the left side of the main window:

Object Workspace

In the object workspace you can list existing objects, create new ones, and perform various operations on them by invoking a context menu.

Start of instruction setTo expand a branch in the object workspace and list the objects contained in it:

  • With the left mouse button, click on the plus sign graphics/ngc_plus.png preceding the object.

In the following example, all defined printers are listed:

Object Workspace with Printers branch expanded

An object preceded by a minus sign graphics/ngc_minus.png has been fully expanded.

To switch the display of the object workspace on or off, you use the View options in the menu bar.

The display and the options to change it correspond closely to those of the Windows Explorer.

Note:
With the System Automation Tools server user exit ESEXIT1N, it is possible to hide an inaccessible application node, depending on the reason why the application cannot be accessed. For details, see the source code of ESEXIT1N in the library SYSSAT.

Selection Criteria for Lists of Objects

Whenever you use a List command or expand an object type, normally all objects of that type would be listed. However, you may wish to list only certain objects. For this purpose, you can use the Filter command to specify selection criteria. Only objects which meet these criteria will then be listed.

The selection criteria specified via a Filter command apply to all subsequent List commands and object expansions for this object type. They are retained until you change them or remove them with another Filter command.

If you want to save your Filter selection criteria for the next Output Management GUI Client session, you use the My Desktop option in the menu bar (option Store my desktop > during shutdown > Filter).

The selection criteria you can use are different for each object type; they are described for each object type in the corresponding section.

Reading Many Object Records

If it takes a long time before a list of objects is displayed, this may be due to the fact that many objects of that type exist, and therefore a large number of object records has to be read. By pressing the ESC key, you can stop the reading of records. Only the objects read so far will then be listed.

To avoid the time-consuming reading of large numbers of object records, you can use the Filter command, as outlined above, to narrow down the number of objects to be listed.

Context Menu

A context menu provides a list of operations. It enables you to perform one of the listed operations on the selected object.

Start of instruction setTo invoke a context menu and choose a command:

  1. Select an object - either in the object workspace or in the content pane.

  2. Click the right mouse button, or press SHIFT+F10, or press MENU.

    The context menu is displayed, showing the commands available - for example:

    Context Menu for Reports

  3. Choose the desired command.

Commands that are greyed-out are not available for the selected object.

Key Shortcuts

As an alternative to invoking commands by selecting them from the context menu, you can also invoke most commands by pressing a key or a combination of keys. In the context menu, the corresponding key or key combination is shown after the command.

In the example above, instead of selecting the command List from the context menu, you can invoke it by pressing the key F8.

Content Pane

The content pane takes up the right side of the main application window. The appropriate list, window or dialog is displayed here when you invoke a command for an object.

Changing the Columns Display of a List

Whenever a list of objects is displayed, several columns of information are displayed for each item on the list. You can change the sequence in which the columns are displayed, and you can also choose which columns to display and which not.

Start of instruction setTo change the columns display of a list:

  1. Invoke the context menu and choose Columns....

    The Choose List Columns window is displayed.

  2. To display or not display a column, select or clear the corresponding check box.

    The columns are displayed in the sequence in which they are listed in the Choose List Columns window. To change the sequence, select a column and use the Move Up or Move Down button.

    To show all columns in their system default sequence again, choose Reset.

    When all columns to be displayed are in the desired sequence, choose OK.

Menu Bar

The menu bar is at the top of the main application window on the left:

Menu Bar

Start of instruction setTo choose a command from the menu bar:

  1. Select the appropriate menu.

    A drop-down menu of options is displayed.

  2. From the drop-down menu, choose the desired command and object options.

The following menus are available:

Menu Functions
Object Perform various functions on the selected objects; or exit the Output Management GUI Client.
View Show/hide the display of the following elements:
  • object workspace,

  • command input view (command line),

  • result view,

  • status bar.

Options Set the following options:
  • Language - English or German.

  • Refresh mode - current level or recursive.

  • Trace:

    • No trace: No trace is written, provided that the log file previously used is closed.

    • Level 1o 9: - A trace is written with different complexity (1 = low, 9 = high), provided that the log file is open from a previous use.

    • Overwrite: A single log file with the name %temp%/estrace.log is used. Each time the log is newly started, this file will be overwritten.

    • Continuous: Multiple log files are used. Each time the log is newly started, a new log file is generated with the name %temp%/estrace_date_time.log (date and time being the date and time when it was generated).

    The trace is started either when a trace level 1 to 9 is set, or during startup if the last session was closed with an active trace level 1 to 9.

  • Grid lines - show or hide.

  • Interval expansion - options to control treeview expansion individually (if allowed by system defaults; see Interval/Timeout under Components of System Defaults for further information; the individual options also correspond to the ones described there).

My Desktop Store the following for subsequent Output Management GUI Client sessions:
  • your opened dialogs and views,

  • your filter settings,

  • your expanded tree view of the object workspace.

You can select to store them in two ways:

  • on "catch" - that is, they are stored when you select the menu item My Desktop > Catch;

  • during shutdown - that is, they are stored automatically when the Output Management GUI Client is shut down.

You can reset the storage settings either by deselecting them individually, or via the menu item My Desktop > Reset.

Window Select the next, previous or desired content pane; or close all panes.
Help For a selected Output Management GUI Client node:
  • Content displays the corresponding online help.

  • About ... displays the current product version, copyright and other legal information.

Tool Bar

The tool bar is just below the menu bar at the top of the screen:

Tool Bar

Start of instruction setTo invoke a function from the tool bar:

  • Choose the appropriate icon.

If an icon is greyed-out, the function is not available for the selected object.

Command Line

The command line is at the bottom of the main application window, below the object workspace:

graphics/ngc_com.png

In the command line, you can enter a direct command to execute a function directly. From the drop-down list box next to the input field, you can select a command you executed previously during the current session.

Start of instruction setTo execute a direct command:

  1. In the object workspace, select the object to which the command is to be applied.

  2. In the command line, either type in the command, or select it from the drop-down list box.

For a description of all direct commands, see Direct Commands in the Commands documentation.

To show/hide the display of the command line, you use the View options in the menu bar.

Status Bar

The status bar is on the bottom left of the main application window, below the object workspace:

Status Bar

To show/hide the display of the status bar, you use the View options in the menu bar.