Guardian Procedure Calls Reference Manual
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 is 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:
Node name-1
Destination name (for example, volume, device, or process)0
First qualifier (for example, subvolume)1
Second qualifier (file identifier if disk file)2
defaults:defaults-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if defaults-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. The contents of
defaults are compared with longname to perform the unresolved operation.
If used, the value of defaults must be exactly defauts-length bytes long and must be
in this form:
[[\node.]$volume.]subvolume
Omitted name parts are taken from the =_DEFAULTS DEFINE.
If this parameter is omitted or if defaults-length is 0, the value of the VOLUME attribute
of the =_DEFAULTS DEFINE is used.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
FILENAME_UNRESOLVE_ Procedure 603