Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-53
FILENAME_EDIT_
Modifies one or more parts of a file name or file-name pattern, changing them to a
specified value.
-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, INT:value input
<0:12>= Reserved (specify 0).
<13> = 1
= 0
Do not return default values; that is, if a requested part is not present in
filename but a default exists for it, return a null string instead of the
default value.
Default values can be returned.
<14> = 1
= 0
Include prefix, that is, the entire portion of filename that precedes the
part specified by level.
Do not include prefix.
<15> = 1
= 0
Include suffix, that is, the entire portion of filename that follows the
part specified by level.
Do not include suffix.
subpart, INT:value input
0 Extract all sections occurring before the period (.).
1 Extract processor for an unnamed process.
2 Extract PIN for an unnamed process.
3 Extract sequence number, of a process.
4 Extract name (begins with a dollar sign, ends at the first colon or period).
error := FILENAME_EDIT_ ( filename:maxlen
,filename-length
,piece:length
,level
,[ options ]
,[ subpart ] );