Dell Mainframe Enablers User guide

Brand: Dell

Model: Mainframe Enablers

Category: Software

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