Guardian Procedure Calls Reference Manual

filename-length
input, output
INT .EXT:ref:1
on input, is the length in bytes of the name to be edited; on output, is the length in bytes of the
edited version of the file name.
piece:length
input:input
STRING .EXT:ref:*, INT:value
specifies the string that is to replace the portion of filename that is indicated by the parameters
that follow. If used, the value of piece must be exactly length bytes long. If length is 0,
the indicated portion of filename is deleted. See Considerations.
level
input
INT:value
specifies a part of filename. Together with options, it defines the section of filename
that is to be replaced. 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
options
input
INT:value
gives additional options. If omitted, the default value is 0. The fields are:
Reserved (specify 0).<0:13>
Remove filename prefix, that is, the entire portion of filename that precedes the part specified
by level.
= 1<14>
Do not remove prefix.= 0
Remove filename suffix, that is, the entire protion of filename that follows the part specified
by level.
= 1<15>
Do not remove suffix.= 0
subpart
input
INT:value
specifies a single section of the level 0 (destination) part of filename to be replaced. This
parameter applies only to process file names because only a process file name can have a
level 0 part with multiple components. Valid values are:
Replace whole destination, that is, all sections occurring before the period (.).0
Replace processor, that is, the numeric part designating the processor for an unnamed process.1
Replace PIN, that is, the numeric part that gives the process identification number for an unnamed process.2
Replace sequence number, that is, the numeric part that gives the sequence number of a process.3
570 Guardian Procedure Calls (F)