FILEOUT (Define Output Data Sets) › FILEOUT › How to Use

How to Use

Multi-User mode is required to execute this command. Execute the FILEOUT function using the following command format:

►►─ FILEOUT DEVICE= ─┬─ DISK ─┬─ ,DTFNAME=ddddddd ────────────────────────────►
                     ├─ TAPE ─┤
                     └─ Snnn ─┘

 ►─┬───────────────────────┬─┬────────────────────────┬─ ,TABLE=t ────────────►◄
   └─ ,LABEL= ─┬─ YES ◄ ─┬─┘ └─ ,REWIND= ─┬─ YES ◄ ─┬─┘
               └─ NO ────┘                └─ NO ────┘

Command

FILEOUT

Invokes the function to define output data sets.

Required Keywords

Specifies the name of the first/next extract output file.

Each table specified in a FILEOUT must be found in the control records for the input backup file. If any of the specified tables are not found in the control records for the input backup file, a message in the report indicates the invalid table name, and the utility terminates as a failure.

,DTFNAME=

Specifies the name of the first/next extract output file.

Valid Entries:

A valid extract output file name.

Default Value:

(No default)

DEVICE=

Specifies the device type, either DISK, TAPE, or Snnn.

DEVICE=Snnn allows you to use the nnn to specify a different SYS number (for tape only).

When you specify DEVICE=DISK, CA Datacom/DB finds the optimum block size less than 27998.

When you specify DEVICE=TAPE, the system logical unit (SYS) number must be 10 (SYS010). With DEVICE=TAPE the block size is within 32766.

Valid Entries:

DISK, TAPE, or Snnn

Default Value:

(No default)

,TABLE=

Specifies the name of an individual table from which to define the output data set.

Each table specified in a FILEOUT must be found in the control records for the input backup file. If any of the specified tables are not found in the control records for the input backup file, a message in the report indicates the invalid table name, and the utility terminates as a failure.

Valid Entries:

DATACOM-NAME of the table

Default Value:

(No default)

Optional Keywords

,LABEL=

If DEVICE=TAPE (either TAPE or the Snnn form), specifies whether tape labels are to be processed. We recommend that labeled tapes always be used.

Note: LABEL= has no effect when DEVICE=DISK.

Valid Entries:

NO or YES

Default Value:

YES

,REWIND=

Specifies action at OPEN and CLOSE. If DEVICE=TAPE (either TAPE or the Snnn form), YES indicates the tape is to be rewound before OPEN and after CLOSE. NO indicates no rewind before OPEN or after CLOSE. If omitted, the tape is rewound before the OPEN and rewound with unload after the CLOSE. NO allows the stacking of backups on one tape.

Note: REWIND= has no effect when DEVICE=DISK.

Valid Entries:

NO or YES

Default Value:

The tape is rewound before the OPEN and rewound with unload after the CLOSE.