Previous Topic: When to UseNext Topic: Example JCL


How to Use

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

►►─ FILEIN ─ DTFNAME=d,DEVICE= ─┬─ DISK ─┬─┬───────────────────────┬──────────►
                                ├─ TAPE ─┤ └─ ,LABEL= ─┬─ YES ◄ ─┬─┘
                                └─ Snnn ─┘             └─ NO ────┘

 ►─┬────────────────────────┬─────────────────────────────────────────────────►◄
   └─ ,REWIND= ─┬─ YES ◄ ─┬─┘
                └─ NO ────┘

Command

FILEIN

FILEIN invokes the function to concatenate multiple backups to do one load with all the data.

Required Keywords

DEVICE=

DEVICE= specifies the device type for the input data set.

When DEVICE=TAPE is specified, the system logical unit (SYS) number must be 5 (SYS005).

Use the Snnn entry to specify a specific SYS number (for tape only).

Valid Entries:

DISK, TAPE, Snnn (Certain values from previous versions are still accepted but are treated as DISK.)

Default Value:

(No default)

DTFNAME=

DTFNAME= specifies the z/VSE JCL TLBL/DLBL name for the input data set.

If DEVICE=TAPE, this name must match the name that you code in your z/VSE JCL TLBL statement. Otherwise, this name must match the name you code in your z/VSE JCL DLBL statement.

Valid Entries:

Any name valid to z/VSE JCL specifications

Default Value:

(No default)

Optional Keywords

,LABEL=

LABEL= specifies, if DEVICE=TAPE (that is, either TAPE or the Snnn form), whether tape labels are processed. We recommend that you always use labeled tapes.

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

Valid Entries:

NO or YES

Default Value:

YES

,REWIND=

REWIND= is used, if DEVICE=TAPE (that is, either TAPE or the Snnn form), can be specified as YES to indicate that 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.

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.