Measure Reference Manual

Examples
• This information appears when “pathname” specifies an OSS file:
+ LISTGNAME "/Path/to/the/file"
$DATA01.ZYQ00001.Y00003D2:340359 "/Path/to/the/file"
• This information appears when “pathname” specifies an OSS directory:
+ LISTGNAME "/Path/to/the"
Directory: "/Path/to/the/Sourcefiles"
Directory: "/Path/to/the/Objectfiles"
$DATA01.ZYQ00001.Y00003D2:340359 "/Path/to/the/file"
$DATA01.ZYQ00001.Y00003D2:340223 "/Path/to/the/file1"
$DATA01.ZYQ00001.Y00003D2:340864 "/Path/to/the/file2"
• This information appears when an ANSI SQL name is specified:
+ LISTGNAME ’TABLE CATALOG_12.SCHEMA_34.TABLE_56’
$DATA01.ZSD12345.Z1234567:340259
’TABLE CATALOG_12.SCHEMA_34.TABLE_56 PARTITION PARTITION_01’
$DATA01.ZSD12345.Z1234567:340282
’TABLE CATALOG_12.SCHEMA_34.TABLE_56 PARTITION PARTITION_02’
$DATA01.ZSD12345.Z1234567:340276
’TABLE CATALOG_12.SCHEMA_34.TABLE_56 PARTITION PARTITION_03’
LISTPNAME
In Measure G09 and later PVUs, the LISTPNAME command translates a Guardian file name (gname)
and creation version serial number (CRVSN) to the corresponding OSS file pathname. The CRVSN
distinguishes a specific instance of a Guardian file name in cases of file name reuse. If the Guardian
file name specified identifies a file that is accessible through more than one path, all paths are
listed.
OSS file pathname translation is affected by the current MEASCOM session and the type of data
files being added or deleted. For examples that describe how this pathname translation is
determined, see the table in LISTGNAME (page 98).
In Measure G11 and later PVUs, LISTPNAME is still available but is superseded by LISTENAME
(page 97), which supports both OSS file pathnames and ANSI SQL names.
Syntax
LISTPNAME [ / OUT filename / ] gname [:crvsn]
OUT filename
directs command output to filename. If filename does not exist, MEASCOM creates an
EDIT file by that name and writes command output to it. If filename does exist, MEASCOM
opens the file and appends the command output to it.
gname
is the Guardian file name to be translated.
:crvsn
is the CRVSN associated with a specific instance of a gname. The CRVSN can be obtained
from the MEASCOM entity displays and is appended to the Guardian file name using a colon.
Usage Notes
• The /G form of a Guardian file name is always assumed to exist as a valid OSS file pathname.
The /G name is listed in a LISTPNAME output only if translation was through an OSS journal
segment and the access information recorded in the measurement data file indicates that the
/G form was used to access the file for a particular record.
• These warning or error messages might appear with this command:
LISTPNAME 99