NET/MASTER Network Control Language (NCL) Reference Manual

FILE PUTGET
Verbs
106126 Tandem Computers Incorporated 3–95
FILE PUTGET The FILE PUTGET verb puts records into and gets records from a Guardian process.
The records sent to or from the operating system process are sent as messages,
constructed from variables or a string of text specified by the DATA operand. The
message that the operating system process returns is read into the variables specified
in the VARS, ARGS, or MDO operand.
An end-of-file indicator (EOF) is generated by the operating system process when
there is no more data. NCL acknowledges the EOF by setting the return code,
&SYS.FILE.RC, to 4.
FILE PUTGET { 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 ]
TO
{ ARGS [ RANGE=( start , end ) ] [ SEGMENT= n ] |
MDO= mdo-name [ HEADER={ NO | YES } ] |
VARS={ input-vars-list | variable* }
[ RANGE=( start , end ) ]
[ SEGMENT= n ] }
ARGS
specifies a range of variables supplying data for the PUT portion of the FILE
PUTGET operation. 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.