Dell Mainframe Enablers User guide

December 2021

Rev 22

Dell EMC Mainframe Enablers

TimeFinder SnapVX and zDP

Version 8.4

Product Guide

Notes, cautions, and warnings

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

Figures................................................................................................................................................ 7

Tables ................................................................................................................................................. 8

Preface ............................................................................................................................................... 9

Purpose ......................................................................................................................................................... 9

Audience........................................................................................................................................................ 9

Coverage....................................................................................................................................................... 9

Related documentation ................................................................................................................................ 9

CLI conventions .......................................................................................................................................... 10

Where to get help....................................................................................................................................... 10

Your comments........................................................................................................................................... 10

Part I: TimeFinder SnapVX ...................................................................................................................11

Chapter 1: Introduction to SnapVX .................................................................................................. 12

Mainframe Enablers and TimeFinder SnapVX ................................................................................................. 12

Licensing ..................................................................................................................................................... 12

Introduction to TimeFinder ............................................................................................................................... 12

Introduction to TimeFinder SnapVX................................................................................................................. 13

Linking snapshots to targets...................................................................................................................... 13

Cascading snapshots.................................................................................................................................. 13

Backward compatibility to traditional TimeFinder products ..................................................................... 13

Chapter 2: Getting started with SnapVX .......................................................................................... 14

TimeFinder SnapVX and TimeFinder/Clone Mainframe Snap Facility............................................................ 14

Postinstallation.................................................................................................................................................. 14

Software interoperability considerations ......................................................................................................... 14

SIBBATCH................................................................................................................................................... 14

SRS.............................................................................................................................................................. 14

FlashCopy.................................................................................................................................................... 15

Starting ResourcePak Base .............................................................................................................................. 15

Setting up security............................................................................................................................................ 15

Running TimeFinder/Clone Mainframe Snap Facility ...................................................................................... 15

Chapter 3: SnapVX configuration .................................................................................................... 16

TimeFinder SnapVX configuration layers......................................................................................................... 16

Configuration layer 1: EMCSNAPO site options........................................................................................ 16

Configuration layer 2: GLOBAL command parameters............................................................................. 16

Configuration layer 3: Parameters on other commands ........................................................................... 16

Editing the EMCSNAPO macro.........................................................................................................................17

EMCSNAPO site options ...................................................................................................................................17

Summary ..................................................................................................................................................... 18

ACTIVATE_SUBTASK# .............................................................................................................................. 19

ALLOW_FBA_META .................................................................................................................................. 19

ALLOW_LIGHTNING_DEVICE ................................................................................................................... 19

ALLOWZDP ................................................................................................................................................. 19

AUTOCREATE ............................................................................................................................................20

AUTOUNLINK .............................................................................................................................................20

BACKGRND ................................................................................................................................................20

CACHESYM ................................................................................................................................................20

CHECKBCV .................................................................................................................................................20

Contents

4 Contents

CHKONLIN ..................................................................................................................................................20

CHKSNSZ ...................................................................................................................................................20

CONDVOL ................................................................................................................................................... 21

CONSIST ..................................................................................................................................................... 21

COPYVOL ................................................................................................................................................... 21

DEBUG_ERROR ......................................................................................................................................... 21

DEBUG_SDUMP ......................................................................................................................................... 21

DISPCUU ..................................................................................................................................................... 21

EMUL_TYPE ............................................................................................................................................... 21

FREEUNLK ..................................................................................................................................................22

GROUP_DSNAME ......................................................................................................................................22

MESSAGE ...................................................................................................................................................22

REFVTOC ....................................................................................................................................................22

REPLACE ....................................................................................................................................................22

RESTORE_CREATE ...................................................................................................................................22

SECURE ......................................................................................................................................................22

SECURE_QUERY ........................................................................................................................................23

SHOWDEF ..................................................................................................................................................23

SNAPSHOT_LIST .......................................................................................................................................23

SNAPSHOT_NAME ....................................................................................................................................23

SOFTLINK ...................................................................................................................................................23

SOFTRESTORE ..........................................................................................................................................23

SRDFA_RETRY ...........................................................................................................................................23

SRPPERCT .................................................................................................................................................24

SRPMSGLVL ...............................................................................................................................................24

TERM_ALL ..................................................................................................................................................24

TIMEOUT ....................................................................................................................................................24

VARYOFF ....................................................................................................................................................24

VARYON ......................................................................................................................................................24

VCLOSE ......................................................................................................................................................25

UNLNKAFT .................................................................................................................................................25

WFDEF ........................................................................................................................................................25

Chapter 4: SnapVX operations ........................................................................................................26

Summary of operations.....................................................................................................................................26

Managing snapshots................................................................................................................................... 26

Viewing snapshots ...................................................................................................................................... 27

Linking, unlinking, and copying................................................................................................................... 27

Fine-tuning snapshot processing ............................................................................................................... 28

Setting up consistency ............................................................................................................................... 29

Controlling device status............................................................................................................................ 29

Conditioning target volume ........................................................................................................................ 30

Managing groups of statements ................................................................................................................ 30

Miscellaneous SnapVX settings ................................................................................................................. 31

Softlinked and hardlinked snapshots ............................................................................................................... 31

Snapshot life cycle ............................................................................................................................................ 31

SnapVX group status transitions ............................................................................................................... 32

Creating and activating snapshots...................................................................................................................32

Linking and unlinking snapshots .......................................................................................................................33

Impact of linking on SRP usage and SRDF data transfer ......................................................................... 33

Monitoring SRP usage ......................................................................................................................................34

Target volume track definition .........................................................................................................................34

Freeing tracks ...................................................................................................................................................34

Secure snaps .....................................................................................................................................................35

Defining groups of statements.........................................................................................................................36

Step 1: Specify group dataset .................................................................................................................... 36

Step 2: Define groups................................................................................................................................. 37

Step 3: Use groups as arguments to SnapVX commands ........................................................................ 37

Referencing other groups from within a group ......................................................................................... 37

Contents 5

Example of operations ......................................................................................................................................38

Chapter 5: SnapVX command reference ..........................................................................................40

SnapVX commands ...........................................................................................................................................40

Common parameters .................................................................................................................................. 41

ACTIVATE ...................................................................................................................................................57

CONFIG .......................................................................................................................................................57

CREATE ......................................................................................................................................................59

FREE ...........................................................................................................................................................60

GLOBAL ...................................................................................................................................................... 61

LINK .............................................................................................................................................................62

QUERY FREE ..............................................................................................................................................64

QUERY GLOBAL .........................................................................................................................................64

QUERY SNAPSHOT ...................................................................................................................................65

RENAME .....................................................................................................................................................70

TERMINATE .................................................................................................................................................71

UNLINK .......................................................................................................................................................72

Grouping commands .........................................................................................................................................73

Common parameters for grouping commands ..........................................................................................74

DEFINE GROUP ..........................................................................................................................................74

DELETE GROUP .........................................................................................................................................75

END GROUP ...............................................................................................................................................75

QUERY GROUP ..........................................................................................................................................75

Part II: zDP ........................................................................................................................................76

Chapter 6: Introduction to zDP .......................................................................................................77

Overview ........................................................................................................................................................... 77

Implementation.................................................................................................................................................. 77

Requirements and restrictions .........................................................................................................................78

Security considerations ....................................................................................................................................78

Chapter 7: zDP features and concepts .............................................................................................79

Key concepts.....................................................................................................................................................79

Versioned data group (VDG) .....................................................................................................................79

Snapset .......................................................................................................................................................79

Snapshot .....................................................................................................................................................80

Target set (TGT) ........................................................................................................................................80

Secure snaps .....................................................................................................................................................80

Persistent snapsets ..........................................................................................................................................80

Saved snapsets ................................................................................................................................................. 81

Copy-once devices and snapsets..................................................................................................................... 81

Defining copy-once devices ....................................................................................................................... 81

Viewing copy-once devices and snapsets ................................................................................................. 81

Linking and restoring copy-once devices .................................................................................................. 82

Unlinking copy-once devices...................................................................................................................... 82

On-demand snapsets ........................................................................................................................................82

Dynamic VDG update........................................................................................................................................82

Setting the snapset limit (MAX_SNAPSETS) .................................................................................................82

Calculating the snapset limit with saved and secure snapsets ................................................................ 83

Configuring SECURE on both CYCLE_TIME and SAVED_SNAPSETS ................................................... 83

Chapter 8: zDP Definition Utility .....................................................................................................84

Overview ...........................................................................................................................................................84

Running zDP Definition Utility ..........................................................................................................................84

Summary of operations.....................................................................................................................................85

Command reference .........................................................................................................................................89

Common parameters ..................................................................................................................................89

6 Contents

DEFINE TGT ...............................................................................................................................................96

DEFINE VDG ...............................................................................................................................................96

DELETE TGT ...............................................................................................................................................97

DELETE VDG ..............................................................................................................................................97

GLOBAL ......................................................................................................................................................98

LINK VDG ....................................................................................................................................................98

MODIFY TGT ADD|REMOVE .....................................................................................................................99

MODIFY VDG ADD|REMOVE .....................................................................................................................99

MODIFY VDG OPTIONS ........................................................................................................................... 100

PERSISTENT .............................................................................................................................................101

QUERY FREE ............................................................................................................................................ 102

QUERY TGT .............................................................................................................................................. 103

QUERY VDG .............................................................................................................................................. 104

RESTORE VDG ......................................................................................................................................... 109

SECURE VDG ........................................................................................................................................... 109

STOP_FREE TGT ..................................................................................................................................... 109

TERMINATE VDG ..................................................................................................................................... 109

UNLINK TGT .............................................................................................................................................. 110

UNLINK VDG .............................................................................................................................................110

Chapter 9: zDP ISPF interface ....................................................................................................... 111

Introduction .......................................................................................................................................................111

Logging in to zDP..............................................................................................................................................111

Logging out of zDP .......................................................................................................................................... 112

Accessing zDP ISPF tools................................................................................................................................ 112

Setting session options and GLOBAL parameters ......................................................................................... 113

Accessing zDP ISPF help................................................................................................................................. 113

Monitoring and managing VDGs...................................................................................................................... 113

Enable automatic refresh .......................................................................................................................... 114

Define VDG ................................................................................................................................................ 114

View SRP usage .........................................................................................................................................115

View VDG configuration parameters ........................................................................................................ 116

Modify VDG member ................................................................................................................................. 116

Query VDGs ............................................................................................................................................... 116

Set SMF parameters ................................................................................................................................. 116

Managing VDG members ................................................................................................................................. 117

Managing target sets....................................................................................................................................... 118

Define target set ....................................................................................................................................... 118

View target set storage details ................................................................................................................. 119

Modify target set member ....................................................................................................................... 120

Query target sets ...................................................................................................................................... 121

Link target set ........................................................................................................................................... 121

Unlink target set ........................................................................................................................................ 121

Managing target set members ....................................................................................................................... 122

Managing snapsets ......................................................................................................................................... 122

View VDG snapsets .................................................................................................................................. 123

Query snapsets ......................................................................................................................................... 126

Chapter 10: zDP SMF records ....................................................................................................... 127

Overview ..........................................................................................................................................................127

SMF record format ..........................................................................................................................................127

SMF record header................................................................................................................................... 127

Section header.......................................................................................................................................... 128

Section descriptors................................................................................................................................... 128

Base section.............................................................................................................................................. 129

Symm section ........................................................................................................................................... 129

Device section .......................................................................................................................................... 130

EIPVDG_FLAGS flags................................................................................................................................ 131

EIPSYM_FLAGS flags............................................................................................................................... 133

Figures 7

1 zDP Tool List panel ...................................................................................................................................... 112

2 Specify the Session parameters panel ........................................................................................................ 113

3 zDP VDG Monitor panel ............................................................................................................................... 113

4 Specify Versioned Data Group Parameters panel....................................................................................... 114

5 Specify VDG Device Parameters panel ....................................................................................................... 115

6 zDP SRP Monitor panel ............................................................................................................................... 115

7 zDP VDG Configuration Information panel ................................................................................................. 116

8 QUERY VDG options panel when querying VDGs....................................................................................... 116

9 SMF parameters panel ................................................................................................................................. 117

10 Manage VDG Members panel ...................................................................................................................... 117

11 zDP Target Set Display panel ...................................................................................................................... 118

12 Specify Target Set Parameters panel ......................................................................................................... 119

13 Configuration panel ...................................................................................................................................... 119

14 Device Information panel ............................................................................................................................ 120

15 Modify Group Parameters panel for a target set ...................................................................................... 120

16 QUERY TGT options panel........................................................................................................................... 121

17 Specify Link Snapset Parameters panel...................................................................................................... 121

18 UNLINK options panel.................................................................................................................................. 121

19 Manage TGT Members panel...................................................................................................................... 122

20 zDP Snapset Controller Display panel ........................................................................................................ 122

21 zDP VDG SnapSet Device panel................................................................................................................. 123

22 zDP Snapset Display panel ......................................................................................................................... 123

23 Select Target Set to Link panel .................................................................................................................. 124

24 LINK options panel ...................................................................................................................................... 124

25 Make a Snapset Secure panel .................................................................................................................... 124

26 Extend expiration time for Secure Snapset panel ..................................................................................... 125

27 RESTORE options panel.............................................................................................................................. 125

28 Terminate a range of snapsets panel ......................................................................................................... 126

29 QUERY VDG options panel when querying snapsets ................................................................................ 126

Figures

Tables 8

1 EMCSNAPO site options .............................................................................................................................. 18

2 Managing snapshots ..................................................................................................................................... 26

3 Viewing snapshots......................................................................................................................................... 27

4 Linking, unlinking, and copying ..................................................................................................................... 27

5 Fine-tuning snapshot processing.................................................................................................................. 28

6 Setting up consistency.................................................................................................................................. 29

7 Controlling device status .............................................................................................................................. 29

8 Conditioning target volume........................................................................................................................... 30

9 Managing groups of statements................................................................................................................... 30

10 Miscellaneous SnapVX settings.................................................................................................................... 31

11 Allowable SnapVX commands per snapshot state....................................................................................... 32

12 SnapVX group actions and statuses ............................................................................................................ 32

13 Impact of linking on SRP usage and SRDF data transfer............................................................................ 33

14 Managing VDGs............................................................................................................................................. 85

15 Managing target sets .................................................................................................................................... 85

16 Managing snapsets........................................................................................................................................ 85

17 Setting VDG snapset-related options .......................................................................................................... 86

18 Setting SRP usage and RDP cache utilization parameters ......................................................................... 87

19 Managing copy-once devices ....................................................................................................................... 87

20 Monitoring zDP status .................................................................................................................................. 88

21 zDP messaging and SMF records................................................................................................................. 88

22 Setting zDP runtime task options ................................................................................................................ 88

23 EIPVDG_FLAGS flag values......................................................................................................................... 131

24 EIPSYM_FLAGS flags ................................................................................................................................. 133

Ta b l e s

Preface 9

As part of an effort to improve its product lines, Dell EMC periodically releases revisions of its software and hardware. Therefore,

some functions described in this document might not be supported by all versions of the software or hardware currently in use. The

product release notes provide the most up-to-date information about product features.

Contact your Dell EMC representative if a product does not function properly or does not function as described in this document.

NOTE: This document was accurate at publication time. New versions of this document might be released at the Dell EMC

Online Support website. Check the Dell EMC Online Support website to ensure that you are using the latest version of this

document.

Purpose

This document describes how to configure, run, and use Dell EMC TimeFinder SnapVX and Data Protector for z Systems

(zDP).

Audience

This document is intended for the host system administrator, system programmer, or operator who is evaluating, planning for,

managing, or using TimeFinder SnapVX and zDP.

Coverage

This document describes TimeFinder SnapVX and zDP when used with the following storage system operating environments:

PowerMaxOS 5978

HYPERMAX OS 5977

Enginuity 5876

NOTE: For information pertaining to earlier operating environment levels, see prior versions of this guide.

Related documentation

To access related documentation, go to the PowerMax and VMAX All Flash Technical Documentation webpage at:

https://www.dellemc.com/en-us/documentation/vmax-all-flash-family.htm

The following documents provide information about Mainframe Enablers:

Mainframe Enablers Release Notes

Mainframe Enablers Installation and Customization Guide

Mainframe Enablers Message Guide

ResourcePak Base for z/OS Product Guide

SRDF Host Component for z/OS Product Guide

AutoSwap for z/OS Product Guide

Consistency Groups for z/OS Product Guide

TimeFinder SnapVX and zDP Product Guide

TimeFinder/Clone Mainframe Snap Facility Product Guide

TimeFinder/Mirror for z/OS Product Guide

TimeFinder Utility for z/OS Product Guide

The following documents provide additional information:

PowerMax Family Product Guide

Preface

10 Preface

PowerMaxOS for PowerMax and VMAX All Flash Release Notes

VMAX All Flash Product Guide

HYPERMAX OS for VMAX All Flash and VMAX3 Family Release Notes

E-Lab Interoperability Navigator (ELN) at https://elabnavigator.emc.com provides a web-based interoperability and solution

search portal.

CLI conventions

Command line interface (CLI) documentation conventions are as follows:

Courier—Used for command syntax and parameters, as well as system output, such as messages.

Courier bold—Used for user input, for example: Reply CONT.

Courier italic—Used for variables in commands and parameters, for example: DISPLAY ccuu

Courier underline—Underline indicates the default value, for example: YES|NO

< >—Angle brackets enclose variables or explanatory text when it includes multiple words, for example: <list of

device numbers>

[ ]—Square brackets enclose optional values, for example: DISPLAY [DETAIL]

|—A vertical bar indicates alternate selections (the bar means “or”), for example: RUN|NORUN

{ }—Braces are used together with the vertical bar (|) to indicate the start and end of alternate selections, for example:

{DEV symdv#|CUU ccuu}

...—An ellipsis indicates nonessential information omitted from the command output example.

Keywords appear in uppercase (for example, CREATE). They must be spelled exactly as shown.

For easy reference, keywords can be supplemented by lowercase letters to form a meaningful word (for example,

SOUrce). When typing a command, use only CAPITALIZED characters of any keyword.

Aside from the characters listed above, you must type all other characters that are shown in the syntax statements.

Where to get help

Dell Technologies maintains support pages for all products at https://www.dell.com/support.

The product support pages provide important product information such as product and user documentation, knowledge base

articles, drivers and other software installation packages downloads, advisories, and more.

A valid support contract and registration is required to access all information available on the product support sites.

Your comments

Your suggestions help us continue to improve the accuracy, organization, and overall quality of the user publications. Send

your opinions of this document to VMAXContentFe[email protected].

TimeFinder SnapVX 11

TimeFinder SnapVX

Part 1 of this guide describes how to set up and use TimeFinder SnapVX for z/OS.

Topics:

•Introduction to SnapVX

•Getting started with SnapVX

•SnapVX configuration

•SnapVX operations

•SnapVX command reference

I

12 Introduction to SnapVX

Introduction to SnapVX

This chapter provides an introduction to TimeFinder SnapVX.

Topics:

•Mainframe Enablers and TimeFinder SnapVX

•Introduction to TimeFinder

•Introduction to TimeFinder SnapVX

Mainframe Enablers and TimeFinder SnapVX

TimeFinder is one of the Dell EMC Mainframe Enablers. The Dell EMC Mainframe Enablers allow you to monitor and manage

the storage and include the following components:

ResourcePak Base for z/OS

SRDF Host Component for z/OS

AutoSwap for z/OS

Consistency Groups for z/OS

TimeFinder SnapVX

Data Protector for z Systems (zDP)

TimeFinder/Clone Mainframe Snap Facility

TimeFinder/Mirror for z/OS

TimeFinder Utility

When you install the Mainframe Enablers kit, you install the software for all the components.

NOTE: zDP requires TimeFinder SnapVX but is a separately licensed product.

Licensing

For information about licensing, see the following documents:

Mainframe Enablers Installation and Customization Guide

PowerMax Family Product Guide

VMAX All Flash Product Guide

Introduction to TimeFinder

Dell EMC TimeFinder is a family of local replication products. The products allow you to nondisruptively create and manage

point-in-time copies of data, enabling simultaneous action of business tasks that were previously sequential. For example,

TimeFinder allows you to create a point-in-time copy of critical data while this data continues to be used in production

operations.

The ability to access source data during the TimeFinder copy operation can increase the availability of the application.

TimeFinder can also shorten backup windows, maintenance windows and improve service levels.

This manual provides the command and parameter details for using TimeFinder SnapVX, which is a TimeFinder product that

supports the z/OS mainframe environment as one of the components of Dell EMC Mainframe Enablers.

NOTE: For a comprehensive description of traditional TimeFinder products, including TimeFinder/Clone and TimeFinder VP

Snap, see the TimeFinder/Clone Mainframe Snap Facility Product Guide.

1

Introduction to SnapVX 13

Introduction to TimeFinder SnapVX

Starting with HYPERMAX OS 5977, TimeFinder introduces TimeFinder SnapVX which provides the best aspects of the

traditional TimeFinder offerings, together with increased scalability and ease-of-use.

SnapVX provides targetless snapshot capabilities. Instead of requiring target volumes to capture point-in-time images of

source volumes, SnapVX introduces the new concept of creating a “snapshot” to create and access point-in-time images of

volumes. SnapVX supports up to 256 snapshots per volume which effectively allows for the creation of 256 separate

point-in-time images of every volume. Snapshots store changed tracks (deltas) directly in the Storage Resource Pool of the

source device and use shared allocations to eliminate saving duplicate tracks between multiple snapshots. Users can assign

names to individual snapshots and assign an automatic expiration date to each snapshot.

NOTE: The PowerMax Family Product Guide and VMAX All Flash Product Guide provide additional information about SnapVX.

Linking snapshots to targets

With SnapVX, a snapshot can be accessed by linking it to a host accessible volume (known as a target volume). Up to 1024

target volumes can be linked to one or more snapshots of a single source volume. The 1024 links can all be to the same

snapshot on a single source volume, or they can be multiple target volumes that are linked to multiple snapshots from the

same source volume.

NOTE: A target volume may be linked only to one snapshot at a time.

You can link, unlink, relink snapshots to the same set of target volumes, providing flexibility in the point-in-time copy that is

presented on a single set of target devices. These snapshots share allocations to the same track image whenever possible

while ensuring they each continue to represent a unique point-in-time image of the source volume. Despite the space

efficiency that is achieved through shared allocation to unchanged data, additional capacity is required to preserve the

preupdate images of changed tracks that each point-in-time snapshot captures.

Cascading snapshots

Snapshots can be cascaded from linked targets, and targets can be linked to snapshots of linked targets. There is no limit to

the number of levels of cascading, and the cascade can be broken.

Backward compatibility to traditional TimeFinder products

TimeFinder SnapVX supports backward compatibility to traditional TimeFinder products, including TimeFinder/Clone,

TimeFinder VP Snap, and TimeFinder/Mirror.

TimeFinder transparently converts the commands of the traditional TimeFinder products to SnapVX commands.

NOTE: Using TimeFinder SnapVX requires no change of scripts that use the traditional TimeFinder commands.

TimeFinder emulation sessions and TimeFinder snapshots can coexist on the same device.

14 Getting started with SnapVX

Getting started with SnapVX

This chapter instructs you how to run TimeFinder SnapVX.

Topics:

•TimeFinder SnapVX and TimeFinder/Clone Mainframe Snap Facility

•Postinstallation

•Software interoperability considerations

•Starting ResourcePak Base

•Setting up security

•Running TimeFinder/Clone Mainframe Snap Facility

TimeFinder SnapVX and TimeFinder/Clone

Mainframe Snap Facility

SnapVX is a feature of TimeFinder/Clone Mainframe Snap Facility. As such, it uses the TimeFinder/Clone Mainframe Snap

Facility program EMCSNAP and its global configuration parameters.

For information about other features of TimeFinder/Clone Mainframe Snap Facility, see the TimeFinder/Clone Mainframe

Snap Facility Product Guide.

Postinstallation

To use SnapVX, install Mainframe Enablers and enable the TimeFinder/Clone component of TimeFinder/Clone Mainframe

Snap Facility, as described in the Mainframe Enablers Installation and Customization Guide.

Software interoperability considerations

SIBBATCH

If you plan to run with full IBM SNAPSHOT compatibility, place the Dell EMC-supplied SIBBATCH in the search list ahead of

the IBM-supplied SIBBATCH.

SIBBATCH uses the same DD statements as SNAPSHOT. If you want any TimeFinder functions, code the statement exactly

as it is coded in TimeFinder. For instance, a GLOBAL statement could be added to the input stream.

SRS

If the installation uses the Space Management Software from DTS Software, you should exclude TimeFinder from SRS

recovery by coding the following rule:

DEFRULE NOEMC

IF PGM=EMCSNAP

THEN EXIT

2

Getting started with SnapVX 15

FlashCopy

IBM 2105 and 2107 controllers are recognized, and IBM FlashCopy is automatically invoked as a datamover, if appropriate.

TimeFinder recognizes FlashCopy V2 support and uses FlashCopy V2 to copy dataset extents.

TimeFinder recognizes whether a storage system is FlashCopy capable. It also recognizes when a FlashCopy session is active

at the logical volume level.

FlashCopy and Snap sessions can co-exist and the value in the site options table for &EMCDSSU_FLASH_SNAP is always

used. If the site options table has Snap as the preferred copy method (&EMCDSSU_FLASH_SNAP=SNAP) and a FlashCopy

session already existed on the device, TimeFinder would use Snap.

NOTE: A FlashCopy target cannot be used as a SnapVX source.

Starting ResourcePak Base

TimeFinder/Clone Mainframe Snap Facility requires that ResourcePak Base (SCF) is running. Before using TimeFinder/Clone

Mainframe Snap Facility, start ResourcePak Base as described in the ResourcePak Base for z/OS Product Guide.

By default, TimeFinder/Clone Mainframe Snap Facility expects that ResourcePak Base runs as a task named EMC$SCF. If

your instance of ResourcePak Base has another name, specify it in the SCF$nnnn DD statement of the TimeFinder/Clone

Mainframe Snap Facility job.

If ResourcePak Base is not running, issuing any TimeFinder/Clone Mainframe Snap Facility command results in an error

message stating that EMCSCF is not available.

Setting up security

TimeFinder/Clone Mainframe Snap Facility uses SAF calls to validate access to resources. This feature is turned on by default.

The source code for the TimeFinder/Clone Mainframe Snap Facility SAF interface routine is provided in the SAMPLIB library

of ResourcePak Base, so that you can tailor it to your specific needs.

NOTE: The Mainframe Enablers Installation and Customization Guide describes the security interface and the class and

resource names used.

Running TimeFinder/Clone Mainframe Snap

Facility

You normally run TimeFinder/Clone Mainframe Snap Facility as a batch job. The JCL is as follows:

//EMCSNAP EXEC PGM=EMCSNAP,REGION=0M

//STEPLIB DD DISP=SHR,DSN=ds_prefix.LINKLIB

//SYSABEND DD SYSOUT=*

//QCOUTPUT DD SYSOUT=*

//QCERROR DD SYSOUT=*

//SCF$nnnn DD DUMMY

//QCINPUT DD *

Where:

ds_prefix is the product dataset name prefix that you specified during installation of Mainframe Enablers as described in

the Mainframe Enablers Installation and Customization Guide.

nnnn identifies the ResourcePak Base task that the TimeFinder/Clone Mainframe Snap Facility job runs against.

The QCOUTPUT DD statement defines the QCOUTPUT report file that is described in the TimeFinder/Clone Mainframe

Snap Facility Product Guide.

When the QCERROR DD statement is specified, any error messages are written to the QCERROR file and to the

QCOUTPUT report file.

The QCINPUT DD statement can reference a disk file: DISP=SHR,DSN=dsn.

NOTE: You can also use the DD statement //EMCGROUP DD to reference the statement group dataset.

16 SnapVX configuration

SnapVX configuration

This chapter discusses how to configure TimeFinder SnapVX.

Topics:

•TimeFinder SnapVX configuration layers

•Editing the EMCSNAPO macro

•EMCSNAPO site options

TimeFinder SnapVX configuration layers

TimeFinder has three configuration layers, each of which can override the layer above it:

1. Configuration layer 1: EMCSNAPO site options

2. Configuration layer 2: GLOBAL command parameters

3. Configuration layer 3: Parameters on other commands

NOTE: Only the administrator for the site should set and change site options to avoid unforeseen complications and problems

with TimeFinder processing and the expected results.

Configuration layer 1: EMCSNAPO site options

The first configuration layer consists of the TimeFinder site options. You can accept the site option default values, or you may

permanently change the value to suit your requirements.

You can also use the Dell EMC REXX interface to create scripts to influence standard Dell EMC processing or to perform

related external user-defined processing. For more information, see the description of TimeFinder REXX exits in the

TimeFinder/Clone Mainframe Snap Facility Product Guide.

The site-specific values are specified in the EMCSNAPO macro in the Mainframe Enablers SAMPLIB (SMP/E DDNAME:

MFESAMP). You can change a value by adding the modification to a member in the RIMLIB and then running the EMCSNAPO

statement.

The JCL in the RIMLIB specifies the Mainframe Enablers SAMPLIB as the first dataset in the SYSLIB concatenation for the

assembly.

Configuration layer 2: GLOBAL command parameters

The second layer consists of the GLOBAL command parameters. The GLOBAL command parameters match many of the site

options. GLOBAL command parameters override EMCSNAPO site options. To temporarily change a site option value that has

a matching GLOBAL parameter, you can set that GLOBAL parameter to the value you want to use.

GLOBAL parameter values apply only to commands that follow the GLOBAL command in the current job step. They do not

affect any commands that precede them in the current job step. After that job step is over, TimeFinder uses the site option

value again.

You can set multiple global commands within a job step. In each case, the GLOBAL command applies to the commands that

follow unless overridden by another, later GLOBAL command.

Configuration layer 3: Parameters on other commands

The third layer consists of the parameters that are associated with other TimeFinder commands. Many of the TimeFinder

commands can take parameters available on the GLOBAL command statement. To override an EMCSNAPO site option or a

GLOBAL parameter, issue the equivalent parameter with that command.

3

SnapVX configuration 17

The value that you use is only in force for the duration of the operation of the command to which it is appended. After the

command is finished, TimeFinder uses the GLOBAL parameter value (if it was set) or the site option value again.

Editing the EMCSNAPO macro

The EMCSNAPO macro lists all site options that you can change. (Many of these site options are also parameters of the

GLOBAL command.) For each site option, the macro lists:

A short form of the site option name with the default value in the form: &SHORTFORM=DEFAULT

The full name of the site option

A list of possible values

For example, the macro listing for the AUTOMATIC_DEALLOC parameter is:

&AUTODEAL=YES, AUTOMATIC_DEALLOC (Y/N)

To change a parameter setting, use member #91SNPJB supplied in the RIMLIB and add the parameter to the EMCSNAPO

statement and then run the job. Then issue the SCF INI,RELOAD command or restart SCF.

For example, the default value for the macro &AUTODEAL is YES. To change this setting to NO, you would add

AUTODEAL=NO to the EMCSNAPO statement.

NOTE: The ampersand (&) is used only in the macro definition, but you do not use it when you are adding to the EMCSNAPO

statement for execution.

Before:

EMCSNAPO DSECT=NO

After:

EMCSNAPO AUTODEAL=NO,DSECT=NO

Member #91SNPJB runs the IBM assembler, and the EMCSNAPO statement must follow the IBM assembler rules for coding.

This requirement especially applies to statement continuation, placing a character in column 72 to indicate continuation and

continuing in column 16 of the next line. DSECT=NO must always be present.

For example:

v - column 10

v - column 16 v - column 72

EMCSNAPO DATACLAS=ABC, X

MGMTCLAS=DEF, X

STORCLAS=GHI, X

DSECT=NO

NOTE: After a PTF has been applied that adds new GLOBAL parameters, add the new parameters to the EMCSNAPO

statement in RIMLIB(#91SNPJB) and run the updated #91SNPJB job.

EMCSNAPO site options

NOTE: This guide lists site options pertaining to SnapVX. For other TimeFinder site options, see the TimeFinder/Clone

Mainframe Snap Facility Product Guide.

18 SnapVX configuration

Summary

The following table lists the EMCSNAPO site options and their default values together with the corresponding GLOBAL

parameters.

Table 1 EMCSNAPO site options

Site option (without the macro

“&” designation)

Site

option

default Site option valid values

Site option name in QUERY GLOBAL

output

ACTIVATE_SUBTASK# 3 0-255 ACTIVATE_SUBTASK#

ALLOW_FBA_META NO YES|NO ALLOW_FBA_META

ALLOW_LIGHTNING_DEVICE NO YES|NO ALLOW_LIGHTNING_DEVICE

ALLOWZDP NO YES|NO ZDP

AUTOCREATE NO YES|NO AUTO_CREATE

AUTOUNLINK NO YES|NO AUTO_UNLINK

BACKGRND YES YES|NO|NOCOPYRD|VSE BACKGROUNDCOPY

CACHESYM NO YES|NO CACHE_FULL_SYM

CHECKBCV YES YES|NO CHECKBCVHOLDSTATUS

CHKONLIN YES YES|NO|NEVER CHECKONLINEPATHSTATUS

CHKSNSZ NO YES|NO CHECK_SNAPSHOT_SIZE

CONDVOL ALL ALL|DUMP|LABEL CONDITIONVOLUME

CONSIST NO YES|NO CONSISTENT

COPYVOL YES YES|NO COPYVOLID

DEBUG_ERROR NO YES|NO DEBUG(ERROR)

DEBUG_SDUMP NO YES|NO DEBUG(SDUMP)

DISPCUU NO YES|NO DISPLAY_CUU

EMUL_TYPE ALL ALL|HARDLINK|SNAPVX EMUL_TYPE

FREEUNLK NO YES|NO FREEUNLK

GROUP_DSNAME n/a dataset_name GROUP_DSNAME(LOCAL)

MESSAGE NONE DISPLAY|PROMPT|NONE|

DETAIL

MESSAGE

REFVTOC NO YES|NO REFVTOC

REPLACE NO YES|NO REPLACE

RESTORE_CREATE NO YES|NO RESTORE_CREATE

SECURE NO YES|NO SECURE

SECURE_QUERY NO YES|NO SECURE_QUERY

SHOWDEF NO YES|NO SHOW_TRACKS_TO_BE_DEFINED

SNAPSHOT_LIST ALL ALL|LINKED|NOT_LINKED|

SNAPSHOT|ACTIVATED|

NOT_ACTIVATED|

COPY|NOCOPY|

DEFINED|NOT_DEFINED|

SECURE|NOT_SECURE|

ZDP|NOT_ZDP

SNAPSHOT_LIST

SnapVX configuration 19

ACTIVATE_SUBTASK#

See ACTIVATE_SUBTASK#.

Syntax

ACTIVATE_SUBTASK#=nnn

Where nnn is the minimum number of storage systems. The default value is 3.

ALLOW_FBA_META

See ALLOW_FBA_META.

Syntax

ALLOW_FBA_META={YES|NO}

ALLOW_LIGHTNING_DEVICE

See ALLOW_LIGHTNING_DEVICE.

Syntax

ALLOW_LIGHTNING_DEVICE={YES|NO}

ALLOWZDP

See ZDP.

Syntax

ALLOWZDP={YES|NO}

SNAPSHOT_NAME n/a snapshot_name NAME

SOFTLINK NO YES|NO SOFTLINK

SOFTRESTORE NO YES|NO SOFTRESTORE

SRDFA_RETRY 10 YES|NO|count SRDFA_CONSISTENT_RETRY

SRPPERCT 100 0-100 SRPPERCT

SRPMSGLVL INFO INFO|WARN|ERROR|SKIP SRPMSGLVL

TERM_ALL NO YES|NO TERMINATE_ALL

TIMEOUT 15 0-128 TIMEOUT

VARYOFF AUTO AUTO|NEVER VARY_OFFLINE

VARYON AUTO AUTO|NEVER VARY_ONLINE

VCLOSE NO YES|NO VCLOSE

UNLNKAFT NO YES|NO UNLINK_AFTER_COPY

WFDEF YES YES|NO WAIT_FOR_DEFINITION

Table 1 EMCSNAPO site options

20 SnapVX configuration

AUTOCREATE

See AUTO_CREATE.

Syntax

AUTOCREATE={YES|NO}

AUTOUNLINK

See AUTO_UNLink.

Syntax

AUTO_UNLINK={YES|NO}

BACKGRND

See BACKGROUNDCOPY.

Syntax

BACKGRND={YES|NO|NOCOPYRD|VSE}

CACHESYM

See CACHE_FULL_SYM.

Syntax

CACHESYM={YES|NO}

CHECKBCV

See CHECKBCVHoldstatus.

Syntax

CHECKBCV={YES|NO}

CHKONLIN

See CHECKONLINEpathstatus.

Syntax

CHKONLIN={YES|NO|NEVER}

CHKSNSZ

See CHECK_SNAPSHOT_SIZE.

Syntax

CHKSNSZ={YES|NO}

Page is loading ...

Dell Mainframe Enablers User guide

Related papers

Other documents