Relational Data Framework Reference › OPS/REXX Programs › READTBL Program—Read Backup Data Set

READTBL Program—Read Backup Data Set

The READTBL OPS/REXX program reads the backup data set created by the WRITETBL program and rebuilds the table on the target CA OPS/MVS system using the data from the data set. If you want, you can use the TABLE keyword to give the reconstructed table a new name.

To invoke the READTBL program, issue the following command:

OI READTBL
[CMDRESP(TERMINAL|XDQ)]
[DSNAME(datasetname)]
[FIND(tablename)]
[LIST]
[SUBSYS(subsystem)]
[TABLE(tablename)]

You may specify these keywords when invoking the READTBL program:

CMDRESP

(Optional) Possible values:

TERMINAL

Causes messages to be issued to the terminal or default destination.

XDQ

Causes messages to be placed in the REXX external data queue.

Default: TERMINAL

DSNAME

(Optional) Defines the name of the backup data set. To specify the full data set name, enclose the name with a pair of single quotes, as shown in the following example. If you omit the quotes, the user ID becomes the high-level node.

DSNAME('OPS.BACKUP.STCTBL')

The backup data set must have the attributes DSORG=PS, RECFM=FB, LRECL=80. In addition, WRITETBL must have been used to offload the table into this data set.

If you specify no data set name, the CA OPS/MVS product uses the default name userid.subsys.WRITETBL.

FIND

(Optional) Backup data set is searched for a matching table name. If found, the table is recreated.

LIST

(Optional) Read a backup data set and issue a message for each table name found.

SUBSYS

(Optional). Defines the subsystem name of CA OPS/MVS that contains the desired table.

TABLE

(Optional) Defines the name of the recreated table.

Default: The original name of the table.