IBM SG24-5360-00 manual Syntax of Ixfp Ddsr Command Details

Page 59

B.2 DDSR Command

In this section we present examples of the IXFP DDSR command.

Remember: Before you can use the DDSR option against a volume, you must bring it offline by using the DVCDN VSE/ESA command.

B.2.1 Syntax

￿￿￿￿IXFP￿￿￿￿DDSR￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿

￿ ￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿ ￿ ￿￿,NOPROMPT￿￿

￿

￿￿￿,unit￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿

￿ ￿￿(dcyl￿￿￿-dcyl￿￿￿)￿￿ ￿

￿￿￿.ncyl￿￿ ￿

￿￿,unit(DSN=′ data-set-name ) ￿￿￿￿￿￿

Figure 28. Syntax of IXFP DDSR Command: Details

DDSR If specified without any additional operand, the operator can delete the VTOC entries and all physical space for all non secured files residing on VSE-managed RVA devices whose associated expiration date has been reached and which have been created by VSE. A request is sent to the RVA subsystem, causing the RVA subsystem to release the physical extents that VSE considers as free space. Once released, these extents are reclaimed for free space allocation.

If a unit parameter is used, without any additional operands, the data on the entire volume will be deleted (including the VTOC and the VOL1 label). Therefore the volume must be reinitialized (ICKDSF) before it is used as a regular data-pack again, assuming it is not going to be used as a SNAP target device, in which case such an initialization run would be obsolete. VSE requires the volume to be DOWN (DVCDN command) if the whole volume or a range of cylinders is to be deleted.

unit The device ID (cuu) or the VOL1 label of the device that should be either totally released or, if a data set name (DSN=) or a cylinder range has been specified, partially released. The VTOC on this device will remain unchanged unless a file was released, in which case the appropriate labels will be deleted from the VTOC. If you release the whole volume, or the cylinder range containing the VTOC, the VTOC will be deleted. dcyl-dcylSpecifies the decimal start cylinder and end cylinder

where deletion is to start and to end. Cylinder is the smallest entity that can be specified for any DDSR command function. The highest (end) cylinder number must not exceed 32767, and the start cylinder number must not be higher than the end cylinder number.

dcyl.ncyl Specifies the decimal start cylinder where deletion is to start and provides the number of cylinders (ncyl) that should be released. Cylinder is the smallest entity that can be specified for any DDSR command function. The highest resulting cylinder number must not exceed 32767 or the devices number of primary cylinders.

D S N = The data set name identifying the file on the specified unit that the operator wants to be deleted. The file must be a non-VSAM file, If the specified unit is in the

Appendix B. IXFP Command Examples 49

Image 59
Contents International Technical Support Organization Page International Technical Support Organization First Edition January Contents Peer-to-Peer Remote Copy Itso Redbook Evaluation Contents Vi Ramac Virtual Array, Peer-to Peer Remote VSE/ESA Team That Wrote This Redbook PrefaceYour comments are important to us Comments WelcomeLog Structured File What Is an IBM Ramac Virtual Array?IBM Ramac Virtual Array Overview of RVA and the Virtual Disk Architecture− Functional track table Data Compression and CompactionVSE/ESA Support for the RVA What Is IXFP/SnapShot for VSE/ESA?What Is SnapShot? Deleted Data Space Release What Is IXFP?Reporting Functions What Is Peer-to-Peer Remote Copy?Ramac Virtual Array, Peer-to Peer Remote VSE/ESA Disk Capacity RVA Benefits for VSE/ESARVA Simplifies Your Storage Management Batch Window Improvement AdministrationIxfp IXFP/SnapShot for VSE/ESA Ramac Virtual ArrayHardware Application DevelopmentRVA Data Availability Pprc SnapShotRamac Virtual Array, Peer-to Peer Remote VSE/ESA Prerequisites VSE/ESA Support for the RVAHost Connection Volumes1 VSE/ESA Input/Output Configuration Program Exec Volume Minimal InitPartial Disk Minimal Init AssgnRamac Virtual Array, Peer-to Peer Remote VSE/ESA System VSE/ESA User Time IXFP/SnapShot for VSE/ESASample Batch Job to Invoke Ixfp Report Function DTRIATTN,PARM=′ Ixfp REPORT′IXFP/SnapShot for VSE/ESA Defined DetailPhys AR 0015 CUU DEFIxfp Snap Full VolumeVSE/VSAM Reply ′ YES′ to ProceedRange of Cylinders Non-VSAM File Expired Files Ixfp DDSR,PATEV30000-0999,NOPROMPT Total VolumeIxfp DDSR,PATEV3 Ixfp DDSR,PATEV3DSN=′ test.data.3′ , Noprompt Specified FileIxfp Report Ixfp REPORT,80E Ixfp REPORT,80FIxfp REPORT,80E,80F Device Detail Report Sample Output of Ixfp Report CommandRamac Virtual Array, Peer-to Peer Remote VSE/ESA Subsystem Summary Report Device Summary ReportRamac Virtual Array, Peer-to Peer Remote VSE/ESA Peer-to-Peer Remote Copy Peer-to-Peer Remote CopyPprc Data Flow Pprc and VSE/ESA Software RequirementsInvoking peer-to-peer remote copy Pprc Hardware RequirementsSecondary Devices of a Pprc Pair Examples of Pprcopy CommandsSnapShot Considerations Primary Devices of a Pprc PairRecovering from a Primary Site Failure Setting Up Pprc Paths and PairsPhysical Connections to the RVA Recovering from a Secondary Site FailureDeleting Pprc Pairs and Paths Determining the Channel Connection Address Determining the Logical Control Unit Number for RVARamac Virtual Array, Peer-to Peer Remote VSE/ESA Functional Device Configuration Appendix A. RVA Functional Device ConfigurationFunctional Device Configuration Screen CD23 Syntax Appendix B. Ixfp Command ExamplesSnap Command Ramac Virtual Array, Peer-to Peer Remote VSE/ESA Noprompt Using SnapShot to Copy One Volume to Another Test Prod Overall Test Prod AR 0015 Capacity DEFINED-CAPACITY Using SnapShot to Copy Files with Relocation Using SnapShot to Copy a File from One Volume to AnotherIXFP20I Snap Function Completed AT Other Uses of SnapShotSyntax of Ixfp Ddsr Command Details Ddsr CommandUsing Ddsr to Delete the Contents of a Volume Using Ddsr to Delete a Single Data SetAR+0015 IXFP29D Ddsr for For Deletion Using Ddsr to Delete the Free Space on an RVAReport Report Command Device Detail Report FUNC. Capacity MB Reporting on the Capacity of a Single VolumeReporting on the Capacity of Multiple Volumes Reporting on the Capacity of the RVA SubsystemExec DTRIATTN,PARM=′ Ixfp REPORT′ IXFP/SnapShot Setup Job StreamsJOB WCWTEST1 Ready Ixfp DDSR,80F BG 0000 // JOB InitdiskBG 0000 1A86I Following Assignments are Released Ixfp DDSR,80E$$DITTO BLKFACTOR=1 EOJ 50.83 47.86 AR 0015 1I40I Ready$$DITTO BLKFACTOR=1 $$DITTO EOJ 726532.208 MB 117880.209 MB 57754.953 MB Appendix C. VSE/VSAM Considerations Backing up Vsam Volumes Appendix C. VSE/VSAM Considerations Ramac Virtual Array, Peer-to Peer Remote VSE/ESA Appendix D. Iocds Example Ramac Virtual Array, Peer-to Peer Remote VSE/ESA Appendix E. Special Notices Following terms are trademarks of other companies Other Publications Appendix F. Related PublicationsInternational Technical Support Organization Publications Redbooks on CD-ROMsRamac Virtual Array, Peer-to Peer Remote VSE/ESA ∙ E-mail Orders How to Get Itso RedbooksPlease send me the following IBM Redbook Fax Order FormSee CKD IndexPprc distance Please answer the following questions Itso Redbook EvaluationSG24-5360-00