EVL (Exported Stacked Volume List)

Purpose

List the contents of an Exported Stacked Volume.

Usage notes

File Manager first verifies that the volume loaded was created by the VTS export function. File Manager forward spaces the volume to the Table of Contents and then prints a listing of the Table of Contents. The sequence printed is the same as the sequence of the logical volumes on the Exported Stacked Volume.

You can choose a short listing using the SHORT listing type, which prints only the logical volumes on the Exported Stacked Volume, or you can obtain a more detailed list of the Table of Contents by using the LONG listing type. This listing shows standard label header and trailer information and the location of tape marks.

Specify a DDNAME for the tape. If the DDNAME is not allocated, you are asked for allocation information.

If you do not know the VOLSER and first data set name of the tape, specify BLP during allocation.

For more information about using this function, see ESV options.

Options

None.

Related function

EVC: Copy a logical volume from an Exported Stacked Volume

Figure 1. Syntax

ddname

Refers to a DD or TSO ALLOC statement.

end

The relative number of the logical volume on the input Exported Stacked Volume where the listing is to stop. For example, END=9 causes the listing of logical volumes to stop after volume 9 has been listed. If omitted, or greater than the number of logical volumes on the input Exported Stacked Volume, then the value defaults to the maximum number of volumes on the input Exported Stacked Volume. Ignored if TYPE=SHORT, or VOLSER has been specified.

LABEL=BLP

Specifies that bypass label processing is used. This parameter must be specified with the first File Manager function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the File Manager for z/OS Customization Guide.

lvolser

Logical volume numbers of the volumes to be listed. Use VOL1 for a standard labeled volume. Specify up to five logical volume numbers in the form (volser1, volser2, …). If omitted, and START, END parameters are not used, then all logical volumes on the input Exported Stacked Volume are listed. Ignored if TYPE=SHORT.

start

The relative number of the logical volume on the input Exported Stacked Volume where the listing is to start. For example, START=5 causes the first 4 logical volumes to be skipped and the listing starts with logical volume 5. If omitted, the value defaults to 1. If START is greater than END, then no logical volumes is listed. Ignored if TYPE=SHORT, or VOLSER has been specified.

type

Specify one of the following:

SHORT: Print only the volsers of the logical volumes on the input Exported Stacked Volume (the default).
LONG: Print detailed listing of the format of the logical volumes on the input Exported Stacked Volume. Parameters VOLSER or START, END can be used to qualify the logical volumes listed.

//EVL JOB (acct),'name'  Exported Stacked Volume List
//DTOEVL   EXEC PGM=FILEMGR
//STEPLIB  DD DSN=FMN.SFMNMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//TAPE     DD UNIT=F07M3N80,VOL=SER=ESV994,
//             DISP=SHR,LABEL=(,BLP)
//SYSIN    DD *
$$FILEM EVL INPUT=TAPE,TYPE=LONG,VOLSER=(EJ0020,EJ1019,EJ1029,EJ1035)
$$FILEM EOJ
/*

File Manager
$$FILEM EVL INPUT=TAPE,TYPE=LONG,VOLSER=(EJ0020,EJ1019,EJ1029,EJ1035)
Exported Stacked Volume Table of Contents for Volume ESV994
          VOLSER   SEQ NO    Logical Volume Layout
          EJ1019      3      VOL1EJ1019
                             HDR1PE.MNT06.TAB351OO
                             ----- TAPE MARK -----
                                   Data File
                             ----- TAPE MARK -----
                             EOF1PE.MNT06.TAB351OO
                             ----- TAPE MARK -----
                             ----- TAPE MARK -----
                             ===== End of Volume =====
          EJ1035      4      VOL1EJ1035
                             HDR1PE.MNT12.TAB351OO
                             ----- TAPE MARK -----
                                   Data File
                             ----- TAPE MARK -----
                             EOF1PE.MNT12.TAB351OO
                             ----- TAPE MARK -----
                             ----- TAPE MARK -----
                             ===== End of Volume =====
          EJ1029      7      VOL1EJ1029
                             HDR1PE.MNT08.TAB351OO
                             ----- TAPE MARK -----
                                   Data File
                             ----- TAPE MARK -----
                             EOF1PE.MNT08.TAB351OO
                             ----- TAPE MARK -----
                             ----- TAPE MARK -----
                             ===== End of Volume =====
          EJ0020     10      VOL1EJ0020
                             HDR1.BACKTAPE.DATASET
                             ----- TAPE MARK -----
                                   Data File
                             ----- TAPE MARK -----
                             EOF1.BACKTAPE.DATASET
                             ----- TAPE MARK -----
                             ----- TAPE MARK -----
                             ===== End of Volume =====
EVL completed
$$FILEM EOJ