IBM SG24-5360-00 manual Appendix B. Ixfp Command Examples, Snap Command, Syntax

Page 53

Appendix B. IXFP Command Examples

In this appendix we present the syntax and use of the various IXFP commands.

B.1 SNAP Command

In this section we present examples of the IXFP SNAP command. The command syntax is followed by examples of using the command.

Remember: Before you can use the SNAP option, you must bring the target offline by using the VSE/ESA DVCDN command.

B.1.1 Syntax

Figure 24 shows the syntax of the SNAP command.

 

￿￿,￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿

 

￿

 

￿￿￿￿IXFP￿￿￿￿SNAP,￿￿￿￿source￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿:target￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿

￿

￿￿(scyl￿￿￿-scyl￿￿￿)￿￿

￿￿(tcyl)￿￿ ￿￿,VOL1=volid￿￿ ￿ ￿￿,NOPROMPT￿￿

￿

￿￿.ncyl￿￿

￿

￿￿source(DSN=′ data-set-name ) : target￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿￿

 

 

￿￿(tcyl)￿￿

 

 

Figure 24. Syntax of IXFP SNAP Command: Details

 

 

SNAP identifies this command as a SNAP command.

 

source The device ID=(cuu) or the VOL1 label of the source device

 

that the user wants to be used as the source when copying

 

data to a target device. If the source device is identified by its

 

VOLID, it must be either the only volume with that VOLID or the

 

only volume with that VOLID that is up (DVCUP). Otherwise an

 

error message will be issued. The whole volume will be

 

copied unless the operator has provided additional information

 

that either identifies a cylinder range or a DSN on the source

 

device that he or she wants to be copied.

 

scyl-scylSpecifies the decimal start cylinder and end cylinder

 

 

range where copying is to start and to end on the

 

 

source device. Cylinder is the smallest entity that can

 

 

be specified for any SNAP command function. The

 

 

highest (end) cylinder number must not exceed 32767

 

 

or the devices primary number of cylinders and the

 

 

start cylinder number must not be higher than the end

 

 

cylinder number.

 

scyl.ncyl Specifies the decimal start cylinder where copying is

 

 

to start on the source device and provides the number

 

 

of cylinders (ncyl) that should be copied. Cylinder is

 

 

the smallest entity that can be specified for any SNAP

 

 

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 source

 

 

device that the operator wants to be copied onto the

 

 

target device. The file must be a non-VSAM file. The

file will be copied into the exact extent boundaries where it was located on the source device. Sequential

© Copyright IBM Corp. 1999

43

Image 53
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 WelcomeIBM Ramac Virtual Array What Is an IBM Ramac Virtual Array?Overview of RVA and the Virtual Disk Architecture Log Structured File− 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 Partial Disk Minimal Init Volume Minimal InitAssgn ExecRamac 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 Phys DetailAR 0015 CUU DEF DefinedIxfp 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 RequirementsSnapShot Considerations Examples of Pprcopy CommandsPrimary Devices of a Pprc Pair Secondary 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 AnotherTest Prod Overall Test Prod AR 0015 CapacityDEFINED-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 Reporting on the Capacity of Multiple Volumes Reporting on the Capacity of a Single VolumeReporting on the Capacity of the RVA Subsystem Device Detail Report FUNC. Capacity MBExec DTRIATTN,PARM=′ Ixfp REPORT′ IXFP/SnapShot Setup Job StreamsJOB WCWTEST1 BG 0000 1A86I Following Assignments are Released BG 0000 // JOB InitdiskIxfp DDSR,80E Ready Ixfp DDSR,80F$$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 International Technical Support Organization Publications Appendix F. Related PublicationsRedbooks on CD-ROMs Other PublicationsRamac 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