Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-67
FNAMETOFNAME32
(obsolete) Converts a file name from the 12-word Guardian format to the 32-character
Distributed Name Service format.
FORMATCONVERT[X]
Converts the external format to the internal form required for presentation to the
FORMATDATA[X] procedures.
[0:3] default volname. First two bytes can be “\sysnum,” in which case “$” is
omitted from volume name. (blank-filled on right).
[4:7] default subvolname (blank-filled on right).
[0:7] corresponds directly to word[1:8] of the command interpreter startup message.
status := FNAMETOFNAME32 ( fname ,fname32 );
status, INT returned value
-1 The file name was successfully converted.
0 The file name cannot be converted, or an error occurred.
fname, STRING .EXT:ref:24 input
fname32, STRING .EXT:ref:32 output
status := FORMATCONVERT[X] ( iformat
,iformatlen
,eformat
,eformatlen
,scales
,scale-count
,conversion );
status, INT returned value
> 0 Successful conversion. The value is the number of bytes in the converted format
(iformat).
= 0 The value of iformatlen was insufficient to hold the entire converted format.
< 0 Error in the format. The value is the negated byte location in the input string at
which the error was detected. The first byte of eformat is numbered 1.