Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-171
FILENAME_DECOMPOSE_ Procedure
filename:length input:input
STRING .EXT:ref:*, INT:value
specifies the valid file name or file-name pattern from which a piece is extracted.
The value of
filename must be exactly length bytes long. See caution under
“Considerations.”
piece:maxlen output:input
STRING .EXT:ref:*, INT:value
returns the extracted piece of
filename. maxlen is the length in bytes of the
string variable
piece.
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:
-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)
options input
INT:value
gives additional information about the piece of
filename to be returned. The
fields are:
<0:12> Reserved (specify 0).
<13> = 1 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.
= 0 Default values can be returned.
<14> = 1 Include prefix, that is, the entire portion of filename that precedes
the part specified by
level.
= 0 Do not include prefix.