PUTS
Write sequential fixed-length data
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
PUTS(channel, data_area[, label]) [[error_list]]
Arguments
channel
The channel to which you want to write the data. The channel must already have been opened in output, append, or update mode with no submode specified. (n)
On OpenVMS, the channel must be open to a file that has a stream record format, or be opened to a serial or terminal device.
data_area
An expression whose contents are to be transmitted. The size of the result of the expression determines how many characters are output. For example, an a623 variable sends the next 623 characters. (a)
label
(optional) The label to which control is transferred if the output device is full.
error_list
(optional) An I/O error list. If any one of the specified errors occurs during the PUTS, control is transferred to the associated label.
Discussion
The PUTS statement writes the specified data area’s next sequential fixed-length record to a channel. It does not interpret the data being transmitted. It assumes that each character is an 8-bit binary value.
During PUTS processing, record terminators are not automatically attached or stripped.
When using xfServer, setting the SCSPREFETCH environment variable turns on record buffering for the PUTS statement. See SCSPREFETCH for more information.
Examples
The examples below use the following data division.
record area1 ,a38 area2 ,a1967 area3 ,a5
The following example sends the five bytes contained in area3 to the specified channel. Since PUTS performs sequential access, the output begins at the current position in the file.
puts(CHN, area3)
The next example outputs a 1967-byte record to the file opened on CHN. If an error is trapped, control immediately transfers to the statement lbl1.
puts(CHN, area2) [err=lbl1]