Divert (Non-existing) Table (DV)

Divert Table to a library which does not contain the table

This command causes any subsequent store of the table to be targeted to the tableBASE library specified in the DDNAME parameter—unlike DW, DV is used when the targeted directory does not yet contain a copy of the table.

MOVE 'DV'                   TO xxxx-COMMAND.
CALL 'DK1TCALL' USING        TB-PARM
                            xxxx-COMMAND-AREA
                            DDNAME.

DDNAME

This command does not actually store the table; the store must be explicitly performed by issuing an ST command. In batch using a local TSR, if the table was opened with an OR, the DV command promotes the Table to Open for Write and allows the table to be stored. In an online interface, batch multitasking or multitasking environment such as a VTS-TSR, the table must be open for write before issuing the DV.

If the DV is not successful, the DDNAME and DSN will be blank, and the table will be treated like a new table (see Define Table (DT) Command.

Error code 40 subcode 1 occurs if the DDNAME does not exist.

None