Guardian Procedure Calls Reference Manual

OLDFILENAME_TO_FILENAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The OLDFILENAME_TO_FILENAME_ procedure converts a file name in the C-series internal file-name
format to a file name in the D-series file-name format. See Appendix D: File Names and Process
Identifiers for descriptions of C-series and D-series file names.
Syntax for C Programmers
#include <cextdecs(OLDFILENAME_TO_FILENAME_)>
short OLDFILENAME_TO_FILENAME_ ( short *oldfilename
,char *filename
,short maxlen
,short *filename-length );
Syntax for TAL Programmers
error := OLDFILENAME_TO_FILENAME_ ( oldfilename ! i
,filename:maxlen ! o:i
,filename-length ); ! o
Parameters
oldfilename
input
INT .EXT:ref:12
specifies a valid internal file name to be converted.
filename:maxlen
output:input
STRING .EXT:ref:*, INT:value
contains the resulting file name. maxlen specifies the length in bytes of the string variable
filename.
filename-length
output
INT .EXT:ref:1
returns the actual byte length of the file name returned in filename. 0 is returned if an error
occurs.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
OLDFILENAME_TO_FILENAME_ Procedure 893