Guardian Procedure Calls Reference Manual

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
if present and not equal to 0, specifies that all trailing space characters (if any) in the line being
processed are retained in the output line image. Otherwise, trailing space characters are
discarded.
new-record-number
output
INT(32) .EXT:ref:1
returns the record number of the newly written line. This value is 1000 times the EDIT line
number of the line.
Returned Value
INT
A file-system error code that indicates the outcome of the call. Possible values include:
File already includes a line with the specified record number.10
Specified record is too long to fit into EDIT packed line format. (The maximum is 255 bytes of packed text.)21
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.
45
1500 Guardian Procedure Calls (W-Z)