Post on 22-Mar-2020
Device Support Facilities (ICKDSF)Version Release 17
User's Guide and Reference
IBM
GC35-0033-42
Note
Before using this information and the product it supports, read the information in “Notices” on page679.
This edition applies to Release 17 of the Device Support Facilities program and to all subsequent releases andmodifications until otherwise indicated in new editions.
Last updated: 2019-02-16© Copyright International Business Machines Corporation 1978, 2017.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.
Contents
List of Figures...................................................................................................xxxvList of Tables.................................................................................................. xxxvii
About this document....................................................................................... xxxixICKDSF product library.......................................................................................................................... xxxixAdditional reference information.......................................................................................................... xxxix
Hardware documents............................................................................................................................ xlSoftware documents............................................................................................................................xlii
Terminology.............................................................................................................................................. xliiiHow to use this document for your operating environment....................................................................xliii
How to send your comments to IBM.....................................................................xlvIf you have a technical problem................................................................................................................ xlv
Summary of changes..........................................................................................xlviGeneral changes..................................................................................................................................xlviMessage changes................................................................................................................................ xlvi
Part 1. Introducing ICKDSF....................................................................................1
Chapter 1. Introduction to ICKDSF..............................................................................................................3About ICKDSF......................................................................................................................................... 3
Verifying your ICKDSF version..........................................................................................................3Running multiple ICKDSF jobs..........................................................................................................3Running ICKDSF on Dual Copy volumes.......................................................................................... 4
ICKDSF commands.................................................................................................................................4Operating systems that support ICKDSF............................................................................................... 5
Versions that support ICKDSF commands.......................................................................................6Storage requirements....................................................................................................................... 6
Devices supported by ICKDSF............................................................................................................... 6ICKDSF support of the RAMAC Array family..........................................................................................8ICKDSF support of the Internal Disk......................................................................................................9ICKDSF support of the 2105, 2107, and 1750......................................................................................9Additional ICKDSF support information.............................................................................................. 10
Configuration checking................................................................................................................... 10Processing on XRC volumes........................................................................................................... 10
Tasks you can perform with ICKDSF....................................................................................................10
Chapter 2. About DASD storage media..................................................................................................... 13DASD physical characteristics............................................................................................................. 13Data checks.......................................................................................................................................... 14
Degree of repeatability................................................................................................................... 14Degree of visibility...........................................................................................................................14Correctable versus uncorrectable.................................................................................................. 14Temporary versus permanent........................................................................................................ 14
Error notification...................................................................................................................................15
Chapter 3. Understanding ICKDSF command statements....................................................................... 17ICKDSF command statement syntax...................................................................................................17
Conflicting keyword parameters.................................................................................................... 18Abbreviating commands and parameters......................................................................................18Separating commands and parameters.........................................................................................18
iii
Continuing lines.............................................................................................................................. 18Commenting your code...................................................................................................................19Ending a command......................................................................................................................... 19
Writing statements to control ICKDSF processing..............................................................................19Writing a SET statement................................................................................................................. 20Writing the IF-THEN-ELSE statement............................................................................................ 21Writing the DO-END statement...................................................................................................... 22Writing a null THEN and ELSE.........................................................................................................23
Chapter 4. Getting started with the MVS version of ICKDSF.................................................................... 25Overview of the ICKDSF tasks using the MVS version........................................................................ 25Using JCL to run ICKDSF...................................................................................................................... 26
Printed output data set...................................................................................................................27Using ISMF panels to run ICKDSF........................................................................................................27Protecting MVS volumes and data sets............................................................................................... 30
Protecting data sets in an offline mode......................................................................................... 31Protecting data sets in an online mode..........................................................................................31Authorizing access with RACF........................................................................................................ 31Limiting the use of resources with the Authorized Program Facility (APF)...................................33
Protecting ICKDSF commands with RACF...........................................................................................34Processing in a shared environment....................................................................................................34
Preserving data during INSPECT....................................................................................................35Preserving data during INSPECT under concurrent media maintenance..................................... 35
Operator's intervention consideration.................................................................................................35
Chapter 5. Getting started with the CMS version......................................................................................37Definition of a minidisk and dedicated device.....................................................................................37Overview of ICKDSF tasks using the CMS version...............................................................................37Invoking ICKDSF under CMS from the console................................................................................... 39
Example of invoking ICKDSF from the console..............................................................................39Invoking ICKDSF with a CMS EXEC......................................................................................................40Invoking ICKDSF with an input file...................................................................................................... 41Using parameters to select the input and output devices.................................................................. 42Supporting minidisks under the CMS version......................................................................................42
Supporting general users without special authority......................................................................43Using DEVMAINT authority.............................................................................................................43
Supporting dedicated devices under the CMS version........................................................................44
Chapter 6. Getting started with the VSE version.......................................................................................47Overview of the ICKDSF tasks using the VSE version......................................................................... 47Running the VSE version of ICKDSF in batch mode............................................................................ 48
Operator intervention..................................................................................................................... 49Running the VSE version of ICKDSF in command mode..................................................................... 49
Use of VSE ICKDSF command mode during VSE install process.................................................. 50Command mode restrictions.......................................................................................................... 50
Verifying identification and preventing data loss................................................................................ 50Processing in a shared environment....................................................................................................51
Sharing across multiple processors............................................................................................... 51Sharing across multiple users and partitions in a single processor.............................................. 51
Chapter 7. Getting started with the Stand-Alone version.........................................................................53About the Stand-Alone version............................................................................................................53Overview of the ICKDSF tasks using the Stand-Alone version........................................................... 54Creating an ICKDSF Stand-Alone IPL tape using MVS........................................................................ 55Creating an ICKDSF Stand-Alone IPL tape using CMS........................................................................56Preparing to use the Stand-Alone........................................................................................................56IPLing the Stand-Alone ICKDSF...........................................................................................................57IPLing the Stand-Alone from a tape library......................................................................................... 57
iv
IPLing the Stand-Alone from SAPL...................................................................................................... 58IPLing the Stand-Alone with a load parm specified............................................................................ 58IPLing the Stand-Alone with no load parm specified..........................................................................59Loading the Stand-Alone ICKDSF from CD-ROM................................................................................ 60Defining the input and output device...................................................................................................60Interpreting error conditions............................................................................................................... 61Performing ICKDSF tasks on minidisks with the Stand-Alone version...............................................63
Chapter 8. ICKDSF versions supported as guests under VM....................................................................65Problem solving under VM................................................................................................................... 66
Part 2. Using ICKDSF to install and maintain CKD devices.....................................67
Chapter 9. Examples of ICKDSF tasks—CKD devices............................................................................... 69Installing devices................................................................................................................................. 69
Completing the installation procedure...........................................................................................69Installing a device from the factory................................................................................................69Setting an IBM 3390 to 3380 track compatibility mode............................................................... 70Installing a 3375 or older HDA from the factory........................................................................... 70
Resuming initialization from a checkpoint location............................................................................ 71Validating and writing the FFVDP................................................................................................... 71Validating part of a volume.............................................................................................................71Writing the FFVDP on part of a volume.......................................................................................... 71Writing the FFVDP regardless of previous processing...................................................................72Validating from a specific point...................................................................................................... 72Validating to a specific point...........................................................................................................73Validating and writing the FFVDP for one head............................................................................. 73Validating the last heads of a device.............................................................................................. 73
Formatting devices...............................................................................................................................74Formatting minidisks...................................................................................................................... 74Formatting an entire volume in the CMS version........................................................................... 74Formatting part of a volume in the CMS version............................................................................74Writing the VTOC.............................................................................................................................75Placing a VTOC at the end of a volume...........................................................................................75Determining the VTOC size and location........................................................................................75Expanding the VTOC at Its current location...................................................................................75Changing the volume serial number and owner identification......................................................76Adding IPL text to a volume............................................................................................................76Converting a volume to indexed format......................................................................................... 76
Problem determination........................................................................................................................ 77Investigating suspected drive problems........................................................................................77Scanning data on part of a volume................................................................................................. 78Checking disk surfaces with INSPECT........................................................................................... 78Surface checking part of a volume................................................................................................. 78
Media maintenance.............................................................................................................................. 79Conditionally assigning alternate tracks........................................................................................ 80Unconditionally assigning alternate tracks.................................................................................... 80Reclaiming a single flagged track...................................................................................................80Reclaiming alternate tracks with INSPECT.................................................................................... 81Finding where INSPECT failed........................................................................................................81Saving data during surface checking..............................................................................................81
Emulating devices................................................................................................................................ 82Using a 3995 Model 151 or 153 device......................................................................................... 83Initializing an emulated CKD device on a 3370 FBA device..........................................................83Initializing an emulated CKD Device on an IBM 9313, 9332, or 9335 FBA device...................... 83Media maintenance on an emulated device.................................................................................. 84
Performing miscellaneous tasks with ICKDSF.................................................................................... 85
v
Clearing a storage path fence status..............................................................................................85Erasing a volume.............................................................................................................................85Printing a track assignment map....................................................................................................85
Chapter 10. AIXVOL command—CKD........................................................................................................87Syntax................................................................................................................................................... 87
Required parameters...................................................................................................................... 87Optional parameters.......................................................................................................................88
Formatting a cylinder with AIXVOL......................................................................................................89Errors reported by EXAMINE............................................................................................................... 90Minidisk support...................................................................................................................................91Examples of the AIXVOL command.....................................................................................................91
Formatting an entire volume.......................................................................................................... 91Formatting part of a volume........................................................................................................... 91Inspecting a range of cylinders for errors...................................................................................... 91Rewriting the volume label.............................................................................................................91
Chapter 11. ANALYZE command—CKD.....................................................................................................93Protecting the ANALYZE command with RACF....................................................................................93Syntax................................................................................................................................................... 93
Required parameters...................................................................................................................... 93Optional parameters.......................................................................................................................94
Detecting hardware problems with DRIVETEST............................................................................... 100Testing the drive and logical volume with ANALYZE....................................................................100Path control under ANALYZE drive test........................................................................................101
Verifying data records with ANALYZE................................................................................................101Data verification output................................................................................................................102Unexpected I/O errors..................................................................................................................102
RANGE Parameters: specifying part of a volume..............................................................................103CMS version minidisk support........................................................................................................... 104Dual copy volumes............................................................................................................................. 104Examples of the ANALYZE command................................................................................................ 104
Analyzing volumes with the Stand-Alone version....................................................................... 104Analyzing volumes with the CMS version.....................................................................................105Analyzing volumes with the MVS version.....................................................................................105Analyzing a volume with the VSE version.................................................................................... 106Examples of path control under the ANALYZE drive test............................................................ 106
Diagnostic messages..........................................................................................................................107Drive test error summary..............................................................................................................107Movable head error table............................................................................................................. 107Fixed-head error table..................................................................................................................108
Pathing reports...................................................................................................................................109Path status table...........................................................................................................................109Logical path status table.............................................................................................................. 111Interface information................................................................................................................... 112Host interface information........................................................................................................... 112
Fiber channel connection information...............................................................................................113Example........................................................................................................................................ 113
Host access information.................................................................................................................... 114
Chapter 12. BUILDIX command—CKD....................................................................................................115Protecting the BUILDIX command with RACF.................................................................................. 115Syntax................................................................................................................................................. 115
Required parameters....................................................................................................................115Optional parameters.....................................................................................................................116
Processing in a Shared Environment................................................................................................. 116Converting an OSVTOC to an indexed VTOC......................................................................................116Converting an indexed VTOC to an OSVTOC......................................................................................117
vi
Examples of the BUILDIX command................................................................................................. 117Changing an IXVTOC to an OSVTOC without operator's intervention.........................................117Building a VTOC index on a volume without an index allocated................................................. 118Building a VTOC index on a volume with an index allocated.......................................................118
Chapter 13. CONTROL command—CKD..................................................................................................119Protecting the CONTROL command with RACF.................................................................................119Syntax................................................................................................................................................. 119
Required parameters....................................................................................................................119Optional parameters.....................................................................................................................120
Clearing a storage control without performing an IML..................................................................... 122Allowing write operations through a storage control........................................................................122Clearing a fenced path or device....................................................................................................... 123Discarding data pinned in cache........................................................................................................123Examples of the CONTROL command............................................................................................... 124
Clearing a WRITE INHIBITed storage control............................................................................. 124Clearing a storage path fence status............................................................................................124Resetting indefinite status condition........................................................................................... 124Resetting a fence status............................................................................................................... 125Display subsystem information....................................................................................................125
Chapter 14. CPVOLUME command—CKD............................................................................................... 127Formatting CP-owned volumes......................................................................................................... 127Formatting CP-owned volumes for a specific VM operating system................................................ 127Protecting the CPVOLUME command with RACF.............................................................................. 127Syntax................................................................................................................................................. 128
Required parameters....................................................................................................................128Optional parameters.....................................................................................................................129
Formatting cylinders.......................................................................................................................... 131Formatting cylinder 0, track 0...................................................................................................... 132Updating the allocation map........................................................................................................ 133Examining volumes for errors...................................................................................................... 133Displaying volume information.....................................................................................................133Rewriting the volume label...........................................................................................................133
Copying data to a different device size..............................................................................................133Creating a minidisk allocation map................................................................................................... 134Examples of the CPVOLUME command.............................................................................................134
Formatting an entire volume........................................................................................................ 134Formatting part of a volume......................................................................................................... 135Changing volume allocation......................................................................................................... 135
Chapter 15. FLASHCPY commands—CKD for Asynchronous PPRCOPY................................................ 137Protecting the FLASHCPY command with RACF............................................................................... 137FLASHCPY ESTABLISH.......................................................................................................................137
Syntax........................................................................................................................................... 138Required parameters....................................................................................................................138Optional parameters.....................................................................................................................139Examples of Flashcopy Establish.................................................................................................144Flashcopy Establish for Flashcopy of a PPRC Secondary............................................................144Flashcopy Establish with Fast Reverse Restore.......................................................................... 145Flashcopy Establish used to reverse a Flashcopy relationship...................................................146Flashcopy Establish used to establish incremental Flashcopy...................................................146
FLASHCPY QUERY..............................................................................................................................146Syntax........................................................................................................................................... 147Required parameters....................................................................................................................147Optional parameters.....................................................................................................................148Examples of Flashcopy Query...................................................................................................... 148
FLASHCPY QUERY INCREMENTSTATUS............................................................................................149
vii
Syntax........................................................................................................................................... 150Required parameters....................................................................................................................150Optional parameters.....................................................................................................................150Examples of FLASHCPY QUERY INCREMENTSTATUS................................................................. 151
FLASHCPY QUERY RELATIONS..........................................................................................................151Syntax........................................................................................................................................... 152Required parameters....................................................................................................................152Optional parameters.....................................................................................................................152Example of FLASHCPY Query Relations...................................................................................... 153
FLASHCPY WITHDRAW......................................................................................................................153Syntax........................................................................................................................................... 154Required parameters....................................................................................................................154Optional parameters.....................................................................................................................155Examples of Flashcopy Withdraw................................................................................................ 158Flashcopy Withdraw with PPRC Secondary as Flashcopy Source.............................................. 159
Chapter 16. INIT command—CKD.......................................................................................................... 161Protecting the INIT command with RACF......................................................................................... 162Syntax................................................................................................................................................. 162
Required parameters....................................................................................................................162Optional parameters.....................................................................................................................163
Initializing volumes............................................................................................................................ 178Minimal initialization.....................................................................................................................178Medial initialization.......................................................................................................................179Initialization for open-system DASD............................................................................................179Processing in a shared environment............................................................................................ 180Processing in a shared DFSMS environment............................................................................... 180
Resuming after a job or system failure.............................................................................................. 181RANGE parameters: specifying part of a volume.............................................................................. 182CMS version minidisk support........................................................................................................... 183Restoring FFVDP to a volume............................................................................................................ 183Dual copy volumes............................................................................................................................. 183Examples of the INIT command........................................................................................................183
Initializing volumes for the MVS operating system..................................................................... 184Initializing volumes with the Stand-Alone version...................................................................... 186Initializing a minidisk in the CMS version.................................................................................... 187Initializing volumes with the VSE version.................................................................................... 187
Chapter 17. INSPECT command—CKD................................................................................................... 189Protecting the INSPECT command with RACF..................................................................................189Understanding which INSPECT parameters to use.......................................................................... 189Syntax................................................................................................................................................. 191
Required parameters....................................................................................................................191Optional parameters.....................................................................................................................192
Controlling the level of surface checking.......................................................................................... 202RANGE parameters: part of a volume................................................................................................203Assigning alternate tracks..................................................................................................................204Resource serialization when using INSPECT.................................................................................... 205Recovering data after a job or system failure....................................................................................205Preserving data during INSPECT....................................................................................................... 206
Keeping your data in storage or in storage and backup.............................................................. 207Preserving data under Concurrent Media Maintenance.............................................................. 207
Dual copy volumes............................................................................................................................. 208CMS version minidisk support........................................................................................................... 208Examples of the INSPECT command................................................................................................ 209
Inspecting volumes with the MVS version...................................................................................209Producing a volume map of an entire volume in a Stand-Alone version.................................... 210Inspecting volumes with the CMS version...................................................................................211
viii
Checking tracks for defects in the VSE version............................................................................211
Chapter 18. INSTALL command—CKD.................................................................................................... 213Protecting the INSTALL command with RACF...................................................................................214Installing relocated devices...............................................................................................................214
3380..............................................................................................................................................2143390..............................................................................................................................................2149345..............................................................................................................................................214Changing the mode of 3390 volumes.......................................................................................... 214
Syntax................................................................................................................................................. 214Required parameters....................................................................................................................214Optional parameters.....................................................................................................................215
Resuming after a job or system failure.............................................................................................. 216Processing in a shared environment..................................................................................................216Examples of the INSTALL command................................................................................................. 216
Installing and initializing a volume...............................................................................................217Converting an IBM 3390 to 3380 track compatibility mode.......................................................217
Chapter 19. IODELAY command—CKD................................................................................................... 219Protecting the IODELAY command with RACF..................................................................................219Syntax................................................................................................................................................. 219
Required parameters....................................................................................................................219Optional parameters.....................................................................................................................219
Examples of the IODELAY command................................................................................................ 220Delaying 100 ms after every 20 operations with the MVS version............................................. 220
Chapter 20. PPRCOPY commands—CKD................................................................................................ 223Protecting the PPRCOPY command with RACF.................................................................................224PPRCOPY Overview............................................................................................................................224
Non-cascading..............................................................................................................................224Cascading......................................................................................................................................225
Extended Distance Mode................................................................................................................... 225Setting up your environment to use PPRCOPY extended distance.................................................. 225Using PPRCOPY extended distance...................................................................................................226
Establishing PPRCOPY volume pairs............................................................................................226Using synchronous and asynchronous PPRCOPY........................................................................226Using cascading............................................................................................................................ 226Establishing PPRCOPY cascaded pairs........................................................................................ 227Long distance data migration....................................................................................................... 228
Converting from one PPRCOPY volume state to another..................................................................228Monitoring PPRCOPY volume pairs....................................................................................................230PPRCOPY FAILOVER, FAILBACK and FAILOVERMT ......................................................................... 230Using Freeze/Run............................................................................................................................... 231ICKDSF Peer-to-Peer Remote Copy command functions.................................................................231Peer-to-Peer Remote Copy hardware requirements........................................................................ 232Peer-to-Peer Remote Copy (PPRCOPY) restrictions......................................................................... 232Setting up the PPRCOPY environment.............................................................................................. 233
Identifying volume pairs...............................................................................................................233Establishing the PPRCOPY configuration.....................................................................................234Configuring storage subsystem resources for PPRCOPY............................................................ 234Controlling ICKDSF activity to PPRCOPY volumes...................................................................... 235
PPRCOPY DEFINESESSION............................................................................................................... 236Syntax........................................................................................................................................... 237Required parameters....................................................................................................................237Optional parameters.....................................................................................................................238Examples of PPRCOPY DEFINESESSION.....................................................................................238
PPRCOPY DELPAIR–deleting pairs.................................................................................................... 238Syntax........................................................................................................................................... 238
ix
Required parameters....................................................................................................................238Optional parameters.....................................................................................................................239Examples of PPRCOPY DELPAIR.................................................................................................. 240
PPRCOPY DELPATH–deleting paths.................................................................................................. 240Syntax........................................................................................................................................... 240Required parameters....................................................................................................................240Optional parameters.....................................................................................................................241Examples of PPRCOPY DELPATH................................................................................................. 242
PPRCOPY ESTPAIR–establishing pairs..............................................................................................243Syntax........................................................................................................................................... 244Required parameters....................................................................................................................244Optional parameters.....................................................................................................................245Examples of PPRCOPY ESTPAIR.................................................................................................. 250
PPRCOPY ESTPATH–establishing paths............................................................................................251Syntax........................................................................................................................................... 252Required parameters....................................................................................................................252Optional parameters.....................................................................................................................257Examples of PPRCOPY ESTPATH................................................................................................. 258
PPRCOPY FREEZE–suspend all operations for all PPRCOPY volumes on a single storage control.259Syntax........................................................................................................................................... 259Required parameters....................................................................................................................259Optional parameters.....................................................................................................................260Example of PPRCOPY FREEZE..................................................................................................... 261
PPRCOPY POPULATESESSION.......................................................................................................... 261Syntax........................................................................................................................................... 261Required parameters....................................................................................................................262Optional parameters.....................................................................................................................264Examples of PPRCOPY POPULATESESSION................................................................................264
PPRCOPY QUERY–querying status.................................................................................................... 265Syntax........................................................................................................................................... 265Required parameters....................................................................................................................265Optional parameters.....................................................................................................................266Using PPRCOPY QUERY without the PATHS parameter.............................................................. 266Using PPRCOPY QUERY with the PATHS parameter....................................................................273Using PPRCOPY QUERY with the multi-target support............................................................... 280
PPRCOPY QUERY ASYNCCOPY.......................................................................................................... 281Syntax........................................................................................................................................... 284Required parameters....................................................................................................................284Optional parameters.....................................................................................................................284Examples of PPRCOPY QUERY ASYNCCOPY............................................................................... 284
PPRCOPY QUERY OUTOFSYNCSTATE............................................................................................... 285Syntax........................................................................................................................................... 285Required parameters....................................................................................................................286Optional parameters.....................................................................................................................286Examples of PPRCOPY QUERY OUTOFSYNCSTATE.....................................................................286
PPRCOPY QUERY SESSIONSDEVICES...............................................................................................287Syntax........................................................................................................................................... 288Required parameters....................................................................................................................288Optional parameters.....................................................................................................................288Examples of PPRCOPY QUERY SESSIONSDEVICES.................................................................... 288
PPRCOPY RECOVER–recovering data on the recovery system.........................................................288Syntax........................................................................................................................................... 288Required parameters....................................................................................................................288Optional parameters.....................................................................................................................289Examples of PPRCOPY RECOVER.................................................................................................290
PPRCOPY RUN–resume all operations for all PPRCOPY volumes on a single storage control........291Syntax........................................................................................................................................... 291Required parameters....................................................................................................................291
x
Optional parameters.....................................................................................................................292Example of PPRCOPY RUN........................................................................................................... 292
PPRCOPY SETCHARACTERISTICS.....................................................................................................293Syntax........................................................................................................................................... 293Required parameters....................................................................................................................293Optional parameters.....................................................................................................................295Example of PPRCOPY SETCHARACTERISTICS............................................................................295
PPRCOPY STARTASYNCCOPY............................................................................................................ 295Syntax........................................................................................................................................... 296Required parameters....................................................................................................................297Optional parameters.....................................................................................................................298Examples of PPRCOPY STARTASYNCCOPY................................................................................. 300
PPRCOPY SUSPEND–suspending pairs.............................................................................................300Syntax........................................................................................................................................... 301Required parameters....................................................................................................................301Optional parameters.....................................................................................................................301Examples of PPRCOPY SUSPEND................................................................................................ 302
PPRCOPY TERMASYNCCOPY.............................................................................................................303Syntax........................................................................................................................................... 303Required parameters....................................................................................................................304Optional parameters.....................................................................................................................306Examples of PPRCOPY TERMASYNCCOPY.................................................................................. 307
Establishing and managing PPRCOPY volumes and paths............................................................... 307Managing the PPRCOPY system...................................................................................................307Identifying Peer-to-Peer Remote Copy volume states................................................................308Details for setting cache and non-volatile storage...................................................................... 309Obtain SSID, serial number, CCA, and LSS...................................................................................311Obtain physical 3990 interface and ESCON Director address.................................................... 311Establishing paths........................................................................................................................ 312Managing volumes and paths.......................................................................................................313
Examples for using FAILOVER and FAILBACK.................................................................................. 318
Chapter 21. Asynchronous PPRCOPY..................................................................................................... 321Introduction....................................................................................................................................... 321
Background...................................................................................................................................321Asynchronous PPRCOPY Solution................................................................................................321Typical Scenario for establishing an Asynchronous PPRCOPY session...................................... 322
Disaster Recovery for Asynchronous PPRC Processing.................................................................... 322Recovering when Flashcopy target volumes are inconsistent.................................................... 322Asynchronous Peer-to-Peer Remote Copy Recovery from an unplanned outage......................323
Examples of creating Asynchronous PPRCOPY configurations........................................................ 324Example 1: All volumes are contained within one ESS............................................................... 324Example 2: All PPRCOPY primary volumes on one ESS, PPRCOPY secondaries and
Flashcopy targets on another ESS.......................................................................................... 327
Chapter 22. REFORMAT command—CKD............................................................................................... 331Protecting the REFORMAT command with RACF.............................................................................. 331Syntax................................................................................................................................................. 331
Required parameters....................................................................................................................332Optional parameters.....................................................................................................................333
Processing in a shared environment..................................................................................................341Examples of the REFORMAT command.............................................................................................341
Reformatting volumes with the MVS version...............................................................................341Using the REFORMAT command with the CMS version...............................................................343Changing the volume serial number in the VSE version.............................................................. 344
Chapter 23. REVAL command—CKD....................................................................................................... 345Protecting the REVAL command with RACF...................................................................................... 345
xi
Syntax................................................................................................................................................. 346Required parameters....................................................................................................................346Optional parameters.....................................................................................................................347
Formatting tracks and reassigning alternate tracks..........................................................................348Repairing the cause of specific '4E4E' SIMS..................................................................................... 348
Recommendation......................................................................................................................... 349Resuming after a job or system failure.............................................................................................. 349Examples of the REVAL command.....................................................................................................349
Running REVAL with FIXSIM........................................................................................................ 349Reinitializing a volume..................................................................................................................350
Chapter 24. TRKFMT command—CKD.................................................................................................... 351Protecting the TRKFMT command with RACF...................................................................................351Syntax................................................................................................................................................. 351
Required parameters....................................................................................................................351Optional parameters.....................................................................................................................354
Handling of checkpoint data from a previous command.................................................................. 355RANGE parameters: part of a volume................................................................................................356Resource serialization when using TRKFMT..................................................................................... 356Examples of the TRKFMT command................................................................................................. 357
Processing tracks with the MVS version...................................................................................... 357Processing tracks in a Stand-Alone version.................................................................................358Processing tracks in a CMS version..............................................................................................358Processing tracks in the VSE version........................................................................................... 358
Part 3. Using ICKDSF to install and maintain FBA devices................................... 359
Chapter 25. Examples of ICKDSF tasks—FBA devices........................................................................... 361Installing new devices....................................................................................................................... 361
Initializing a replaced HDA with a minimal INIT..........................................................................361Resuming initialization from a checkpoint location.......................................................................... 362Formatting devices.............................................................................................................................363
Formatting FBA minidisks............................................................................................................ 363Formatting an entire volume with the CMS version.....................................................................363Changing the volume serial Number and owner identification................................................... 363Placing an FBAVTOC at the end of a volume................................................................................363Writing the FBAVTOC....................................................................................................................364
Problem determination...................................................................................................................... 364Investigating suspected drive problems......................................................................................364Finding where INSPECT failed..................................................................................................... 365Checking disk surfaces.................................................................................................................365
Media maintenance............................................................................................................................366Conditionally assigning alternate blocks..................................................................................... 366Unconditionally assigning alternate blocks................................................................................. 366Reclaiming flagged blocks............................................................................................................366Saving data during surface checking............................................................................................367
Performing miscellaneous tasks with ICKDSF.................................................................................. 368Erasing a volume...........................................................................................................................368Printing a block assignment map................................................................................................. 368Emulating a CKD device on an FBA device.................................................................................. 369
Chapter 26. ANALYZE command—FBA................................................................................................... 371Syntax................................................................................................................................................. 371
Required parameters....................................................................................................................371Optional parameters.....................................................................................................................372
Detecting hardware problems with DRIVETEST............................................................................... 373Testing the drive and logical volume with ANALYZE....................................................................373
xii
Verifying data records with ANALYZE.......................................................................................... 374Solving problems with ANALYZE output............................................................................................374
Assumed conditions when running ANALYZE..............................................................................374CMS version minidisk support........................................................................................................... 374Examples of the ANALYZE command................................................................................................ 375
Analyzing volumes with the Stand-Alone version....................................................................... 375Analyzing volumes with the CMS version.....................................................................................376Analyzing a VSE version volume...................................................................................................376
Diagnostic messages..........................................................................................................................376
Chapter 27. CONTROL command—FBA.................................................................................................. 379Syntax................................................................................................................................................. 379
Required parameters....................................................................................................................379Optional parameters.....................................................................................................................380
Examples of the CONTROL command............................................................................................... 381Display subsystem information and microcode lic and bundle level..........................................381
Chapter 28. CPVOLUME command—FBA................................................................................................383Formatting CP volumes for a specific VM operating system.............................................................383Syntax................................................................................................................................................. 383
Required parameters....................................................................................................................383Optional parameters.....................................................................................................................384
Formatting pages............................................................................................................................... 386Formatting blocks 0-15................................................................................................................ 387Updating the allocation map........................................................................................................ 388Examining pages for errors...........................................................................................................388Displaying volume information.....................................................................................................388Rewriting the volume serial..........................................................................................................388
Copying data to a different device size..............................................................................................388Creating a minidisk allocation map................................................................................................... 389Examples of the CPVOLUME command.............................................................................................389
Formatting an entire volume........................................................................................................ 389Formatting part of a volume......................................................................................................... 389Changing volume allocation......................................................................................................... 389
Chapter 29. INIT command—FBA...........................................................................................................391Syntax................................................................................................................................................. 391
Required parameters....................................................................................................................392Optional parameters.....................................................................................................................392
Initializing a volume at the minimal level..........................................................................................396Initializing a volume at the maximal level......................................................................................... 396Resuming after a job or system failure.............................................................................................. 396CMS version minidisk support........................................................................................................... 397Examples of the INIT command........................................................................................................397
Initializing volumes with the Stand-Alone version...................................................................... 397Initializing a VSE version FBA volume..........................................................................................398Initializing a minidisk in the CMS version for a VSE environment............................................... 398
Chapter 30. INSPECT command—FBA................................................................................................... 399Understanding which INSPECT parameters to use.......................................................................... 399Syntax................................................................................................................................................. 400
Required parameters....................................................................................................................400Optional parameters.....................................................................................................................401
Assigning alternate blocks.................................................................................................................404Preserving data during INSPECT....................................................................................................... 405
Writing data from a backup or storage location...........................................................................405Retrieving data from the backup location....................................................................................405
Recovering data after a job or system failure....................................................................................406
xiii
CMS version minidisk support........................................................................................................... 407Examples of the INSPECT command................................................................................................ 407
Inspecting volumes with the Stand-Alone version......................................................................407Inspecting volumes with the VSE version....................................................................................408Inspecting volumes with the CMS version...................................................................................408
Chapter 31. IODELAY command—FBA................................................................................................... 409Syntax................................................................................................................................................. 409
Required parameters....................................................................................................................409Optional parameters.....................................................................................................................409
Examples of the IODELAY command................................................................................................ 410Delaying 100 ms after every 20 operations.................................................................................410
Chapter 32. MAPALT command—FBA.....................................................................................................411Syntax................................................................................................................................................. 411
Required parameters....................................................................................................................411Optional parameters.....................................................................................................................412
Reading the MAPALT report output................................................................................................... 412MAPALT diagnostic output................................................................................................................. 413Examples of the MAPALT command.................................................................................................. 413
Mapping volumes with the Stand-Alone version......................................................................... 413Mapping a full VSE version volume.............................................................................................. 414
Chapter 33. REFORMAT command—FBA................................................................................................415Syntax................................................................................................................................................. 415
Required parameters....................................................................................................................415Optional parameters.....................................................................................................................416
Examples of the REFORMAT command.............................................................................................416Reformatting volumes with the VSE version................................................................................417Reformatting a minidisk in the CMS version................................................................................ 417
Appendix A. Device Support Facilities messages (ICK)........................................419Message routing and descriptor codes................................................................................................... 419
ICK001D............................................................................................................................................. 420ICK002D............................................................................................................................................. 420ICK003D............................................................................................................................................. 421ICK004D ............................................................................................................................................ 421ICK005E............................................................................................................................................. 421ICK006E............................................................................................................................................. 421ICK007E............................................................................................................................................. 421ICK008E............................................................................................................................................. 422ICK009I.............................................................................................................................................. 422ICK010I.............................................................................................................................................. 422ICK011E............................................................................................................................................. 422ICK012E............................................................................................................................................. 422ICK013E............................................................................................................................................. 423ICK014D............................................................................................................................................. 423ICK015E............................................................................................................................................. 423ICK016E............................................................................................................................................. 423ICK017D............................................................................................................................................. 423ICK018D ............................................................................................................................................ 424ICK019D ............................................................................................................................................ 424ICK020D............................................................................................................................................. 424ICK024I.............................................................................................................................................. 424ICK030E............................................................................................................................................. 425ICK031E............................................................................................................................................. 425ICK033E............................................................................................................................................. 425
xiv
ICK035I.............................................................................................................................................. 425ICK036I.............................................................................................................................................. 426ICK037I.............................................................................................................................................. 426ICK057I ............................................................................................................................................. 426ICK058I ............................................................................................................................................. 426ICK059I ............................................................................................................................................. 426ICK061I.............................................................................................................................................. 427ICK062I............................................................................