Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-175
FILENAME_EDIT_ Procedure
Parameters
error returned value
INT
returns a file-system error number indicating the outcome of the operation.
filename:maxlen input, output:input
STRING .EXT:ref:*, INT:value
on input, is the file name or file-name pattern to be edited; on output, contains the
edited version of the file name or file-name pattern. The input must be a valid file
name or valid file-name pattern; it must not be a DEFINE name. Refer to
Appendix D, File Names and Process Identifiers
for the definitions of file name and
file-name pattern. See caution under “Considerations.”
maxlen is the length in bytes of the string variable filename.
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:
-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)