EVC (Exported Stacked Volume Copy)

Purpose
Copy a logical volume from an Exported Stacked Volume to a physical volume.
Usage notes
If either the input volume or the output volume are not at their load point, this function rewinds the volumes.

The input volume is verified to ensure that it was created by the VTS export function. If valid, then the Table of Contents located at the end of the Exported Stacked Volume volume is read. The Exported Stacked Volume is then rewound again before the copy process starts.

The requested logical volumes are then copied to the physical volumes. The copy sequence is the same as the sequence of the logical volumes on the Exported Stacked Volume. The requested list of logical volumes is internally sorted into the same sequence as the Exported Stacked Volume Table of Contents to enable all copies to be completed without the need to rewind the input volume during the copy process.

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

You can copy up to 5 logical volumes in a single step.

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
EVL
Print a table of contents list for an Exported Stacked Volume
Read syntax diagramSkip visual syntax diagram
Syntax

>>-EVC--+-----------+--INPUT=ddname--OUTPUT=ddname-------------->
        '-LABEL=BLP-'                                

>--VOLSER=lvolser--+---------+---------------------------------><
                   '-DENS=mm-'   

ddname
Refers to a DD or TSO ALLOC statement.

There must be one to one correspondence between the logical volumes requested (lvolser) and the physical output volumes specified in the VOL= parameter of the DD statement specified by ddname in the OUTPUT parameter.

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 copied. Use VOL1 for a standard labeled volume. Specify up to five logical volume numbers in the form (volser1, volser2, …).

The logical volume numbers must be unique, duplicates are not permitted (that is, one logical volume cannot be specified more than once). Each logical volume is copied to a single physical output volume (specified in tapevol).

mm
A 2-byte tape mode as shown in Tape density and mode values.
//EVC JOB (acct),'name'  Exported Stacked Volume Copy
//* Copy 1 logical volume to 1 specified volume
//DTOEVC   EXEC PGM=HFMMAIN
//STEPLIB  DD DSN=HFM.SHFMMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//TAPE1    DD UNIT=561,VOL=SER=ESV001,
//            DISP=SHR,LABEL=(,BLP)
//TAPE2    DD UNIT=562,VOL=SER=NEWVOL,
//            DISP=SHR,LABEL=(,BLP)
//SYSIN    DD *
$$FILEM EVC INPUT=TAPE1,OUTPUT=TAPE2,VOLSER=LVOL03
$$FILEM EOJ
/*
Z Data Tools
$$FILEM EVC INPUT=TAPE1,OUTPUT=TAPE2,VOLSER=LVOL03
Logical volume LVTS03 being copied to physical volume NEWVOL
Standard Label File Number    1  DSN='LVOL03.TEST '
Copy of logical volume LVOL03 to physical volume NEWVOL complete
EVC completed
//EVC JOB (acct),'name'  Exported Stacked Volume Copy
//* Copy 2 logical volumes to 2 specified volumes
//DTOEVC   EXEC PGM=HFMMAIN
//STEPLIB  DD DSN=HFM.SHFMMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//TAPE1    DD UNIT=561,VOL=SER=ESV001,
//            DISP=SHR,LABEL=(,BLP)
//TAPE2    DD UNIT=562,VOL=SER=(NEWVL1,NEWVL2),
//            DISP=SHR,LABEL=(,BLP)
//SYSIN    DD *
$$FILEM EVC INPUT=TAPE1,OUTPUT=TAPE2,
$$FILEM     VOLSER=(LVOL03,LVOL06)
$$FILEM EOJ
/*
//EVC JOB (acct),'name'  Exported Stacked Volume Copy
//* Copy 5 logical volumes to 5 scratch volumes
//DTOEVC   EXEC PGM=HFMMAIN
//STEPLIB  DD DSN=HFM.SHFMMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//TAPE1    DD UNIT=561,VOL=SER=ESV001,
//            DISP=SHR,LABEL=(,BLP)
//TAPE2    DD UNIT=562,DISP=(NEW,PASS),LABEL=(,SL)
//SYSIN    DD *
$$FILEM EVC INPUT=TAPE1,OUTPUT=TAPE2,
$$FILEM     VOLSER=(LVOL03,LVOL06,LVOL01,LVOL99,LVOL10)
$$FILEM EOJ
/*