(Page 3 of 6 in this chapter)


5.2 Command Line Use and Options

This section describes the agmon command line options for each operating system.
Option

Platform

Description

-a

Windows NT

OS/2

Parallel load. Loads all MVIP clock masters in parallel, then loads remaining boards in parallel.

-b

UnixWare

SCO

Solaris

Background. Executes agmon as a daemon process. This is useful when agmon is invoked during your system's initialization by the init process.

-c

UnixWare

SCO

Check/configure AG device drivers. Checks the AG boards' hardware configuration as defined in the AG configuration file for:

· Consistency with your UNIX system configuration

· Hardware conflicts with other devices configured in your system

agmon adds the AG device drivers to your UNIX system configuration if it finds that they are not a part of the system configuration. agmon also updates the drivers' configurations if an inconsistency with your UNIX system configuration is detected. The -c command line option must be specified when:

· The AG device drivers are first added to your UNIX system configuration

· An AG board is added to your system

· An AG board is removed from your system

· The interrupt shared by the AG boards in your system is changed

· The I/O address of an AG board is changed

-d level

Windows NT

OS/2

UnixWare

SCO

Solaris

Diagnostic level. Defines the relative degree of diagnostics run when the boards are initialized. The -d command line option has precedence over the Diagnostics statement in your AG configuration file. level can be one of the following values:

0 - No diagnostics

1 - Minimal diagnostics

2 - Moderate diagnostics (default)

3 - Maximum diagnostics

-e filename

Windows NT

OS/2

UnixWare

SCO

Solaris

Error log file. Specifies the file to which errors are logged. If a directory is not specified in filename, the current working directory is used. Errors that occur are displayed by agmon on the screen and appended to the error log file. The default error log file is:

Windows NT, OS/2: .\agerror.log

UNIX: /var/opt/nms/ag/agerror.log

-f filename

Windows NT

OS/2

UnixWare

SCO

Solaris

AG configuration file. Defines filename as the AG configuration file.

Windows NT & OS/2:

If a directory is not specified in filename, agmon searches for filename in the current working directory and then in the directories specified in the AGLOAD environment variable. The default AG configuration file is ag.cfg

UnixWare, SCO, & Solaris:

If a directory is not specified in filename, agmon searches for filename in the current working directory and then in the directory /opt/nms/ag/cfg. The default AG configuration file is/opt/nms/ag/cfg/ag.cfg

-l

Windows NT

OS/2

UnixWare

SCO

Load only. agmon exits after checking the configuration and loading the AG boards. The exit code is 0 if all boards load successfully; otherwise, it is non-zero

-m

Windows NT

OS/2

UnixWare

SCO

Solaris

Monitor only. agmon does not attempt to reset or load any boards, but enters the monitor mode immediately. Any AG error messages that occur after agmon startup are displayed on the screen and written to the error log file.

-r

UnixWare

SCO

Remove AG device drivers. Removes the AG device drivers from your UNIX system configuration.

-s

Windows NT

OS/2

UnixWare

SCO

Solaris

Shutdown only. agmon shuts down another instance of the monitor if there is another running instance. agmon does not load or monitor the AG boards, but exits immediately.

-z size

UnixWare

SCO

Solaris

Coprocessor software download size. Defines how to partition the AG coprocessor software for downloading. The size of each partition is size bytes. The default partition size is 29952 bytes.

-?

Windows NT

OS/2

UnixWare

SCO

Solaris

Help. Displays a summary of command line options.



(Page 3 of 6 in this chapter)


Tech_Support@nmss.com
Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.