Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-10
OLDFILENAME_TO_FILENAME_ Procedure
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.
Considerations
•
The output file name always includes a node name regardless of whether the input
name was in network form. Note that the node name in the output is independent
of the =_DEFAULTS DEFINE, as is the node name in the input. This is because
the default node name in an internal file name is the node that the caller is running
on, not the value in the =_DEFAULTS DEFINE.
•
If the node number that is specified as part of oldfilename does not designate a
node that is known to the local system, an
error value of 18 is returned. In this
case, the value returned in
filename includes a printable string such as “\255,”
showing the node number that was supplied as input in place of a valid node
name.
•
When converting the process file name of a named or an unnamed process,
OLDFILENAME_TO_FILENAME_ looks up the process in a system table and it
might send a system message. An error 14 is returned if the process does not
exist.
Related Programming Manual
For programming information about the OLDFILENAME_TO_FILENAME_ procedure,
refer to the
Guardian Application Conversion Guide.