# User-specified product directory search: nmssearch

Use this utility to search a user-specified root directory and display a list of installed NMS products.

#### Usage

nmssearch [options]

where options are:

Option | Use this option to...
--- | ---
-h | Access Help.
directory | Display the NMS product name and version number for each associated file in the specified root directory.
-f filename directory | Display the NMS product name and version number for each file that matches the specified file name and root directory. For the utility to locate the file, the file must be in the same directory in which it was originally installed. Note: When entering a file name, enter just the name of the file, not a complete path.
-p product directory | Display the NMS product name and base version number followed by version information on all existing product files installed in the specified root directory. To exclude non-NMS files from the display, enter the following command line: nmssearch [options] | grep -v "not NMS file"

#### Description

Each Natural Access product contains a signature file (.sgn) that lists each file associated with the product. A signature of checksum information and a full path uniquely identify each associated file.

nmssearch uses the signature file to display the name and version information of product files that are on your system. For example, ctaccess.sgn lists 100 files. To access information for the files on your system, enter the following command at the prompt:

nmssearch -p ctaccess \nms\bin

nmssearch displays information for the 75 files on your system in the Windows \nms\bin root directory.

If you request information on a product file that does not match any file listed in the signature file, you receive one of the following error messages:

Error message | Meaning
--- | ---
unknown | The file for which you requested information is located on your system. Although the path of the file matches the path in the signature file, the checksum information does not match.
not NMS file | The file for which you requested information exists on your system, but it is not listed in any signature file. Ensure that the file is in its original installation directory.
file not found | The file for which you requested information does not exist on your system.

#### Procedure

To run nmssearch, enter the following command at the prompt:

nmssearch [option]

For example, if you enter the following command with a UNIX root directory name of /opt/nms/bin:

nmssearch /opt/nms/bin

nmssearch lists the NMS product names and version numbers for each of the associated files in the /opt/nms/bin root directory.

Note: For UNIX systems, run this utility as super user.