Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-17
WRITEEDIT Procedure
returns a file-system error number indicating the outcome of the operation.
Possible values include:
10 File already includes a line with the specified record number.
21 Specified record is too long to fit into EDIT packed line format. (The maximum
is 255 bytes of packed text.)
45 All of the file’s possible extents are allocated and full. You can use
EXTENDEDIT to increase the file’s extent size and call WRITEEDIT again.
filenum input
INT:value
specifies the file number of the open file to which the line is to be written.
record-number input
INT(32):value
if present, specifies the record number of the line to be written. If
record-
number:
•
is greater than or equal to 0, it specifies 1000 times the EDIT line number of
the line to be written.
•
is -1, the line is written at the beginning of the file.
•
is -2, the line is written at the end of the file.
•
is -3, the line is written to the line represented by the file’s current record
number.
If this parameter is omitted, -3 is used.
unpacked-line input
STRING .EXT:ref:*
is a string array that contains the line in unpacked format that is to be written. The
length of
unpacked-line is specified by the unpacked-length parameter.
unpacked-length input
INT:value
specifies the length in bytes of
unpacked-line. The minimum value is 0 bytes
and the maximum value is the equivalent of 255 bytes of packed text. The
maximum value of
unpacked-length is variable because the packing algorithm
depends on the number of sequences of blank characters.
full-length input
INT:value