Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-208
FILENAME_TO_PATHNAME_ Procedure
options input
INT:value
specifies options for the
filename parameter:
<0:12> Reserved (specify 0).
<13> 1 If the caller has appropriate privileges, specifies that pathname is
an absolute pathname with respect to the system root.
0 Specifies that
pathname is an absolute pathname with respect to
the current root of the process.
<14> 1 Specifies that pathname always includes the system name in the
form /E/system/path.
0 Specifies that
pathname includes system names only for remote
pathnames; that is, local pathnames do not start with “/E.”
<15> 1 Specifies that a subvolume name be accepted as valid input.
0 Specifies that a the input must be a file name.
The default value is 0.
index input,output
INT .EXT:ref:1
specifies the index of the link to the named file to be returned in
pathname.
Specifying a value of -1 finds only the first accessible path. Specifying a value of 0
starts a search for all possible pathnames.
index returns the index to the next pathname to the file. A value of -1 on return
indicates that
pathname contains the last (or only) name for the file.
The default value is -1.
OSS Considerations
•
If the supplied Guardian file name is not the Guardian file name of an OSS file,
pathname returns an absolute pathname of the form:
/G[/volume[/subvolume[/file-id]]]
•
The number of components in the pathname is the same as the number in the
Guardian file name plus the /G prefix.
•
volume, if present, is derived from the Guardian volume name by removing
the dollar sign ($).
•
subvolume, if present, is the Guardian subvolume name, including any
preceding pound sign (#).