Guardian Procedure Calls Reference Manual

file has the form /G/volname/#number which corresponds to the Guardian name
$volume.#number. The conversion takes place as follows:
◦ The initial "/G/" is removed.
◦ The remaining slash separators (/) are replaced by periods.
◦ If the current directory symbol (.) is part of the pathname it is safely ignored.
◦ If the parent directory symbol (..) is part of the pathname, the first element to the left is
deleted.
◦ A leading dollar sign ($) is added for part of the Guardian volume name.
◦ Any period (.), hyphen (-), or underscore (_) characters within pathname elements are
deleted.
◦ Name elements are truncated to eight characters after the ".", "-", and "_ characters are
deleted.
• No timestamps are updated as a result of this procedure.
• Two additional file numbers might be allocated: one for the OSS root directory and one for
the OSS current working directory. These files are not necessarily the next available file
numbers and they cannot be closed by calling FILE_CLOSE_.
• A current OSS working directory is established from the value of the VOLUME attribute of the
=_DEFAULTS DEFINE.
• The resident memory used by the calling process increases by a small amount.
Example
ret = PATHNAME_TO_FILENAME_(
argv[1], /* OSS Pathname */
filename, /* Guardian file name buffer */
64, /* size of file name buffer */
&fileln,, /* length of file name */
&status); /* if = 1, Guardian file (/G)
if = 0, OSS file */
Related Programming Manual
For programming information about the PATHNAME_TO_FILENAME_ procedure, see the Open
System Services Programmer's Guide.
936 Guardian Procedure Calls (P)