Guardian Procedure Calls Reference Manual

FILENAME_TO_PATHNAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
OSS Considerations
Example
Related Programming Manual
Summary
The FILENAME_TO_PATHNAME_ procedure converts a Guardian file name or subvolume name
to an OSS pathname. See Appendix D: File Names and Process Identifiers for a descriptions of
OSS pathname syntax.
Syntax for C Programmers
#include <cextdecs(FILENAME_TO_PATHNAME_)>
short FILENAME_TO_PATHNAME_ ( const char *filename
,short length
,char *pathname
,short maxlen
,short *pathlen
,[ short options ]
,[ short *index ] );
Syntax for TAL Programmers
error := FILENAME_TO_PATHNAME_ ( filename:length ! i:i
,pathname:maxlen ! o:i
,pathlen ! o
,[ options ] ! i
,[ index ] ); ! i,o
Parameters
filename:length
input:input
STRING .EXT:ref:*, INT:value
specifies the name of the file or subvolume to be converted. To indicate that filename contains
a subvolume name, use the options parameter. The value of filename must be exactly
length bytes long, and it must be a valid disk file name. If the name is partially qualified, it
is resolved using the contents of the VOLUME attribute of the =_DEFAULTS DEFINE.
pathname:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the null-terminated OSS pathname that corresponds to the Guardian filename.
maxlen specifies the maximum length in bytes of pathname, including the terminating null
character.
596 Guardian Procedure Calls (F)