(Page 12 of 12 in this chapter)


11.11 Utilities

The following utilities are provided with AG Access:

11.11.1 AG Access Daemon

Name

addaemon

Purpose

Allows developers to override compile-time default parameters.

Usage

addaemon [-f filename ]


filename
specifies an ASCII file which contains a statement for overriding default parameters.

Description

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

Procedure

AG Access 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. If you want to modify this file, we recommend that you make a copy of this file, and edit the copy.

To run addaemon:

addaemon [-f filename]


Use the -f option to specify the name of the parameter configuration 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).

  • To print help, enter -h.

    
    Note:	 To start the addaemon in interactive mode in UNIX, enter -i. To stop the active addaemon in UNIX, enter -s.

  • 11.11.2 AG Access Parameter Display

    Name

    adiparm

    Purpose

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

    Usage

    adiparm [options]

    where 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

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

    adiparm [-e -s structlist -f fieldlist -g]

    
     To display the parameter structure names, use the -e option. 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 12 of 12 in this chapter)


    tech_support@nmss.com
    Copyright © 1997, Natural MicroSystems, Inc. All rights reserved.