CA Dynam for VSE User Guide
CA Dynam for VSE User Guide CA Dynam for VSE User Guide
IBM Virtual Tape Facility (VTAPE) Support Normally, CA Dynam/T scans all available tape drives searching for a scratch tape to use when creating a data set on a real tape. Unlike real tapes, when a virtual tape is requested for output, CA Dynam/T must search the Dynam catalog for an appropriate virtual volser to specify on either the VTAPE START command or in the special FakeTape mount CCW request. If a volume is to be selected by CA Dynam/T for use as a virtual volume, the volser must be defined in the Dynam catalog as a virtual scratch tape. Define Virtual Volumes The DYNCAT SCRPOOL command is used to define virtual volumes in the catalog. Specifying either the VIRTAPE=VTAPE/FTAPE parameter, or the VTAPLOC=‘location’ and VTAPFILE=‘filename’ parameters on the SCRPOOL command, will define the volumes as virtual scratch tapes. The VTAPLOC and VTAPFILE parameters must be specified together and are mutually exclusive with the VIRTAPE parameter. The VTAPLOC and VTAPFILE parameters define the location and file name where the file is to be created. This virtual tape information is stored in the catalog when the SCRPOOL command is processed. If a VTAPE volume is being defined, specify VTAPLOC=‘VSAM’ or VTAPLOC=‘ipaddress:portnumber’. If a FakeTape volume is being defined, specify VTAPLOC=‘FTAPE’. If VIRTAPE=FTAPE or VIRTAPE=VTAPE is specified on the SCRPOOL command, the default file name and location defined in the DTVIRT option record will be passed on the VTAPE START command or in the FakeTape CCW when the data set is opened. The virtual tape information associated with a volume remains intact unless the volume is deleted from the catalog, or if a SCRPOOL command is issued with new virtual tape information specified. The virtual tape information remains associated with the volume even after the virtual volume is scratched. Virtual tape volumes do not need to be pre-initialized. CA Dynam/T writes the VOL1 and HDR1 labels the first time the virtual volume is used to create an output file. If a particular data set should always be created on a virtual volume, specify VIRTAPE=FTAPE or VIRTAPE=VTAPE on the DYNCAT DEFINE or ALTER command. To create a controlled version on a virtual tape on an as-needed basis, specify the TLBL option VT for a VTAPE, or FT for a FakeTape. Specifying the TLBL option causes a virtual tape to be created regardless of the VIRTAPE specification for the data set. 3–58 User Guide
IBM Virtual Tape Facility (VTAPE) Support If CA Dynam/T automatically creates a virtual tape, the logical unit must be unassigned when a single file or the first file of a multi-file set is opened. If the logical unit is preassigned, message CADT107D is issued. At that point, the operator can either release the assignment by replying 'REL' to the CADT107D message or cancel the job. The only time the logical unit can be preassigned is if other than file one of a multi-file set is being opened and the previous file used the HOLD option. See the section entitled "IBM limitation when writing to VSAM Virtual Tapes" for more information and an example on how to create multi-file VSAM VTAPE files. Precautions for Virtual Tapes The following precautions need to be taken when using virtual tapes: • Due to a conflict between the JCLIF macro interface and POWER, do not create or read POFFLOAD tapes using the automatic VTAPE interface. • To prevent simultaneous use, CA Dynam/T locks virtual CUUs. An internal method of locking is used, which requires no additional setup or options to be set. To unlock a virtual CUU that remains locked due to cancellation or abnormal termination of a job, use the new AR command DT READY VCUU=cuu. The AR command DT STATUS shows NOT AVRABLE next to any virtual CUU currently in locked status. • To reduce the amount of I/O when searching the catalog for an eligible virtual scratch tape, specify the VOLID parameter for data sets that are to be written to virtual tapes. If a data set is defined with a VOLID, CA Dynam/T performs a generic search looking only for volumes where the first two characters match the specified VOLID. For example, if there are no eligible virtual scratch tapes in the catalog, and no VOLID is specified, every volume in the catalog will be accessed. However, if a VOLID is specified, then only the volumes whose first two characters match the VOLID will be accessed. Using the VOLID parameter limits searches only to virtual volumes, thus reducing unnecessary catalog I/O. • To use VSAM and FakeTape files as virtual tapes, you must define them before they can be used by CA Dynam/T. For details about defining files to be used as virtual tapes, see IBM or FakeTape documentation. Example The following is an example of how to create and read a VTAPE that will reside in a VSAM file: * $$ JOB JNM=VTAPE,CLASS=0,DISP=D // JOB VTAPE CREATE VIRTUAL TAPE FILE * STEP 1 - DEFINE VTAPE VSAM CLUSTER // EXEC IDCAMS,SIZE=AUTO DELETE (VTAPE.FILE) PURGE CL - CATALOG(VSAM.USER.CATALOG) DEFINE CLUSTER (NAME(VTAPE.FILE) - Chapter 3: Supporting Tape File Management 3–59
- Page 126 and 127: Tape File Management Utilities TDYN
- Page 128 and 129: Tape File Management Utilities UPSI
- Page 130 and 131: Tape File Management Utilities // J
- Page 132 and 133: Tape File Management Utilities TEST
- Page 134 and 135: Tape File Management Utilities The
- Page 136 and 137: Tape File Management Utilities The
- Page 138 and 139: Tape File Management Utilities CATN
- Page 140 and 141: Tape File Management Utilities Exam
- Page 142 and 143: Tape File Management Utilities VER
- Page 144 and 145: Tape File Management Utilities SYST
- Page 146 and 147: Reporting on Tape Files The TDYNUTL
- Page 148 and 149: Reporting on Tape Files The followi
- Page 150 and 151: Reporting on Tape Files In addition
- Page 152 and 153: Reporting on Tape Files TDYNPULL Pr
- Page 154 and 155: Reporting on Tape Files UNCONTROLLE
- Page 156 and 157: Reporting on Tape Files Note: • S
- Page 158 and 159: Reporting on Tape Files This job st
- Page 160 and 161: Reporting on Tape Files Important!
- Page 162 and 163: Reporting on Tape Files PED AS-OF-D
- Page 164 and 165: Vault Location Control Program—TD
- Page 166 and 167: Vault Location Control Program—TD
- Page 168 and 169: Vault Location Control Program—TD
- Page 170 and 171: IBM 3494 Tape Library Interface IBM
- Page 172 and 173: IBM 3494 Tape Library Interface Not
- Page 174 and 175: IBM Virtual Tape Facility (VTAPE) S
- Page 178 and 179: IBM Virtual Tape Facility (VTAPE) S
- Page 180 and 181: IBM Virtual Tape Facility (VTAPE) S
- Page 182 and 183: Basic Components The enhanced VTOC
- Page 184 and 185: Basic Components Disk Space Availab
- Page 186 and 187: Basic Components Method Two Submitt
- Page 188 and 189: Basic Components Overriding Catalog
- Page 190 and 191: Managing the VTOC Default Allocatio
- Page 192 and 193: Managing the VTOC Searching the VTO
- Page 194 and 195: Defining File ID Option Codes Defin
- Page 196 and 197: Defining File ID Option Codes F Fra
- Page 198 and 199: Defining File ID Option Codes O Old
- Page 200 and 201: Controlling Generation Data Sets //
- Page 202 and 203: Controlling Generation Data Sets De
- Page 204 and 205: Automatic Volume Assignment and Rec
- Page 206 and 207: Selecting Logical Units LUB Availab
- Page 208 and 209: Modifying Logical Unit Assignments
- Page 210 and 211: Controlling Disk Pools To catalog a
- Page 212 and 213: Controlling Disk Pools For example,
- Page 214 and 215: Allocating Space across Generic Vol
- Page 216 and 217: Recovering from Lack of Allocated S
- Page 218 and 219: Defining Independent Files Defining
- Page 220 and 221: Releasing Unused Disk Space Single-
- Page 222 and 223: Deleting Files DA Files No truncati
- Page 224 and 225: Processing Expired Files If the ret
IBM Virtual Tape Facility (VTAPE) Support<br />
Normally, <strong>CA</strong> <strong>Dynam</strong>/T scans all available tape drives searching <strong>for</strong> a scratch<br />
tape to use when creating a data set on a real tape. Unlike real tapes, when a<br />
virtual tape is requested <strong>for</strong> output, <strong>CA</strong> <strong>Dynam</strong>/T must search the <strong>Dynam</strong><br />
catalog <strong>for</strong> an appropriate virtual volser to specify on either the VTAPE START<br />
command or in the special FakeTape mount CCW request. If a volume is to be<br />
selected by <strong>CA</strong> <strong>Dynam</strong>/T <strong>for</strong> use as a virtual volume, the volser must be<br />
defined in the <strong>Dynam</strong> catalog as a virtual scratch tape.<br />
Define Virtual Volumes<br />
The DYN<strong>CA</strong>T SCRPOOL command is used to define virtual volumes in the<br />
catalog. Specifying either the VIRTAPE=VTAPE/FTAPE parameter, or the<br />
VTAPLOC=‘location’ and VTAPFILE=‘filename’ parameters on the SCRPOOL<br />
command, will define the volumes as virtual scratch tapes. The VTAPLOC and<br />
VTAPFILE parameters must be specified together and are mutually exclusive<br />
with the VIRTAPE parameter. The VTAPLOC and VTAPFILE parameters define<br />
the location and file name where the file is to be created. This virtual tape<br />
in<strong>for</strong>mation is stored in the catalog when the SCRPOOL command is processed.<br />
If a VTAPE volume is being defined, specify VTAPLOC=‘VSAM’ or<br />
VTAPLOC=‘ipaddress:portnumber’. If a FakeTape volume is being defined,<br />
specify VTAPLOC=‘FTAPE’.<br />
If VIRTAPE=FTAPE or VIRTAPE=VTAPE is specified on the SCRPOOL command,<br />
the default file name and location defined in the DTVIRT option record will be<br />
passed on the VTAPE START command or in the FakeTape CCW when the<br />
data set is opened.<br />
The virtual tape in<strong>for</strong>mation associated with a volume remains intact unless<br />
the volume is deleted from the catalog, or if a SCRPOOL command is issued<br />
with new virtual tape in<strong>for</strong>mation specified. The virtual tape in<strong>for</strong>mation<br />
remains associated with the volume even after the virtual volume is scratched.<br />
Virtual tape volumes do not need to be pre-initialized. <strong>CA</strong> <strong>Dynam</strong>/T writes the<br />
VOL1 and HDR1 labels the first time the virtual volume is used to create an<br />
output file.<br />
If a particular data set should always be created on a virtual volume, specify<br />
VIRTAPE=FTAPE or VIRTAPE=VTAPE on the DYN<strong>CA</strong>T DEFINE or ALTER<br />
command. To create a controlled version on a virtual tape on an as-needed<br />
basis, specify the TLBL option VT <strong>for</strong> a VTAPE, or FT <strong>for</strong> a FakeTape. Specifying<br />
the TLBL option causes a virtual tape to be created regardless of the VIRTAPE<br />
specification <strong>for</strong> the data set.<br />
3–58 <strong>User</strong> <strong>Guide</strong>