Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-213
FILENAME_UNRESOLVE_ Procedure
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
longname:length input:input
STRING .EXT:ref:*, INT:value
contains the valid file name or file-name pattern to be acted upon by
FILENAME_UNRESOLVE_. The value of
longname must be exactly length
bytes long. See caution under “Considerations.”
shortname:maxlen output:input
STRING .EXT:ref:*, INT:value
defines the buffer where the resultant file name is to be placed. This buffer can
occupy the same area as
longname. The length of the resultant name is never
greater than the length of
longname.
maxlen is the length in bytes of the string variable shortname.
shortname-length output
INT .EXT:ref:1
returns the length in bytes of the name returned in
shortname. If an error occurs,
0 is returned.
level input
INT:value
specifies the first part of the file name, scanning from the left, that should be
returned even if it matches the default name. Name parts of this level and greater
are always returned if they are present in
longname. If omitted, the default level is
0 (that is, no more than the node name is to be removed). Valid values are:
-1 Node name
0 Destination name (for example, volume, device, or process)
1 First qualifier (for example, subvolume)
2 Second qualifier (file identifier if disk file)
defaults:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0, specifies either a subvolume name to be used
as the default subvolume name or the name of a CLASS DEFAULTS DEFINE.