Backup & Recovery Manager Suite User Guide: ABARS Managerpublib.boulder.ibm.com/tividd/td/ITABaRfzOS/GC23-6060-00/... · 2006. 12. 12. · Backup & Recovery Manager Suite: ABARS Manager

Mainstar®: Backup & Recovery Manager™ Suite User Guide

ABARS Manager Product Version 6, Release 01

SC23-6060-00 November 2006

Mainstar Software Corporation P.O. Box 4132 Bellevue, WA 98009 USA

Tel 1-425-455-3589 Fax 1-425-455-1992 Technical Support: [email protected] Web: www.mainstar.com

Copyright ©2006 Mainstar Software Corporation. All rights reserved.

Mainstar Software Corporation is a wholly owned subsidiary of Rocket Software, Inc.

mailto:[email protected]://www.mainstar.com/

Backup & Recovery Manager Suite: ABARS Manager User Guide

Seventeenth Edition (November 2006)

This edition of the Mainstar: Backup & Recovery Manager Suite User Guide supports Version 6 Release 01 of the Mainstar: Backup & Recovery Manager Suite product.

Restricted Materials Notice

This manual contains restricted materials proprietary to Mainstar Software Corporation. Use and possession of this manual is pursuant to the user obtaining a license for Mainstar: Backup & Recovery Manager Suite from Mainstar Software Corporation.

Trademarks

'Mainstar' is a registered trademark of Mainstar Software Corporation in the United States and/or

other countries.

The following terms used in this publication have been adopted by Mainstar Software Corporation as

trademarks in the United States and/or other countries.

ABARS Manager All/Star

Aggregate LoadBalancer ASAP

Catalog RecoveryPlus CATSCRUB

Incremental ABARS FullRename

Prevent BackLevel

The following terms used in this publication have been adopted by the IBM Corporation as trademarks in the United States and/or other countries.

AIX DFSMSdss z/OS

IBM DFSMShsm

The following terms used in this publication have been adopted by other corporations as trademarks in the United States and/or other countries:

TRADEMARK COMPANY

Brightstor® CA-FAVER® Computer Associates International, Inc. FDR™ Innovation Data Processing Quick-Ref™ Chicago-Soft

©2000–2006 by Mainstar Software Corporation All Rights Reserved

November 2006 SC23-6060-00 Seventeenth Edition

Mainstar Software Corporation ©2006 i Contents SC23-6060-00

PROPRIETARY: Unauthorized use, reproduction or distribution prohibited.

User Guide Backup & Recovery Manager Suite: ABARS Manager

Contents ii Mainstar Software Corporation ©2006 SC23-6060-00



Summary of Changes

SC23-6060-00 This version of the Mainstar: Backup & Recovery Manager Suite User November 2006 Guide supports Version 6 Release 01 of the Mainstar: Backup & Seventeenth Edition Recovery Manager Suite: ABARS Manager product.

Integrated Maintenance See Fixlist distributed with release for details.

Documentation Updates • Split the Backup & Recovery Manager Suite User Guide into two User Guides, one for ABARS Manager, and one for All/Star. Add ASAP to the BRM Suite documents.

• Update Chapter 1, About Backup & Recovery Manager Suite to: − add Validating Load Module Contents topic from boilerplate

• Update Chapter 2, BRM Suite: Online Dialog, to: − update image in BRMINI Values - Menu Option 2 (24159) − add ABARS Manager and All/Star as needed to Utilities Sub-Menu

(25607) • Update Chapter 3, ABARS Manager: Setup and Configuration to: − add number of events to display in History (24145) − add RECALL MIGRATED VSAM and RECALL FAILED to Submit

Backup panel (24780) − add note to Line Command ES and Line Command BS, allowing

ABARS SDSs to be members of a PDSE (23001) • Update Chapter 4, ABARS Manager: Backup and Recovery

Management, to: − add field description for DATASETCONFLICT values RS and RT,

and DATASETCONFLICT HLQ parameter (23516) − add RECALL MIGRATED and RECALL FAILED to Submit Backup

panel (24780) − add note to Line Command ES and Line Command BS, allowing

ABARS SDSs to be members of a PDSE (23001) • Update Chapter 5, BRM Suite: Features – Option 4 to: − revise CATSCRUB panel & field descriptions for CR+ 0641 (23977) − change the default of CATSCRUB SIMULATE to Y (21875)

• Update Chapter 6, BRM Suite: Search for Data Set – Option 5 to: − add Quick Search option (23043)

• Update Chapter 7, ABARS Manager: Reports – Online Using Option 6 to:

− add new From Time and To Time fields to Event List Report (24526)

• Update Chapter 9, BRM Suite: History – Option 8 to: − explain how BRM determines how many events to retain for the

History display (24145) − update program types in PGM/Type field description

• Update Chapter 10, ABARS Manager Batch Processing & Output to: − correct Backup Options output listing (12525) − add DELETE keyword to the AGGMGMT batch command (22654) − add RECALL-MIGRATED-VSAM AND RECALL-FAILED to

ABACKUP command syntax (24780) − add TIME parameter to REPORT EVTLIST command (24526)

• Update Chapter 11, ABARS Manager: SDSL – Selection Data Set

Mainstar Software Corporation ©2006 iii Contents SC23-6060-00



Language, to: − correct misc. wording issues (22789) − add new example for masks for relative gens; reword some of the

FILTERS text (25251) • Update Chapter 13, BRM Suite: Dynamic Data Set

Backup/Reorganization to:

− change all occurrences of SI042DC0 to BRM01BRR (21482)

• Update Chapter 16, BRM Suite: CATSCRUB – Synchronize Catalogs/Volumes for DR to:

− revise command syntax and examples for CR+ 0641 (23977)

• Update TOC and Index

Contents iv Mainstar Software Corporation ©2006 SC23-6060-00



Document 005-0202-16 This version of the Mainstar: Backup & Recovery Manager Suite User June 2005 Guide supports Version 4 Release 03 of the Mainstar: Backup & Sixteenth Edition Recovery Manager Suite product.


Documentation Updates • Add Load/Unload IDS options for All/Star (18523) • Add INCLUDE and EXCLUDE filter options to Setup and Configuration

Panel (20013) • Update Chapter 1, About Backup & Recovery Manager Suite to: − add topic describing data set naming restrictions when using

hyphens as last character of a data set name (20236) − update PDS note (23001)

• Update Chapter 2, BRM Suite: Online Dialog to: − Change LOADIDS/UNLOADIDS ALL to have selectable criteria for

both ABARS and All/Star data (21174) • Update Chapter 3, ABARS Manager Setup and Configuration to: − Update PDS note (23001)

• Update Chapter 4, All/Star Setup and Configuration to: − describe new panels for INCLUDE and EXCLUDE filters (20013)

• Update Chapter 5, ABARS Manager: Backup & Recovery Management – Option 2 to: − add GDGGEN0ONLY as an ARECOVER option (19752)

− Change LOADIDS/UNLOADIDS ALL Options 4 and 7 on the

UTILITIES sub-menu to provide selectable criteria for both ABARS and All/Star data (21174)

• Update Chapter 6, All/Star Backup and Recovery Management – Option 2 to: − add new sub-option 6, Applications (requires ASAP) to the Backup

and Recovery Management menu (16639) − add new fields to Set Up Restore panel for No Backup Found RC

and No Backup Found Status (21308) • Update Chapter 9, BRM Suite Reports to split into 2 chapters and: − add new Overlap by Dataset Recovery Report (13342) − add INCLEVT and EXCLEVT fields to Overlap by Data Set Report

panel (13437) • Update Chapter 10, All/Star Reports to: − add What Isn't Backed Up report (18865) − add 2 new Critical in ASAP reports 10 and 11 (19163) − move 3 reports from old All Backups Option 3 to new Option 3,

All/Star Backup Reports (19474) − add Backup End Summary report (17950)

• Update Chapter 13, ABARS Manager: Batch Processing & Output to: − add RESETCB keyword to ABACKUP command (18448) − add GDGGEN0ONLY keyword to ARECOVER command (19752) − add instructions for overriding SYSOUT (19864) − add new INCLEVT and EXCLEVT parameters to OVERLAPD

(13437) − add new OVERLAPD-RCV report in batch (13342)

Mainstar Software Corporation ©2006 v Contents SC23-6060-00



• Update Chapter 14, All/Star: Batch Processing & Output to: − add REFRESH-AST and BUILD-BIFDSN commands (20332) − document enhancement to the NOBACKUP report (19505) − document OVERLAPE-AST report (9942) − add ASAP2BRM-B and ASAP2BRM-NB reports (19163) − add BKUPEND report (17950)

• Update Chapter 19, ABARS Manager: Incremental ABARS to: − add note about ABEND 201 (20627)

• Add new Chapter 20, All/Star: Application Backup and Restore. − add new BKUPEND command (17950)

• Update Chapter 21, All/Star: Build Restore to: − add note about VOL=RETAIN to section 18.1 − change RESTORE command to BLDREST (9942) − add new APPL selection category to BLDREST command (17950) − add COPY, BADBKUPRC, INCLLOC, and EXCLLOC parameters to

BLDREST command − add USEGEN0ALL and USEGEN0NOBKUP parameters to

BLDREST command (16639) − add NOBKUPFOUND parameter to BLDREST command (21308)

• Update TOC and Index.

Document 005-0202-15 This version of the Mainstar: Backup & Recovery Manager Suite User December 2004 Guide supports Version 4 Release 1 of the Mainstar: Backup & Recovery Fifteenth Edition Manager Suite product.


Documentation Updates • Renumber chapters to accommodate new chapters. • Move Appendix A, Filtering Pattern Masks, to Chapter 1; renumber

Appendix B, All/Star Skeleton Processing and Skeleton Variables, to Appendix A.

• Update Chapter 2, BRM Suite: Online Dialog to: − document new selectable feature CATSCRUB (19145)

• Add new Chapter 7, Features – Option 4, to document new selectable feature CATSCRUB (19145)

• Update Chapter 14, Dynamic Data Set Backup/Reorganization to: − add note regarding Lock Data Set (18349)

• Update Chapter 18 All/Star: All/Star Tracking (AST) Started Task to: − add sections on reorganizing and resizing the IDS (19593)

• Add new Chapter 20, BRM Suite: CATSCRUB – Synchronize Catalogs/Volumes For DR (19145)

• Update Appendix A, All/Star Skeleton Processing and Skeleton Variables to: − add new skeleton variable &NXTVOLSER to generic variables

(PMR 18534)

− add new generic variable &EXPDTJCL (19339)


Contents vi Mainstar Software Corporation ©2006 SC23-6060-00



Document 005-0202-14 This version of the Mainstar: Backup & Recovery Manager Suite User July 2004 Guide supports Version 4 Release 1 of the Mainstar: Backup & Recovery Fourteenth Edition Manager Suite product.


Documentation Updates • Add All/Star documentation and rename Backup & Recovery Manager to ABARS Manager throughout. Rename product to Backup & Recovery Manager Suite.

• Update Chapters 2 & 3 to: − explain how to negate the "do not show this panel again"

specification using the "C" field (ETR 16252)

− move content of Chapter 5, Group Filters, into Chapter 2

• Update Chapter 14, ABARS Manager: ABARS Aggregate LoadBalancer, to: − change Aggregate LoadBalancer to sort ML2 by volume

(ETR16337) − change Aggregate LoadBalancer to display intermediate file

variables.

• Move 'Reports in Batch' from Chapter 7 to Chapter 10 • Update TOC and Index.

Document 005-0202-13 This version of the Mainstar: Backup & Recovery Manager User Guide August 2003 supports Version 3 Release 2 of the Mainstar: Backup & Recovery Thirteenth Edition Manager product.

Integrated Maintenance Service Pack A. See Fixlist distributed with release for details.

Documentation Updates • Update Chapter 11, SDSL – Selection Data Set Language to: − change topic name from 'Howe SDSL Works to 'Overview of SDSL

Setup' − add new topic 'Overview of SDSL Language' to provide information

and examples for FILTERS and CANDIDATES. (PMR14623) − update DSNTYPE keyword to document descriptions for the values.

(PMR14623) − document additional examples of using CANDIDATES and

FILTERS. (PMR14623)

• Update Chapter 14, Incremental ABARS to: − update topic 'How to Use Incremental ABARS' to document new

Step 4 – Identify the Aggregate as Incremental and set the 'Backup Gens/Groups to Retain'.


Mainstar Software Corporation ©2006 vii Contents SC23-6060-00



Twelfth Edition, 005-0202-12, March 2003, supports Backup & Recovery Manager product 3.2 Eleventh Edition, 005-0202-11, November 2002, supports Backup & Recovery Manager product 3.1 Service Pack A Tenth Edition, 005-0202-10, September 2002, supports Backup & Recovery Manager product 3.1 Service Pack A Ninth Edition, 005-0202-09, February 2002, supports Backup & Recovery Manager product 3.1 Eighth Edition, 005-0202-08, July 2001, supports Backup & Recovery Manager product 2.1 Service Pack C Seventh Edition, 005-0202-07, June 2001, supports Backup & Recovery Manager product 2.1 Service Pack B Sixth Edition, 005-0202-06, May 2001, supports Backup & Recovery Manager product 2.1 Service Pack B Fifth Edition, 005-0202-05, April 2001, supports Backup & Recovery Manager product 2.1 Service Pack A Fourth Edition, 005-0202-04 TNL, April 2001, supports Backup & Recovery Manager product 2.1 Service Pack A Third Edition, 005-0202-03, January 2001, supports Backup & Recovery Manager product 2.1 Second Edition, 005-0202-02, 2000, supports Backup & Recovery Manager product 1.1 Service Pack A First Edition, 005-0202-01, 2000, supports Backup & Recovery Manager product 1.1

Contents viii Mainstar Software Corporation ©2006 SC23-6060-00



Contents

Preface.1 About This Book ......................................................................................................................... 1

Preface.2 Where to Find More Information................................................................................................ 3

1 About Backup & Recovery Manager Suite ...................................................................................... 1-1

1.1 About ABARS Manager ..................................................................................................................... 1-1

1.1.1 Benefits of Using ABARS Manager .......................................................................................... 1-2

1.1.2 ABARS & Other Utilities............................................................................................................ 1-2

1.2 Validating Load Module Contents – Run MODLEVEL....................................................................... 1-3

1.3 How to Read Command Syntax......................................................................................................... 1-5

1.4 Mainstar Extended ACS Filtering Pattern Masks............................................................................... 1-6

1.5 Your EBCDIC Code Tables – Specification and Display of EBCDIC Characters.............................. 1-7

1.6 Data Set Naming Conventions........................................................................................................... 1-7

1.7 View Backup & Recovery Manager Suite Messages......................................................................... 1-7

1.7.1 Message Identifier Naming Convention.................................................................................... 1-7

1.7.2 Determine Which MESSAGES Member Contains the Message Description .......................... 1-8

1.7.3 View Messages Using ISPF Interface ...................................................................................... 1-8

1.7.4 View Messages in MESSAGES Library ................................................................................... 1-8

1.7.5 View Messages Using Quick-Ref ............................................................................................. 1-8

2 BRM Suite: Online Dialog .................................................................................................................. 2-1

2.1 About the Backup & Recovery Manager Suite Interactive Dialog Panels ......................................... 2-1

2.1.1 Panel Types & Usage ............................................................................................................... 2-1

2.1.2 Panel 'Jump' Convention & Usage ........................................................................................... 2-2

2.1.3 Format and Fields on a Selection Panel................................................................................... 2-2

2.1.4 Format and Fields on a Table/List Panel.................................................................................. 2-3

2.2 Backup & Recovery Manager Suite Main Menu ................................................................................ 2-4

2.3 Sub-Menu Options ............................................................................................................................. 2-7

2.4 MENU Sub-Menu ............................................................................................................................... 2-8

2.4.1 Messages – Menu Option 1...................................................................................................... 2-8

2.4.2 BRMINI Values – Menu Option 2 ............................................................................................. 2-9

2.4.3 Exit Backup & Recovery Manager Suite – Menu Option 3....................................................... 2-9

2.5 DIAGNOSTICS Sub-Menu............................................................................................................... 2-10

2.5.1 About – Diagnostics Option 1 ................................................................................................. 2-10

2.5.2 Load Modules – Diagnostics Option 2.................................................................................... 2-10

2.5.3 Free Memory – Diagnostics Option 3 ..................................................................................... 2-11

2.5.4 Trace Records (ABARS Manager) – Diagnostics Option 4.................................................... 2-11

2.6 PREFERENCES Sub-Menu ............................................................................................................ 2-12

2.6.1 Space Display (ABARS Manager and All/Star) – Preferences Option 1................................ 2-12

2.6.2 Job Card (ABARS Manager) – Preferences Option 2 ............................................................ 2-14

2.6.3 Job Card (All/Star) – Preferences Option 3 ............................................................................ 2-15

2.6.4 Job Card – CATSCRUB (ABARS Manager and All/Star) – Preferences Option 4 ................ 2-15

2.7 UTILITIES Sub-Menu – ABARS Manager and All/Star ................................................................... 2-16

2.7.1 Load Activity Log (ABARS Manager) – Utilities Option 1 ....................................................... 2-16

2.7.2 Load Inventory (ABARS Manager) – Utilities Option 2........................................................... 2-21

2.7.3 Load Inventory (All/Star) – Utilities Option 3........................................................................... 2-23

2.7.4 Load Inventory (All) – Utilities Option 4 .................................................................................. 2-23

2.7.5 Unload Inventory (ABARS Manager) – Utilities Option 5 ....................................................... 2-25

2.7.6 Unload Inventory (All/Star) – Utilities Option 6 ....................................................................... 2-28

Mainstar Software Corporation ©2006 ix Contents SC23-6060-00



2.7.7 Unload Inventory (All) – Utilities Option 7............................................................................... 2-28

2.7.8 Reset Aggregate Options (ABARS Manager) – Utilities Option 8 .......................................... 2-31

2.7.9 DAD Monitor (ABARS Manager and All/Star) – Utilities Option 9 .......................................... 2-34

2.8 Admin Sub-Menu – All/Star Only ..................................................................................................... 2-36

3 ABARS Manager: Setup and Configuration – Option 1.................................................................. 3-1

3.1 About Aggregate Management with SMS Interface – Sub-Option 1 ................................................. 3-2

3.1.1 Aggregate Management w/SMS Interface Panel ..................................................................... 3-3

3.1.2 Line Command A – Add an Aggregate to ABARS Manager .................................................... 3-6

3.1.3 Line Command B – Submit an ABACKUP ............................................................................. 3-12

3.1.4 Concurrent Copy Options ....................................................................................................... 3-18

3.1.5 Check for Results of ABACKUPs or ARECOVERs................................................................ 3-18

3.1.6 Line Command C – Change an Aggregate in ABARS Manager ............................................ 3-19

3.1.7 Line Command D – Delete an Aggregate from ABARS Manager.......................................... 3-20

3.1.8 Line Command I – View Aggregate Information..................................................................... 3-21

3.1.9 Line Command BI – Browse an Aggregate's Instruction Data Set......................................... 3-24

3.1.10 Line Command EI – Edit an Aggregate's Instruction Data Set............................................... 3-25

3.1.11 Line Command BL – Browse an Aggregate's SDSL Parameters .......................................... 3-26

3.1.12 Line Command CL – Convert an Aggregate's SDS(s) to SDSL Parameters ......................... 3-27

3.1.13 Line Command EL – Edit an Aggregate's SDSL Parameters ................................................ 3-29

3.1.14 Line Command BS – Browse an Aggregate's Selection Data Set(s) ..................................... 3-30

3.1.15 Line Command ES – Edit an Aggregate's Selection Data Set(s)........................................... 3-32

3.1.16 Line Command BRM – Shortcut to Main Menu Option 2 ....................................................... 3-34

3.2 Group Filter Management – Sub-Option 2....................................................................................... 3-35

3.2.1 Group Filter Management Panel ............................................................................................ 3-36

3.2.2 Add a Group Filter .................................................................................................................. 3-37

3.2.3 Line Command D – Delete a Group Filter .............................................................................. 3-38

3.2.4 Line Command E – Edit a Group Filter................................................................................... 3-39

4 ABARS Manager: Backup and Recovery Management – Option 2............................................... 4-1

4.1 ABARS Events – Sub-Option 1.......................................................................................................... 4-2

4.1.1 ABARS Events Search Setup Panel – Initial Selection ............................................................ 4-2

4.1.2 About the ABARS Events Panel............................................................................................... 4-5

4.1.3 Line Command N – View ABACKUP/ARECOVER Data Set Name List................................ 4-10

4.1.4 Line Command S – View ABACKUP/ARECOVER Event Detail ............................................ 4-15

4.1.5 Line Command SP – Display Space Used/Allocated for Selected Aggregate ....................... 4-18

4.1.6 Line Command SM – View ABACKUP/ARECOVER Event Summary................................... 4-19

4.1.7 Line Command VA – View ABACKUP/ARECOVER Event Activity Log ................................ 4-24

4.1.8 Line Command VC – View ARECOVER Conflict Data Sets .................................................. 4-26

4.1.9 Line Command VE – View ABACKUP/ARECOVER Event Errors ......................................... 4-30

4.1.10 Line Command VI – View ABACKUP Instruction Data Set .................................................... 4-31

4.1.11 Line Command VR – View ARECOVER Restart Data Sets................................................... 4-33

4.1.12 Line Command VS – View ABACKUP Selection Data Set(s) ................................................ 4-37

4.1.13 Line Command DE – Delete an ABARS Event Record.......................................................... 4-38

4.1.14 Line Command B – Submit an ABACKUP ............................................................................. 4-39

4.1.15 Concurrent Copy Options ....................................................................................................... 4-45


4.1.17 Line Command C – Change Aggregate Information in ABARS Manager.............................. 4-47

4.1.18 Line Command M – Monitor ................................................................................................... 4-51

4.1.19 Line Command O – Search for ABACKUP Data Set Overlaps .............................................. 4-53

4.1.20 Line Command R – Submit ARECOVER (Non-Incremental) ................................................. 4-55

4.1.21 Line Command R – Submit ARECOVER (Incremental)......................................................... 4-69

4.1.22 Line Command R – Submit ARECOVER Using FullRename ................................................ 4-73

4.1.23 Filter Rules.............................................................................................................................. 4-89

Contents x Mainstar Software Corporation ©2006 SC23-6060-00




4.1.25 Line Command RD – Submit RECOVER of ABARS 'D' file data using DFSMSdss .............. 4-90

4.1.26 Line Command BI – Browse an Aggregate's Instruction File ................................................. 4-95

4.1.27 Line Command EI – Edit an Aggregate's Instruction File ....................................................... 4-96

4.1.28 Line Command BL – Browse an Aggregate's SDSL Parameters .......................................... 4-97

4.1.29 Line Command EL – Edit an Aggregate's SDSL Parameters ................................................ 4-98

4.1.30 Line Command BS – Browse an Aggregate's Selection Data Set(s) ..................................... 4-99

4.1.31 Line Command ES – Edit an Aggregate's Selection Data Set(s)......................................... 4-101

4.1.32 Line Command BR – Browse Cataloged ARECOVER Restart Data Set............................. 4-103

4.1.33 Line Command ER – Edit Cataloged ARECOVER Restart Data Set .................................. 4-104

4.1.34 Line Command BC – Browse Cataloged ARECOVER Conflict Data Set ............................ 4-105

4.1.35 Line Command EC – Edit Cataloged ARECOVER Conflict Data Set .................................. 4-106

4.2 Logical Aggregates – Sub-Option 2 ............................................................................................... 4-107

4.2.1 Logical Aggregate Management – Initial Selection .............................................................. 4-108

4.2.2 Check for Results of ABACKUPs or ARECOVERs.............................................................. 4-111

4.2.3 Two Ways to Create a New Logical Aggregate.................................................................... 4-112

4.2.4 Line Command A – Add an Aggregate to a Logical Aggregate ........................................... 4-114

4.2.5 Line Command DL – Delete a Logical Aggregate ................................................................ 4-116

4.2.6 Line Command DA – Delete an Aggregate from a Logical Aggregate................................. 4-117

5 BRM Suite: Features – Option 4 ....................................................................................................... 5-1

5.1 CATSCRUB – Sub-Option 1 .............................................................................................................. 5-2

6 BRM Suite: Search for Data Set – Option 5 ..................................................................................... 6-1

6.1 Search for a Specific Data Set Name or Mask .................................................................................. 6-1

6.1.1 Search Selection Menu............................................................................................................. 6-2

6.1.2 Search for Data Set Setup Panel – Option 1............................................................................ 6-2

6.1.3 Search for Data Set Panel ........................................................................................................ 6-4

6.1.4 Quick Search for Data Set Setup Panel – Option 2 ................................................................. 6-6

6.1.5 Quick Search for Data Set Panel.............................................................................................. 6-8

6.2 Identifying Data Set Overlaps .......................................................................................................... 6-10

6.3 Line Command O – Search for Data Set Overlaps.......................................................................... 6-12

6.4 Line Command R – Select Data Set for Recovery .......................................................................... 6-13

6.5 Restoring Data Without Knowledge of Which Utility Backed Up the Data Set ................................ 6-15

7 ABARS Manager: Reports – Online Using Option 6....................................................................... 7-1

7.1 ABARS Backup Reports – Sub-Option 1 ........................................................................................... 7-2

7.1.1 ABARS Manager Backup Report 1 – Overlap by Data Set Report .......................................... 7-3

7.1.2 ABARS Manager Backup Report 2 – Overlap by Backup Event Report.................................. 7-5

7.1.3 ABARS Manager Backup Report 3 – Data Set List Report...................................................... 7-8

7.1.4 ABARS Manager Backup Report 4 – Event List Report......................................................... 7-11

7.1.5 ABARS Manager Backup Report 5 – Tape Pull List Report................................................... 7-14

7.1.6 ABARS Manager Backup Report 6 – Disaster Recovery Space Summary Report ............... 7-18

7.2 ABARS Manager Recovery Reports – Sub-Option 2 ...................................................................... 7-21

7.2.1 ABARS Manager Recovery Report 1 – Overlap by Data Set Recovery Report .................... 7-23

8 ABARS Manager: Monitor – Option 7............................................................................................... 8-1

8.1 ABARS Monitor Search Setup – Initial Selection............................................................................... 8-2

8.2 About ABARS Monitor Panel ............................................................................................................. 8-3

9 BRM Suite: History – Option 8 .......................................................................................................... 9-1

9.1 History Search Setup – Initial Selection............................................................................................. 9-2

9.2 About the BRM History Panel ............................................................................................................ 9-4

10 ABARS Manager: Batch Processing & Output ............................................................................. 10-1

10.1 ABARS Manager Error and Product Messages............................................................................... 10-2

10.2 The ABACKUP Command ............................................................................................................... 10-3

Mainstar Software Corporation ©2006 xi Contents SC23-6060-00



10.2.1 Submitting the ABACKUP Command..................................................................................... 10-3

10.2.2 ABACKUP Command Syntax ................................................................................................. 10-4

10.2.3 ABACKUP Command Parameter Definitions ......................................................................... 10-5

10.2.4 About Concurrent Copy .......................................................................................................... 10-9

10.2.5 ABACKUP Command – Examples ....................................................................................... 10-10

10.2.6 Overriding SYSOUT to a Data Set ....................................................................................... 10-11

10.3 The ARECOVER Command .......................................................................................................... 10-12

10.3.1 Submitting the ARECOVER Command................................................................................ 10-12

10.3.2 ARECOVER Command Syntax ............................................................................................ 10-13

10.3.3 ARECOVER Command Parameter Definitions .................................................................... 10-15

10.3.4 About FullRename ................................................................................................................ 10-22

10.3.5 About Prevent BackLevel ..................................................................................................... 10-33

10.3.6 ARECOVER Command – Examples .................................................................................... 10-35

10.4 Native ABARS ARECOVER .......................................................................................................... 10-36

10.4.1 To Use Native ABARS Processing....................................................................................... 10-36

10.5 The AGGMGMT Command ........................................................................................................... 10-37

10.5.1 Submitting the AGGMGMT Command ................................................................................. 10-37

10.5.2 AGGMGMT Command Syntax ............................................................................................. 10-38

10.5.3 AGGMGMT Command Parameter Definitions ..................................................................... 10-39

10.5.4 AGGMGMT Command – Rules for Batch Processing ......................................................... 10-45

10.5.5 AGGMGMT Command – Example ....................................................................................... 10-46

10.6 The CONVSDSL Command .......................................................................................................... 10-47

10.6.1 Submitting the CONVSDSL Command ................................................................................ 10-47

10.6.2 CONVSDSL Command Syntax ............................................................................................ 10-47

10.6.3 CONVSDSL Command Parameter Definitions .................................................................... 10-47

10.6.4 CONVSDSL Command – Example ...................................................................................... 10-48

10.7 The LOADACT Command ............................................................................................................. 10-48

10.7.1 Submitting the LOADACT Command ................................................................................... 10-48

10.7.2 LOADACT Command Syntax ............................................................................................... 10-48

10.7.3 LOADACT Command Parameter Definitions ....................................................................... 10-49

10.7.4 LOADACT Command – Example ......................................................................................... 10-50

10.8 The LOADIDS Command............................................................................................................... 10-51

10.8.1 Submitting the LOADIDS Command .................................................................................... 10-51

10.8.2 LOADIDS Command Syntax ................................................................................................ 10-51

10.8.3 LOADIDS Command Parameter Definitions......................................................................... 10-52

10.8.4 LOADIDS Command – Examples ........................................................................................ 10-55

10.9 The UNLOADIDS Command ......................................................................................................... 10-56

10.9.1 Using UNLOADIDS to Remove All/Star Entries Incurred During a Trial .............................. 10-56

10.9.2 Submitting the UNLOADIDS Command ............................................................................... 10-56

10.9.3 UNLOADIDS Command Syntax ........................................................................................... 10-56

10.9.4 UNLOADIDS Command Parameter Definitions ................................................................... 10-57

10.9.5 UNLOADIDS Command – Examples ................................................................................... 10-61

10.9.6 UNLOADIDS Record Counts................................................................................................ 10-61

10.10The REPORT Command ............................................................................................................... 10-62

10.10.1 Submitting the REPORT Command ..................................................................................... 10-62

10.11OVERLAPD Report Type – Overlap by Data Set .......................................................................... 10-62

10.11.1 REPORT OVERLAPD Command Syntax ............................................................................ 10-62

10.11.2 REPORT OVERLAPD Command Parameter Definitions..................................................... 10-63

10.12OVERLAPD-RCV Report Type – Overlap by Data Set Recovery................................................. 10-65

10.12.1 REPORT OVERLAPD-RCV Command Syntax ................................................................... 10-65

10.12.2 REPORT OVERLAPD-RCV Command Parameter Definitions............................................ 10-66

10.13OVERLAPE Report Type – Overlap by Backup Event .................................................................. 10-68

10.13.1 REPORT OVERLAPE Command Syntax............................................................................. 10-68

Contents xii Mainstar Software Corporation ©2006 SC23-6060-00



10.13.2 REPORT OVERLAPE Command Parameter Definitions..................................................... 10-68

10.14DSNLIST Report Type – Data Set List .......................................................................................... 10-71

10.14.1 REPORT DSNLIST Command Syntax................................................................................. 10-71

10.14.2 REPORT DSNLIST Command Parameter Definitions ......................................................... 10-72

10.15EVTLIST Report Type – Event List................................................................................................ 10-74

10.15.1 REPORT EVTLIST Command Syntax ................................................................................. 10-74

10.15.2 REPORT EVTLIST Command Parameter Definitions.......................................................... 10-74

10.16TAPEPULL Report Type – Tape Pull List ...................................................................................... 10-77

10.16.1 REPORT TAPEPULL Command Syntax.............................................................................. 10-77

10.16.2 REPORT TAPEPULL Command Parameter Definitions...................................................... 10-78

10.17SPACE Report Type – Disaster Recovery Space Summary......................................................... 10-81

10.17.1 REPORT SPACE Command Syntax.................................................................................... 10-81

10.17.2 REPORT SPACE Command Parameter Definitions ............................................................ 10-81

10.18Batch ABARS Output (SYSOUT) Reporting .................................................................................. 10-84

10.19ABARS Manager ABACKUP and ARECOVER Results ................................................................ 10-88

10.19.1 Final RC Value and Error Messages Display ....................................................................... 10-88

10.19.2 Successful ABACKUP Data Set Space Calculations ........................................................... 10-90

10.19.3 ARECOVER Data Set Usage ............................................................................................... 10-90

10.19.4 Selection Data Set Results ................................................................................................... 10-91

11 ABARS Manager: SDSL – Selection Data Set Language ............................................................. 11-1

11.1 What Is SDSL?................................................................................................................................. 11-1

11.2 Overview of SDSL Processing ......................................................................................................... 11-2

11.3 How to Use SDSL ............................................................................................................................ 11-3

11.4 Overview of the SDSL Keywords..................................................................................................... 11-4

11.5 Constructing SDSL Instructions ....................................................................................................... 11-4

11.5.1 Rules for Coding SDSL CANDIDATES and FILTERS Instructions........................................ 11-5

11.5.2 SDSL Instructions Example .................................................................................................... 11-5

11.6 SDSL Instructions Processing Logic................................................................................................ 11-5

11.6.1 Filtering Logic – 'first match you're out'................................................................................... 11-5

11.6.2 Data Set Attributes Tested in Filters....................................................................................... 11-6

11.6.3 Boolean Operators Used in Filters ......................................................................................... 11-7

11.7 The SDSL CANDIDATES Instruction............................................................................................... 11-8

11.7.1 CANDIDATES Instruction Syntax........................................................................................... 11-8

11.7.2 CANDIDATES Instruction – Keyword Descriptions ................................................................ 11-8

11.7.3 CANDIDATES Processing Notes ......................................................................................... 11-10

11.8 The SDSL FILTERS Instruction ..................................................................................................... 11-11

11.8.1 FILTERS Instruction Syntax ................................................................................................. 11-11

11.8.2 FILTERS Instruction Keyword Descriptions ......................................................................... 11-12

11.8.3 FILTERS Criteria Descriptions ............................................................................................. 11-13

11.9 Examples of Using CANDIDATES and FILTERS .......................................................................... 11-20

12 ABARS Manager: ABARS Aggregate LoadBalancer.................................................................... 12-1

12.1 About ABARS Aggregate LoadBalancer.......................................................................................... 12-1

12.2 Using the ABARS Aggregate LoadBalancer Procedure .................................................................. 12-2

12.2.1 ALB00001 Job Stream Description ........................................................................................ 12-2

12.2.2 Modify ABARS Aggregate LoadBalancer JCL ....................................................................... 12-4

12.3 The DISTRIBUTE Control Statements............................................................................................. 12-6

12.3.1 DISTRIBUTE Control Statement Syntax ................................................................................ 12-6

12.3.2 DISTRIBUTE Control Statement Keyword Descriptions ........................................................ 12-6

12.3.3 Usage Notes for INPUT and OUTPUT Aggregate Names..................................................... 12-9

12.4 Using the Sample Aggregate LoadBalancer REXX EXEC .............................................................. 12-9

12.5 Space Calculations .......................................................................................................................... 12-9

13 BRM Suite: Dynamic Data Set Backup/Reorganization ............................................................... 13-1

Mainstar Software Corporation ©2006 xiii Contents SC23-6060-00



13.1 About Dynamic Backup/Reorganization .......................................................................................... 13-1

13.1.1 Usage Considerations ............................................................................................................ 13-1

13.1.2 Product Data Set Applicability ................................................................................................ 13-1

13.1.3 Lock Data Set ......................................................................................................................... 13-2

13.2 Using the Dynamic Backup/Reorganization Utility........................................................................... 13-3

13.2.1 Step 1: Modify SI040 tokens in the Backup & Recovery Manager Suite PARMLIB ............. 13-3

13.2.2 Step 2: Use REUSE to reallocate the BRM Inventory Data Set............................................ 13-3

13.2.3 Step 3: Tailor and execute the backup, reorganization, or reload utility JCL ........................ 13-3

13.3 Execution JCL .................................................................................................................................. 13-4

13.3.1 BACKUP ................................................................................................................................. 13-4

13.3.2 REORG................................................................................................................................... 13-6

13.3.3 RELOAD ................................................................................................................................. 13-8

13.4 BRM01BRR Parm Values ................................................................................................................ 13-9

13.4.1 BACKUP ................................................................................................................................. 13-9

13.4.2 REORG................................................................................................................................... 13-9

13.4.3 RELOAD ................................................................................................................................. 13-9

14 BRM Suite: DADSMFTK (DAD) Started Task ................................................................................. 14-1

14.1 DADSMFTK Operator Commands................................................................................................... 14-1

14.1.1 Start the Started Task (DAD) and Individual Subtasks .......................................................... 14-2

14.1.2 Start the DAD Started Task by Jobname (DAD) and Individual Subtasks ............................. 14-2

14.1.3 Start the DAD Started Task without the Individual Subtasks ................................................. 14-3

14.1.4 Stop the Structure/Terminate DADSMFTK............................................................................. 14-3

14.1.5 Manipulate the IEFU83 Exit .................................................................................................... 14-4

14.1.6 Manipulate the Dataspace ...................................................................................................... 14-5

14.2 Removing Obsolete Entries from the DAD Database...................................................................... 14-6

15 ABARS Manager: Incremental ABARS .......................................................................................... 15-1

15.1 About Incremental Backup and Recovery........................................................................................ 15-1

15.1.1 What Are Incremental Backups? ............................................................................................ 15-1

15.1.2 Pros and Cons of Incremental Backup ................................................................................... 15-1

15.1.3 How Incremental ABARS Works ............................................................................................ 15-2

15.2 Using ABARS Manager with Incremental ABARS ........................................................................... 15-4

15.2.1 What to Do Before You Can Use Incremental ABARS .......................................................... 15-4

15.2.2 How to Use Incremental ABARS ............................................................................................ 15-4

15.2.3 Backing Up the BRM Inventory Data Set ............................................................................... 15-9

16 BRM Suite: CATSCRUB – Synchronize Catalogs/Volumes for DR ............................................. 16-1

16.1 The CATSCRUB Command ............................................................................................................ 16-1

16.2 Using the CATSCRUB Command ................................................................................................... 16-3

16.2.1 What to Do Before You Can Use CATSCRUB....................................................................... 16-3

16.3 Submitting the CATSCRUB Command............................................................................................ 16-3

16.4 CATSCRUB Command Syntax........................................................................................................ 16-4

16.5 CATSCRUB Command Keyword Definitions................................................................................... 16-6

16.6 CATSCRUB Processing Notes ...................................................................................................... 16-17

16.6.1 When Would CATSCRUB Be Run? ..................................................................................... 16-17

16.6.2 CATSCRUB Simulation Processing ..................................................................................... 16-17

16.6.3 Why Delete Catalog Entries With No Matching Physical Data Set? .................................... 16-17

16.6.4 How Does CATSCRUB Processing Work? .......................................................................... 16-18

16.6.5 Examples .............................................................................................................................. 16-21

16.7 CATSCRUB Benchmark Run Timings........................................................................................... 16-22

16.7.1 Comparative Timings – CATSCRUB vs. IDCAMS ............................................................... 16-22

16.8 Sample CATSCRUB Commands and Output Examples............................................................... 16-23

16.8.1 CATSCRUB – EXECUTE Mode to Clean Up One BCS and Two Volsers .......................... 16-23

16.8.2 CATSCRUB – SIMULATE and Premature Termination by END Specification.................... 16-26

Contents xiv Mainstar Software Corporation ©2006 SC23-6060-00



Figures Figure 2-1: Types of fields that may be used on a Selection type of panel .................................................... 2-2

Figure 2-2: Format of Table/List type of panel ................................................................................................ 2-3

Figure 2-3: Backup & Recovery Manager Suite Main Menu........................................................................... 2-4

Figure 10-1: ABARS Manager ABACKUP in Batch Mode............................................................................ 10-3

Figure 10-2: ABARS Manager ARECOVER in Batch Mode....................................................................... 10-12

Figure 12-1: Sample ABARS Aggregate LoadBalancer JCL........................................................................ 12-5

Figure 16-1: CATSCRUB – Single BCS synchronized with two volumes .................................................. 16-24

Figure 16-2: CATSCRUB – Simulate BCS with END termination .............................................................. 16-26

Tables Table 1-1: Filtering Pattern Masks ................................................................................................................. 1-6

Table 4-1: Steps for Performing FullRename Processing Using Online Panels.......................................... 4-84

Table 10-1: Steps to Set Up Prevent BackLevel Processing..................................................................... 10-34

Table 10-2: AGGMGMT Command Parameter Definitions ....................................................................... 10-39

Table 10-3: CONVSDSL Command Parameter Definitions....................................................................... 10-47

Table 10-4: LOADACT Command Parameter Definitions ......................................................................... 10-49

Table 10-5: LOADIDS Command Parameter Definitions........................................................................... 10-52

Table 10-6: UNLOADIDS Command Parameter Definitions ..................................................................... 10-57

Table 10-7: REPORT OVERLAPD Command Parameter Definitions....................................................... 10-63

Table 10-8: REPORT OVERLAPD-RCV Command Parameter Definitions.............................................. 10-66

Table 10-9: REPORT OVERLAPE Command Parameter Definitions ....................................................... 10-68

Table 10-10: REPORT DSNLIST Command Parameter Definitions ......................................................... 10-72

Table 10-11: REPORT EVTLIST Command Parameter Definitions.......................................................... 10-74

Table 10-12: REPORT TAPEPULL Command Parameter Definitions ...................................................... 10-78

Table 10-13: REPORT SPACE Command Parameter Definitions ............................................................ 10-81

Table 11-1: SDSL Processing...................................................................................................................... 11-2

Table 11-2: Using SDSL .............................................................................................................................. 11-3

Table 13-1: Steps to Use the Dynamic Backup/Reorganization Utility ........................................................ 13-3

Table 15-1: Steps to Use Incremental ABARS ............................................................................................ 15-4

Mainstar Software Corporation ©2006 xv Contents SC23-6060-00



Preface Preface.1 About This Book

Who Should Use This Book

This User Guide is provided for Storage Administrators, the users who are responsible for using Backup & Recovery Manager Suite Dialog facilities to manage aggregates and anyone who needs an understanding of the capabilities of the Backup & Recovery Manager Suite product.

Organization of This Book

Chapter 1 – About Backup & Recovery Manager Suite provides an overview of Backup & Recovery Manager Suite, and includes information about masking characters and reading syntax.

Chapter 2 – BRM Suite: Online Dialog discusses the structure and features of the online dialog panels, including the Menu, Preferences, Utilities, and Diagnostics sub-menus, and how to use them.

Chapters 3–9 discuss each of the Options that can be selected from the Backup & Recovery Manager Main Menu.

Chapter 10 – ABARS Manager: Batch Processing & Output describes how to submit aggregate backups and recoveries, loads of activity logs to the BRM Inventory Data Set, loads/unloads of the Inventory Data Set in batch mode using BRMBPROC, and reports in batch mode.

Chapter 11 – ABARS Manager: SDSL – Selection Data Set Language discusses what SDSL does, the processing logic used by SDSL, and how to create the SDSL CANDIDATE and FILTERS instructions.

Chapter 12 – ABARS Manager: ABARS Aggregate LoadBalancer describes how to use the LoadBalancer to spread the backup and restore load across multiple aggregates to take advantage of Concurrent Copy and reduce the impact of a backup failure, and also to combine multiple small aggregates into a single aggregate to avoid excessive tape mounts.

Chapter 13 – BRM Suite: Dynamic Data Set Backup/Reorganization describes how to use the Dynamic Backup/Reorganization utility to allow the BRM Inventory Data Set to be backed up or reorganized without stopping the product, or product programs.

Chapter 14 – BRM Suite: DADSMFTK (DAD) Started Task describes the DADSMFTK started task for both Incremental ABARS and All/Star, and associated operator commands.

Chapter 15 – ABARS Manager: Incremental ABARS describes the use of Incremental backups and recoveries and a discussion of the pros and cons in different environments.

Chapter 16 – BRM Suite: CATSCRUB – Synchronize Catalogs/Volumes for DR describes how to use this very high-speed capability to 'condition' user and master catalogs (BCSs) at a DR site. CATSCRUB is useful for DR methodologies where you take 'populated' catalogs to your DR site, and then 'scrub' them of all or specified entries that don't match the actual data sets that have been restored at your DR site.

Reader’s Comments

We want to receive your comments about this manual. Your suggestions about the accuracy, clarity, and format of this document will be appreciated.

Please document your observations and email to [email protected] or provide to Mainstar Technical Support via our website.

Let us know if you would like a reply, and provide your contact information.

Mainstar Software Corporation ©2006 1 Preface SC23-6060-00


mailto:[email protected]:[email protected]:[email protected]://www.mainstar.com/services/support/problem/index.asphttp://www.mainstar.com/services/support/problem/index.asp


Acronyms

ALB Aggregate LoadBalancer

AST All/Star Tracking Started Task

BRM Backup & Recovery Manager Suite

DAD Data Set Activity Database

INC Incremental ABARS

Preface 2 Mainstar Software Corporation ©2006 SC23-6060-00



Preface.2 Where to Find More Information

Publications in the Backup & Recovery Manager Suite Document Set

• Backup & Recovery Manager Suite Installation & Maintenance Guide (document GC23-6062)

• Backup & Recovery Manager Suite User Guide for ABARS Manager (document SC23-6060) • Backup & Recovery Manager Suite User Guide for All/Star (document SC23-6061) • Backup & Recovery Manager Suite User Guide for ASAP (document SC23-6059)

How to Contact Us for Technical Support

• Mainstar Technical Support • Phone: 425-455-3589 • Fax: 425-455-1992

How to Contact Us for Product Information

• Send an email to:

[email protected]

• In North and South America

Mainstar Software Corporation

Worldwide Headquarters

P.O. Box 4132 Bellevue, WA 98009

U.S.A.

Tel: 1-425-455-3589

or

1-800-233-6838

Fax: 1-425-455-1992

• In Europe

Mainstar Software Corporation Ltd.

Sanderum House

Oakley Road

Chinnor

Oxon OX39 4TW

England

Tel: +44-(0)1844-347173

Fax: +44-(0)1844-346627

• In Asia Pacific

Mainstar International Ltd. P.O. Box 1624 Macquarie Centre

North Ryde, NSW 2113

Australia

Tel: +61-(0)2-9888-1777

Fax: +61-(0)2-9888-1588

Mainstar Software Corporation ©2006 3 Preface SC23-6060-00


http://www.mainstar.com/services/support/techsupport/index.aspmailto:[email protected]


Visit Our Web Site – www.mainstar.com

• Current release information • Product information • Interesting and informative White Papers and articles • Online presentations • Sign up for an online seminar

Preface 4 Mainstar Software Corporation ©2006 SC23-6060-00


http://www.mainstar.com/


Chapter 1 1 About Backup & Recovery Manager Suite

Backup and Recovery Manager Suite consists of one common install, a common inventory data set between ABARS Manager and All/Star, a separate database for ASAP, common panels, and three selectable products. Backup & Recovery Manager Suite is designed to meet your company's business resiliency needs either locally, or in the event of a disaster, from the minor to the catastrophic. Backup and Recovery Manager Suite offers the following products and features:

• ABARS Manager: – enhances and extends ABARS functionality – centralizes management of ABARS to make ABARS easy to use – consolidates and manages essential tracking, status, and resource information – adds functionality not included in native ABARS – provides selectable feature Incremental ABARS for true ABARS incremental support

Selectable features for ABARS Manager:

– CATSCRUB, designed for full volume restore, enables you to quickly synchronize one or more BCS catalogs with associated DASD volumes at your disaster recovery site.

– Incremental ABARS enables you to perform ABARS backups on an incremental basis. • All/Star:

– centralizes and inventories z/OS backups so you can recover anywhere, anytime – identifies what isn’t backed up at your site

Selectable features for All/Star:

– CATSCRUB, designed for full volume restore, enables you to quickly synchronize one or more BCS catalogs with associated DASD volumes at your disaster recovery site.

• ASAP: – identifies critical business data as the application executes – identifies the data that needs to be backed up for business resiliency, either onsite,

offsite, or both, and builds the list as input to a backup utility • ASAP and All/Star, when used together:

– use the list created by ASAP to compare to what was actually backed up – provide documented evidence that critical assets have a backup – provide proof that critical business data is offsite if required – alert on critical assets that don’t have a backup

Backup & Recovery Manager Suite panels provide access to functionality common to all three products, ABARS Manager, All/Star, and ASAP, and are named either Backup & Recovery Manager Suite or BRM. ABARS Manager panels are named either ABARS Manager or ABM, All/Star panels are named either All/Star or AST, and ASAP panels are named either ASAP or ASP.

1.1 About ABARS Manager ABARS Manager provides powerful enhancements and extensions to ABARS processing and availability. ABARS Manager is specifically designed to enhance, simplify, and automate Disaster Recovery and Local processing using ABARS backup and recovery functions. ABARS Manager makes ABARS and DFSMShsm more powerful, flexible, reliable, and easier to use.

Mainstar Software Corporation ©2006 1-1 Chapter 1 SC23-6060-00 About Backup & Recovery Manager Suite



Incremental ABARS, available as a selectable feature, allows you to combine the Disaster Recovery Solutions provided by ABARS, with the benefits of Incremental backup strategy.

Selectable feature CATSCRUB synchronizes catalogs/volumes for Disaster Recovery at blazing speeds. The result is catalogs that correctly reflect the data on physical volumes.

1.1.1 Benefits of Using ABARS Manager • Centralized management and control information in a powerful Inventory Data Set (IDS) with in-

depth tracking features. • Batch operation – for routine operations and planned activities. • Interactive operation – for detailed analysis, error correction, research, process restart, selective

recovery, overlap analysis, and VTOC information. • Tape information is automatically created for recovery execution. • Extensive supplemental information held in the Inventory Data Set, including selection data set

information and activity log details, as well as error status. • Extended ABARS functionality and reliability features:

– Selection Data Set Language (SDSL) is a powerful tool that expands the ABARS language to over 30 different attributes for INCLUDE or EXCLUDE of data sets. Boolean logic makes it easy to define powerful selection rules.

– Selection Data Set preprocessing reduces run-time errors by identifying, and optionally correcting, common ABARS syntax errors.

– Prevent BackLevel ensures that an application is not back-leveled by an older copy of a data set being restored.

– GDG REPLACE / NOREPLACE gives you the control to restore non-GDS using the NOREPLACE parameter for non-GDS files, and REPLACE specifically for GDS files.

– Selective Data Set Restore allows you to restore specific data sets, data sets you identify using masking, or data sets independent of the backup name.

– Extended Rename provides the capability to rename more than the high level qualifier.

1.1.2 ABARS & Other Utilities Tracking and restoring ABARS backups requires Backup & Recovery Manager Suite selectable product ABARS Manager (ABM). Unlike other utilities, ABARS-tracked backups require initiating backups via an ABARS Manager procedure.

If both ABARS Manager and All/Star are utilized, all backed-up data sets (i.e., if backed up either by ABARS or other z/OS backups) are presented in a consolidated view.

Chapter 1 1-2 Mainstar Software Corporation ©2006 About Backup & Recovery Manager Suite SC23-6060-00


http://www.mainstar.com/products/backupandrecovery/index.asp#inc#inc


1.2 Validating Load Module Contents – Run MODLEVEL

Mainstar Technical Support may request that you submit the MODLEVEL JCL to identify the current modification levels of your Mainstar product load modules. If you experience difficulty running the report, or have any questions, contact Mainstar Technical Support at 1-425-455-3589, or [email protected].

MODLEVEL identifies and displays which program PTFs (fixes) and ETRs (enhancements) have been applied to the level of the product you are running. This information is based on information stored internally within load modules. Please note that only the last update (level) will contain the fix and revision number and the change date. All other fixes will have only the ID number.

The following is an example of the MODLEVEL JCL.

//*JOBCARD JOB 'FIX REPORTER',CLASS=?,MSGCLASS=?//*---------------------------------------------------------------*//* JCLFIXES * //* SAMPLE JCL FOR LISTING THE BUILD INFORMATION INCLUDED IN * //* MAINSTAR LOAD MODULES. * //* * //* MODIFY JOBCARD TO MEET LOCAL STANDARDS * //* * //* CHANGE THE &HLQ TO MATCH YOUR MAINSTAR PRODUCT LIBRARIES. * //*---------------------------------------------------------------*//*//FIXRPTR PROC SOUT='SYSOUT-CLASS',

LOAD1='?HLQ..LOAD'//BRM01MOD EXEC PGM=BRM01MOD//STEPLIB DD DISP=SHR,DSN=&LOAD1//SYSUT1 DD DISP=SHR,DSN=&LOAD1//SYSPRINT DD HOLD=YES,SYSOUT=&SOUT// PEND //*//RUN EXEC FIXRPTR

DD statements for the MODLEVEL JCL are described in the following table.

DD STATEMENT DESCRIPTION STEPLIB Required. Specify the Mainstar product LOAD library.

SYSPRINT Required. Output DD statement.

SYSUT1 Required. Specify the primary LOAD library to be processed.



http://www.mainstar.com/services/support/problem/index.asp


Execution of the MODLEVEL JCL creates a report containing the last fix and a list of fixes for all of the modules in the SYSUT1 library. The following is an example of the BRM MODLEVEL report.

Highest ETR is ETR21657

Member DD Last fix Vers Rev Build Date/Time Macro

ALB00001 SYSUT1 LAST SYSUT1 LIST 19673

1.3.05 15 2005/06/09 09:06 EHDR

ALB00002 SYSUT1 LAST SYSUT1 LIST 20289

1.2.01 5 2005/06/08 16:17 EHDR

ASP90100 SYSUT1 LAST ETR21482 1.0 2 SYSUT1 LIST 19163,17950,21482

2005/06/08 16:17 MSCHDR

ASTBKEND SYSUT1 LAST ETR21482 1.0 2 SYSUT1 LIST 17950,21180,21482

2005/06/08 16:18 MSCHDR

ASTBLDFF SYSUT1 LAST ETR21482 1.0 4 2005/06/08 16:18 MSCHDRSYSUT1 LIST 20228,20198,20295,21179,21482

ASTBLDRJ SYSUT1 LAST ETR21482 4.3 5 2005/06/09 10:35 MSCHDRSYSUT1 LIST 16639,20687,18862,21179,21308,21482

ASTDADFL SYSUT1 LAST ETR21482 4.3 1 SYSUT1 LIST 20228,21482

ASTDADUP SYSUT1 LAST ETR21482 1.0 1 SYSUT1 LIST 19455,21482

ASTDATRT SYSUT1 LAST ETR21482 6.1 2 SYSUT1 LIST 20198,21482

ASTEMSGX SYSUT1 LAST ETR21482 1.0 2 SYSUT1 LIST 09942,21482

ASTGETJB SYSUT1 LAST ETR21482 1.0 2 SYSUT1 LIST 09942,20013,21482

2005/06/08 16:19 MSCHDR

2005/06/08 16:19 MSCHDR

2005/06/08 16:19 MSCHDR

2005/06/08 16:19 MSCHDR

2005/06/08 16:19 MSCHDR




1.3 How to Read Command Syntax These are the definitions for the various symbols used in the command syntax. These symbols are not to be coded; rather, their function is to denote usage.

{ } braces mean you are required to choose one, and only one, of the items (or a group or items if they are enclosed in brackets) within the braces.

[ ] brackets mean optional parameter(s) or keyword(s). … An ellipsis means you may include multiple values of the type specified prior to the

ellipsis. | A vertical bar (may also be called a 'pipe') means a delimiter between optional

items, from which you may choose only one. Underline An underline denotes the default.

Example of command syntax:

The symbols used in the sample syntax below say the same thing as the sample text from the Keyword Description table:

{ [ ALL-RELATED ] | [ TO-STORAGEGROUP( stgrp1 | stgrpmask1

…stgrpn | stgrpmaskn ) TO-VVDS( volser1 | volsermask1 …volsern | volsermaskn ) ] }

Default: ALL-RELATED Required: Yes Restrictions: • TO-STORAGEGROUP and TO-VVDS can both be specified in one command. • If ALL-RELATED is specified, neither of the TO… keywords can be specified with it.

Default – ALLRELATED is underlined because it is the default.

Required – The braces that enclose this entire example mean that it is required that you choose from among the options within the braces.

Restrictions – There are brackets around the ALL-RELATED keyword, meaning it is one of your options. There are also brackets around the TO-STORAGEGROUP and TO-VVDS keywords, meaning these are your other options. Note that there is no pipe between the TO… keywords, meaning you may choose both. So there are two 'optional groups' within the braces, and it is required that you choose one or the other, and it is OK that you choose both TO-STORAGEGROUP and TO-VVDS if you want.




1.4 Mainstar Extended ACS Filtering Pattern Masks Many commands allow specification of powerful filtering masks. These filtering pattern masks can be specified with Mainstar extended ACS masking characters, as shown in the following table.

Table 1-1: Filtering Pattern Masks

Mask Hex

* (Single)

5C n

a wild-card *Use the %

In the example:

PROD* (i.e. *ZREM*

% 6C l % In the example:

are ER6.

< 4C Similar to the % value, the <

. In the example:

CR, the 3rd and 4th th and 6th ER

l

> 6E only

. In the example:

CR, the 3rd and 4th th and 6th ER

l

** ACS and Only used

for The * or **wild-card

In the example:

st qualifiernd

qualifiers.

Description

Represents 0– characters. Can be used before and/or after an item to designate character position. You cannot use an in the middle portion of a

single item (except for data set names). character (see below) for that purpose.

*PROD an item is selected if the last four characters are regardless of the starting characters. Using the character before and after an item ) means that item is to be selected if any character string matches ZREM in its name.

Denotes a single character place-holder value, which can be alpha-numeric or any specia character. The character can be used in any position order.

CRM%%ER6 an item is to be selected if it is 8-characters in length and the first three characters

CRM and the last three characters are The two middle place-holder values can be any characters.

character denotes a place-holder value for only alpha characters The < character can be used in any position order.

CR character can be used in any position order.

CR>>ER* an item is to be selected if the first two characters are characters must be numeric, the 5 characters are , with any remaining characters a lowed.

(Double) 5C5C

Allows compatibility with standard DFSMSdss filtering masks. partially qualified data set names. characters can be used in any

qualifier position to denote a node.

CRFM*.*VER.** a data set entry is to be selected if it has at least two qualifiers and the 1starts with CRFM, the 2 qualifier must end with VER, and any remaining

Note: As with common data set name masking, any combination of *, **, %, < and/or > characters can be used for the item mask value.




Mask Hex Description

Similar to the % value, the ! character denotes a place-holder value for only national characters (based on the U.S.A. EBCDIC code set, see topic ! 5A 'Your EBCDIC Code Tables – Specification and Display of EBCDIC Characters', page 1-7). The ! character can be used in any position order. National characters (based on the U.S.A. EBCDIC code set) are: @ # $

1.5 Your EBCDIC Code Tables – Specification and Display of EBCDIC Characters

Data supplied as input to batch programs or input to ISPF panels:

For Mainstar product code shipped in binary, when specifying input where the product takes special action based on specific characters, the user is responsible for entering the EBCDIC character peculiar to their code tables that results in the binary value for the EBCDIC character shown in this document according to the U.S.A. EBCDIC code set.

For instance, if an exclamation mark ( ! ) is called for, and your code tables do not translate the ! character to a hexadecimal 5A, you must enter the character that will translate to a 5A.

Do not change Mainstar distributed ISPF panels:

Mainstar programs may reference ISPF panel attribute bytes. A panel change involving an attribute byte will not be consistent with the program code.

Product output:

Depictions of product output shown in the product manuals are based on the U.S.A. EBCDIC code set. Actual output may vary if your EBCDIC code tables are different.

1.6 Data Set Naming Conventions A hyphen ( - ) can be used as a character in a data set name; however, when a hyphen is used as the last character in a data set name, it may be mistaken for a continuation symbol and failures may occur. This restriction is also documented in the IBM document DFSMShsm Storage Administration Reference.

1.7 View Backup & Recovery Manager Suite Messages Product messages are distributed with the product in MESSAGES library members. The messages can be viewed directly from the MESSAGES members, or via Chicago-Soft's® Quick-Ref™, if it is installed in your environment.

1.7.1 Message Identifier Naming Convention Product message identifiers are in the form pppmmmnnx

Where: ppp is the 3 alpha character product code –

BRM for code shared by ABARS Manager, All/Star, and ASAP BRM for ABARS Manager and some Incremental ABARS messages ALB for ABARS Manager Aggregate LoadBalancer INC for Incremental ABARS

mmm is the module identifier nn is the message number and x is the message type indicator – E=error, I=information, W=warning.

Example 1: The message identifier BRM02056I would be a message from module BRM020, message number of 56, and is an Information only message.




Example 2: The message identifier BRMVSE11E would be a message from module BRMVSE, message number of 11, and is an Error type message.

1.7.2 Determine Which MESSAGES Member Contains the Message Description Messages are in the MESSAGES library in a member name that matches the first six characters of the message identifier (ID).

Example 1: With the first six characters of message identifier BRM02056I being BRM020, the description would be found in MESSAGES member BRM020.

Example 2: With the first six characters of message identifier BRMVSE11E being BRMVSE, the description would be found in MESSAGES member BRMVSE.

1.7.3 View Messages Using ISPF Interface Product messages can be viewed using the ISPF interface. In the ISPF interface, the Action Bar (at the top of the screen) has an option labeled “Menu”. Choose “Menu” to display a Pull-Down menu; option 1 is messages. Choosing option 1 will start a Browse session of product messages.

1.7.4 View Messages in MESSAGES Library Be sure you always refer to the most current MESSAGES members, as the members may be updated and distributed with a release of the product, cumulative maintenance, and sometimes for PTFs as well.

Use Browse FIND Command to Locate Messages Within a MESSAGES Member:

Within a message member, use the Browse FIND command to locate a specific message identifier (ID) explanation. Message IDs begin in column one. Include the column information in your FIND command to go directly to the main descriptions for the specified message.

F msgid 1

Where: msgid is the specific product message ID.

To Obtain a Hardcopy of Messages in the MESSAGES Members:

Print the MESSAGES members (but remember to print new ones after product releases, cumulative maintenance, or PTFs have been applied).

1.7.5 View Messages Using Quick-Ref You can access messages via Chicago-Soft's Quick-Ref if it is installed in your environment. Request the latest updates from Chicago-Soft if needed.




Chapter 2 2 BRM Suite: Online Dialog

Use the Online Dialog facility of Backup & Recovery Manager Suite products as a powerful tool to:

• Easily access critical ABARS aggregate Event, Data Set, and Volume information from the Backup & Recovery Manager Suite Inventory Data Set (IDS).

• Perform daily storage management activities critical to your backup and recovery environment.

Storage Administrators: Read this chapter to effectively manage and support your ABARS backup activities.

Other users: Read this chapter if you will be directly using Backup & Recovery Manager Suite: ABARS Manager Dialog facilities to manage aggregates.

2.1 About the Backup & Recovery Manager Suite Interactive Dialog Panels This topic provides general information about using the various Online Dialog facility panel features. Backup & Recovery Manager Suite: ABARS Manager interactive dialog panels can be used to:

• Set up ABARS Manager • Inquire on the status of backup and recovery events • Perform backups and recoveries • Determine event history • Detect data set overlaps • Perform data set searches • Submit reports • Perfor

Backup & Recovery Manager Suite User Guide: ABARS Managerpublib.boulder.ibm.com/tividd/td/ITABaRfzOS/GC23-6060-00/... · 2006. 12. 12. · Backup & Recovery Manager Suite: ABARS Manager

Documents