GNT Analyzer

Library: Command Line Interface

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:

• View, print, and execute the demonstration programs
  
  
• Copy the demonstration programs to different directories
  
  
• Start Animator
  
  
• Run script files and interactive shells

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 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:

• Use the arrow keys to move up and down through the menu list, and then press Enter
  
  
• Press a number that corresponds to the topic you want to select

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:

• The Transfer option enables you to transfer the demonstration programs to the directory specified in the configuration file. See the section Configuring Infomgr for details.
  
  
• The Compile option enables you to compile the demonstration programs. This might not be available for all demonstration programs. Before you compile demonstration programs you should use the Transfer option to transfer them to a working directory, as Infomgr does not allow you to compile programs in the demonstration directory.

9.4 Configuring Infomgr

You can configure the behavior of Infomgr using 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:

• The global file $COBDIR/mfcobolrc
  
  
• The local file called .mfcobolrc that should be stored in your home directory

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:

cobinfdir: /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:

cobinfdata: /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:

cobinfmenu: 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:

Default:

None.

Examples:

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

GNT Analyzer

Library: Command Line Interface