Guardian Procedure Calls Reference Manual

piece-length
output
INT .EXT:ref:1
returns the length in bytes of the extracted piece of filename. If an error occurs, 0 is returned.
level
input
INT:value
specifies a part of filename. Together with options and subpart, it defines the piece of
filename to be returned. 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
provides additional information about the piece of filename to be returned. The fields are:
Reserved (specify 0).<0:12>
Do not return default values; that is, if a requested part is not present in filename but a default
value exists for it, return a null string instead of the default value.
= 1<13>
Default values can be returned.= 0
Include prefix, that is, the entire portion of filename that precedes the part specified by level.= 1<14>
Do not include prefix.= 0
Include suffix, that is, the entire portion of filename that follows the part specified by level.= 1<15>
Do not include suffix.= 0
The default value is 0.
subpart
input
INT:value
specifies a single section to be extracted from the level 0 (destination) part of filename. 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:
Extract whole destination, that is, all sections occurring before the period (.).0
Extract processor, that is, the numeric part designating the processor for an unnamed process.1
Extract PIN, that is, the numeric part that gives the process identification number for an unnamed process.2
Extract sequence number, that is, the numeric part that gives the sequence number of a process.3
Extract name, that is, the alphanumeric section that begins with a dollar sign and ends at the first colon
or period.
4
The default value is 0.
You should specify a nonzero value for subpart only when level is 0 and bits 14 and 15
(extract prefix and extract suffix) of options are 0.
FILENAME_DECOMPOSE_ Procedure 567