Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Language Reference Manual

Stream-oriented data transmission

Data transmission statements
GET statement
PUT statement
Options of data transmission statements
COPY option
Data specification options
FILE option
LINE option
PAGE option
SKIP option
STRING option
Transmission of data-list items
Data-directed data specification
Restrictions on data-directed data
Syntax of data-directed data
GET data-directed
PUT data-directed
Edit-directed data specification
GET edit-directed
PUT edit-directed
FORMAT statement
List-directed data specification
Syntax of list-directed data
GET list-directed
PUT list-directed
PRINT attribute
DBCS data in stream I/O

This chapter describes the input and output statements used in stream-oriented data transmission. Features that apply to stream-oriented and record-oriented data transmission, including files, file attributes, and opening and closing files, are described in Input and output.

Stream-oriented data transmission treats a data set as a continuous stream of data values in character, graphic, or mixed character data form. Within a program, record boundaries are generally ignored. However, a data set consists of a series of lines of data, and each data set created or accessed by stream-oriented data transmission has a line size associated with it. In general, a line is equivalent to a record in the data set, but the line size does not necessarily equal the record size.

The stream-oriented data transmission statements can also be used for internal data movement, by specifying the STRING option instead of specifying the FILE option. Although the STRING option is not an input/output operation, its use is described in this chapter.

Stream-oriented data transmission can be list-directed, data-directed, or edit-directed.

List-directed data transmission
transmits the values of data-list items without your having to specify the format of the values in the stream. The values are recorded externally as a list of constants, separated by blanks or commas.
Data-directed data transmission
transmits the names of the data-list items, as well as their values, without your having to specify the format of the values in the stream. The GRAPHIC option of the ENVIRONMENT attribute must be specified if any variable name contains a DBCS character, even if no DBCS data is present.
Edit-directed data transmission
transmits the values of data-list items and requires that you specify the format of the values in the stream. The values are recorded externally as a string of characters or graphics to be treated character by character (or graphic by graphic) according to a format list.

The following sections detail the data transmission statements and their options, and how to specify the list-, data-, and edit-directed data. How to accommodate double-byte characters is discussed in DBCS data in stream I/O.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)