NET/MASTER Network Control Language (NCL) Reference Manual

FILE PUT
Verbs
106126 Tandem Computers Incorporated 3–93
The options available are shown in the following table:
Category Option Description
Paper Movement SKIP0 Paper not advanced before the record is written.
SKIP1 Paper advanced one line before the record is written.
SKIP2 Paper advanced two lines before the record is written.
SKIP3 Paper advanced three lines before the record is written.
NEWPAGE Skip to a new page before the record is written.
Underscore Options USCORE1 Text of this record (excluding blanks) underlined with an
underscore (_) character.
USCORE2 Text of this record (including blanks) underlined with an
underscore (_) character.
Text Alignment LEFT Text of the record aligned to the left edge of the paper.
RIGHT Text of the record aligned to the right edge of the paper.
CENTER Center the text of this record. The record width, and
therefore the location of the center, is determined from
the logical record length of the file.
Bold Print BOLD Print the text in bold (overstrike) print.
Considerations
The &SYS.FILE.RC system variable reflects the result of all file operations within
NCL. NCL sets this variable on completion of the FILE PUT verb, as follows:
Return Code Meaning
0 Record added or updated successfully.
4 Record not added or updated because a duplicate alternate key exists.
8 A file system error occurred during processing. Further information is contained
in the &SYS.FILE.ERROR system variable.
12 Not used.
16 An error occurred. Further information is contained in &SYSMSG.
It is the user’s responsibility to test the &SYS.FILE.RC system variable for errors.
There is an implicit resumption of the NCL procedure after any errors, unless the
user has coded an error handler for the FILE_ERROR condition. See the core
statements ON and RESUME in Section 2, “Core Statements.”
For return codes other than 0 (zero) and 4, the FILE_ERROR condition is signalled.
This condition can be trapped (or intercepted) by an error handler.
See also FILE ADD, FILE OPEN, FILE GET, and FILE SET.
When reading files that are described by user-defined maps, NCL converts data
from an internal to an external format. A conversion takes place in the opposite
direction when such files are written. For more information on user-defined maps,
and on the data conversion that occurs when a FILE verb is used to process files
described by user-defined maps, refer to the NonStop NET/MASTER NCL
Programmer's Guide.