PMDF System Manager's Guide
PMDF-REF-6.0

Find specified version of a PMDF log file.

Syntax

pmdf find file-pattern

Command Qualifiers	Defaults
-f=offset-from-first	None
-l=offset-from-last	None

restrictions

Must have read access to the requested file.

PARAMETERS

file-pattern

A file name pattern for which PMDF log file to find.

DESCRIPTION

The pmdf find utility may be used to find the precise file name of the specified "version" of a PMDF file. PMDF log files have a -uniqueid appended to the file name to allow for the creation of multiple "versions" of the log file; on UNIX, the -uniqueid is appended to the very end of the file name (the end of the file extension), while on NT, the -uniqueid is appended to the end of the name part of the file name, before the file extension. The pmdf find utility understands these unique ids and can find the particular file name corresponding to the requested "version" of the file.

The default, if no offset qualifier is specified, is to find the most recent "version" of the file.

COMMAND QUALIFIERS

-f=offset-from-first

This qualifier is used to specify finding the nth "version" of the file (starting counting from 0). For instance, to find the earliest (oldest) "version" of the file, specify -f=0

-l=offset-from-last

This qualifier is used to specify finding the nth from the last "version" of the file (starting decrementing from 0 as the most recent version). For instance, to find the most recent (newest) "version" of the file, specify -l=0

EXAMPLES

# pmdf find /pmdf/log/tcp_local_slave.log

This UNIX command will print out the file name of the /pmdf/log/tcp_local_slave.log-uniqueid file most recently created.

# pmdf find /pmdf/log/tcp_bitnet_master.log -f=0

This UNIX command will display the file name of the oldest /pmdf/log/tcp_bitnet_master.log-uniqueid file.

C:\> pmdf find C:\pmdf\log\tcp_local_slave.log

This NT command will print out the file name of the C:\pmdf\log\tcp_local_slave-uniqueid.log file most recently created.

C:\> pmdf find \pmdf\log\tcp_bitnet_master.log -f=0

This NT command will display the file name of the oldest C:\pmdf\log\tcp_bitnet_master-uniqueid.log file.