NET/MASTER Network Control Language (NCL) Reference Manual

FILE ADD
Verbs
106126 Tandem Computers Incorporated 3–69
FILE ADD The FILE ADD verb adds a record to a file pair of files, or to an operating system
process.
For key-sequenced files, FILE ADD attempts to add the record as a new record. If a
record of the same key already exists, the operation fails. For key-sequenced files in a
pair of files, FILE ADD attempts to add the record as a new record in the first file only:
the second file is a read-only file. If the record is in neither file, the record is added;
otherwise, the FILE ADD operation fails.
For entry-sequenced files, FILE ADD adds a new record after the last existing record
in the file.
FILE ADD { ARGS [ RANGE=( start , end ) ] [ SEGMENT= n ] |
DATA= text |
MDO= mdo-name [ HEADER={ NO | YES } ] |
VARS={ output-vars-list | variable * }
[ RANGE=( start , end ) ]
[ SEGMENT= n ] }
[ ID= fileid ]
[ KEY= keydata ]
[ PRTCNTL={ [ SKIP0 | SKIP1 |SKIP2 | SKIP3 |
NEWPAGE ]
[, USCORE1 |, USCORE2 ]
[, LEFT |, RIGHT |, CENTER ]
[, BOLD ] } ]
ARGS
specifies a range of variables that is used for data. See “Frequently Occurring
Operands,” at the beginning of this section, for more information. You can cause
an error if you exceed the maximum record size by specifying too many variables.
RANGE=( start , end )
determines the range of variables specified by the ARGS operand. See
“Frequently Occurring Operands,” at the beginning of this section, for more
information.
SEGMENT= n
specifies the amount of data (in bytes) to be put into the variables specified.
For mapped or delimited files, the default value is 32000. For unmapped files,
the default value is 256. You can specify a value from 1 through 32000.
DATA= text
contains the text to be added to the file. For unmapped files, the text makes up the
whole record. For mapped $NCL or delimited files, the text becomes the first