EVL (Exported Stacked Volume List)

Purpose
List the contents of an Exported Stacked Volume.
Usage notes
Z Data Tools first verifies that the volume loaded was created by the VTS export function. Z Data Tools 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
Read syntax diagramSkip visual syntax diagram
Syntax

                                     .-TYPE=SHORT-.   
>>-EVL--+-----------+--INPUT=ddname--+------------+------------->
        '-LABEL=BLP-'                '-TYPE=type--'   

>--+----------------+--+-------------+--+---------+------------><
   '-VOLSER=lvolser-'  '-START=start-'  '-END=end-'   

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 Z Data Tools function that uses the tape. For BLP processing requirements, see “Customizing the Security Environment” in the Z Data Tools 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=HFMMAIN
//STEPLIB  DD DSN=HFM.SHFMMOD1,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
/*
Z Data Tools
$$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