See EXECIO Example 6 under the heading Figure 7 on page 168, which shows the
usage of the EXECIO command with stem variables.
Return Codes from EXECIO
After an EXECIO command runs, it sets the REXX special variable "RC" to a return
code. Valid return codes from EXECIO are:
Return Code Meaning
0 Normal completion of requested operation.
1 Data was truncated during DISKW operation.
2 End-of-file reached before the specified number of lines were read
during a DISKR or DISKRU operation. (This return code does not occur
when * is specified for number of lines because the remainder of the file
is always read.)
4 An empty data set was found within a concatenation of data sets during
a DISKR or DISKRU operation. The file was not successfully opened
and no data was returned.
20 Severe error. EXECIO completed unsuccessfully and a message is
issued.
When to Use the EXECIO Command
The various operands and combination of operands of the EXECIO command
permit you to do many types of I/O. For example, you can use the EXECIO
command to:
v Copy information from one data set to another
– Copy an entire data set
– Copy parts of a data set
– Add information to the end of a sequential data set
v Copy information to and from a list of compound variables
v Update information in a data set
Copying Information From One Data Set to Another
Before you can copy one data set to another, the data sets must be either
sequential data sets or members of a PDS, and they must be pre-allocated.
Following are examples of ways to allocate and copy data sets using the EXECIO
command.
Copying an entire data set: To copy an entire existing sequential data set named
'USERID.MY.INPUT' into a new sequential data set named 'USERID.NEW.INPUT',
and to use the ddnames DATAIN and DATAOUT respectively, you could use the
following instructions. (Remember that when the first qualifier of a data set name is
your prefix (usually your user ID), you can omit the first qualifier.)
Using EXECIO to Process Information ...
Chapter 12. Processing Data and Input/Output Processing 159
To Next Page
Need help?
General
