version release 17 device support facilities (ickdsf) · device support facilities (ickdsf) version...

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


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


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


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


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


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


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


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


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


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


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


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


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


Examples of the IODELAY command................................................................................................ 410Delaying 100 ms after every 20 operations.................................................................................410

Chapter 32. MAPALT command—FBA.....................................................................................................411Syntax................................................................................................................................................. 411


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


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............................................................................

version release 17 device support facilities (ickdsf) · device support facilities (ickdsf) version...

Documents