PreviousGNT Analyzer Library: Command Line InterfaceNext"

Chapter 9: Infomgr

This chapter describes Infomgr.

9.1 Introduction

Infomgr is a tool for managing the demonstration programs provided with Server Express; these programs are stored in the directory $COBDIR/demo. Infomgr enables you to:

Infomgr uses a configuration file and an environment variable to control many of its functions. You can change these to suit your requirements. See the section Configuring Infomgr for more details.

9.2 Starting Infomgr

To start Infomgr, type:

infomgr

at the system prompt.

9.3 The Infomgr Menu System

When you start Infomgr a banner is displayed, and you are asked you to press any key to continue. Press a key and a menu is displayed:

This menu shows the demonstration programs available. The contents of this menu might be different to that shown above, depending on what demonstration programs are available with this release of Server Express.

There are two methods you can use to select a topic:

If a topic has only one corresponding demonstration, then the demonstration programs for that topic are displayed. If a topic has more than one demonstration application, a submenu is displayed from which you can make further selections. You select items from the submenus in the same way as for the menu described above.

When you have selected a demonstration program, this menu is displayed at the bottom of the screen:

Select a menu option by typing the first letter of the option, or use the keys specified in the menu. For example, to page up and down through the file you can use either the U and D keys on your keyboard, or the Page-Up and Page-Down keys; see the appendix UNIX Key Usage Chart for further information on these keys.

Most of the options on this menu enable you to move through and view the demonstration programs, except for Transfer and Compile:

9.4 Configuring Infomgr

You can configure the behavior of Infomgr an environment variable and a configuration file. You should configure Infomgr if you intend using the Transfer option to move the demonstration programs to a working directory.

9.4.1 Environment Variables

You can use the environment variable TMPDIR to specify which directory Infomgr will use for its temporary files. If you do not set this environment variable, Infomgr uses the /tmp directory for temporary files.

Example:
tmpdir=sys:/tmp
export tmpdir

9.4.2 Configuration File

You can configure Infomgr using the system configuration files. Infomgr recognizes two configuration files:

If both files are found the global entries are read first followed by the local ones.

For more details on the configuration files see the chapter Configuring Development Tools in your Getting Started.

To configure Infomgr, add the section name [MF-INFOMGR](if it doesn't already exist) to the configuration file. In this section, add tags in the format:

tag-name: value

where the parameter tag-name can be in upper or lower case.

The values that are specified in the [MF-ATTRIBUTES] section of the configuration file also affect Infomgr; therefore, if you change the appearance of the SDE by altering the values in this section, you will also change the appearance of Infomgr.

You can enter the following tags in the [MF-INFOMGR] section.


COBDIR

The COBOL system directory. This entry overrides the COBDIR environment variable.

Syntax:
COBDIR: directory

where directory is the directory that contains your Server Express COBOL system

Default:
$COBDIR
Example:
cobdir=/usr/cobol

CLEARCMD

Command used for clearing the screen before running a shell, or some C or UNIX related function.

Syntax:
CLEARCMD: command

where command is a command that will clear the external screen.

Default:
tput clear
Example:
clearcmd: tput clear

CMDDIR

Controls which directory is current when the F2-Cmd function is used.

Syntax:
CMDDIR: menu
Comments:

If you set menu then, when you press F2-Cmd when viewing a source or text file, the current working directory is changed to the directory containing the item being viewed.

If CMDDIR is set to anything other than menu then Infomgr treats this option as not set.

Default:

By default the current working directory is the same directory as that from which Infomgr is invoked.

Example:
cmddir: menu

COBINFDIR

Specifies the directory that contains the Infomgr control and menu files.

Syntax:
COBINFDIR: directory

where directory specifies the directory.

Default:
$COBDIR/etc
Example:
coninfdir: /u/infomgr

COBINFDATA

Specifies the directory where Infomgr expects the data files to be located.

Syntax:
COBINFDATA: directory

where directory specifies the directory.

Default:
$COBDIR/demo
Example:
coninfdata: /u/infomgr

COBINFMENU

The menu file to be used by Infomgr.

Syntax:
COBINFMENU: filename

where filename specifies the file that contains the definition for the menu.

Comments:

filename contains the menu structure which matches the structure referenced by the COBINFDATA entry.

Default:
demomenu
Example:
coninfmenu: testmenu

PRINTCMD

The command used by Infomgr to print or display files.

Syntax:
PRINTCMD: command

where command is a UNIX print command such as pg or lp.

Default:
pg
Example:
printcmd: lp

GREPCASE

The option required to enable egrep to ignore case during search and find functions.

Syntax:
GREPCASE: option

where option can be -i or -y.

Default:

No option is set (egrep is case-sensitive).

Example:
grepcase: -y

TMPDIR

The directory to be used by Infomgr's transfer function for temporary files.

Syntax:
TMPDIR: directory

where directory is the required directory.

Comments:

This option overrides the value in the TMPDIR environment variable.

Default:
$TMPDIR
Example:
tmpdir: /tmp

TRANSCMD

The command required for Infomgr's transfer function.

Syntax:
TRANSCMD: command

where command is one of the UNIX file copying commands such as cp.

Default:
cp
Example:
transcmd: rcp -rp

TRANSDIR

The directory to be used by Infomgr's transfer function.

Syntax:
TRANSDIR: directory

where directory is the required directory.

Comments:

If no value is specified for this option the Infomgr transfer function is disabled.

Default:

Transfer function is disabled.

Example:
transdir: /tmp

USRCMD

Specifies user-defined options to Infomgr.

For example, you could use this tag to specify a menu option that enables users to use ftp to copy a demonstration program from one system to another.

Syntax:
USRCMD: menu-text,command-details [+] [@]

where the parameters are:

menu-text The text to be displayed for the menu item
command-details The command to be executed on selection of this menu item
+ Indicates that a filename is expected at this point in the command. Infomgr substitutes either the current filename, or the PRINTOPT value from the readme (.inf) file in the directory at the time the option is selected, and then executes the command.
@ Refers to the current topic if you are viewing a document that has been specially prepared and divided into topics. Only large on-line system documentation is divided in this way.
Default:

None.

Examples:
usrcmd: test Entry One,pr +
usrcmd: Test Entry two,faxit + @


Copyright © 2000 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.

PreviousGNT Analyzer Library: Command Line InterfaceNext"