NET/MASTER Network Control Language (NCL) Reference Manual

FILE PUT
Verbs
3–90 106126 Tandem Computers Incorporated
FILE PUT The FILE PUT verb replaces an already existing record in, or adds a new record to, a
file, a pair of files, or an operating system process.
For key-sequenced files, FILE PUT replaces an existing record, or adds a new record if
no record with that key exists. If you know you want to write a new record to a
key-sequenced file, use the FILE ADD verb.
For key-sequenced files in a pair of files, FILE PUT operates as follows:
If the record is in neither file, the record is added to the first file.
If the record is in the first file but not the second file, the record replaces the
existing record in the first file.
If the record is in the second file but not the first file, the record is added to the
first file (thereby hiding the record in the second file).
If the record is in both files, the record replaces the existing record in the first file.
For entry-sequenced files, FILE PUT adds a new record after the last existing record in
the file.
A record retrieved by a FILE GET can be rewritten to a key-sequenced file by using a
FILE PUT verb, without the need to redesignate the key.
An attempt to write a record longer than the maximum record permissible for the file
results in an error.
FILE PUT { 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 containing the 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.