Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-7
PATHNAME_TO_FILENAME_ Procedure
length output
INT .EXT:ref:1
returns the length in bytes of the fully qualified Guardian file name returned in
filename. If error returns 563 (buffer too small) due to filename being to
small to contain the name,
length returns the actual length of the name.
info-flags output
INT .EXT:ref:1
contains additional information about the file.
info-flags is returned as a bit
mask defined as:
<0:14> Reserved
<15> = 1 The specified file is a Guardian file.
= 0 The specified file is an OSS file.
OSS Considerations
•
If the file identified by pathname is in the Guardian name space (/G), then the file
name is syntactically changed to the Guardian format without checking whether the
file exists. The local pathname of a permanent Guardian disk file has the form
/G/
volume/subvol/file-id which corresponds to the Guardian name
$
volume.subvol.file-id. Similarly, the local pathname for a temporary
Guardian disk 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.