Guardian Procedure Calls Reference Manual

FNAMETOFNAME32 Procedure (Superseded)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The FNAMETOFNAME32 procedure converts a file name from the 12-word internal format to the
32-character Distributed Name Service (DNS) format.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
status := FNAMETOFNAME32 ( fname ! i
,fname32 ); ! o
Parameters
fname
input
STRING .EXT:ref:24
is the name to be converted. The array must contain a valid file name in 12-word internal
format.
fname32
output
STRING .EXT:ref:32
on return, contains the file name in DNS format. If a status of 0 (zero) is returned, the contents
of this array have not been modified by the procedure.
Returned Value
A status value that indicates the outcome of the call:
File name successfully converted.-1
File name cannot be converted, or an error occurred.0
Considerations
• If fname is in network format and the system number specified is not currently defined to the
network, FNAMETOFNAME32 returns 0 to indicate that the file name cannot be converted.
• If a parameter is missing or a bounds error occurs on a parameter, 0 is returned.
FNAMETOFNAME32 Procedure (Superseded) 621