Measure Reference Manual

MEASLISTPNAME
Translates a Guardian file name or an OSS pathid to its OSS file pathname equivalent. The OSS
file pathname must be valid at the time of the call. If CRVSN is specified, only a translation that
matches the specified CRVSN returns a pathname.
In Measure G11 and later PVUs, MEASLISTPNAME is still available but is superseded by
MEASLISTENAME (page 399), which supports both OSS file pathnames and ANSI SQL names.
error := MEASLISTPNAME ( dfnum ! i
,fnameorpathid ! i
,[ sysname ] ! i
,[ crvsn ] ! i
,[ pathid ] ! o
,[ pathname ] ! o
,[ pathname_max ] ! i
,[ pathname_len ] ! o
,[ index ] ); ! i,o
error
INT
is the error code indicating the outcome of the operation. Possible error codes include:
DescriptionError Code
Successful completion.0
The pathname returned exceeded the buffer size.err^buftoosmall3204
The specified file name or pathname could not be resolved.err^invalidosspath3233
A CRVSN was required but not specified.err^crvsnnotspecified3234
An OSS journal segment was required but not available.err^missingossjournal3236
The specified ANSI SQL name could not be translated.err^unknownsqlname3238
The specified ANSI SQL name contained syntax errors or was not fully
qualified.
err^badformatsqlname3239
The ANSI SQL name specified could not be parsed.err^sql^api^internal3295
dfnum
input
INT:value
is the data file access number or -1. To access the journal segment of an open Measure data
file that contains a journal segment, use the dfnum value returned by the MEASOPEN procedure.
If the data file access number is omitted, -1 is specified. If no journal segment is available for
the specified data file, but the file is from the current system, dfnum is retrieved from the OSS
file system.
fnameorpathid
input
INT .EXT:ref:12
is an array of 12 words that can contain the internal format of a local form Guardian name
of an OSS file or an internal format of an OSS pathid.
MEASLISTPNAME 409