Dell EMC Mainframe EnablersResourcePak Base for z/OSVersion 8.4
Product Guide REV 06
ResourcePak Base for z/OS 8.4 Product Guide2
Copyright © 2001-2020 Dell Inc. or its subsidiaries. All Rights Reserved.
Published May 2020
Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS”. DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.
Dell Technologies, Dell, EMC, Dell EMC and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners. Published in the USA.
Dell EMCHopkinton, Massachusetts 01748-91031-508-1000 In North America 1-866-464-7381www.DellEMC.com
CONTENTS
Preface
Chapter 1 Overview
Mainframe Enablers and ResourcePak Base............................................. 30Licensing ............................................................................................ 30
Introduction to ResourcePak Base ........................................................... 31Storage environment features ............................................................ 31Storage pool features ......................................................................... 33Local replication features ................................................................... 34Remote replication features ............................................................... 35
Chapter 2 Getting Started
Post-installation ....................................................................................... 38Setting up security ............................................................................. 38Checking IEFSSN table ...................................................................... 38Initializing thin devices........................................................................ 38Resetting storage pool MaxO to percentage ...................................... 38
Configuring ResourcePak Base ................................................................ 39Creating the SCF initialization file ...................................................... 39Sample SCF initialization file............................................................... 40PARMLIB(SCFINI00) ......................................................................... 41
Running ResourcePak Base...................................................................... 42Customizing the SCF started task ...................................................... 42Starting SCF ...................................................................................... 43Running multiple SCF instances ......................................................... 44Stopping SCF ..................................................................................... 44SCF system abend codes ................................................................... 47SAICALL error codes .......................................................................... 51SCF termination utility........................................................................ 53Running AutoSwap in SCF address space........................................... 54
Using ResourcePak Base commands ........................................................ 55Command format................................................................................ 55Command types ................................................................................. 55
Chapter 3 ResourcePak Base Initialization Parameters
Overview.................................................................................................. 58Parameter verification ........................................................................ 59Default values..................................................................................... 59
ResourcePak Base Initialization Parameter Verification parameters.......... 67PARM_VERIFY................................................................................... 67
SRDF/A Monitor (ASY) parameters.......................................................... 68SCF.ASY.MONITOR ........................................................................... 68SCF.ASY.POLL.INTERVAL ................................................................. 68SCF.ASY.SECONDARY_DELAY ......................................................... 69SCF.ASY.SMF.POLL .......................................................................... 69SCF.ASY.SMF.RECORD..................................................................... 70SCF.ASY.USEREXIT........................................................................... 70
ResourcePak Base for z/OS 8.4 Product Guide 3
Contents
Storage system specification (CNTRL) parameters.................................. 71SCF.CNTRL.EXCLUDE.LIST .............................................................. 71SCF.CNTRL.INCLUDE.LIST ............................................................... 71
Cross-System Communication (CSC) parameters.................................... 72SCF.CSC.ACTIVE............................................................................... 72SCF.CSC[.{symm-serial|RMT}].ACTIVEPOLL ................................... 72SCF.CSC[.symm-serial].ATTNACTIVE ............................................... 73SCF.CSC[.symm-serial].ATTNPATHGRP........................................... 74SCF.CSC[.{symm-serial|RMT}].EXPIRECYCLE ................................. 75SCF.CSC.GATEKEEPER.LIST ............................................................ 76SCF.CSC.GATEKEEPER.symm-serial.LIST ........................................ 76SCF.CSC[.{symm-serial|RMT}].IDLEPOLL ........................................ 77SCF.CSC.INSTANCE.......................................................................... 78SCF.CSC[.{symm-serial|RMT}].MITPERIOD ..................................... 78SCF.CSC.REFORMAT........................................................................ 79SCF.CSC[.{symm-serial|RMT}].SELTIMEOUT .................................. 79SCF.CSC[.{symm-serial|RMT}].VERBOSE ........................................ 80
AutoSwap (DAS) parameters ................................................................... 82SCF.DAS.ACTIVE ............................................................................... 82
Device specification (DEV) parameters .................................................... 83SCF.DEV.ATTR.HRO.EXCLUDE.LIST................................................. 83SCF.DEV.ATTR.HRO.INCLUDE.LIST.................................................. 83SCF.DEV.EXCLUDE.LIST ................................................................... 84SCF.DEV.FIXUP ................................................................................. 84SCF.DEV.INCLUDE.LIST .................................................................... 84SCF.DEV.MULTSS ............................................................................. 85SCF.DEV.WAITINT ............................................................................. 85
Optimizer (DEV.OPTIMIZE) parameters................................................... 86SCF.DEV.OPTIMIZE.ENABLE ............................................................ 86SCF.DEV.OPTIMIZE.MIR ................................................................... 86SCF.DEV.OPTIMIZE.MIR.ENABLE ..................................................... 87SCF.DEV.OPTIMIZE.MIR.EXCLUDE.LIST .......................................... 87SCF.DEV.OPTIMIZE.MIR.INCLUDE.LIST ........................................... 88SCF.DEV.OPTIMIZE.MIR.JOBNAME.LIST ......................................... 88SCF.DEV.OPTIMIZE.MIR.JOBNAME.EXCLUDE.LIST ........................ 89SCF.DEV.OPTIMIZE.MIR.JOBPREFIX.EXCLUDE.LIST ...................... 89SCF.DEV.OPTIMIZE.MIR.JOBPREFIX.LIST ....................................... 90SCF.DEV.OPTIMIZE.MIR.PASSIVE.LIST............................................ 90SCF.DEV.OPTIMIZE.MIR.QUIPOINT.DEVICE .................................... 91SCF.DEV.OPTIMIZE.MIR.QUIPOINT.GLOBAL ................................... 91SCF.DEV.OPTIMIZE.MIR.SRVCLASS.LIST ........................................ 92SCF.DEV.OPTIMIZE.MIR.STORGRP.INCLUDE.LIST ......................... 92SCF.DEV.OPTIMIZE.MIR.VOLMASK.INCLUDE.LIST ......................... 93SCF.DEV.OPTIMIZE.MIR.VOLSER.INCLUDE.LIST ............................ 94SCF.DEV.OPTIMIZE.PAV ................................................................... 94SCF.DEV.OPTIMIZE.PAV.ENABLE..................................................... 95SCF.DEV.OPTIMIZE.PAV.EXCLUDE.LIST.......................................... 95SCF.DEV.OPTIMIZE.PAV.INCLUDE.LIST........................................... 96SCF.DEV.OPTIMIZE.PAV.JOBNAME.LIST......................................... 97SCF.DEV.OPTIMIZE.PAV.JOBNAME.EXCLUDE.LIST........................ 97SCF.DEV.OPTIMIZE.PAV.JOBPREFIX.LIST....................................... 97SCF.DEV.OPTIMIZE.PAV.JOBPREFIX.EXCLUDE.LIST...................... 98SCF.DEV.OPTIMIZE.PAV.PASSIVE.LIST ........................................... 98SCF.DEV.OPTIMIZE.PAV.QUIPOINT.DEVICE .................................... 99SCF.DEV.OPTIMIZE.PAV.QUIPOINT.GLOBAL................................... 99
4 ResourcePak Base for z/OS 8.4 Product Guide
Contents
SCF.DEV.OPTIMIZE.PAV.QUIPOINT.LCU ....................................... 100SCF.DEV.OPTIMIZE.PAV.QUIPOINT.LCU.PCT................................ 100SCF.DEV.OPTIMIZE.PAV.SPLIT.MAX............................................... 101SCF.DEV.OPTIMIZE.PAV.SPLIT.MAX.READ..................................... 101SCF.DEV.OPTIMIZE.PAV.SPLIT.MAX.WRITE.................................. 102SCF.DEV.OPTIMIZE.PAV.SRVCLASS.LIST...................................... 102SCF.DEV.OPTIMIZE.PAV.STORGRP.INCLUDE.LIST ....................... 103SCF.DEV.OPTIMIZE.PAV.TRACK.MIN............................................. 103SCF.DEV.OPTIMIZE.PAV.TRACK.MIN.READ................................... 104SCF.DEV.OPTIMIZE.PAV.TRACK.MIN.WRITE................................. 104SCF.DEV.OPTIMIZE.PAV.VOLMASK.INCLUDE.LIST ....................... 104SCF.DEV.OPTIMIZE.PAV.VOLSER.INCLUDE.LIST .......................... 105SCF.DEV.OPTIMIZE.SELECTION.DSN ............................................ 106SCF.DEV.OPTIMIZE.SELECTION.MEMBER .................................... 106SCF.DEV.OPTIMIZE.SMF.RECID ..................................................... 107SCF.DEV.OPTIMIZE.VERBOSE........................................................ 108
DSE Monitor (DSE) parameters ............................................................. 109SCF.DSE .......................................................................................... 109SCF.DSE.xx.LIST.............................................................................. 109SCF.DSE.symm-serial.LIST ................................................................ 111SCF.DSE.symm-serial.LIST=GATEkeeper=ccuu................................ 112SCF.DSE.symm-serial.xx.LIST........................................................... 113SCF.DSE.symm-serial.poolname.xx.LIST........................................... 115SCF.DSE.MAJOR .............................................................................. 117SCF.DSE.MINOR............................................................................... 117SCF.DSE.WARNING.......................................................................... 117
Gatekeeper specification (GATEKEEPER) parameters ............................ 118SCF.GATEKEEPER.LIST ................................................................... 118SCF.GATEKEEPER.symm-serial.LIST ............................................... 118
Group Name Services (GNS) parameters................................................ 119SCF.GNS.ACTIVE.............................................................................. 119SCF.GNS.WAITINT ........................................................................... 119
General Pool Management (GPM) parameters....................................... 120SCF.GPM.OSUB .............................................................................. 120
SCF initialization (INI) parameters .......................................................... 121SCF.INI.COMMAND.MAX ................................................................. 121SCF.INI.CPFX.................................................................................... 121SCF.INI.CPFX.DD............................................................................. 122SCF.INI.SCOPE................................................................................ 122
Licensing (LFC) parameters ................................................................... 123SCF.LFC.LCODES.LIST.................................................................... 123
SCF log file (LOG) parameters ............................................................... 124SCF.LOG.CYLINDER ........................................................................ 124SCF.LOG.DATACLAS ....................................................................... 124SCF.LOG.MGMTCLAS ..................................................................... 125SCF.LOG.RETAIN.COUNT ............................................................... 125SCF.LOG.RETAIN.DAYS................................................................... 125SCF.LOG.STORCLAS....................................................................... 126SCF.LOG.TRACKS.PRI..................................................................... 126SCF.LOG.TRACKS.SEC .................................................................... 127
Multi-Session Consistency (MSC) parameters....................................... 128SCF.MSC.ADCOPY.ONDROP .......................................................... 128SCF.MSC.AUTO.RECOVER.RETRY ................................................. 128SCF.MSC.CYCLE.TIME.WARN ........................................................ 129SCF.MSC.ENABLE........................................................................... 129
ResourcePak Base for z/OS 8.4 Product Guide 5
Contents
SCF.MSC.GTFUSR.RECID ............................................................... 130SCF.MSC.GTFUSR.TRACE .............................................................. 130SCF.MSC.MAX.LOCK.WAIT.............................................................. 131SCF.MSC.OVERWRITE..................................................................... 131SCF.MSC.PAVO............................................................................... 132SCF.MSC.SDDFQ.TODA .................................................................. 132SCF.MSC.SDDFQ.TOMF.................................................................. 133SCF.MSC.SDDFQ.TOOS.................................................................. 133SCF.MSC.VERBOSE ........................................................................ 134
Feature registration (REG) parameters .................................................. 135SCF.REG.MAX.ERRORS .................................................................. 135SCF.REG.MAX.CONTROLLER.ERRORS.......................................... 135SCF.REG.WAITINT........................................................................... 135
SDV Monitor (SDV) parameters ............................................................. 136SCF.SDV .......................................................................................... 136SCF.SDV.xx.LIST.............................................................................. 136SCF.SDV.symm-serial.LIST .............................................................. 138SCF.SDV.symm-serial.LIST=GATEkeeper=ccuu............................... 139SCF.SDV.symm-serial.xx.LIST.......................................................... 140SCF.SDV.symm-serial.poolname.xx.LIST.......................................... 142
SNAP Monitor (SNAP) parameters ........................................................ 145SCF.SNAP.NOTIFY_POLLING ......................................................... 145SCF.SNAP.NOTIFY_POLLTIME ....................................................... 145
Service task (SRV) parameters .............................................................. 146SCF.SRV.GSM.ACTIVE .................................................................... 146SCF.SRV.GSM.INTERVAL................................................................ 146
SRDF/A Single Session (SS) Auto Recovery parameters......................... 147SCF.SS.AUTO.RECOVER.................................................................. 147SCF.SS.AUTO.RECOVER.symm-serial.srdfgrp ................................. 147SCF.SS.AUTO.RECOVER.BCV......................................................... 148SCF.SS.AUTO.RECOVER.BCV.symm-serial.srdfgrp ........................ 149SCF.SS.AUTO.RECOVER.ITRK ........................................................ 150SCF.SS.AUTO.RECOVER.ITRK.symm-serial .................................... 150SCF.SS.AUTO.RECOVER.JOBNAME................................................ 151SCF.SS.AUTO.RECOVER.JOBNAME.symm-serial............................ 151SCF.SS.AUTO.RECOVER.LPAR....................................................... 152SCF.SS.AUTO.RECOVER.MINDIR ................................................... 152SCF.SS.AUTO.RECOVER.MINDIR.symm-serial ............................... 153SCF.SS.AUTO.RECOVER.PREFIX ................................................... 153SCF.SS.AUTO.RECOVER.PROC...................................................... 154
THN Monitor (THN) parameters ............................................................ 155SCF.THN.......................................................................................... 155SCF.THN.REMOTE .......................................................................... 155SCF.THN.xx.LIST ............................................................................. 155SCF.THN.symm-serial.LIST.............................................................. 157SCF.THN.symm-serial.LIST=GATEkeeper=ccuu .............................. 158SCF.THN.symm-serial.xx.LIST ......................................................... 159SCF.THN.symm-serial.poolname.xx.LIST .......................................... 161
SCF tracing (TRACE) parameters .......................................................... 163SCF.TRACE.COMPRESS ................................................................. 163SCF.TRACE.CYLINDER.................................................................... 163SCF.TRACE.DATACLAS................................................................... 164SCF.TRACE.FLUSH.AT .................................................................... 164SCF.TRACE.MEGS........................................................................... 164SCF.TRACE.MGMTCLAS................................................................. 165
6 ResourcePak Base for z/OS 8.4 Product Guide
Contents
SCF.TRACE.RETAIN.COUNT........................................................... 165SCF.TRACE.RETAIN.DAYS .............................................................. 166SCF.TRACE.STORCLAS .................................................................. 166SCF.TRACE.TRACKS.PRI ................................................................ 166SCF.TRACE.TRACKS.SEC ............................................................... 167
TRU Monitor (TRU) parameters............................................................. 168SCF.TRU.DEBUG ............................................................................. 168SCF.TRU.DEV.EXCLUDE.LIST ......................................................... 168SCF.TRU.DEV.INCLUDE.LIST .......................................................... 169SCF.TRU.ENABLE............................................................................ 169SCF.TRU.OFFLINE........................................................................... 170SCF.TRU.RECLAIM.DSFACTOR ...................................................... 170SCF.TRU.RECLAIM.DSPREFIX ......................................................... 171SCF.TRU.RECLAIM.METHOD........................................................... 171SCF.TRU.RECLAIM.PGMNAME........................................................ 172SCF.TRU.RECLAIM.POST.MAX........................................................ 172SCF.TRU.RECLAIM.POST.MIN......................................................... 173SCF.TRU.RECLAIM.POST.PCT......................................................... 173SCF.TRU.RECLAIM.POST.TYPE....................................................... 174SCF.TRU.RECLAIM.SCRATCH.WAIT................................................ 174SCF.TRU.RECLAIM.STCNAME........................................................ 175SCF.TRU.RECLAIM.STRESS.MONITOR.......................................... 175SCF.TRU.RECLAIM.STRESS.WAIT.................................................. 176SCF.TRU.RECLAIM.SYSVTOC.HOLDLIMIT ..................................... 176SCF.TRU.RECLAIM.SYSVTOC.TRKLIMIT......................................... 177SCF.TRU.RECLAIM.SYSVTOC.WAIT ................................................ 177SCF.TRU.RECLAIM.TIMELIMIT.LIST ............................................... 178SCF.TRU.RECLAIM.TASK.LIMIT...................................................... 178SCF.TRU.SCAN.PGMNAME ............................................................ 178SCF.TRU.SCAN.STCNAME ............................................................. 179SCF.TRU.SCAN.TASK.LIMIT............................................................ 179SCF.TRU.SCRATCH.POST.MAX...................................................... 180SCF.TRU.SCRATCH.POST.MIN....................................................... 180SCF.TRU.SCRATCH.POST.PCT ....................................................... 181SCF.TRU.SCRATCH.POST.TYPE...................................................... 181SCF.TRU.SCRATCH.RECLAIM ........................................................ 182SCF.TRU.THICKR1 ........................................................................... 182
SCF log and trace file (WORK) parameters ............................................ 183SCF.WORK.HLQ .............................................................................. 183SCF.WORK.UNIT ............................................................................. 183SCF.WORK.VOLSER ........................................................................ 184
SRDF/A Write Pacing Monitor (WPA) parameters.................................. 185SCF.WPA.EXCLUDE.CNTRL[.LIST] ................................................. 185SCF.WPA.INCLUDE.CNTRL[.LIST].................................................. 186SCF.WPA.MONITOR........................................................................ 186SCF.WPA.MSGLEVEL...................................................................... 187SCF.WPA.POLL.INTERVAL.............................................................. 188SCF.WPA.SMF................................................................................. 188SCF.WPA.SMF.FILTER .................................................................... 189SCF.WPA.SMF.RECORD ................................................................. 190SCF.WPA.STYPES ........................................................................... 190
Chapter 4 Using Symmetrix Control Facility (SCF)
Introduction ........................................................................................... 194
ResourcePak Base for z/OS 8.4 Product Guide 7
Contents
Managing the storage environment ........................................................ 195Summary of operations .................................................................... 195Viewing licenses ............................................................................... 198Discovering devices .......................................................................... 203Viewing storage systems and devices............................................... 204Multiple subchannel addressing ........................................................ 214Dynamic activation of IODF configuration statements...................... 215Dynamic Volume Expansion (DVE) support ...................................... 215HRO-controlled devices in AutoSwap groups ................................... 218Global State Management ................................................................ 219Non-disruptive SymmAPI-MF refreshes ........................................... 220Command Prefix Facility................................................................... 220SCF log and trace files...................................................................... 220
Command reference............................................................................... 222Syntax conventions .......................................................................... 222DEV,CH,CNTRL................................................................................ 223DEV,DISPLAY ................................................................................... 224DEV,EXPAND ................................................................................... 228DEV,REFRESH ................................................................................. 231DEV,RESCAN ................................................................................... 232DEV,STATUS.................................................................................... 232DEV,UNPIN ...................................................................................... 233ELM,LIST ......................................................................................... 234ELM,QUERY..................................................................................... 235INI,REFRESH ................................................................................... 236INI,RELOAD...................................................................................... 236INI,SHUTDOWN ............................................................................... 237REC,QUERYDEVICELOCK ............................................................... 238REC,RELEASEDEVICELOCK............................................................ 239SRV,SYSBUSY,HELP ....................................................................... 240SRV,SYSBUSY,DISPLAY .................................................................. 240SRV,SYSBUSY,DECREMENT........................................................... 241SRV,SYSBUSY,RESET ..................................................................... 241
Chapter 5 Controlling Communications (CSC)
Introduction ........................................................................................... 244 Getting started....................................................................................... 244
Configuring CSC............................................................................... 244 Controlling communications ................................................................... 245
Summary of operations .................................................................... 245Polling storage systems.................................................................... 246Selecting gatekeepers ...................................................................... 246Polling hosts ..................................................................................... 248Enginuity Attention........................................................................... 248Viewing hosts ................................................................................... 249Working with multiple SCF instances................................................ 253Viewing listeners............................................................................... 255Verbose messaging........................................................................... 256
Command reference............................................................................... 257Syntax conventions .......................................................................... 257CSC,DISPLAY,HOSTS...................................................................... 257CSC,DISPLAY,LISTENER ................................................................. 259CSC,REFRESH................................................................................. 260
8 ResourcePak Base for z/OS 8.4 Product Guide
Contents
Chapter 6 Naming Storage Systems (ESFCTLNM)
Introduction ........................................................................................... 262 Getting started....................................................................................... 262
Running ESFCTLNM utility............................................................... 262 Naming a storage system ....................................................................... 262 Command reference............................................................................... 263
Syntax conventions .......................................................................... 263ASSIGN NAME................................................................................. 263
Chapter 7 Validating System Paths (ESFCHNU1)
Introduction ........................................................................................... 266 Getting started....................................................................................... 266
Running ESFCHNU1 utility................................................................ 266 Command reference............................................................................... 267
Syntax conventions .......................................................................... 267ALL................................................................................................... 267CCUU ............................................................................................... 267
Return codes.......................................................................................... 268
Chapter 8 Resetting FBA Paths and Devices (ESFFUCBC)
Introduction ........................................................................................... 270 Getting started........................................................................................ 271
Running ESFFUCBC utility ................................................................ 271Sample JCL ....................................................................................... 271Parameters........................................................................................ 271
Chapter 9 Managing Device Groups (GNS)
Introduction ........................................................................................... 274 Getting started....................................................................................... 275
Configuring GNS .............................................................................. 275Running EMCGROUP batch utility ................................................... 275
Managing GNS groups ........................................................................... 276Summary of operations .................................................................... 276Defining GNS groups ........................................................................ 277GNS group types .............................................................................. 277Open systems group support............................................................ 280
Command reference: EMCGROUP batch utility ..................................... 281Overview .......................................................................................... 281Syntax conventions .......................................................................... 282Common parameters ........................................................................ 282DEFINE COMPLEMENT................................................................... 286DEFINE GROUP ............................................................................... 288DEFINE ENTERPRISE GROUP......................................................... 293DEFINE GROUP FOR GCOPYBCV ................................................... 295DELETE GROUP............................................................................... 297DISPLAY GROUP ............................................................................. 298LIST GROUP .................................................................................... 300REMOVE FROM GROUP DEVICE .................................................... 301REMOVE FROM GROUP RDF GROUP ............................................ 302RENAME GROUP............................................................................. 303
Command reference: SCF GNS.............................................................. 304Overview .......................................................................................... 304
ResourcePak Base for z/OS 8.4 Product Guide 9
Contents
Syntax conventions .......................................................................... 304GNS,FORMAT.................................................................................. 304GNS,LIST ......................................................................................... 305GNS,REFRESH................................................................................. 307GNS,REVERT ................................................................................... 307
GNS reason codes.................................................................................. 308
Chapter 10 Managing Quality of Service (QoS)
Introduction ........................................................................................... 312 Getting started....................................................................................... 313
Security prerequisites....................................................................... 313Running the QoS utility..................................................................... 313
Copy priorities........................................................................................ 315Overview .......................................................................................... 315Managing copy priorities .................................................................. 315
Dynamic Cache Partitioning (DCP) ........................................................ 316Overview .......................................................................................... 316DCP analysis mode ........................................................................... 316Setting up DCP.................................................................................. 317Exploring cache partitions ................................................................. 317Managing cache partitions................................................................. 317DCP example .................................................................................... 318
Mixed SRDF Mode (MRDF) ................................................................... 319Overview .......................................................................................... 319Redistribution of CPU weights ......................................................... 320Managing MRDF policy and weights................................................. 320
Symmetrix Priority Control (Enginuity 5876) ......................................... 321Overview .......................................................................................... 321Managing SPC priorities ................................................................... 321SPC example .................................................................................... 322
Command reference: Miscellaneous ....................................................... 323Syntax conventions .......................................................................... 323EXIT ................................................................................................. 323WAIT ................................................................................................ 323
Command reference: DCP...................................................................... 324Syntax conventions .......................................................................... 324Common parameters ........................................................................ 324DISPCCFG ....................................................................................... 325DISPCDEV/DISPCDVG and DISPCDV.............................................. 326DISPCGEN ....................................................................................... 327DISPCGRP ....................................................................................... 327DISPCUSE........................................................................................ 328SETCACHE ...................................................................................... 329SETCPADD....................................................................................... 329SETCPDEL ....................................................................................... 330SETCPMOD ..................................................................................... 331SETCPMRP...................................................................................... 331SETCPMVD and SETCPMV ............................................................. 332
Command reference: Copy priority......................................................... 334Syntax conventions .......................................................................... 334Common parameters ........................................................................ 334DISPCPYP and DISPDEV.................................................................. 334QOSGET .......................................................................................... 336QOSRESET ...................................................................................... 337
10 ResourcePak Base for z/OS 8.4 Product Guide
Contents
QOSSET........................................................................................... 338SETCPYP and SETDEVCP ............................................................... 340
Command reference: SPC...................................................................... 342Syntax conventions .......................................................................... 342Common parameters ........................................................................ 342DISPDEVP and DISPDEV.................................................................. 342DISPSPC .......................................................................................... 343SETDEVP and SETDEV .................................................................... 344SETDIR and SETSPC ....................................................................... 345
Command reference: MRDF................................................................... 347Syntax conventions .......................................................................... 347Common parameters ........................................................................ 347MRDFDISP DEFAULTS .................................................................... 347MRDFDISP RDFSTATS .................................................................... 348MRDFDISP WEIGHTS ...................................................................... 349MRDFSET POLICY ........................................................................... 350MRDFSET RESET ............................................................................ 351MRDFSET WEIGHTS ....................................................................... 352
Chapter 11 Optimizing I/O(zBoost PAV Optimizer, Mirror Optimizer)
Introduction ........................................................................................... 356Requirements and restrictions.......................................................... 360
Getting started....................................................................................... 361Security............................................................................................ 361Configuring optimizers ..................................................................... 361
Optimizing I/Os...................................................................................... 365Summary of operations .................................................................... 365Operation modes .............................................................................. 368Selecting devices.............................................................................. 368Selecting datasets ............................................................................ 370Limiting optimization by started task/job .......................................... 371Limiting optimization by service class................................................ 371Limiting optimization by tracks (zBoost PAV Optimizer) ................... 371Controlling number of splits/constituent I/Os (zBoost PAV Optimizer) .. ........................................................................................................ 372Setting quiesce points ...................................................................... 372Consistency support......................................................................... 374Processing error conditions (Mirror Optimizer)................................ 375
SMF recording ....................................................................................... 376Overview .......................................................................................... 376SMF record types............................................................................. 376SMF record format........................................................................... 377STATS record fields ......................................................................... 379SMF reporting utility ........................................................................ 386
Command reference............................................................................... 390Syntax conventions .......................................................................... 390DEV,OPTIMIZE ENABLE .................................................................. 390DEV,OPTIMIZE DISABLE ................................................................. 390DEV,OPTIMIZE DISPLAY CONSISTENCY ........................................ 391DEV,OPTIMIZE DISPLAY DEVICE .................................................... 392DEV,OPTIMIZE DISPLAY EVENTS ................................................... 399DEV,OPTIMIZE DISPLAY SSID......................................................... 400DEV,OPTIMIZE DISPLAY SUMMARY............................................... 402
ResourcePak Base for z/OS 8.4 Product Guide 11
Contents
DEV,OPTIMIZE HELP....................................................................... 403DEV,OPTIMIZE LOG EVENTS .......................................................... 403DEV,OPTIMIZE REFRESH................................................................ 404DEV,OPTIMIZE RESET..................................................................... 405DEV,OPTIMIZE RESUME ................................................................. 406DEV,OPTIMIZE SUSPEND ............................................................... 407
Optimizer batch interface (ESFOPTBT)................................................. 408Overview .......................................................................................... 408JCL and parameters ......................................................................... 408Example............................................................................................ 412
Chapter 12 Monitoring Track Changes (ChangeTracker)
Introduction ........................................................................................... 414 Getting started....................................................................................... 415
Prerequisites .................................................................................... 415Running ChangeTracker Collector .................................................... 415ChangeTracker Collector sample JCL............................................... 415ChangeTracker Collector configuration parameters ......................... 416ChangeTracker Collector sample CONFIG file .................................. 423Running ChangeTracker Reporter .................................................... 423ChangeTracker Reporter sample JCL ............................................... 424ChangeTracker Reporter configuration parameters.......................... 425
Tracking changes with ChangeTracker Collector .................................... 433Overview .......................................................................................... 433Setting up change track collection ................................................... 434Selecting devices to track changes .................................................. 434Setting up ChangeTracker Collector log dataset .............................. 434ChangeTracker Collector log dataset ............................................... 436Dumping VTOCs ............................................................................... 437Storage estimates for ChangeTracker Collector disk output ............ 437
Producing reports with ChangeTracker Reporter ................................... 438Overview .......................................................................................... 438Setting up reports ............................................................................ 439Collector Summary report ................................................................ 439Reporter Summary report ................................................................ 440Symmetrix Summary report.............................................................. 441Volume Summary report................................................................... 443Dataset Summary report .................................................................. 445Interval statistics file ........................................................................ 446
Command reference............................................................................... 448Syntax conventions .......................................................................... 448DISPLAY ALL.................................................................................... 448DISPLAY CYCLE............................................................................... 448DISPLAY DEVICE ............................................................................. 449DISPLAY LOG................................................................................... 450HELP ................................................................................................ 451LOG# ............................................................................................... 451LOGSWAP........................................................................................ 451STOP................................................................................................ 451VOLSER ........................................................................................... 452
Chapter 13 Comparing Tracks (Disk Compare)
Introduction ........................................................................................... 454
12 ResourcePak Base for z/OS 8.4 Product Guide
Contents
Getting started....................................................................................... 455Prerequisites .................................................................................... 455Running Disk Compare ..................................................................... 455Sample JCL ...................................................................................... 455Parameters....................................................................................... 456
Comparing tracks................................................................................... 461Summary of operations .................................................................... 461Examples .......................................................................................... 461
Chapter 14 Managing Storage Pools (GPM)
Introduction ........................................................................................... 466PowerMaxOS 5978 and HYPERMAX OS 5977 ................................. 466Enginuity 5876 ................................................................................. 466
Getting started....................................................................................... 467Configuring GPM.............................................................................. 467Executing GPM commands............................................................... 467Running the ESFGPMBT utility ........................................................ 467ESFGPMBT conditional processing .................................................. 468
Working with pools(PowerMaxOS 5978 and HYPERMAX OS 5977) ..................................... 470
Storage groups................................................................................. 470Storage resource pools..................................................................... 473Service level objectives .................................................................... 474Workload .......................................................................................... 476Disk group ........................................................................................ 476Summary of operations .................................................................... 477SRP-level alerts................................................................................ 480
Working with pools (Enginuity 5876) ..................................................... 481Summary of operations .................................................................... 481Creating/deleting pools .................................................................... 484Adding/removing devices ................................................................. 497Allocating/reallocating tracks........................................................... 501Moving allocations............................................................................ 501Draining data or save devices ........................................................... 503Rebalancing pools............................................................................ 505Compressing thin devices................................................................. 508Halting thin device tasks................................................................... 517Pool-level alerts................................................................................ 518
Queries (PowerMaxOS 5978 and HYPERMAX OS 5977) ....................... 520Storage Group Query ....................................................................... 520Storage Group (SG) Performance Statistics Query.......................... 522Storage Resource Pool Query .......................................................... 524Service Level Objective Query.......................................................... 526Disk Group Query ............................................................................. 528Pool Query ....................................................................................... 530Thin Device Query ............................................................................ 532Thin Device Allocations Query .......................................................... 535Thin Device Allocations by Pool Query.............................................. 536Data Device Query............................................................................ 537
Queries (Enginuity 5876) ....................................................................... 540FAST Tier Query............................................................................... 540Pool Query ....................................................................................... 540Pool Device Query ............................................................................ 543Thin Device Query ............................................................................ 545
ResourcePak Base for z/OS 8.4 Product Guide 13
Contents
Thin Device Allocations Query ......................................................... 550Thin Device Allocations by Pool Query.............................................. 553Data Device Query........................................................................... 556Save Device Query .......................................................................... 560Rebalance Task Query ...................................................................... 562
Command reference(PowerMaxOS 5978 and HYPERMAX OS 5977) ..................................... 564
Syntax conventions .......................................................................... 564Common parameters ........................................................................ 564ADD SYMSG..................................................................................... 569ALLOCATE ....................................................................................... 570CREATE SYMSG .............................................................................. 571DELETE SYMSG............................................................................... 574HALTTASK ....................................................................................... 575HELP ................................................................................................ 575PERSIST OFF................................................................................... 576QUERY ALLOC ................................................................................. 576QUERY ALLALLOCS......................................................................... 578QUERY DATADEV ............................................................................ 580QUERY DISKGRP ............................................................................. 582QUERY POOLDEV............................................................................ 583QUERY POOLS ................................................................................ 583QUERY SAVEDEV ............................................................................ 583QUERY SLO ..................................................................................... 583QUERY SRP ..................................................................................... 585QUERY SYMSG................................................................................ 586QUERY THINDEV ............................................................................. 588REFRESH SYMSG........................................................................... 590REMOVE SYMSG............................................................................. 591RENAME POOL................................................................................ 592RENAME SLO .................................................................................. 593RENAME SYMSG............................................................................. 594SET SRP ......................................................................................... 595SET SYMSG ..................................................................................... 597USR_NRDY ...................................................................................... 599USR_RDY........................................................................................ 600
Command reference (Enginuity 5876).................................................... 602Syntax conventions .......................................................................... 602Common parameters ........................................................................ 602ADD POOL ....................................................................................... 604ALLOCATE ....................................................................................... 606BIND................................................................................................. 608COMPRESS ...................................................................................... 611CREATE POOL................................................................................. 614DECOMPRESS................................................................................. 616DELETE POOL ................................................................................. 618DISABLE........................................................................................... 619DISPLAY........................................................................................... 621DRAIN .............................................................................................. 624ENABLE ........................................................................................... 626HALTTASK ....................................................................................... 628HDRAIN............................................................................................ 630HELP ................................................................................................ 632MOVE............................................................................................... 633PERSIST OFF................................................................................... 635
14 ResourcePak Base for z/OS 8.4 Product Guide
Contents
POOLATTR ...................................................................................... 637QUERY ALLOC ................................................................................. 640QUERY ALLALLOCS......................................................................... 641QUERY DATADEV ............................................................................ 643QUERY POOLDEV............................................................................ 645QUERY POOLS ................................................................................ 647QUERY SAVEDEV ............................................................................ 648QUERY TASKS ................................................................................ 650QUERY TIERS .................................................................................. 651QUERY THINDEV ............................................................................. 652REBALANCE .................................................................................... 654REBIND ............................................................................................ 656REMOVE POOL................................................................................ 658RENAME POOL................................................................................ 659UNBIND............................................................................................ 661USR_NRDY ...................................................................................... 663USR_RDY......................................................................................... 665
Condition statements (ESFGPMBT) ...................................................... 667IF ...................................................................................................... 667ELSE ................................................................................................ 668ENDIF............................................................................................... 668RESET.............................................................................................. 668
Return codes (ESFGPMBT)................................................................... 669
Chapter 15 Monitoring Thin Pools (THN Monitor)
Introduction ........................................................................................... 672 Getting started....................................................................................... 673
Configuring THN Monitor ................................................................. 673Running THN Monitor....................................................................... 673
Monitoring thin pools ............................................................................. 674Summary of operations .................................................................... 674Optional user exit ............................................................................. 674Examples .......................................................................................... 675
Command reference............................................................................... 680Syntax conventions .......................................................................... 680THN,DISABLE .................................................................................. 680THN,DISPLAY .................................................................................. 681THN,ENABLE ................................................................................... 682THN,LOCAL ..................................................................................... 682THN,REFRESH................................................................................. 683THN,REMOTE.................................................................................. 683
Chapter 16 Monitoring Snap Pools (SDV Monitor)
Introduction ........................................................................................... 686 Getting started....................................................................................... 687
Configuring SDV Monitor ................................................................. 687Running SDV Monitor ....................................................................... 687
Monitoring Snap pools ........................................................................... 688Summary of operations .................................................................... 688Optional user exit ............................................................................. 688Example............................................................................................ 689
Command reference............................................................................... 690Syntax conventions .......................................................................... 690
ResourcePak Base for z/OS 8.4 Product Guide 15
Contents
SDV,DISABLE................................................................................... 690SDV,DISPLAY................................................................................... 691SDV,ENABLE.................................................................................... 692SDV,REFRESH ................................................................................. 692
Chapter 17 Monitoring DSE Pools (DSE Monitor)
Introduction ........................................................................................... 694 Getting started....................................................................................... 696
Configuring DSE Monitor.................................................................. 696Running DSE Monitor ....................................................................... 696
Monitoring DSE pools ............................................................................ 697Summary of operations .................................................................... 697Optional user exit ............................................................................. 697Example............................................................................................ 698
Command reference............................................................................... 699Syntax conventions .......................................................................... 699DSE,DISABLE................................................................................... 699DSE,DISPLAY ................................................................................... 700DSE,ENABLE.................................................................................... 701DSE,REFRESH ................................................................................. 701
Chapter 18 Monitoring Space Reclamation (TRU Monitor)
Introduction ........................................................................................... 704 Getting started....................................................................................... 704
Configuring the TRU Monitor ........................................................... 704Running the TRU Monitor................................................................. 706
Monitoring the TRU environment ........................................................... 707Summary of operations .................................................................... 707Monitoring........................................................................................ 709Monitored devices ............................................................................ 710Scanning ........................................................................................... 711Reclaiming......................................................................................... 712
Command reference............................................................................... 714Syntax conventions ........................................................................... 714TRU,HELP......................................................................................... 714TRU,DISABLE................................................................................... 715TRU,DISPLAY................................................................................... 716TRU,DISPLAY,DEVICE ...................................................................... 717TRU,ENABLE ................................................................................... 718TRU,HOLD ....................................................................................... 719TRU,RECLAIM.................................................................................. 719TRU,REFRESH................................................................................. 720TRU,RELEASE.................................................................................. 720TRU,SCAN ........................................................................................ 721TRU,START...................................................................................... 722TRU,STOP........................................................................................ 723
Chapter 19 Pool Monitor User Exit
Overview................................................................................................ 726 Sample user exit..................................................................................... 726 Parameters passed to user exit .............................................................. 727
General information .......................................................................... 727
16 ResourcePak Base for z/OS 8.4 Product Guide
Contents
Interval information .......................................................................... 728Percentage used............................................................................... 728Symmetrix system information ......................................................... 728Symmetrix system information from prior interval............................ 729Pool information ............................................................................... 729Pool information from prior interval .................................................. 730
Chapter 20 Managing zDP
Introduction ........................................................................................... 734 Summary of operations .......................................................................... 734 Command reference............................................................................... 736
Syntax conventions .......................................................................... 736ZDP,CREATE ................................................................................... 736ZDP,ECACLEAR ............................................................................... 736ZDP,MODIFY,SMF ........................................................................... 737ZDP,PAUSE...................................................................................... 738ZDP,RELEASEDEVICELOCK ............................................................ 738ZDP,RESUME .................................................................................. 738ZDP,START...................................................................................... 739ZDP,STOP........................................................................................ 740
Chapter 21 Monitoring SRDF/A (SRDF/A Monitor)
Introduction ........................................................................................... 744 Getting started....................................................................................... 745
Configuring SRDF/A Monitor ........................................................... 745Running SRDF/A Monitor................................................................. 745
Monitoring SRDF/A sessions.................................................................. 746Summary of operations .................................................................... 746Monitoring process........................................................................... 748SRDF/A Single Session Auto Recovery ............................................ 750Optional user exit ............................................................................. 751SMF record format........................................................................... 751
Command reference............................................................................... 757Syntax conventions .......................................................................... 757ASY,DISABLE ................................................................................... 757ASY,DISPLAY ................................................................................... 757ASY,ENABLE.................................................................................... 758ASY,REFRESH ................................................................................. 758ASY,SSAR,DISABLE ......................................................................... 760ASY,SSAR,ENABLE.......................................................................... 760ASY,RECOVER,SRDFA..................................................................... 761
Chapter 22 Monitoring SRDF/A Write Pacing (WPA Monitor)
Introduction ........................................................................................... 764Limitations........................................................................................ 764
Getting started....................................................................................... 765Configuring SRDF/A Write Pacing Monitor ...................................... 765Running SRDF/A Write Pacing Monitor............................................ 765
Monitoring SRDF/A Write Pacing........................................................... 766Summary of operations .................................................................... 766Monitoring process........................................................................... 766SMF record format........................................................................... 767
ResourcePak Base for z/OS 8.4 Product Guide 17
Contents
Chapter 23 Managing SRDF/AR Processes
Introduction ........................................................................................... 770 Running SRDF/AR processes ................................................................. 770 Command reference................................................................................ 771
Syntax conventions ........................................................................... 771SAR,PAUSE....................................................................................... 771SAR,START...................................................................................... 772SAR,RESTART ................................................................................. 772SAR,STOP........................................................................................ 773
Chapter 24 Managing SRDF/A MSC
Introduction ........................................................................................... 776 Getting started....................................................................................... 776
Configuring MSC.............................................................................. 776 Controlling MSC environment ................................................................ 777
Enabling MSC environment of SCF .................................................. 777Basic operations ............................................................................... 777SRDF Automatic Recovery ............................................................... 778Tracing and messaging ..................................................................... 778Miscellaneous ................................................................................... 778
Command reference............................................................................... 779Syntax conventions .......................................................................... 779MSC,ADDDEV .................................................................................. 779MSC,DEACT..................................................................................... 780MSC,DEACTREFRESH..................................................................... 782MSC,DEACTRESTART..................................................................... 784MSC,DEACTRESTARTTOSEC ......................................................... 786MSC,DEACTRESTARTTOZERO....................................................... 787MSC,DELDEV................................................................................... 789MSC,DISABLE.................................................................................. 790MSC,DISPLAY.................................................................................. 792MSC,ENABLE................................................................................... 793MSC,PENDDROP............................................................................. 794MSC,RECOVER................................................................................ 796MSC,REFRESH ................................................................................ 797MSC,RESTART ................................................................................ 799MSC,RESTARTTOSEC..................................................................... 801MSC,RESTARTTOZERO .................................................................. 802MSC,TAKEOVER.............................................................................. 803MSC,VERBOSE................................................................................ 804
18 ResourcePak Base for z/OS 8.4 Product Guide
FiguresFIGURES
1 z/OS SymmAPI architecture ................................................................................. 1942 zBoost PAV Optimizer processing.......................................................................... 3573 Mirror Optimizer processing .................................................................................. 3574 zBoost PAV Optimizer and Mirror Optimizer processing........................................ 3585 Symmetrix Summary report ................................................................................... 4416 Volume Summary report ........................................................................................ 4437 Dataset Summary report........................................................................................ 445
ResourcePak Base for z/OS 8.4 Product Guide 19
ResourcePak Base for z/OS 8.4 Product Guide20
TablesTABLES
1 SCF system abend codes ......................................................................................... 472 SAICALL error codes................................................................................................ 513 SAICALL error codes—EMCRC............................................................................... 514 SAICALL error codes—ESFCTLNM......................................................................... 515 SCFTM31A return codes .......................................................................................... 546 ResourcePak Base features and associated command types ................................... 557 Features and prefixes............................................................................................... 588 Initialization parameter default values ...................................................................... 599 Managing devices .................................................................................................. 19510 Licensing................................................................................................................ 19611 SymmAPI-MF operations ....................................................................................... 19612 Managing external applications .............................................................................. 19613 Command Prefix Facility operations....................................................................... 19614 SCF log and trace files ............................................................................................ 19715 SCF log file ............................................................................................................. 19716 SCF trace file .......................................................................................................... 19717 Basic operations..................................................................................................... 24518 Timing operations .................................................................................................. 24519 Enginuity Attention operations............................................................................... 24620 ESFCHNU1 return codes........................................................................................ 26821 GNS operations...................................................................................................... 27622 GNS batch commands ........................................................................................... 28123 GNS reason codes ................................................................................................. 30824 Managing copy priorities ........................................................................................ 31525 Setting up DCP ....................................................................................................... 31726 Exploring cache partitions....................................................................................... 31727 Managing cache partitions ...................................................................................... 31728 Managing MRDF policy and weights ...................................................................... 32029 Managing SPC priorities ........................................................................................ 32130 General operations................................................................................................. 36531 Logging and messaging .......................................................................................... 36532 Defining scope of optimization............................................................................... 36633 Controlling resource utilization............................................................................... 36734 Section 1—zHPF PAV optimization parameters..................................................... 37935 Section 2—Basic monitoring zHPF counts ............................................................ 38036 Section 3—PAV optimization passive zHPF counters............................................ 38137 Section 4—PAV optimization active monitoring zHPF counters ............................ 38238 Section 5—PAV optimization zHPF skip processing by parameters ...................... 38339 Section 6—PAV optimization zHPF skip processing .............................................. 38540 Section 7—PAV optimization logging event stats .................................................. 38541 Setting up track change collection......................................................................... 43442 Selecting devices to track changes........................................................................ 43443 Setting up ChangeTracker Collector log dataset.................................................... 43444 Setting up reports.................................................................................................. 43945 Interval statistics file fields..................................................................................... 44646 Disk Compare operations ....................................................................................... 46147 SLO levels .............................................................................................................. 47548 Disk drive requirements.......................................................................................... 47549 Available workloads................................................................................................ 47650 Storage group operations....................................................................................... 477
ResourcePak Base for z/OS 8.4 Product Guide 21
Tableses
51 Storage resource pool operations .......................................................................... 47752 Thin pool operations............................................................................................... 47753 SLO operations ...................................................................................................... 47754 Device operations .................................................................................................. 47855 Track allocation operations .................................................................................... 47856 Query commands .................................................................................................. 47857 Command execution settings ................................................................................. 47958 Getting help .......................................................................................................... 47959 Pool operations ...................................................................................................... 48160 Device operations .................................................................................................. 48161 Thin device allocation operations ........................................................................... 48262 Thin device compression operations ...................................................................... 48263 Query commands .................................................................................................. 48264 Command execution settings ................................................................................. 48365 Getting help .......................................................................................................... 48366 THN Monitor operations ........................................................................................ 67467 SDV Monitor operations......................................................................................... 68868 DSE Monitor operations......................................................................................... 69769 Basic TRU Monitor operations ............................................................................... 70770 Setting scanning options........................................................................................ 70771 Setting reclaiming options...................................................................................... 70872 Setting scratch options.......................................................................................... 70873 Parameters for general information ....................................................................... 72774 Parameters for interval information ....................................................................... 72875 Parameters for percentage used............................................................................ 72876 Parameters for Symmetrix system information...................................................... 72877 Parameters for Symmetrix system information from prior interval......................... 72978 Parameters for pool information ............................................................................ 72979 Parameters for pool information from prior interval ............................................... 73080 Managing zDP processes ....................................................................................... 73481 Creating snapsets .................................................................................................. 73482 Handling device locks and clearing ECA ................................................................. 73483 Setting up SMF recording...................................................................................... 73584 SRDF/A Monitor initialization parameters.............................................................. 74585 SRDF/A Single Session Auto Recovery initialization parameters ........................... 74586 SRDF/A Monitor operations .................................................................................. 74687 SRDF/A Single Session Auto Recovery operations ................................................ 74788 SRDF/A Write Pacing Monitor initialization parameters..
Top Related