Dell Mainframe Enablers User guide

February 2022

Rev 23

Dell EMC Mainframe Enablers

ResourcePak Base for z/OS

Product Guide

Version 8.4

Notes, cautions, and warnings

subsidiaries. Other trademarks may be trademarks of their respective owners.

NOTE: A NOTE indicates important information that helps you make better use of your product.

CAUTION:

A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid

the problem.

WARNING:

A WARNING indicates a potential for property damage, personal injury, or death.

Contents 3

About this document .......................................................................................................................... 19

Purpose ............................................................................................................................................................................19

Audience ...........................................................................................................................................................................19

Coverage ..........................................................................................................................................................................19

Related documentation ..................................................................................................................................................19

CLI conventions .............................................................................................................................................................20

Where to get help ..........................................................................................................................................................20

Your comments ..............................................................................................................................................................20

Part I: INTRODUCTION AND CONFIGURATION .................................................................................... 21

Chapter 1: Overview .......................................................................................................................22

Mainframe Enablers and ResourcePak Base ...................................................................................................22

Licensing .........................................................................................................................................................................22

Introduction to ResourcePak Base...................................................................................................................22

Storage environment features .....................................................................................................................................23

Storage pool features ....................................................................................................................................................24

Local replication features ..............................................................................................................................................24

Remote replication features .........................................................................................................................................25

Chapter 2: Getting started .............................................................................................................26

Postinstallation..................................................................................................................................................26

Set up security ...............................................................................................................................................................26

Check IEFSSN table ......................................................................................................................................................26

Initialize thin devices ......................................................................................................................................................26

Reset storage pool MaxO to percentage ...................................................................................................................26

Configuring ResourcePak Base ........................................................................................................................26

Creating the SCF initialization file .............................................................................................................27

Sample SCF initialization file ......................................................................................................................27

Using PARMLIB(SCFINI00) .......................................................................................................................28

Running ResourcePak Base..............................................................................................................................28

Customizing the SCF started task .............................................................................................................29

Starting SCF ...............................................................................................................................................30

Running multiple SCF instances ................................................................................................................30

Stopping SCF .............................................................................................................................................. 31

SCF system abend codes ...........................................................................................................................32

SAICALL error codes ..................................................................................................................................35

SCF termination utility ................................................................................................................................36

Running AutoSwap in SCF address space ................................................................................................37

Using ResourcePak Base commands ...............................................................................................................37

Chapter 3: ResourcePak Base initialization parameters .....................................................................40

Overview ...........................................................................................................................................................40

Parameter verification ................................................................................................................................ 41

Default values ............................................................................................................................................. 41

ResourcePak Base initialization parameter verification parameters ..............................................................44

PARM_VERIFY ...........................................................................................................................................44

SRDF/A Monitor (ASY) parameters ................................................................................................................44

Contents

4 Contents

SCF.ASY.MONITOR ...................................................................................................................................45

SCF.ASY.POLL.INTERVAL .........................................................................................................................45

SCF.ASY.SECONDARY_DELAY .................................................................................................................45

SCF.ASY.SMF.POLL ...................................................................................................................................46

SCF.ASY.SMF.RECORD .............................................................................................................................46

SCF.ASY.USEREXIT ...................................................................................................................................46

Storage system specification (CNTRL) parameters ....................................................................................... 47

SCF.CNTRL.EXCLUDE.LIST ......................................................................................................................47

SCF.CNTRL.INCLUDE.LIST .......................................................................................................................47

Cross-System Communication (CSC) parameters .........................................................................................48

SCF.CSC.ACTIVE .......................................................................................................................................48

SCF.CSC[.{symm-serial|RMT}].ACTIVEPOLL ..........................................................................................48

SCF.CSC[.symm-serial].ATTNACTIVE ......................................................................................................49

SCF.CSC[.symm-serial].ATTNPATHGRP ..................................................................................................49

SCF.CSC[.{symm-serial|RMT}].EXPIRECYCLE ........................................................................................50

SCF.CSC.GATEKEEPER.LIST ....................................................................................................................50

SCF.CSC.GATEKEEPER.symm-serial.LIST ............................................................................................... 51

SCF.CSC[.{symm-serial|RMT}].IDLEPOLL ............................................................................................... 51

SCF.CSC.INSTANCE ..................................................................................................................................52

SCF.CSC[.{symm-serial|RMT}].MITPERIOD ............................................................................................52

SCF.CSC.REFORMAT ................................................................................................................................53

SCF.CSC[.{symm-serial|RMT}].SELTIMEOUT .........................................................................................53

SCF.CSC[.{symm-serial|RMT}].VERBOSE ...............................................................................................54

AutoSwap (DAS) parameters...........................................................................................................................54

SCF.DAS.ACTIVE ........................................................................................................................................54

Device specification (DEV) parameters...........................................................................................................55

SCF.DEV.ATTR.HRO.EXCLUDE.LIST ........................................................................................................55

SCF.DEV.ATTR.HRO.INCLUDE.LIST .........................................................................................................55

SCF.DEV.EXCLUDE.LIST ...........................................................................................................................56

SCF.DEV.INCLUDE.LIST ............................................................................................................................56

SCF.DEV.MULTSS ......................................................................................................................................56

SCF.DEV.WAITINT .....................................................................................................................................57

...........................................................................................................................................................................57

Optimizer (DEV.OPTIMIZE) parameters..........................................................................................................57

SCF.DEV.OPTIMIZE.ENABLE ....................................................................................................................58

SCF.DEV.OPTIMIZE.MIR ...........................................................................................................................58

SCF.DEV.OPTIMIZE.MIR.ENABLE ............................................................................................................58

SCF.DEV.OPTIMIZE.MIR.EXCLUDE.LIST .................................................................................................59

SCF.DEV.OPTIMIZE.MIR.INCLUDE.LIST ..................................................................................................59

SCF.DEV.OPTIMIZE.MIR.JOBNAME.LIST ................................................................................................60

SCF.DEV.OPTIMIZE.MIR.JOBNAME.EXCLUDE.LIST ..............................................................................60

SCF.DEV.OPTIMIZE.MIR.JOBPREFIX.EXCLUDE.LIST ............................................................................60

SCF.DEV.OPTIMIZE.MIR.JOBPREFIX.LIST .............................................................................................. 61

SCF.DEV.OPTIMIZE.MIR.PASSIVE.LIST ................................................................................................... 61

SCF.DEV.OPTIMIZE.MIR.QUIPOINT.DEVICE ...........................................................................................62

SCF.DEV.OPTIMIZE.MIR.QUIPOINT.GLOBAL ..........................................................................................62

SCF.DEV.OPTIMIZE.MIR.SRVCLASS.LIST ...............................................................................................62

SCF.DEV.OPTIMIZE.MIR.STORGRP.INCLUDE.LIST ................................................................................63

SCF.DEV.OPTIMIZE.MIR.VOLMASK.INCLUDE.LIST ................................................................................63

SCF.DEV.OPTIMIZE.MIR.VOLSER.INCLUDE.LIST ...................................................................................64

SCF.DEV.OPTIMIZE.PAV ...........................................................................................................................64

SCF.DEV.OPTIMIZE.PAV.ENABLE ............................................................................................................65

SCF.DEV.OPTIMIZE.PAV.EXCLUDE.LIST .................................................................................................65

SCF.DEV.OPTIMIZE.PAV.INCLUDE.LIST ..................................................................................................65

SCF.DEV.OPTIMIZE.PAV.JOBNAME.LIST ................................................................................................66

SCF.DEV.OPTIMIZE.PAV.JOBNAME.EXCLUDE.LIST ..............................................................................66

SCF.DEV.OPTIMIZE.PAV.JOBPREFIX.LIST ..............................................................................................66

SCF.DEV.OPTIMIZE.PAV.JOBPREFIX.EXCLUDE.LIST ............................................................................67

SCF.DEV.OPTIMIZE.PAV.PASSIVE.LIST ..................................................................................................67

SCF.DEV.OPTIMIZE.PAV.QUIPOINT.DEVICE ...........................................................................................68

Contents 5

SCF.DEV.OPTIMIZE.PAV.QUIPOINT.GLOBAL .........................................................................................68

SCF.DEV.OPTIMIZE.PAV.QUIPOINT.LCU ................................................................................................68

SCF.DEV.OPTIMIZE.PAV.QUIPOINT.LCU.PCT ........................................................................................69

SCF.DEV.OPTIMIZE.PAV.SPLIT.MAX .......................................................................................................69

SCF.DEV.OPTIMIZE.PAV.SPLIT.MAX.READ ............................................................................................69

SCF.DEV.OPTIMIZE.PAV.SPLIT.MAX.WRITE ...........................................................................................70

SCF.DEV.OPTIMIZE.PAV.SRVCLASS.LIST ...............................................................................................70

SCF.DEV.OPTIMIZE.PAV.STORGRP.INCLUDE.LIST ...............................................................................70

SCF.DEV.OPTIMIZE.PAV.TRACK.MIN .......................................................................................................71

SCF.DEV.OPTIMIZE.PAV.TRACK.MIN.READ ............................................................................................71

SCF.DEV.OPTIMIZE.PAV.TRACK.MIN.WRITE ...........................................................................................71

SCF.DEV.OPTIMIZE.PAV.VOLMASK.INCLUDE.LIST ...............................................................................72

SCF.DEV.OPTIMIZE.PAV.VOLSER.INCLUDE.LIST ..................................................................................72

SCF.DEV.OPTIMIZE.SELECTION.DSN ......................................................................................................73

SCF.DEV.OPTIMIZE.SELECTION.MEMBER .............................................................................................73

SCF.DEV.OPTIMIZE.SMF.RECID ...............................................................................................................73

SCF.DEV.OPTIMIZE.VERBOSE .................................................................................................................74

DSE Monitor (DSE) parameters....................................................................................................................... 74

SCF.DSE ......................................................................................................................................................75

SCF.DSE.xx.LIST ........................................................................................................................................75

SCF.DSE.symm-serial.LIST ........................................................................................................................76

SCF.DSE.symm-serial.LIST=GATEkeeper=ccuu .......................................................................................77

SCF.DSE.symm-serial.xx.LIST .................................................................................................................... 77

SCF.DSE.symm-serial.poolname.xx.LIST ...................................................................................................79

SCF.DSE.MAJOR ........................................................................................................................................80

SCF.DSE.MINOR ........................................................................................................................................80

SCF.DSE.WARNING ................................................................................................................................... 81

Gatekeeper specification (GATEKEEPER) parameters .................................................................................. 81

SCF.GATEKEEPER.FIXUP ......................................................................................................................... 81

SCF.GATEKEEPER.LIST ............................................................................................................................ 81

SCF.GATEKEEPER.symm-serial.LIST ........................................................................................................82

Group Name Services (GNS) parameters .......................................................................................................82

SCF.GNS.ACTIVE .......................................................................................................................................82

SCF.GNS.WAITINT .....................................................................................................................................83

General Pool Management (GPM) parameters...............................................................................................83

SCF.GPM.OSUB .........................................................................................................................................83

SCF initialization (INI) parameters ...................................................................................................................83

SCF.INI.COMMAND.MAX ..........................................................................................................................83

SCF.INI.CPFX .............................................................................................................................................84

SCF.INI.CPFX.DD .......................................................................................................................................84

SCF.INI.SCOPE ...........................................................................................................................................84

Licensing (LFC) parameters.............................................................................................................................85

SCF.LFC.LCODES.LIST ..............................................................................................................................85

SCF log file (LOG) parameters.........................................................................................................................85

SCF.LOG.CYLINDER ..................................................................................................................................85

SCF.LOG.DATACLAS .................................................................................................................................86

SCF.LOG.MGMTCLAS ...............................................................................................................................86

SCF.LOG.RETAIN.COUNT .........................................................................................................................86

SCF.LOG.RETAIN.DAYS .............................................................................................................................86

SCF.LOG.STORCLAS .................................................................................................................................87

SCF.LOG.TRACKS.PRI ...............................................................................................................................87

SCF.LOG.TRACKS.SEC ..............................................................................................................................87

Multi-Session Consistency (MSC) parameters ...............................................................................................88

SCF.MSC.ADCOPY.ONDROP ....................................................................................................................88

SCF.MSC.AUTO.RECOVER.RETRY ..........................................................................................................88

SCF.MSC.CYCLE.TIME.WARN ..................................................................................................................89

SCF.MSC.ENABLE .....................................................................................................................................89

SCF.MSC.GTFUSR.RECID .........................................................................................................................89

SCF.MSC.GTFUSR.TRACE ........................................................................................................................90

SCF.MSC.MAX.LOCK.WAIT ......................................................................................................................90

6 Contents

SCF.MSC.OVERWRITE ..............................................................................................................................90

SCF.MSC.PAVO ......................................................................................................................................... 91

SCF.MSC.SDDFQ.TODA ............................................................................................................................ 91

SCF.MSC.SDDFQ.TOMF ............................................................................................................................ 91

SCF.MSC.SDDFQ.TOOS ............................................................................................................................92

SCF.MSC.VERBOSE ..................................................................................................................................92

Feature registration (REG) parameters...........................................................................................................93

SCF.REG.MAX.ERRORS ............................................................................................................................93

SCF.REG.MAX.CONTROLLER.ERRORS ...................................................................................................93

SCF.REG.WAITINT .....................................................................................................................................93

SDV Monitor (SDV) parameters ......................................................................................................................94

SCF.SDV .....................................................................................................................................................94

SCF.SDV.xx.LIST ........................................................................................................................................94

SCF.SDV.symm-serial.LIST ........................................................................................................................95

SCF.SDV.symm-serial.LIST=GATEkeeper=ccuu .......................................................................................96

SCF.SDV.symm-serial.xx.LIST ...................................................................................................................96

SCF.SDV.symm-serial.poolname.xx.LIST ...................................................................................................98

SNAP Monitor (SNAP) parameters .................................................................................................................99

SCF.SNAP.NOTIFY_POLLING ...................................................................................................................99

SCF.SNAP.NOTIFY_POLLTIME .............................................................................................................. 100

Service task (SRV) parameters ..................................................................................................................... 100

SCF.SRV.GSM.ACTIVE ............................................................................................................................ 100

SCF.SRV.GSM.INTERVAL ........................................................................................................................ 100

SRDF/A Single Session (SS) Auto Recovery parameters ............................................................................ 100

SCF.SS.AUTO.RECOVER ......................................................................................................................... 100

SCF.SS.AUTO.RECOVER.symm-serial.srdfgrp ........................................................................................101

SCF.SS.AUTO.RECOVER.BCV .................................................................................................................101

SCF.SS.AUTO.RECOVER.BCV.symm-serial.srdfgrp .............................................................................. 102

SCF.SS.AUTO.RECOVER.ITRK ................................................................................................................ 103

SCF.SS.AUTO.RECOVER.ITRK.symm-serial ...........................................................................................103

SCF.SS.AUTO.RECOVER.JOBNAME ...................................................................................................... 103

SCF.SS.AUTO.RECOVER.JOBNAME.symm-serial ................................................................................. 104

SCF.SS.AUTO.RECOVER.LPAR .............................................................................................................. 104

SCF.SS.AUTO.RECOVER.MINDIR ........................................................................................................... 104

SCF.SS.AUTO.RECOVER.MINDIR.symm-serial ...................................................................................... 105

SCF.SS.AUTO.RECOVER.PREFIX .......................................................................................................... 105

SCF.SS.AUTO.RECOVER.PROC ............................................................................................................. 105

THN Monitor (THN) parameters.................................................................................................................... 106

SCF.THN ................................................................................................................................................... 106

SCF.THN.REMOTE ................................................................................................................................... 106

SCF.THN.xx.LIST ...................................................................................................................................... 106

SCF.THN.symm-serial.LIST ...................................................................................................................... 108

SCF.THN.symm-serial.LIST=GATEkeeper=ccuu .................................................................................... 108

SCF.THN.symm-serial.xx.LIST ................................................................................................................. 109

SCF.THN.symm-serial.poolname.xx.LIST .................................................................................................110

SCF tracing (TRACE) parameters .................................................................................................................. 112

SCF.TRACE.COMPRESS .......................................................................................................................... 112

SCF.TRACE.CYLINDER ............................................................................................................................. 112

SCF.TRACE.DATACLAS ............................................................................................................................ 112

SCF.TRACE.FLUSH.AT ............................................................................................................................. 112

SCF.TRACE.MEGS .................................................................................................................................... 113

SCF.TRACE.MGMTCLAS .......................................................................................................................... 113

SCF.TRACE.RETAIN.COUNT .................................................................................................................... 113

SCF.TRACE.RETAIN.DAYS ....................................................................................................................... 114

SCF.TRACE.STORCLAS ............................................................................................................................ 114

SCF.TRACE.TRACKS.PRI ......................................................................................................................... 114

SCF.TRACE.TRACKS.SEC ........................................................................................................................115

TRU Monitor (TRU) parameters .....................................................................................................................115

SCF.TRU.DEBUG .......................................................................................................................................115

SCF.TRU.DEV.EXCLUDE.LIST ..................................................................................................................115

Contents 7

SCF.TRU.DEV.INCLUDE.LIST ................................................................................................................... 116

SCF.TRU.ENABLE ..................................................................................................................................... 116

SCF.TRU.OFFLINE .................................................................................................................................... 116

SCF.TRU.RECLAIM.DSFACTOR ............................................................................................................... 117

SCF.TRU.RECLAIM.DSPREFIX ................................................................................................................. 117

SCF.TRU.RECLAIM.METHOD .................................................................................................................. 117

SCF.TRU.RECLAIM.PGMNAME ............................................................................................................... 118

SCF.TRU.RECLAIM.POST.MAX ............................................................................................................... 118

SCF.TRU.RECLAIM.POST.MIN ................................................................................................................ 118

SCF.TRU.RECLAIM.POST.PCT ................................................................................................................ 119

SCF.TRU.RECLAIM.POST.TYPE .............................................................................................................. 119

SCF.TRU.RECLAIM.SCRATCH.WAIT ....................................................................................................... 119

SCF.TRU.RECLAIM.STCNAME ............................................................................................................... 120

SCF.TRU.RECLAIM.STRESS.MONITOR .................................................................................................120

SCF.TRU.RECLAIM.STRESS.WAIT ......................................................................................................... 120

SCF.TRU.RECLAIM.SYSVTOC.HOLDLIMIT ............................................................................................. 121

SCF.TRU.RECLAIM.SYSVTOC.TRKLIMIT ................................................................................................ 121

SCF.TRU.RECLAIM.SYSVTOC.WAIT ....................................................................................................... 121

SCF.TRU.RECLAIM.TIMELIMIT.LIST ...................................................................................................... 122

SCF.TRU.RECLAIM.TASK.LIMIT ............................................................................................................. 122

SCF.TRU.SCAN.PGMNAME .................................................................................................................... 122

SCF.TRU.SCAN.STCNAME ..................................................................................................................... 122

SCF.TRU.SCAN.TASK.LIMIT ................................................................................................................... 123

SCF.TRU.SCRATCH.POST.MAX ............................................................................................................. 123

SCF.TRU.SCRATCH.POST.MIN .............................................................................................................. 123

SCF.TRU.SCRATCH.POST.PCT .............................................................................................................. 124

SCF.TRU.SCRATCH.POST.TYPE ............................................................................................................ 124

SCF.TRU.SCRATCH.RECLAIM ................................................................................................................ 124

SCF.TRU.THICKR1 .................................................................................................................................... 125

SCF log and trace file (WORK) parameters .................................................................................................. 125

SCF.WORK.HLQ ....................................................................................................................................... 125

SCF.WORK.UNIT ...................................................................................................................................... 125

SCF.WORK.VOLSER ................................................................................................................................ 126

SRDF/A Write Pacing Monitor (WPA) parameters....................................................................................... 126

SCF.WPA.EXCLUDE.CNTRL[.LIST] ........................................................................................................ 126

SCF.WPA.INCLUDE.CNTRL[.LIST] ..........................................................................................................127

SCF.WPA.MONITOR .................................................................................................................................127

SCF.WPA.MSGLEVEL .............................................................................................................................. 128

SCF.WPA.POLL.INTERVAL ...................................................................................................................... 128

SCF.WPA.SMF .......................................................................................................................................... 128

SCF.WPA.SMF.FILTER ............................................................................................................................ 129

SCF.WPA.SMF.RECORD ......................................................................................................................... 129

SCF.WPA.STYPES .................................................................................................................................... 130

Part II: STORAGE ENVIRONMENT ..................................................................................................... 132

Chapter 4: Using Symmetrix Control Facility (SCF) ........................................................................ 133

Introduction ..................................................................................................................................................... 133

Managing the storage environment ............................................................................................................... 134

Summary of operations ............................................................................................................................ 134

Viewing licenses .........................................................................................................................................137

Discovering devices ................................................................................................................................... 141

Viewing storage systems and devices ..................................................................................................... 142

Multiple subchannel addressing ................................................................................................................151

Dynamic activation of IODF configuration statements ............................................................................151

Dynamic Volume Expansion (DVE) support .............................................................................................151

HRO-controlled devices in AutoSwap groups ......................................................................................... 153

Global State Management ........................................................................................................................ 153

Nondisruptive SymmAPI-MF refreshes ................................................................................................... 154

8 Contents

Command Prefix Facility .......................................................................................................................... 154

SCF log and trace files ............................................................................................................................. 154

Command reference ....................................................................................................................................... 155

Common parameters ................................................................................................................................ 156

DEV,CH,CNTRL ........................................................................................................................................ 157

DEV,DISPLAY ............................................................................................................................................ 157

DEV,EXPAND ............................................................................................................................................ 160

DEV,REFRESH ........................................................................................................................................... 161

DEV,RESCAN ............................................................................................................................................ 162

DEV,STATUS ............................................................................................................................................ 162

DEV,UNPIN ............................................................................................................................................... 162

ELM,LIST .................................................................................................................................................. 162

ELM,QUERY .............................................................................................................................................. 163

INI,REFRESH ............................................................................................................................................ 163

INI,RELOAD ............................................................................................................................................... 163

INI,SHUTDOWN ........................................................................................................................................ 164

REC,QUERYDEVICELOCK ....................................................................................................................... 164

REC,RELEASEDEVICELOCK .................................................................................................................... 165

SRV,SYSBUSY,HELP ................................................................................................................................ 165

SRV,SYSBUSY,DISPLAY .......................................................................................................................... 165

SRV,SYSBUSY,DECREMENT .................................................................................................................. 165

SRV,SYSBUSY,RESET .............................................................................................................................. 166

Chapter 5: Controlling communications (CSC) ............................................................................... 168

Introduction ..................................................................................................................................................... 168

Getting started................................................................................................................................................ 168

Controlling communications ........................................................................................................................... 168

Summary of operations ............................................................................................................................ 169

Polling storage systems ............................................................................................................................ 169

Selecting gatekeepers .............................................................................................................................. 170

Polling hosts .............................................................................................................................................. 170

Using Enginuity Attention ......................................................................................................................... 171

Viewing hosts ............................................................................................................................................. 171

Working with multiple SCF instances .......................................................................................................174

Viewing listeners ....................................................................................................................................... 175

Verbose messaging ................................................................................................................................... 176

Command reference ........................................................................................................................................177

Common parameters .................................................................................................................................177

CSC,DISPLAY,HOSTS ...............................................................................................................................177

CSC,DISPLAY,LISTENER ......................................................................................................................... 178

CSC,REFRESH .......................................................................................................................................... 179

Chapter 6: Naming storage systems (ESFCTLNM) ......................................................................... 180

Introduction ..................................................................................................................................................... 180

Running ESFCTLNM utility............................................................................................................................. 180

Naming a storage system ............................................................................................................................... 180

Command reference ........................................................................................................................................ 181

ASSIGN NAME ........................................................................................................................................... 181

Chapter 7: Validating system paths (ESFCHNU1) ........................................................................... 182

Introduction ..................................................................................................................................................... 182

Running ESFCHNU1 utility.............................................................................................................................. 182

Command reference ....................................................................................................................................... 182

ALL ............................................................................................................................................................ 183

CCUU ........................................................................................................................................................ 183

Return codes ................................................................................................................................................... 183

Chapter 8: Resetting FBA paths and devices (ESFFUCBC) .............................................................. 184

Contents 9

Introduction ..................................................................................................................................................... 184

Running ESFFUCBC utility ............................................................................................................................. 184

Sample JCL ................................................................................................................................................................... 184

Parameters ................................................................................................................................................................... 185

Chapter 9: Managing device groups (GNS) .................................................................................... 186

Introduction ..................................................................................................................................................... 186

Getting started................................................................................................................................................ 186

Configuring GNS ....................................................................................................................................... 186

Running EMCGROUP batch utility .......................................................................................................... 186

Managing GNS groups.................................................................................................................................... 187

Summary of operations ............................................................................................................................ 187

Defining GNS groups ................................................................................................................................ 188

GNS group types ...................................................................................................................................... 188

Open systems group support ................................................................................................................... 190

Command reference: EMCGROUP batch utility ............................................................................................ 191

Overview .................................................................................................................................................... 191

Common parameters ................................................................................................................................ 192

DEFINE COMPLEMENT ........................................................................................................................... 196

DEFINE GROUP ........................................................................................................................................ 196

DEFINE ENTERPRISE GROUP ................................................................................................................ 199

DEFINE GROUP FOR GCOPYBCV ......................................................................................................... 200

DELETE GROUP ....................................................................................................................................... 201

DISPLAY GROUP ...................................................................................................................................... 201

LIST GROUP .............................................................................................................................................202

REMOVE FROM GROUP DEVICE ...........................................................................................................203

REMOVE FROM GROUP RDF GROUP ...................................................................................................204

RENAME GROUP .....................................................................................................................................204

Command reference: SCF GNS .....................................................................................................................204

Common parameters ............................................................................................................................... 205

GNS,FORMAT .......................................................................................................................................... 205

GNS,LIST ................................................................................................................................................. 205

GNS,REFRESH .........................................................................................................................................206

GNS,REVERT ............................................................................................................................................206

GNS reason codes ..........................................................................................................................................207

Chapter 10: Managing Quality of Service (QoS) ..............................................................................209

Introduction .....................................................................................................................................................209

Getting started................................................................................................................................................209

Security prerequisites ...............................................................................................................................209

Running the QoS utility ............................................................................................................................ 210

Copy priorities ................................................................................................................................................. 210

Overview ................................................................................................................................................... 210

Summary of operations ............................................................................................................................. 211

Dynamic Cache Partitioning (DCP)................................................................................................................. 211

Overview .................................................................................................................................................... 211

Summary of operations ............................................................................................................................ 212

DCP analysis mode ................................................................................................................................... 212

DCP example ............................................................................................................................................ 213

Mixed SRDF Mode (MRDF) ........................................................................................................................... 213

Overview ................................................................................................................................................... 213

Summary of operations ............................................................................................................................ 214

Redistribution of CPU weights ................................................................................................................ 214

Symmetrix Priority Control (Enginuity 5876) ................................................................................................ 214

Overview ................................................................................................................................................... 215

Summary of operations ............................................................................................................................ 215

SPC example ............................................................................................................................................. 215

Command reference ....................................................................................................................................... 215

Command parameters .............................................................................................................................. 216

10 Contents

DISPCCFG ................................................................................................................................................ 218

DISPCDEV, or DISPCDVG and DISPCDV ................................................................................................ 218

DISPCGEN ................................................................................................................................................ 219

DISPCGRP ................................................................................................................................................ 219

DISPCPYP and DISPDEV ......................................................................................................................... 219

DISPCUSE .................................................................................................................................................220

DISPDEVP and DISPDEV ......................................................................................................................... 221

DISPSPC ................................................................................................................................................... 221

EXIT ...........................................................................................................................................................222

MRDFDISP DEFAULTS ............................................................................................................................222

MRDFDISP RDFSTATS ............................................................................................................................222

MRDFDISP WEIGHTS ..............................................................................................................................223

MRDFSET POLICY ...................................................................................................................................223

MRDFSET RESET .....................................................................................................................................224

MRDFSET WEIGHTS ................................................................................................................................224

QOSGET ....................................................................................................................................................225

QOSRESET ...............................................................................................................................................225

QOSSET ....................................................................................................................................................226

SETCACHE ...............................................................................................................................................227

SETCPADD ...............................................................................................................................................227

SETCPDEL ................................................................................................................................................228

SETCPMOD ..............................................................................................................................................228

SETCPMRP ...............................................................................................................................................228

SETCPMVD and SETCPMV .....................................................................................................................228

SETCPYP and SETDEVCP .......................................................................................................................229

SETDEVP and SETDEV ............................................................................................................................230

SETDIR and SETSPC ................................................................................................................................ 231

WAIT ..........................................................................................................................................................232

Chapter 11: Optimizing I/O (zBoost PAV Optimizer, Mirror Optimizer) .............................................233

Introduction .....................................................................................................................................................233

Requirements and restrictions ...................................................................................................................................235

Getting started................................................................................................................................................236

Security .....................................................................................................................................................236

Configuring optimizers .............................................................................................................................236

Optimizing I/Os...............................................................................................................................................239

Summary of operations ............................................................................................................................240

Operation modes ......................................................................................................................................242

Selecting devices ......................................................................................................................................242

Selecting datasets ....................................................................................................................................243

Limiting optimization by started task or job ............................................................................................244

Limiting optimization by service class .....................................................................................................244

Limiting optimization by tracks (zBoost PAV Optimizer) .......................................................................244

Controlling number of splits or constituent I/Os (zBoost PAV Optimizer) ...........................................245

Setting quiesce points ..............................................................................................................................245

Consistency support .................................................................................................................................246

Processing error conditions (Mirror Optimizer) ......................................................................................246

SMF recording.................................................................................................................................................247

Overview ...................................................................................................................................................247

SMF record types .....................................................................................................................................247

SMF record format ...................................................................................................................................248

STATS record fields ................................................................................................................................ 250

SMF reporting utility ................................................................................................................................256

Command reference .......................................................................................................................................259

Common parameters ................................................................................................................................259

DEV,OPTIMIZE ENABLE ..........................................................................................................................260

DEV,OPTIMIZE DISABLE .........................................................................................................................260

DEV,OPTIMIZE DISPLAY CONSISTENCY ...............................................................................................260

DEV,OPTIMIZE DISPLAY DEVICE ........................................................................................................... 261

Contents 11

DEV,OPTIMIZE DISPLAY EVENTS ..........................................................................................................267

DEV,OPTIMIZE DISPLAY SSID ................................................................................................................267

DEV,OPTIMIZE DISPLAY SUMMARY ......................................................................................................269

DEV,OPTIMIZE HELP ...............................................................................................................................270

DEV,OPTIMIZE LOG EVENTS .................................................................................................................270

DEV,OPTIMIZE REFRESH .........................................................................................................................271

DEV,OPTIMIZE RESET .............................................................................................................................272

DEV,OPTIMIZE RESUME .........................................................................................................................272

DEV,OPTIMIZE SUSPEND .......................................................................................................................273

Optimizer batch interface (ESFOPTBT) .......................................................................................................273

Overview ...................................................................................................................................................274

JCL and parameters .................................................................................................................................274

Example ..................................................................................................................................................... 277

Chapter 12: Monitoring track changes (ChangeTracker) ................................................................. 278

Introduction .....................................................................................................................................................278

Getting started................................................................................................................................................278

Prerequisites .............................................................................................................................................278

Running ChangeTracker Collector ...........................................................................................................278

ChangeTracker Collector configuration parameters ...............................................................................279

ChangeTracker Collector sample CONFIG file ........................................................................................284

Running ChangeTracker Reporter ...........................................................................................................285

ChangeTracker Reporter configuration parameters ...............................................................................285

Tracking changes with ChangeTracker Collector ......................................................................................... 291

Overview ................................................................................................................................................... 291

Summary of operations ............................................................................................................................ 291

ChangeTracker Collector log dataset ......................................................................................................292

Dumping VTOCs .......................................................................................................................................293

Storage estimates for ChangeTracker Collector disk output .................................................................293

Producing reports with ChangeTracker Reporter .........................................................................................294

Overview ...................................................................................................................................................294

Summary of operations ............................................................................................................................295

Collector Summary report ........................................................................................................................295

Reporter Summary report ........................................................................................................................296

Symmetrix Summary report .....................................................................................................................296

Volume Summary report ..........................................................................................................................298

Dataset Summary report ..........................................................................................................................299

Interval statistics file ............................................................................................................................... 300

Command reference ....................................................................................................................................... 301

DISPLAY ALL ............................................................................................................................................ 301

DISPLAY CYCLE .......................................................................................................................................302

DISPLAY DEVICE ......................................................................................................................................302

DISPLAY LOG ...........................................................................................................................................303

HELP .........................................................................................................................................................303

LOG# .........................................................................................................................................................304

LOGSWAP .................................................................................................................................................304

STOP .........................................................................................................................................................304

VOLSER ....................................................................................................................................................304

Chapter 13: Comparing tracks (Disk Compare) ...............................................................................305

Introduction .................................................................................................................................................... 305

Getting started............................................................................................................................................... 305

Prerequisites ............................................................................................................................................ 305

Running Disk Compare ............................................................................................................................ 305

Disk Compare parameters ........................................................................................................................306

Comparing tracks............................................................................................................................................309

Summary of operations ............................................................................................................................309

Examples ................................................................................................................................................... 310

12 Contents

Part III: STORAGE POOLS ................................................................................................................. 311

Chapter 14: Managing storage pools (GPM) ................................................................................... 312

Introduction ..................................................................................................................................................... 312

GPM with PowerMaxOS 5978 and HYPERMAX OS 5977 .....................................................................................312

GPM with Enginuity 5876 ............................................................................................................................................312

Getting started................................................................................................................................................ 312

Configuring GPM ...................................................................................................................................... 313

Running GPM commands ......................................................................................................................... 313

Running the ESFGPMBT utility ................................................................................................................ 313

ESFGPMBT conditional processing ......................................................................................................... 314

Working with pools (PowerMaxOS 5978, HYPERMAX OS 5977) ............................................................... 315

Summary of operations ............................................................................................................................ 315

Storage groups ......................................................................................................................................... 318

SMS-aligned storage groups .................................................................................................................... 318

Volume-defined groups ............................................................................................................................ 319

Cascaded storage groups ........................................................................................................................320

Storage resource pools ............................................................................................................................320

Service level objectives ............................................................................................................................ 321

Workload ...................................................................................................................................................322

Disk group .................................................................................................................................................322

SRP-level alerts ........................................................................................................................................322

Working with pools (Enginuity 5876).............................................................................................................323

Summary of operations ............................................................................................................................323

Creating and deleting pools .....................................................................................................................325

Adding and removing devices ..................................................................................................................335

Allocating and reallocating tracks ............................................................................................................337

Moving allocations ....................................................................................................................................337

Draining data or save devices ..................................................................................................................338

Rebalancing pools .....................................................................................................................................340

Compressing thin devices ........................................................................................................................342

Halting thin device tasks ..........................................................................................................................348

Pool-level alerts ........................................................................................................................................349

Pool management reports (PowerMaxOS 5978, HYPERMAX OS 5977) ................................................... 350

Storage Group report (QUERY SYMSG) ................................................................................................ 350

Storage Group Performance Statistics report (QUERY SYMSG STATS) ............................................. 351

Storage Resource Pool report (QUERY SRP) .........................................................................................353

Service Level Objective report (QUERY SLO) ........................................................................................354

Disk Group report (QUERY DISKGRP) ................................................................................................... 355

Pool report (QUERY POOLS) ..................................................................................................................356

Thin Device report (QUERY THINDEV) ..................................................................................................358

Thin Device Allocations report (QUERY ALLOC) ....................................................................................360

Thin Device Allocations by Pool report (QUERY ALLALLOCS) ............................................................. 361

Data Device report (QUERY DATADEV) .................................................................................................362

Pool management reports (Enginuity 5876) .................................................................................................364

FAST Tier report (QUERY TIERS) ...........................................................................................................364

Pool report (QUERY POOLS) ..................................................................................................................364

Pool Device report (QUERY POOLDEV) .................................................................................................366

Thin Device report (QUERY THINDEV) ..................................................................................................368

Thin Device Allocations report (QUERY ALLOC) .....................................................................................371

Thin Device Allocations by Pool report (QUERY ALLALLOCS) .............................................................373

Data Device report (QUERY DATADEV) .................................................................................................375

Save Device report (QUERY SAVEDEV) .................................................................................................379

Rebalance Task report (QUERY TASKS) ................................................................................................380

Command reference (PowerMaxOS 5978, HYPERMAX OS 5977) .............................................................382

Common parameters ................................................................................................................................382

ADD SYMSG .............................................................................................................................................387

ALLOCATE ................................................................................................................................................388

CREATE SYMSG .......................................................................................................................................388

Contents 13

DELETE SYMSG .......................................................................................................................................390

HALTTASK ................................................................................................................................................390

HELP .........................................................................................................................................................390

PERSIST OFF ............................................................................................................................................ 391

QUERY ALLOC ......................................................................................................................................... 391

QUERY ALLALLOCS .................................................................................................................................392

QUERY DATADEV ....................................................................................................................................393

QUERY DISKGRP ......................................................................................................................................393

QUERY POOLDEV ....................................................................................................................................394

QUERY POOLS .........................................................................................................................................394

QUERY SAVEDEV .....................................................................................................................................394

QUERY SLO ..............................................................................................................................................394

QUERY SRP ..............................................................................................................................................394

QUERY SYMSG ........................................................................................................................................395

QUERY THINDEV .....................................................................................................................................396

REFRESH SYMSG ....................................................................................................................................397

REMOVE SYMSG .....................................................................................................................................397

RENAME POOL ........................................................................................................................................398

RENAME SLO ...........................................................................................................................................398

RENAME SYMSG .....................................................................................................................................399

SET SRP ....................................................................................................................................................399

SET SYMSG ............................................................................................................................................. 400

USR_NRDY ............................................................................................................................................... 401

USR_RDY ..................................................................................................................................................402

Command reference (Enginuity 5876) ..........................................................................................................402

Common parameters ................................................................................................................................403

ADD POOL ................................................................................................................................................406

ALLOCATE ................................................................................................................................................407

BIND ..........................................................................................................................................................408

COMPRESS ..............................................................................................................................................409

CREATE POOL .........................................................................................................................................409

DECOMPRESS ......................................................................................................................................... 410

DELETE POOL ........................................................................................................................................... 411

DISABLE ..................................................................................................................................................... 411

DISPLAY .................................................................................................................................................... 412

DRAIN ........................................................................................................................................................ 413

ENABLE ..................................................................................................................................................... 414

HALTTASK ................................................................................................................................................ 415

HDRAIN ..................................................................................................................................................... 415

HELP ......................................................................................................................................................... 416

MOVE .........................................................................................................................................................417

PERSIST OFF ............................................................................................................................................ 418

POOLATTR ............................................................................................................................................... 419

QUERY ALLOC .........................................................................................................................................420

QUERY ALLALLOCS ................................................................................................................................. 421

QUERY DATADEV .................................................................................................................................... 421

QUERY POOLDEV ....................................................................................................................................422

QUERY POOLS .........................................................................................................................................422

QUERY SAVEDEV .....................................................................................................................................423

QUERY TASKS ..........................................................................................................................................423

QUERY TIERS ...........................................................................................................................................424

QUERY THINDEV .....................................................................................................................................424

REBALANCE .............................................................................................................................................425

REBIND .....................................................................................................................................................426

REMOVE POOL ........................................................................................................................................426

RENAME POOL ........................................................................................................................................427

UNBIND .....................................................................................................................................................428

USR_NRDY ...............................................................................................................................................429

USR_RDY ..................................................................................................................................................429

Condition statements (ESFGPMBT) .............................................................................................................430

14 Contents

IF ................................................................................................................................................................430

ELSE .......................................................................................................................................................... 431

ENDIF ........................................................................................................................................................ 431

RESET ....................................................................................................................................................... 431

Return codes (ESFGPMBT) ...........................................................................................................................432

Chapter 15: Monitoring thin pools (THN Monitor) ........................................................................... 433

Introduction .....................................................................................................................................................433

Getting started................................................................................................................................................433

Monitoring thin pools ......................................................................................................................................434

Summary of operations ............................................................................................................................434

Optional user exit ......................................................................................................................................434

Example 1 ..................................................................................................................................................434

Example 2 ..................................................................................................................................................435

Example 3 ..................................................................................................................................................436

Example 4 ..................................................................................................................................................436

Example 5 ..................................................................................................................................................437

Example 6 ..................................................................................................................................................437

Command reference .......................................................................................................................................438

Common parameters ................................................................................................................................438

THN,DISABLE ...........................................................................................................................................438

THN,DISPLAY ...........................................................................................................................................439

THN,ENABLE ............................................................................................................................................439

THN,LOCAL ..............................................................................................................................................440

THN,REFRESH .........................................................................................................................................440

THN,REMOTE ...........................................................................................................................................440

Chapter 16: Monitoring snap pools (SDV Monitor) .......................................................................... 441

Introduction ..................................................................................................................................................... 441

Getting started................................................................................................................................................ 441

Configuring SDV Monitor .............................................................................................................................................441

Running SDV Monitor ..................................................................................................................................................442

Monitoring snap pools.....................................................................................................................................442

Summary of operations ............................................................................................................................442

Optional user exit ......................................................................................................................................442

Example .....................................................................................................................................................442

Command reference .......................................................................................................................................443

Common parameters ................................................................................................................................443

SDV,DISABLE ............................................................................................................................................443

SDV,DISPLAY ............................................................................................................................................444

SDV,ENABLE ............................................................................................................................................445

SDV,REFRESH ..........................................................................................................................................445

Chapter 17: Monitoring DSE pools (DSE Monitor) ...........................................................................446

Introduction .....................................................................................................................................................446

Spillover monitoring .....................................................................................................................................................446

Getting started................................................................................................................................................447

Configuring DSE Monitor ............................................................................................................................................447

Running DSE Monitor ..................................................................................................................................................447

Monitoring DSE pools .....................................................................................................................................447

Summary of operations ............................................................................................................................447

Optional user exit ......................................................................................................................................448

Example .....................................................................................................................................................448

Command reference .......................................................................................................................................448

Common parameters ................................................................................................................................448

DSE,DISABLE ............................................................................................................................................449

DSE,DISPLAY ............................................................................................................................................449

DSE,ENABLE ........................................................................................................................................... 450

DSE,REFRESH ......................................................................................................................................... 450

Contents 15

Chapter 18: Monitoring space reclamation (TRU Monitor) ............................................................... 451

Introduction ..................................................................................................................................................... 451

Getting started................................................................................................................................................ 451

Configuring the TRU Monitor .................................................................................................................. 451

Running the TRU Monitor ........................................................................................................................452

Monitoring the TRU environment ..................................................................................................................453

Summary of operations ............................................................................................................................453

Monitoring ................................................................................................................................................ 455

Monitored devices ................................................................................................................................... 455

Scanning ....................................................................................................................................................456

Reclaiming .................................................................................................................................................456

Command reference .......................................................................................................................................457

Common parameters ................................................................................................................................458

TRU,DISABLE ...........................................................................................................................................458

TRU,DISPLAY ............................................................................................................................................458

TRU,DISPLAY,DEVICE ..............................................................................................................................459

TRU,ENABLE ............................................................................................................................................459

TRU,HELP .................................................................................................................................................460

TRU,HOLD ................................................................................................................................................460

TRU,RECLAIM .......................................................................................................................................... 461

TRU,REFRESH .......................................................................................................................................... 461

TRU,RELEASE .......................................................................................................................................... 461

TRU,SCAN ................................................................................................................................................ 461

TRU,START ...............................................................................................................................................462

TRU,STOP .................................................................................................................................................462

Chapter 19: Pool monitor user exit .................................................................................................464

Overview .........................................................................................................................................................464

Sample user exit..............................................................................................................................................464

Parameters passed to user exit......................................................................................................................464

General information .....................................................................................................................................................465

Interval information ......................................................................................................................................................465

Percentage used ..........................................................................................................................................................465

Storage system information .......................................................................................................................................466

Storage system information from prior interval .......................................................................................................466

Pool information ...........................................................................................................................................................467

Pool information from prior interval ...........................................................................................................................467

Part IV: LOCAL REPLICATION ...........................................................................................................468

Chapter 20: Managing zDP ...........................................................................................................469

Introduction .....................................................................................................................................................469

Summary of operations...................................................................................................................................469

Command reference .......................................................................................................................................470

Common parameters ................................................................................................................................470

ZDP,CREATE ............................................................................................................................................470

ZDP,ECACLEAR ........................................................................................................................................471

ZDP,MODIFY,SMF .....................................................................................................................................471

ZDP,PAUSE ...............................................................................................................................................471

ZDP,RELEASEDEVICELOCK ....................................................................................................................472

ZDP,RESUME ...........................................................................................................................................472

ZDP,START ...............................................................................................................................................472

ZDP,STOP .................................................................................................................................................472

Part V: REMOTE REPLICATION ......................................................................................................... 473

Chapter 21: Monitoring SRDF/A (SRDF/A Monitor) ........................................................................ 474

Introduction .....................................................................................................................................................474

16 Contents

Getting started................................................................................................................................................474

Configuring SRDF/A Monitor .....................................................................................................................................474

Running SRDF/A Monitor ...........................................................................................................................................475

Monitoring SRDF/A sessions .........................................................................................................................475

Summary of operations ............................................................................................................................475

SRDF/A monitoring ..................................................................................................................................476

SRDF/A Single Session Auto Recovery ................................................................................................... 477

Optional user exit ......................................................................................................................................478

SMF record format ...................................................................................................................................478

Command reference ....................................................................................................................................... 481

Common parameters ................................................................................................................................ 481

ASY,DISABLE ............................................................................................................................................ 481

ASY,DISPLAY ............................................................................................................................................482

ASY,ENABLE .............................................................................................................................................482

ASY,REFRESH ..........................................................................................................................................482

ASY,SSAR,DISABLE ..................................................................................................................................483

ASY,SSAR,ENABLE ..................................................................................................................................483

ASY,RECOVER,SRDFA .............................................................................................................................483

Chapter 22: Monitoring SRDF/A write pacing (WPA Monitor) .........................................................485

Introduction .....................................................................................................................................................485

Requirements and restrictions ...................................................................................................................................485

Getting started................................................................................................................................................485

Configuring WPA Monitor ...........................................................................................................................................485

Running WPA Monitor .................................................................................................................................................486

Monitoring SRDF/A write pacing...................................................................................................................486

Summary of operations ............................................................................................................................486

Monitoring process ...................................................................................................................................486

SMF record format ...................................................................................................................................487

Chapter 23: Managing SRDF/AR processes ....................................................................................488

Introduction .....................................................................................................................................................488

Running SRDF/AR processes.........................................................................................................................488

Command reference .......................................................................................................................................488

Common parameters ................................................................................................................................489

SAR,PAUSE ...............................................................................................................................................489

SAR,START ...............................................................................................................................................489

SAR,RESTART ..........................................................................................................................................489

SAR,STOP .................................................................................................................................................490

Chapter 24: Managing SRDF/A MSC ............................................................................................. 491

Introduction ..................................................................................................................................................... 491

Getting started................................................................................................................................................ 491

Controlling MSC environment ........................................................................................................................ 491

Summary of operations ............................................................................................................................492

Enabling MSC environment of SCF .........................................................................................................493

Command reference .......................................................................................................................................493

Common parameters ................................................................................................................................494

MSC,ADDDEV ...........................................................................................................................................494

MSC,DEACT .............................................................................................................................................495

MSC,DEACTREFRESH .............................................................................................................................496

MSC,DEACTRESTART .............................................................................................................................497

MSC,DEACTRESTARTTOSEC .................................................................................................................498

MSC,DEACTRESTARTTOZERO ..............................................................................................................498

MSC,DELDEV ...........................................................................................................................................499

MSC,DISABLE .......................................................................................................................................... 500

MSC,DISPLAY ........................................................................................................................................... 501

MSC,ENABLE ........................................................................................................................................... 501

MSC,PENDDROP .................................................................................................................................... 502

Contents 17

MSC,RECOVER ....................................................................................................................................... 503

MSC,REFRESH ........................................................................................................................................ 503

MSC,RESTART ........................................................................................................................................ 504

MSC,RESTARTTOSEC ............................................................................................................................ 505

MSC,RESTARTTOZERO ......................................................................................................................... 506

MSC,TAKEOVER ..................................................................................................................................... 506

MSC,VERBOSE ........................................................................................................................................507

18 Contents

About this document 19

As part of an effort to improve its product lines, Dell EMC periodically releases revisions of its software and hardware. Therefore,

some functions described in this document might not be supported by all versions of the software or hardware currently in use. The

product release notes provide the most up-to-date information about product features.

Contact your Dell EMC representative if a product does not function properly or does not function as described in this document.

NOTE: This document was accurate at publication time. New versions of this document might be released on the Dell EMC

Online Support website. Check the Dell EMC Online Support website to ensure that you are using the latest version of this

document.

Purpose

This document describes how to configure, run, and use Dell EMC ResourcePak Base for z/OS to manage your Dell EMC

storage environment.

Audience

This document is intended for the host system administrator, system programmer, or operator who is involved in managing or

operating the storage environment.

Coverage

This document describes ResourcePak Base for z/OS when used with the following storage system operating environments:

PowerMaxOS 5978

HYPERMAX OS 5977

Enginuity 5876

NOTE: For information pertaining to earlier operating environment levels, see prior versions of this guide.

Dell Mainframe Enablers User guide

Dell Mainframe Enablers User guide

Related papers

Other documents