8.8 Utilities

 (Page 9 of 12 in this chapter)
The following utilities are provided with the AG Access development kit:

8.8.1 AG Access Daemon

Name: addaemon

Purpose: Allows developers to override compile-time default parameters.

Usage: addaemon [options]

where the options are:

Option

 Description

-f filename

 Specifies an ASCII file containing a statement for overriding default parameters.

Description:

The addaemon reads parameter assignment statements from an ASCII file and writes them to system shared memory. Any processes started after the daemon will retrieve the default function parameters from the shared memory instead of from the process data area.

Procedure:

Your AG Access package is shipped with a configuration file containing the compile-time defaults in ASCII format. This file is named sample.cfg and is located in a system dependent directory. It is recommended that you copy this file and edit the copy.

The daemon accepts the name of a parameter configuration file. When starting the daemon, use the -f option to specify the name of the file. If you omit the -f option, the daemon looks for a file named adi.par (OS/2 and Windows NT) in the current directory or \opt\nms\agaccess\cfg\adi.par (Unix).

8.8.2 AG Access Parameter Display

Name: adiparm

Purpose: Displays selected parameter definitions and values stored in shared memory from addaemon.

Usage: adiparm [options]

where the options are:

Option

 Description

-e

Displays the names of all parameter structures.

-s structlist

 Displays all parameters in listed structures.

-f fieldlist

Displays all parameters matching listed field names.

-g

Generates a parameter file from the current values.

Description:

The adiparm utility reads parameters stored in system shared memory and displays them on the screen. You specify which parameter to retrieve on the command line.

Procedure:

To display the parameter structure names, use the -e option when running the program. The structure names displayed on the screen can then be used with the
-s option to display all parameters for a given structure. The lists generated by the -s and -f options are delimited by the `+' (plus) character. For example: 

		adiparm -s adiplay+adirecord
		adiparm -f gain+abort
Note:

If the AG Access daemon is running, the parameters displayed are those resident in system shared memory; otherwise, they are the compile-time defaults.

(Page 9 of 12 in this chapter)

Copyright 1996 Natural MicroSystems, Inc. All Rights Reserved.