dell emc mainframe enablers resourcepak base for z/os 8.4 ... · dell emc mainframe enablers...

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


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


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


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


Contents

Chapter 6 Naming Storage Systems (ESFCTLNM)


Running ESFCTLNM utility............................................................... 262 Naming a storage system ....................................................................... 262 Command reference............................................................................... 263

Syntax conventions .......................................................................... 263ASSIGN NAME................................................................................. 263

Chapter 7 Validating System Paths (ESFCHNU1)


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)


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


Contents

Syntax conventions .......................................................................... 304GNS,FORMAT.................................................................................. 304GNS,LIST ......................................................................................... 305GNS,REFRESH................................................................................. 307GNS,REVERT ................................................................................... 307

GNS reason codes.................................................................................. 308

Chapter 10 Managing Quality of Service (QoS)


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


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


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)


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


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


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


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)


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)


Configuring SDV Monitor ................................................................. 687Running SDV Monitor ....................................................................... 687

Monitoring Snap pools ........................................................................... 688Summary of operations .................................................................... 688Optional user exit ............................................................................. 688Example............................................................................................ 689

Command reference............................................................................... 690Syntax conventions .......................................................................... 690


Contents

SDV,DISABLE................................................................................... 690SDV,DISPLAY................................................................................... 691SDV,ENABLE.................................................................................... 692SDV,REFRESH ................................................................................. 692

Chapter 17 Monitoring DSE Pools (DSE Monitor)


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)


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


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)


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


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


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


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


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

dell emc mainframe enablers resourcepak base for z/os 8.4 ... · dell emc mainframe enablers...

Documents