Guardian Procedure Calls Reference Manual

FNAME32COLLAPSE 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 FNAME32COLLAPSE procedure converts the 32-character file name used by the Distributed
Name Service to external format for display.
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
length := FNAME32COLLAPSE ( intname ! i
,extname ) ! o
Parameters
intname
input
STRING .EXT:ref:32
is a 32-character array containing a subsystem object name in the form:
\sysname$volume subvol file-id
extname
output
STRING .EXT:ref:35
on return, contains the external form of intname:
\sysname.$volume.subvol.file-id
Returned Value
INT
The length (in bytes) of extname, or 0 if an error occurred.
Considerations
• The caller must pass a valid subsystem object name in intname. Invalid names cause
unpredictable results.
• If a parameter is missing or a bounds error occurs on a parameter, length will contain 0.
FNAME32COLLAPSE Procedure (Superseded) 623