Abstract for Device Support Facilities User's Guide and Reference
Where to find more information
Summary of changes
Introducing ICKDSF
Introduction to ICKDSF
About ICKDSF
Verifying your ICKDSF version
Running multiple ICKDSF jobs
Running ICKDSF on Dual Copy volumes
ICKDSF commands
Operating systems that support ICKDSF
Versions that support ICKDSF commands
Storage requirements
Devices supported by ICKDSF
ICKDSF support of the RAMAC Array family
ICKDSF support of the Internal Disk
ICKDSF support of the 2105, 2107, and 1750
Additional ICKDSF support information
Configuration checking
Processing on XRC volumes
Tasks you can perform with ICKDSF
About DASD storage media
DASD physical characteristics
Data checks
Degree of repeatability
Degree of visibility
Correctable versus uncorrectable
Temporary versus permanent
Error notification
Understanding ICKDSF command statements
ICKDSF command statement syntax
Conflicting keyword parameters
Abbreviating commands and parameters
Separating commands and parameters
Continuing lines
Commenting your code
Ending a command
Writing statements to control ICKDSF processing
Writing a SET statement
Writing the IF-THEN-ELSE statement
Writing the DO-END statement
Writing a null THEN and ELSE
Getting started with the MVS version of ICKDSF
Overview of the ICKDSF tasks using the MVS version
Using JCL to run ICKDSF
Printed output data set
Using ISMF panels to run ICKDSF
Protecting MVS volumes and data sets
Protecting data sets in an offline mode
Protecting data sets in an online mode
Authorizing access with RACF
RACF protected data sets
Non-VSAM password-protected data sets
VSAM and unexpired data sets
VTOC and the VTOCIX data sets
Limiting the use of resources with the Authorized Program Facility (APF)
Protecting ICKDSF commands with RACF
Processing in a shared environment
Preserving data during INSPECT
Preserving data during INSPECT under concurrent media maintenance
Operator's intervention consideration
Getting started with the CMS version
Definition of a minidisk and dedicated device
Overview of ICKDSF tasks using the CMS version
Invoking ICKDSF under CMS from the console
Example of invoking ICKDSF from the console
Invoking ICKDSF with a CMS EXEC
Invoking ICKDSF with an input file
Using parameters to select the input and output devices
Supporting minidisks under the CMS version
Supporting general users without special authority
Using DEVMAINT authority
Supporting dedicated devices under the CMS version
Getting started with the VSE version
Overview of the ICKDSF tasks using the VSE version
Running the VSE version of ICKDSF in batch mode
Operator intervention
Running the VSE version of ICKDSF in command mode
Use of VSE ICKDSF command mode during VSE install process
Command mode restrictions
Verifying identification and preventing data loss
Processing in a shared environment
Sharing across multiple processors
Sharing across multiple users and partitions in a single processor
Getting started with the Stand-Alone version
About the Stand-Alone version
Overview of the ICKDSF tasks using the Stand-Alone version
Creating an ICKDSF Stand-Alone IPL tape using MVS
Creating an ICKDSF Stand-Alone IPL tape using CMS
Preparing to use the Stand-Alone
IPLing the Stand-Alone ICKDSF
IPLing the Stand-Alone from a tape library
IPLing the Stand-Alone from SAPL
IPLing the Stand-Alone with a load parm specified
IPLing the Stand-Alone with no load parm specified
Loading the Stand-Alone ICKDSF from CD-ROM
Defining the input and output device
Interpreting error conditions
Performing ICKDSF tasks on minidisks with the Stand-Alone version
ICKDSF versions supported as guests under VM
Problem solving under VM
Using ICKDSF to install and maintain CKD devices
Examples of ICKDSF tasks—CKD devices
Installing devices
Completing the installation procedure
Installing a device from the factory
Setting an IBM 3390 to 3380 track compatibility mode
Installing a 3375 or older HDA from the factory
Resuming initialization from a checkpoint location
Validating and writing the FFVDP
Validating part of a volume
Writing the FFVDP on part of a volume
Writing the FFVDP regardless of previous processing
Validating from a specific point
Validating to a specific point
Validating and writing the FFVDP for one head
Validating the last heads of a device
Formatting devices
Formatting minidisks
Formatting an entire volume in the CMS version
Formatting part of a volume in the CMS version
Writing the VTOC
Placing a VTOC at the end of a volume
Determining the VTOC size and location
Expanding the VTOC at Its current location
Changing the volume serial number and owner identification
Adding IPL text to a volume
Converting a volume to indexed format
Problem determination
Investigating suspected drive problems
Scanning data on part of a volume
Scanning heads 5 and 6 only, cylinders 500 through 599
Scanning from Head 14, Cylinder 500
Checking disk surfaces with INSPECT
Surface checking part of a volume
Cylinder 4, head 6 through cylinder 50, head 8
All heads, cylinders 50 through 100
Head 4 only on all cylinders
Heads 5 and 6 only, cylinders 500 through 599
All heads from 14, all cylinders from 500
Alternate cylinders of 3380 Models A04, AA4, and AD4
Media maintenance
Conditionally assigning alternate tracks
Unconditionally assigning alternate tracks
Reclaiming a single flagged track
Reclaiming alternate tracks with INSPECT
Finding where INSPECT failed
Saving data during surface checking
Emulating devices
Using a 3995 Model 151 or 153 device
Initializing an emulated CKD device on a 3370 FBA device
Initializing an emulated CKD Device on an IBM 9313, 9332, or 9335 FBA device
Initializing an emulated device at a medial level
Scanning data
Assigning alternate tracks
Media maintenance on an emulated device
Performing miscellaneous tasks with ICKDSF
Clearing a storage path fence status
Erasing a volume
Printing a track assignment map
AIXVOL command—CKD
Syntax
Required parameters
FORMAT|LABEL|EXAMINE parameter: specify function
UNITADDRESS parameter: identify the device
VERIFY|NOVERIFY parameter: verify the volume serial number
Optional parameters
MIMIC(MINI) parameter: specify a special volume usage
RANGE parameter: specify the range of cylinders
READCHECK|NOREADCHECK parameter: specify read-back check
VOLID parameter: specify the volume serial number
Formatting a cylinder with AIXVOL
Errors reported by EXAMINE
Minidisk support
Examples of the AIXVOL command
Formatting an entire volume
Formatting part of a volume
Inspecting a range of cylinders for errors
Rewriting the volume label
ANALYZE command—CKD
Protecting the ANALYZE command with RACF
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS|REALADDR parameter: identify volume (or minidisk)
Optional parameters
ALL parameter: specify the area of data verification
ALLOWONLINE parameter: allow UNIT parameter to online volumes
CHPID|ALLCHPID parameter: specify path control
DEVADDR parameter: specify device address to query for host access information
DIRECTIO parameter: specify primary or secondary volumes
DRIVETEST|NODRIVETEST parameter: specify the drivetest
FROMRANGE parameter: specify a specific starting location
HEADRANGE parameter: specify a range of heads
HOSTACCESS parameter: obtain host access information
LIMITS|CYLRANGE parameter: specify the area of data verification
NOLPS parameter: suppress printing of Logical Path Status Table
PRINTDS parameter: print data set name
SCAN|NOSCAN parameter: run data verification tests
SECWWNN parameter: specifies the WWNN of a volume
SPEED|NOSPEED parameter: specify data verification tests
SUBCHSET parameter: specify the subchannel set identifier
TORANGE parameter: specify a specific ending location
USERID parameter: specify another user's minidisk
Detecting hardware problems with DRIVETEST
Testing the drive and logical volume with ANALYZE
Path control under ANALYZE drive test
Verifying data records with ANALYZE
Data verification output
Unexpected I/O errors
RANGE Parameters: specifying part of a volume
CMS version minidisk support
Dual copy volumes
Examples of the ANALYZE command
Analyzing volumes with the Stand-Alone version
Performing a drive test
Performing a drive test and data verification test
Bypassing the drive test and verifying part of a volume
Analyzing a partial volume
Analyzing volumes with the CMS version
Analyzing another user's minidisk
Analyzing a volume with a real address
Analyzing volumes with the MVS version
Analyzing the primary volume of a dual copy pair
Analyzing the secondary volume of a dual copy pair
Analyzing a volume with the VSE version
Examples of path control under the ANALYZE drive test
Diagnostic messages
Drive test error summary
Movable head error table
Fixed-head error table
Pathing reports
Path status table
Logical path status table
Interface information
Host interface information
Fiber channel connection information
Example
Host access information
BUILDIX command—CKD
Protecting the BUILDIX command with RACF
Syntax
Required parameters
DDNAME parameter: identify the volume
IXVTOC|OSVTOC parameter: identify the BUILDIX function
Optional parameters
PURGE|NOPURGE parameter: specify disposition of the index data set
Processing in a Shared Environment
Converting an OSVTOC to an indexed VTOC
Converting an indexed VTOC to an OSVTOC
Examples of the BUILDIX command
Changing an IXVTOC to an OSVTOC without operator's intervention
Building a VTOC index on a volume without an index allocated
Building a VTOC index on a volume with an index allocated
CONTROL command—CKD
Protecting the CONTROL command with RACF
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the volume
Optional parameters
ALLOWWRITE parameter: clear a storage control
CLEARFENCE parameter: clear a fence status
CONFIGURE(DISPLAY) parameter: display subsystem information
RESETICD parameter: reset indefinite status condition
SCOPE parameter: clear the soft-fenced state for a single device or all of the devices in a logical subsystem
SERIAL parameter: specify the subsystem image serial number
SUBCHSET parameter: specify the subchannel set identifier
Clearing a storage control without performing an IML
Allowing write operations through a storage control
Clearing a fenced path or device
Discarding data pinned in cache
Examples of the CONTROL command
Clearing a WRITE INHIBITed storage control
Clearing a storage path fence status
Resetting indefinite status condition
Resetting a fence status
Display subsystem information
CPVOLUME command—CKD
Formatting CP-owned volumes
Formatting CP-owned volumes for a specific VM operating system
Protecting the CPVOLUME command with RACF
Syntax
Required parameters
FORMAT|ALLOCATE|LABEL|LIST|EXAMINE|OWNER|REFVTOC parameter: specify function
UNITADDRESS parameter: identify the device
VERIFY|NOVERIFY parameter: verify the volume serial number
Optional parameters
FILLER|NOFILLER parameter: specify to include filler records
MIMIC(MINI) parameter: specify a special volume usage
NOSSI|SSINAME parameter: specify VM SSI name
NOSYS|SYSNAME parameter: specify system name
RANGE parameter: specify the range of cylinders
READCHECK|NOREADCHECK parameter: specify read-back check
TYPE parameter: specify the type of allocation
VOLID parameter: specify the volume serial number
Formatting cylinders
Formatting cylinder 0, track 0
Updating the allocation map
Examining volumes for errors
Displaying volume information
Rewriting the volume label
Copying data to a different device size
Creating a minidisk allocation map
Examples of the CPVOLUME command
Formatting an entire volume
Formatting part of a volume
Changing volume allocation
FLASHCPY commands—CKD for Asynchronous PPRCOPY
Protecting the FLASHCPY command with RACF
FLASHCPY ESTABLISH
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which the I/O is issued
TARGETVOL: identify Flashcopy target volume
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
CHANGERECORDING: enable Incremental FlashCopy (change recording with persistence)
FASTREVERSERESTORE: quickly reverse Flashcopy direction during disaster recovery processing
INHIBITTARGETWRITES: indicate whether the Flashcopy target volume can be written to once established
MODE: indicates whether to make a background copy of the source tracks
ONLINTGT: indicate whether I/O to online FLASHCOPY target volume is allowed
PRESERVEMIRROR: indicate the handling of the request based on whether the specified target is a PPRC primary device
RESTORE: reverse Flashcopy direction or establish incremental Flashcopy
SETGTOK: specify space efficient target volume
SOURCEVOL: identify remote Flashcopy source volume
TGTCANCOMEONLINE: indicate whether Flashcopy target volume can come online during IPL
TGTOKASPPRCPRIM: Flashcopy target volume can be PPRCOPY primary volume
Examples of Flashcopy Establish
Flashcopy Establish for Flashcopy of a PPRC Secondary
Flashcopy Establish with Fast Reverse Restore
Flashcopy Establish used to reverse a Flashcopy relationship
Flashcopy Establish used to establish incremental Flashcopy
FLASHCPY QUERY
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
SOURCEVOL: identify remote Flashcopy source volume
Examples of Flashcopy Query
FLASHCPY QUERY INCREMENTSTATUS
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
SESSIONNO: session number for which information is desired
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Examples of FLASHCPY QUERY INCREMENTSTATUS
FLASHCPY QUERY RELATIONS
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Example of FLASHCPY Query Relations
FLASHCPY WITHDRAW
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which the I/O is issued
TARGETVOL: identify Flashcopy target volume
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
FORCE parameter: indicates to withdraw a mirrored relationship immediately instead of initializing a background copy
MODE: indicate whether a background copy of source tracks is started and whether target relations are terminated
RELATSPACE: release allocated target space if target is space efficient
RESETTGTWRTINHIBIT: reset target write inhibit
REVERT/COMMIT: indicate that a pending consistency group Flashcopy state is to revert to a previous consistent version or move forward to the new state
SOURCEVOL: identify remote Flashcopy source volume
Examples of Flashcopy Withdraw
Flashcopy Withdraw with PPRC Secondary as Flashcopy Source
INIT command—CKD
Protecting the INIT command with RACF
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the volume
VERIFY|NOVERIFY parameter: verify volser and ownerid
Optional parameters
BOOTSTRAP|NOBOOTSTRAP parameter: write IPL records
CLEAROWNERID parameter: remove the owner identification
CONTINUE|NOCONTINUE parameter: resume from a checkpoint
CYLRANGE parameter: specify a range of cylinders
DATA|NODATA parameter: write FFVDP
DEVICETYPE parameter: identify the type of device
DOSVTOC|VSEVTOC parameter: specify the VTOC in VSE
FROMRANGE parameter: specify a specific starting location
HEADRANGE parameter: specify a range of heads
INDEX|NOINDEX parameter: creating a VTOC index
IPLDD parameter: write a user-supplied IPL program on the volume
NOCHECK parameter: surface checking of the volume
NODSEXIST parameter: verify no data sets exist on the volume
Writing an IPL program on the volume with IPLDD
Supplying variable-length records as IPL data
LABELS parameter: reserve space for additional volume labels
MAP|NOMAP parameter: print a volume map
MIMIC parameter: specify a special volume usage format
OWNERID parameter: specify the owner identification
PASSWORDS parameter: provide passwords for data set security
PURGE|NOPURGE parameter: write over previously written data
RESERVED parameter: mark the volume as reserved so that it cannot come online
RESERVEPOOLNAME parameter: specify the reserve storage pool name
SMSDSEXIST parameter: Data sets exist on a SMS managed volume
STORAGEGROUP parameter: initialize a volume that is system-managed
SUBCHSET parameter: specify the subchannel set identifier
TORANGE parameter: specify a specific ending location
UNRESERVED parameter: initialize a reserved volume as non-reserved
VALIDATE|NOVALIDATE parameter: validate home address/record 0
VERIFYOFFLINE parameter: verify device is offline to all other systems
VOLID parameter: specify the volume serial number
VTOC parameter: specify the volume table of contents
Initializing volumes
Minimal initialization
Medial initialization
Initialization for open-system DASD
Processing in a shared environment
Processing in a shared DFSMS environment
System-managed volume initialization
Resuming after a job or system failure
RANGE parameters: specifying part of a volume
CMS version minidisk support
Restoring FFVDP to a volume
Dual copy volumes
Examples of the INIT command
Initializing volumes for the MVS operating system
Initializing a volume for the first time in offline mode
Initializing two volumes in offline mode
Initializing a volume using the VTOC(OPENDISK) parameter
Initializing a volume in offline mode without operator's intervention
Initializing a volume to be managed in a DFSMS environment
Initializing a volume previously system-managed in a DFSMS environment
Initializing a volume with an index
Initializing a reserve storage pool volume
Initializing volumes with the Stand-Alone version
Initializing a volume at the medial level
Reinitializing a volume at the medial level
Initializing a minidisk
Initializing a minidisk in the CMS version
Initializing volumes with the VSE version
Initializing a volume at the minimal level
Initializing an emulated partial disk at the minimal level
INSPECT command—CKD
Protecting the INSPECT command with RACF
Understanding which INSPECT parameters to use
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS|REALADDR parameter: identify volume (or minidisk)
VERIFY|NOVERIFY parameter: verify volser and ownerid
Optional parameters
ALLTRACKS parameter: inspect the total volume
ASSIGN|NOASSIGN parameter: specify assignment of alternate tracks
AVAILABLE parameter: specify processing is to continue
CHECK|NOCHECK parameter: surface checking of the volume
CYLRANGE parameter: specify a range of cylinders
DEVICETYPE parameter: identify the type of device
DIRECTIO parameter: identify volume of a dual copy pair
FORCE parameter: specify concurrent processing
FROMRANGE parameter: specify a specific starting location
HEADRANGE parameter: specify a range of heads
MAP|NOMAP parameter: print a volume map
MIMIC parameter: specify a special volume usage format
PASSWORDS parameter: provide passwords for data set security
PRESERVE|KEEPIT|NOPRESERVE|HOLDIT parameter: preserve data
Reading and saving data on inspected tracks
Writing data from a backup location with PRESERVE or KEEPIT
Writing data from a CE cylinder
If errors occur while writing data with PRESERVE or KEEPIT
Saving data on the inspected tracks
RECLAIM|NORECLAIM parameter: reclaim defective tracks
SKIP|NOSKIP parameter: specify the level of surface checking
TOLERATE parameter: specify continue processing
TORANGE parameter: specify a specific ending location
TRACKS parameter: specify discrete tracks
USERID parameter: specify another user's minidisk
Controlling the level of surface checking
RANGE parameters: part of a volume
Assigning alternate tracks
Resource serialization when using INSPECT
Recovering data after a job or system failure
Preserving data during INSPECT
Keeping your data in storage or in storage and backup
Preserving data under Concurrent Media Maintenance
How Concurrent Media Maintenance is performed
Dual copy volumes
CMS version minidisk support
Examples of the INSPECT command
Inspecting volumes with the MVS version
Inspecting for conditional assignment of alternate tracks in online mode
Inspecting for unconditional assignment of alternate tracks in offline mode
Reclaiming tracks in offline mode
Inspecting the secondary volume of a duplex pair in online mode
Inspecting the secondary volume of a duplex pair in offline mode
Producing a volume map of an entire volume in a Stand-Alone version
Inspecting volumes with the CMS version
Inspecting another user's minidisk
Inspecting a minidisk with a real address
Checking tracks for defects in the VSE version
INSTALL command—CKD
Protecting the INSTALL command with RACF
Installing relocated devices
3380
3390
9345
Changing the mode of 3390 volumes
Syntax
Required parameters
SYSNAME|UNITADDRESS parameter: identify the volume
Optional parameters
SETMODE parameter: set 3390 mode
VERIFY|NOVERIFY parameter: verify the volume serial number
Resuming after a job or system failure
Processing in a shared environment
Examples of the INSTALL command
Installing and initializing a volume
Converting an IBM 3390 to 3380 track compatibility mode
IODELAY command—CKD
Protecting the IODELAY command with RACF
Syntax
Required parameters
SET|RESET parameter: set an I/O delay
Optional parameters
PERIO parameter: number of I/Os scheduled
SECONDS|MSECONDS|USECONDS parameter: set the time period
Examples of the IODELAY command
Delaying 100 ms after every 20 operations with the MVS version
PPRCOPY commands—CKD
Protecting the PPRCOPY command with RACF
PPRCOPY Overview
Non-cascading
Cascading
Extended Distance Mode
Setting up your environment to use PPRCOPY extended distance
Using PPRCOPY extended distance
Establishing PPRCOPY volume pairs
Using synchronous and asynchronous PPRCOPY
Using cascading
Establishing PPRCOPY cascaded pairs
Long distance data migration
Converting from one PPRCOPY volume state to another
Monitoring PPRCOPY volume pairs
PPRCOPY FAILOVER, FAILBACK and FAILOVERMT
Using Freeze/Run
ICKDSF Peer-to-Peer Remote Copy command functions
Peer-to-Peer Remote Copy hardware requirements
Peer-to-Peer Remote Copy (PPRCOPY) restrictions
Setting up the PPRCOPY environment
Identifying volume pairs
Establishing the PPRCOPY configuration
Configuring storage subsystem resources for PPRCOPY
Configuring the 3990 storage controls
Availability of cache and NVS
3990 VPD settings for SIM alerts
Recovery site 3990 attached to a host system
Accessing PPRCOPY secondary volumes
Controlling ICKDSF activity to PPRCOPY volumes
Performing an ICKDSF repair on a PPRCOPY-managed primary volume
Performing an ICKDSF repair on a PPRCOPY-managed secondary volume
PPRCOPY DEFINESESSION
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
OPEN/CLOSE: indicate whether opening or closing a session
SESSIONNO: session number for which information is desired
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Examples of PPRCOPY DEFINESESSION
PPRCOPY DELPAIR–deleting pairs
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the primary volume
PRIMARY and SECONDARY parameter: identify control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
LSS parameter: identify logical subsystem number
Examples of PPRCOPY DELPAIR
Example for 2105, 2107, or 1750 using LSS parameter
PPRCOPY DELPATH–deleting paths
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the primary volume
PRIMARY and SECONDARY parameter: identify control unit
WWNN parameter: identifies the World Wide Node Name (WWNN) of the primary and secondary
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
FORCE parameter: force removal of existing paths
LSS parameter: identifies logical subsystem number
Examples of PPRCOPY DELPATH
PPRCOPY-FCP path example
Example for 2105, 2107, and 1750 using the LSS parameter
PPRCOPY ESTPAIR–establishing pairs
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the primary volume
PRIMARY and SECONDARY parameter: identify control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
AUTORESYNC parameter: provides the ability to turn off the auto resync properties associated with a Global Copy pair.
CASCADE parameter: make a volume eligible for or establish it as a cascading volume
CRIT parameter: write update error processing
ESUSP parameter: enable suspension after establishment
FAILOVER | FAILOVERMT | FAILBACK parameter: reverse direction of PPRCOPY
FORCE parameter: override 3-site incremental resync checking
INCRESYNC parameter: manage 3-site Incremental Resync processing
LSS parameter: identify logical subsystem number
MODE parameter: copy mode
MSGREQ parameter: completion message processing
ONLINSEC parameter: specify online secondary volume
OPTION parameter: additional options
PACE parameter: number of tracks to be copied
SESECOK parameter: specify space efficient secondary volume
Examples of PPRCOPY ESTPAIR
PPRCOPY extended distance examples
Example for 2105, 2107, and 1750 using LSS parameter
PPRCOPY ESTPATH–establishing paths
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the primary volume
FCPPATHS parameter: establishes PPRCOPY with Fibre Channel Protocol (FCP) paths
LINK parameter: specifies the addressing path
PRIMARY and SECONDARY parameter: identifies control unit
WWNN parameter: establishes the World Wide Node Name (WWNN) of the primary and secondary
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
CGROUP parameter: how an error that is related to a PPRCOPY device is reported by the 2105, 2107, and 1750
FORCE parameter: force removal of existing logical paths
LSS parameter: identify logical subsystem number
Examples of PPRCOPY ESTPATH
Multiple path example
PPRCOPY-FCP path example
Multiple PPRCOPY-FCP path example
Example for 2105, 2107, and 1750 using the LSS parameter
PPRCOPY FREEZE–suspend all operations for all PPRCOPY volumes on a single storage control
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the primary volume
LSS parameter: identify logical subsystem number
PRIMARY and SECONDARY parameter: identifies the control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Example of PPRCOPY FREEZE
PPRCOPY POPULATESESSION
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
IVOLLIST | RVOLLIST | MTIVOLLIST | MTRVOLLIST: list of individual volumes or ranges of volumes
JOIN/REMOVE: indicate whether volumes are being added or removed from session
SESSIONNO: session number for which information is desired
VOLCOUNT: count of volumes in VOLSLIST
Optional parameters
RANGE: indicate whether ranges or individual volumes are specified
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Examples of PPRCOPY POPULATESESSION
PPRCOPY QUERY–querying status
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the volume
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
PATHS parameter: display path status
Using PPRCOPY QUERY without the PATHS parameter
Using PPRCOPY QUERY with the PATHS parameter
Using PPRCOPY QUERY with the multi-target support
PPRCOPY QUERY ASYNCCOPY
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS|SESSIONNO: identify volume to which I/O is issued
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Examples of PPRCOPY QUERY ASYNCCOPY
PPRCOPY QUERY OUTOFSYNCSTATE
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
SESSIONNO: session number which is to be started or modified
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
ESSLEVEL: indicate whether information is for LSS or entire ESS box
Examples of PPRCOPY QUERY OUTOFSYNCSTATE
PPRCOPY QUERY SESSIONSDEVICES
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Examples of PPRCOPY QUERY SESSIONSDEVICES
PPRCOPY RECOVER–recovering data on the recovery system
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the secondary volume
PRIMARY and SECONDARY parameter: identify control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
LSS parameter: identify logical subsystem number
VERIFY|NOVERIFY parameter: verify volser
VOLID parameter: specify the volume serial number
Examples of PPRCOPY RECOVER
Example for 2105, 2107, and 1750 using LSS parameter
PPRCOPY RUN–resume all operations for all PPRCOPY volumes on a single storage control
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the primary volume
LSS parameter: identify logical subsystem number
PRIMARY and SECONDARY parameter: identifies the control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Example of PPRCOPY RUN
PPRCOPY SETCHARACTERISTICS
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify the volume to which the I/O is issued
USEFORPM: set remote pair Flashcopy characteristics
LSS parameter: identify logical subsystem number
PRIMARY and SECONDARY parameter: identify control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
Example of PPRCOPY SETCHARACTERISTICS
PPRCOPY STARTASYNCCOPY
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
SESSIONNO: session number which is to be started or modified
START/MODIFY: indicate whether to start/resume or modify an Asynchronous PPRCOPY configuration
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
CGINTERVALTIME: indicate amount of time between consistency group formation
MAXCOORDTIME: indicate amount of time host I/O to PPRCOPY primaries can be delayed
MAXDRAINTIME: indicate amount of time to drain tracks to the PPRCOPY secondary device
TOPOLOGY: identify Master and Subordinate ESS boxes
Examples of PPRCOPY STARTASYNCCOPY
PPRCOPY SUSPEND–suspending pairs
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the volume
PRIMARY and SECONDARY parameter: identify control unit
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
LSS parameter: identify logical subsystem number
PRIMAINT parameter: reject write I/O
Examples of PPRCOPY SUSPEND
Example for 2105, 2107, and 1750 using LSS parameter
PPRCOPY TERMASYNCCOPY
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS: identify volume to which I/O is issued
PAUSE/TERMINATE/CGPAUSE: indicate whether to pause or terminate an Asynchronous PPRCOPY configuration
SESSIONNO: session number which is to be paused or terminated
TOPOLOGY: identify Master and Subordinate ESS boxes
Optional parameters
ALLOWONLINE parameter: allow UNIT parameter to online volumes
FORCE: indicate that the termination is to proceed regardless of the state of the formation of consistency groups
MASTER/SUBORDINATE: indicate whether addressing a Master or Subordinate ESS
Examples of PPRCOPY TERMASYNCCOPY
Establishing and managing PPRCOPY volumes and paths
Managing the PPRCOPY system
System IPL volumes
ESCON Manager
Performance measurement data
Console device status commands
Reset notification
Identifying Peer-to-Peer Remote Copy volume states
Details for setting cache and non-volatile storage
Obtain SSID, serial number, CCA, and LSS
Obtain physical 3990 interface and ESCON Director address
Establishing paths
Multiple path example
Managing volumes and paths
Establishing a PPRCOPY volume pair
Querying PPRCOPY volumes and paths
PPRCOPY QUERY without the PATHS parameter
PPRCOPY QUERY with the PATHS parameter
Suspending PPRCOPY volume pair operations
Deleting a PPRCOPY volume pair
Deleting a PPRCOPY path
Determining the logical subsystem number (LSS) for 2105, 2107, and 1750
Determining the logical control unit (LCU) number for RVA
Determining the channel connection address (CCA) for RVA
Determining the System Adapter ID (SAID) value for RVA
Examples for using FAILOVER and FAILBACK
Asynchronous PPRCOPY
Introduction
Background
Asynchronous PPRCOPY Solution
Typical Scenario for establishing an Asynchronous PPRCOPY session
Disaster Recovery for Asynchronous PPRC Processing
Recovering when Flashcopy target volumes are inconsistent
Determining the state of the Flashcopy target volumes
Asynchronous Peer-to-Peer Remote Copy Recovery from an unplanned outage
Examples of creating Asynchronous PPRCOPY configurations
Example 1: All volumes are contained within one ESS
Example 2: All PPRCOPY primary volumes on one ESS, PPRCOPY secondaries and Flashcopy targets on another ESS
REFORMAT command—CKD
Protecting the REFORMAT command with RACF
Syntax
Required parameters
DDNAME|SYSNAME|UNITADDRESS parameter: identify the volume
VERIFY|NOVERIFY parameter: verify the volser and ownerid
Optional parameters
BOOTSTRAP|NOBOOTSTRAP parameter: write IPL records
CLEAROWNERID parameter: remove the owner identification
DUMPCOND parameter: Marks and unmarks a volume as a conditioned volume
EXTINDEX parameter: extend index
EXTVTOC|NEWVTOC|REFVTOC parameter: expand VTOC in current or new location
IPLDD parameter: write a user-supplied IPL program on the volume
IPLTXTEXIST parameter: suppress WTOR message when IPL text exists
Writing an IPL program on the volume with IPLDD
Supplying variable-length records as IPL data
OWNERID parameter: specify a new volume-owner identification
PURGE|NOPURGE parameter: rewrite user volume labels
REMOVEIPLTXT parameter: remove IPL text
VERIFYOFFLINE parameter: verify device is offline to all other systems
VOLID parameter: specify a new volume serial number
VTOCPTR parameter: restore a destroyed volume serial
XRCLOGGER parameter: marks and unmarks a volume as a XRC LOGPLUS designated volume.
Processing in a shared environment
Examples of the REFORMAT command
Reformatting volumes with the MVS version
Changing the volume serial number in offline mode
Adding an IPL program in online mode
Adding IPL text from another volume
Expanding the VTOC and the index
Refreshing the VTOC and index
Using the REFORMAT command with the CMS version
Updating a minidisk in the CMS version
Adding IPL text to an MVS volume using the CMS version
Changing the volume serial number in the VSE version
REVAL command—CKD
Protecting the REVAL command with RACF
Syntax
Required parameters
SYSNAME|UNITADDRESS parameter: identify the volume
VERIFY|NOVERIFY parameter: verify the volser and ownerid
Optional parameters
CYLRANGE parameter: specify a range of cylinders
DATA|NODATA|FIXSIM|REFRESH parameter: rewrite home address and record Zero or user data
HEADRANGE parameter: specify a range of heads
Formatting tracks and reassigning alternate tracks
Repairing the cause of specific '4E4E' SIMS
Recommendation
Resuming after a job or system failure
Examples of the REVAL command
Running REVAL with FIXSIM
Reinitializing a volume
TRKFMT command—CKD
Protecting the TRKFMT command with RACF
Syntax
Required parameters
CYLRANGE parameter: specify a range of cylinders
DDNAME|SYSNAME|UNITADDRESS parameter: identify volume (or minidisk)
ERASEDATA parameter: ERASE a track
FROMRANGE parameter: specify a specific starting location
HEADRANGE parameter: specify a range of heads
TORANGE parameter: specify a specific ending location
VERIFY|NOVERIFY parameter: verify volser and ownerid
Optional parameters
CYCLES parameter: number of iterations of overwrite
PASSWORDS parameter: provide passwords for data set security
TOLERATE parameter: specify continue processing
TRACKS parameter: specify discrete tracks
Handling of checkpoint data from a previous command
RANGE parameters: part of a volume
Resource serialization when using TRKFMT
Examples of the TRKFMT command
Processing tracks with the MVS version
Processing of tracks in online mode
Processing of tracks in offline mode
Processing tracks in a Stand-Alone version
Processing tracks in a CMS version
Processing tracks in the VSE version
Using ICKDSF to install and maintain FBA devices
Examples of ICKDSF tasks—FBA devices
Installing new devices
Initializing a replaced HDA with a minimal INIT
Resuming initialization from a checkpoint location
Formatting devices
Formatting FBA minidisks
Formatting an entire volume with the CMS version
Changing the volume serial Number and owner identification
Placing an FBAVTOC at the end of a volume
Writing the FBAVTOC
Problem determination
Investigating suspected drive problems
Finding where INSPECT failed
Checking disk surfaces
Media maintenance
Conditionally assigning alternate blocks
Unconditionally assigning alternate blocks
Reclaiming flagged blocks
Saving data during surface checking
Performing miscellaneous tasks with ICKDSF
Erasing a volume
Printing a block assignment map
Emulating a CKD device on an FBA device
ANALYZE command—FBA
Syntax
Required parameters
SYSNAME|UNITADDRESS|REALADDR parameter: identify the volume
Optional parameters
DRIVETEST|NODRIVETEST parameter: specify the drive test
LIMITS|BLOCKRANGE|ALL parameter: specify data verification area
SCAN|NOSCAN parameter: run data verification tests
SPEED|NOSPEED parameter: specify data verification tests
USERID parameter: specify another user's minidisk
Detecting hardware problems with DRIVETEST
Testing the drive and logical volume with ANALYZE
Verifying data records with ANALYZE
Solving problems with ANALYZE output
Assumed conditions when running ANALYZE
CMS version minidisk support
Examples of the ANALYZE command
Analyzing volumes with the Stand-Alone version
Performing a drive test
Performing a drive test and data verification test
Performing a partial data verification test
Analyzing volumes with the CMS version
Analyzing another user's minidisk
Analyzing a volume specifying a real address
Analyzing a VSE version volume
Diagnostic messages
CPVOLUME command—FBA
Formatting CP volumes for a specific VM operating system
Syntax
Required parameters
FORMAT|ALLOCATE|LABEL|LIST|EXAMINE|OWNER parameter: specify function
UNITADDRESS parameter: identify the volume
VERIFY|NOVERIFY parameter: verify the volume serial number
Optional parameters
NOSSI|SSINAME parameter: specify VM SSI name
NOSYS|SYSNAME parameter: specify system name
RANGE parameter: specify the range of pages
READCHECK|NOREADCHECK parameter: specify read-back check
TYPE parameter: specify the type of allocation
VOLID parameter: specify the volume serial number
Formatting pages
Formatting blocks 0-15
Updating the allocation map
Examining pages for errors
Displaying volume information
Rewriting the volume serial
Copying data to a different device size
Creating a minidisk allocation map
Examples of the CPVOLUME command
Formatting an entire volume
Formatting part of a volume
Changing volume allocation
INIT command—FBA
Syntax
Required parameters
SYSNAME|UNITADDRESS parameter: identify the volume
VERIFY|NOVERIFY parameter: verify volser and ownerid
Optional parameters
BLOCKRANGE parameter: specify part of the volume
CHECK|NOCHECK parameter: surface checking of the volume
CONTINUE|NOCONTINUE parameter: resume from a checkpoint
FBAVTOC parameter: specify an FBAVTOC
FORMAT parameter: format volume
LABELS parameter: reserve space for additional volume labels
MAP|NOMAP parameter: print an alternate block map
OWNERID parameter: specify the volume-owner identification
PURGE|NOPURGE parameter: rewrite data on a volume
RECLAIM|NORECLAIM parameter: reclaim defective blocks
VOLID parameter: specify the volume serial number
Initializing a volume at the minimal level
Initializing a volume at the maximal level
Resuming after a job or system failure
CMS version minidisk support
Examples of the INIT command
Initializing volumes with the Stand-Alone version
Initializing a volume at the minimal level
Initializing a minidisk
Initializing a VSE version FBA volume
Initializing a minidisk in the CMS version for a VSE environment
INSPECT command—FBA
Understanding which INSPECT parameters to use
Syntax
Required parameters
SYSNAME|UNITADDRESS|REALADDR parameter: identify the volume
VERIFY|NOVERIFY parameter: verify volser ownerid
Optional parameters
ASSIGN|NOASSIGN parameter: specify assignment of alternate blocks
BLOCKRANGE|BLOCKS parameter: specify which blocks to inspect
CHECK|NOCHECK parameter: surface checking of the volume
MAP|NOMAP parameter: print an alternate block map
PRESERVE|KEEPIT|HOLDIT|NOPRESERVE parameter: preserve data
Reading and saving data on inspected blocks
Writing data from a backup location with PRESERVE or KEEPIT
Writing data from a CE cylinder
USERID parameter: specify another user's minidisk
Assigning alternate blocks
Preserving data during INSPECT
Writing data from a backup or storage location
Retrieving data from the backup location
Recovering data after a job or system failure
CMS version minidisk support
Examples of the INSPECT command
Inspecting volumes with the Stand-Alone version
Inspecting for defective blocks
Unconditional alternate block assignment
Inspecting volumes with the VSE version
Unconditionally assigning alternate blocks
Inspecting an FBA volume to check blocks for defects
Inspecting volumes with the CMS version
Inspecting another user's minidisk
Inspecting a minidisk specifying a real address
IODELAY command—FBA
Syntax
Required parameters
SET|RESET parameter: set an I/O delay
Optional parameters
PERIO parameter: number of I/Os scheduled
SECONDS|MSECONDS|USECONDS parameter: set the time period
Examples of the IODELAY command
Delaying 100 ms after every 20 operations
MAPALT command—FBA
Syntax
Required parameters
SYSNAME|UNITADDRESS parameter: identify the volume
Optional parameters
DETAIL|NODETAIL parameter: controlling the program output
LIMITS|ALL parameter: specify the area to be mapped
Reading the MAPALT report output
MAPALT diagnostic output
Examples of the MAPALT command
Mapping volumes with the Stand-Alone version
Mapping a full volume
Mapping a range of blocks in a volume
Mapping a full VSE version volume
REFORMAT command—FBA
Syntax
Required parameters
SYSNAME|UNITADDRESS parameter: identify the volume
VERIFY|NOVERIFY parameter: verify volser and ownerid
Optional parameters
OWNERID parameter: specify a new volume-Ooner identification
VOLID parameter: specify a new volume serial number
Examples of the REFORMAT command
Reformatting volumes with the VSE version
Changing the volume serial number
Changing the volume serial and blanking out the owner-ID
Reformatting a minidisk in the CMS version
Device Support Facilities messages (ICK)
Message routing and descriptor codes
ICK001D
Messages received at the output printer
ICK00001I
ICK31300I
Volume layout and record formats on CKD Devices
Example of a 3380 volume map
Track contents after initialization
IPL bootstrap record contents
How track associations are recorded
VTOC index
Calculating the size of the VTOC
Calculating the size of the VTOC index
Calculating the number of tracks for the index
Determining how many VIERs you need
How ICKDSF determines the default index size
Index terminology and calculations:
Fixed block architecture VTOC (FBAVTOC)
Label record format
FBAVTOC space requirements
Surface checking
Surface checking for possible defects
Primary checking
Primary checking for CKD devices
Primary checking for FBA devices
Skip displacement checking
CHECK(n) values
User security exit module
Loading registers
Return codes for password-protected data sets
Return codes for VSAM and unexpired data sets
Return codes for the IBM module
Replacing the IBM-supplied user exit routine
ICKMCLVL macro
Calling ICKDSF from an application program