Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-205
FILENAME_TO_OLDFILENAME_ Procedure
oldstyle-name output
INT .EXT:ref:12
returns the internal-format file name.
Considerations
•
The process file name of an unnamed process can be converted if it has a PIN of
255 or less.
•
If filename contains a node name or if the default node name is remote,
oldstyle-name is normally returned in internal network form. Otherwise,
oldstyle-name is in internal local form.
An exception occurs when an 8-character destination name (for example,
“$LONGDEV”) is supplied as part of
filename. Such a name is converted
without error into internal local form if the local node is explicitly designated in
filename or in the =_DEFAULTS DEFINE (if filename does not contain a node
name). Otherwise error 20 is returned.
Example
error := FILENAME_TO_OLDFILENAME_ ( fname:length,
oldstylename );
Related Programming Manual
For programming information about the FILENAME_TO_OLDFILENAME_ procedure,
refer to the
Guardian Application Conversion Guide.
Caution. Passing an invalid file name to this procedure can result in a trap, a signal, or data
corruption. To verify that a file name is valid, use the FILENAME_SCAN_ procedure.