VISION SUITE Enterprise Edition™ OMS/400™—Object …visionsolutions.custhelp.com/ci/fattach/get/53392/1283803785... · † Symantec and NetBackup—Symantec Corporation

VISION SUITE Enterprise EditionOMS/400Object Mirroring System

v8.2 SR-2 Product Manual

November, 2008

OMS/400 Version 8.2 SR-2 Product Manual

Copyright Vision Solutions, Inc. 20032008

All rights reserved.

The information in this document is subject to change without notice and is furnished under a license agreement. This document is proprietary to Vision Solutions, Inc., and may be used only as authorized in our license agreement. No portion of this manual may be copied or otherwise reproduced without the express written consent of Vision Solutions, Inc.

Vision Solutions provides no expressed or implied warranty with this manual.

The following are trademarks or registered trademarks of their respective organizations or companies:

Vision Solutions is a registered trademark and ORION Solutions, Integrator, Director, Data Manager, Vision Suite, ECS/400, OMS/400, ODS/400, SAM/400, Replicate1, EchoCluster, EchoStream, and iTERA HA are trademarks of Vision Solutions, Inc.

DB2, IBM, i5/OS, iSeries, System i, System i5, AIX5L, Informix, System p, System x, and System z, and WebSphereInternational Business Machines Corporation.

Adobe and Acrobat ReaderAdobe Systems, Inc.

Double-Take, GeoCluster, and NSINSI Software, Inc.

HP-UXHewlett-Packard Company.

TeradataTeradata Corporation.

IntelIntel Corporation.

Java, all Java-based trademarks, and SolarisSun Microsystems, Inc.

LinuxLinus Torvalds.

Microsoft and WindowsMicrosoft Corporation.

Mozilla and FirefoxMozilla Foundation.

NetscapeNetscape Communications Corporation.

OracleOracle Corporation.

Red HatRed Hat, Inc.

SybaseSybase, Inc.

Symantec and NetBackupSymantec Corporation.

UNIX and UNIXWarethe Open Group.

All other brands and product names are trademarks or registered trademarks of their respective owners.

If you need assistance, please contact Vision Solutions SCP Certified CustomerCare team at:

CustomerCare Vision Solutions, Inc. Telephone: 1.800.337.8214 or 1.949.724.5465 Email: [email protected] Web Site: www.visionsolutions.com/Support/Contact-CustomerCare.aspx

mailto:[email protected]://www.visionsolutions.com/Support/Contact-CustomerCare.aspx

Contents

Whats New or Changed in this Release

OMS/400 v8.2 SR-2, with ASP13 Enhancements. . . . . . . . . . . . . . . . . . . . . . xxvV6R1 Compatiblity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv

OMS/400 v8.2 SR-2 Base Release Changes and Enhancements . . . . . . . . . . . xxv

Support for V5R4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxviData Area and Data Queue Authority Journal Entries . . . . . . . . . . . . . . xxviJournal Minimized Data Value *FLDBDY . . . . . . . . . . . . . . . . . . . . . . xxviiiJournal Object Limit Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxviii

Enhancements to OMS/400 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxviiiLogical File Mirroring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxviiiMinimized Journal Entries with CRC Syncheck Support . . . . . . . . . . . . xxixEnhanced Group Mode Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxixPLM and Object Status Enhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . xxx

Additional Information or Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiiNew Control Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiiChanges to OMS/400 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiiSupport Changes for Journal Entry Type . . . . . . . . . . . . . . . . . . . . . . . xxxiiiChanging the Number of Apply Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . xxxivMirroring to Secondary iASPs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxivMirroring Special Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiv

Introduction

How OMS/400 Works

What is OMS/400? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

OMS/400 v8.2 SR-2 Product Manual iii

Contents

Mirroring process diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3OMS/400 one-to-one mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3OMS/400 with remote journaling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Single system mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

Getting StartedConfiguration Topics

Configuring Links

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Links per system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Link Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Chapter topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Related topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Link organization and planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5Group any of the following related physical files into the same link. . . . . 2-6Remote journals required for certain mirroring scenarios. . . . . . . . . . . . . 2-7ASP group considerations and data area . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

Link configuration process flow diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

Creating the source side of a link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10Creating the source link. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12Defining the system role and message queues . . . . . . . . . . . . . . . . . . . . 2-17Specifying a journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19Defining the link to the journal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21Configuring Miscellaneous Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 2-24Additional configuration step for local linksingle system mirroring . . 2-27

Creating the target side of the link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30Target link values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30Journaling options on a target system . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30

Defining a remote journal to a link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32Defining a remote journal to Journal Manager on the remote system . . 2-40Configuring the target side of the remote journal link . . . . . . . . . . . . . . 2-42

Creating a single system mirroring link . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-46Creating the link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-46Specifying a journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-48Defining the link to the journal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-49

iv OMS/400 v8.2 SR-2 Product Manual

Contents

Configuring Miscellaneous Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . 2-50Configuring the source and target libraries for single system mirroring . . 2-50Configuring the destination side of a local link to a journal . . . . . . . . . . 2-51Local link configuration notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53Object selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53Sync point in a single system link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-54

Changing link values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-54Renaming a link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-55

Deleting a link. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56Conditions required for link deletion . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56

Defining the Objects to be Mirrored

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Object selection and related topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Journaling function extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Stream File Journaling and Mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3Object Status Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

Object Selection Process Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Methods for Defining Objects to OMS/400 . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5Adding files in join logical relationships or with referential constraints . . . 3-6Mirroring Files with LOB Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7Data area and data queue journalingsome limitations . . . . . . . . . . . . . . 3-7

Do Not Mirror Vision Suite Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8

Using the OMS/400 Maintenance Menu to Select Objects . . . . . . . . . . . . . . . 3-9

Selecting objects with the Production Library Monitor . . . . . . . . . . . . . . . . . 3-14

Object configuration using the CFGFRMJRN command . . . . . . . . . . . . . . . 3-16

Configuring individual objects from the Object Status screen . . . . . . . . . . . . 3-17

Verifying the status of selected objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19

Object status of configured objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21Starting journaling on objects with *NOTJRN status . . . . . . . . . . . . . . . 3-22

Removing an object definition from OMS/400. . . . . . . . . . . . . . . . . . . . . . . 3-25

Additional Configuration Tasks

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Additional configuration diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

What is the Production Library Monitor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3Determine if libraries should be defined to the PLM . . . . . . . . . . . . . . . . 4-3

OMS/400 v8.2 SR-2 Product Manual v

Contents

Libraries with associated logical files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3Configuring the PLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4Excluding objects from the PLM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

Configuring the target object allocation state . . . . . . . . . . . . . . . . . . . . . . . . 4-14Allocation State periodic maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

Configuring a library cross reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20Changing or deleting a cross reference library . . . . . . . . . . . . . . . . . . . . 4-22Defining a journal to the cross-referenced library on the target . . . . . . . 4-22Configuring the target library cross reference. . . . . . . . . . . . . . . . . . . . . 4-23Library cross reference in reverse mode . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

Overriding a target apply queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24When to override the system-assigned queue . . . . . . . . . . . . . . . . . . . . . 4-24

Monitoring OMS/400

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Verifying Mirrored Object Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4Verifying that source and target objects are in-sync . . . . . . . . . . . . . . . . . 5-7

Using the System Activity Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8Being current and being behind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8Accessing the System Activity Display . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10Viewing the System Activity Display . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11The target System Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

Customizing the F23 (WRKACTJOB) command key. . . . . . . . . . . . . . . . . 5-15

Using the Network Activity screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

Using the Network Status screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

Using the Production Library Monitor report . . . . . . . . . . . . . . . . . . . . . . . 5-20Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20Generating the report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20

Generating Journal Receiver Analysis reportMRR280 . . . . . . . . . . . . . . . 5-21

Using the Apply Queue user space monitor . . . . . . . . . . . . . . . . . . . . . . . . . 5-22When additional user spaces are required . . . . . . . . . . . . . . . . . . . . . . . 5-22Starting the monitor job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23Ending the monitor job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24OMSAPYMON messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24Limitations and usage notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25

vi OMS/400 v8.2 SR-2 Product Manual

Contents

Establishing a Sync Point

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Steps involved in establishing a sync point. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2Electronic send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2Sync pointobjects are configured before they are saved . . . . . . . . . . . . . 6-3Locating the starting sequence number for mirroring . . . . . . . . . . . . . . . . 6-3Restoring the saved objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4Sync pointobjects are saved before they are selected . . . . . . . . . . . . . . . 6-5

Monitoring OMS/400

Starting Mirroring

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Starting mirroring process diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Starting OMS/400 mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3Starting mirroring with a remote journal . . . . . . . . . . . . . . . . . . . . . . . . . 7-4Prompting the STROMS command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

Verifying the mirroring process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8Verifying that the mirroring jobs are active . . . . . . . . . . . . . . . . . . . . . . . . 7-8

Ending mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11Ending mirroring for scheduled events . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

Verifying and Restoring Object Synchronization

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

How OMS/400 checks for synchronization. . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2Auto Sync Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2Sample Sync Check Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2CRC Sync Check Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

Why and how objects become unsynchronized . . . . . . . . . . . . . . . . . . . . . . . . 8-5

Setting Up Data Areas For Sync Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7Logging Sample Sync Check Hold Status . . . . . . . . . . . . . . . . . . . . . . . . . 8-7Defining a CRC Resend Threshold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8

About Sync Check and Object Repair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9CRC Sync Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9Object Repair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10Recommendations for configuring CRC Sync Check and Object Repair 8-11Out of Sync Action Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13

OMS/400 v8.2 SR-2 Product Manual vii

Contents

Setting Up SYNCHK and Object Repair Definitions . . . . . . . . . . . . . . . . . 8-14Related topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18

Confirming Object Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-19Configuring the Auto Sync Check Job . . . . . . . . . . . . . . . . . . . . . . . . . 8-20Using Option 8 to Sync Check Individual Objects . . . . . . . . . . . . . . . . 8-20Using the SYNCHK Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-21

Viewing the Results of the Sync Check Test . . . . . . . . . . . . . . . . . . . . . . . . 8-31Sample Sync Check Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-31Analyzing CRC Sync Check Results . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-32Results on System Activity Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-35Object Status screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-35About the *FIX Object Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-36

Troubleshooting CRC Sync Checks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-37

Identifying Objects Not Verified by Sync Check . . . . . . . . . . . . . . . . . . . . . 8-38

Using OMSOBJREP (OMS/400 Object Repair Command) . . . . . . . . . . . . 8-39Control Value OBJREPDLTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-39Object Repair methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-40Submitting the Object Repair command. . . . . . . . . . . . . . . . . . . . . . . . 8-40

Working with related physical files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-42About the OMS/400 build constraint process . . . . . . . . . . . . . . . . . . . . 8-42Verifying all files are defined to the same queue. . . . . . . . . . . . . . . . . . . 8-45Grouping files with constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-45Perform an Electronic Send on Files with RI. . . . . . . . . . . . . . . . . . . . . 8-45

Verifying mirrored objects are in-sync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-47Using the SYNCHKJRN command . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-48

Resynchronizing objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-50Resynchronizing objectsmethods available for various scenarios. . . . . 8-50

Resynchronizing individual objects using electronic send. . . . . . . . . . . . . . . 8-51Manual resetting and sending . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-52Automatic resetting and sending of held objects . . . . . . . . . . . . . . . . . . 8-55

Resynchronizing individual objects using Save/Restore . . . . . . . . . . . . . . . . 8-57Saving the objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-57Restoring the saved objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-60

Resynchronizing an entire library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-62

Resynchronizing complete links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-65Local journal links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-66Remote journal links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-69

Data Area for Electronic Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-74

viii OMS/400 v8.2 SR-2 Product Manual

Contents

Viewing Synch Check Job/Object History . . . . . . . . . . . . . . . . . . . . . . . . . . 8-75Accessing the Synch Check Job History and Object Status . . . . . . . . . . . 8-75Synch Check Job History Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-76Synch Check Job History Screen Function Keys . . . . . . . . . . . . . . . . . . . 8-79Synch Check Job History Screen Options. . . . . . . . . . . . . . . . . . . . . . . . 8-79Object Synch Check Status (WRKSYNOBJ) Screen. . . . . . . . . . . . . . . . 8-85

Managing Journals in OMS/400

About the Journal Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1Journaling and OMS/400 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

Configuring journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4Extended size options (*MAXOPT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4Changing and deleting journal receivers . . . . . . . . . . . . . . . . . . . . . . . . . 9-10Receiver deletion checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12Changing receivers manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13Configuring JRNMSG queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

Remote journaling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14Remote journals and receivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15Remote journal transport methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19Confirmed versus unconfirmed entries . . . . . . . . . . . . . . . . . . . . . . . . . . 9-24What happens if communications fails . . . . . . . . . . . . . . . . . . . . . . . . . . 9-24

Defining a remote journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-27Creating multiple communication paths to the remote system . . . . . . . . 9-27Defining multiple RDB entries to a remote journal . . . . . . . . . . . . . . . . 9-33Defining the remote journal to Journal Manager on the remote system . 9-34

Journaling with local links (single system mirroring) . . . . . . . . . . . . . . . . . . . 9-36

Journaling on the target system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-37

Journaling and role swaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-38Journaling impact on the apply jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-38Role swap journaling confirmation options. . . . . . . . . . . . . . . . . . . . . . . 9-39Journal verification for IFS objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-40

Resetting the journal receiver sequence number. . . . . . . . . . . . . . . . . . . . . . . 9-42When to reset the sequence number . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-42Approaching the maximum value warning . . . . . . . . . . . . . . . . . . . . . . . 9-43Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-43

Identifying journal entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-44Identifying an entry in an attached receiver. . . . . . . . . . . . . . . . . . . . . . . 9-44Identifying entries in older, detached receivers . . . . . . . . . . . . . . . . . . . . 9-45

Reviewing journal history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-46

OMS/400 v8.2 SR-2 Product Manual ix

Contents

OMS/400 journal entry types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-47

i5/OS journal codes and journal entry types. . . . . . . . . . . . . . . . . . . . . . . . . 9-48

OMS/400 Advanced Topics

Using Advanced Database Features

OMS/400 interaction with iSeries DB2 features . . . . . . . . . . . . . . . . . . . . . 10-1

Mirroring commitment control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2Considerations for commitment control mirroring . . . . . . . . . . . . . . . . 10-2Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2Link configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3Fast commitment control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4Commitment control with referential integrity . . . . . . . . . . . . . . . . . . . 10-4Sync checking under commitment control . . . . . . . . . . . . . . . . . . . . . . 10-5Target saves and commitment control . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5

Mirroring referential integrity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6OMS/400 and referential integrity . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6Configuration guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6Configuration procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7

Mirroring triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8Trigger transactions are filtered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8Trigger transactions are not filtered . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10Trigger maintenance file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-11

Large object (LOB) support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14Required Journal configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14

Mirroring apply and remove journal change . . . . . . . . . . . . . . . . . . . . . . . 10-16How OMS/400 mirrors forward and backward recovery . . . . . . . . . . . 10-16APYJRNCHG command (Forward recovery) . . . . . . . . . . . . . . . . . . . 10-17RMVJRNCHG command (Backward recovery) . . . . . . . . . . . . . . . . . 10-19

Journal support for manually ended rollbacks . . . . . . . . . . . . . . . . . . . . . . 10-19

Support for the Change Physical File (CHGPF) command . . . . . . . . . . . . 10-20How OMS/400 works with CHGPF . . . . . . . . . . . . . . . . . . . . . . . . . 10-20Electronic send of the object initiated . . . . . . . . . . . . . . . . . . . . . . . . . 10-20

Reversing System Roles

Role swap overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1Limitations and recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2

Before beginning the role swap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3

x OMS/400 v8.2 SR-2 Product Manual

Contents

How many links will be swapped?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3Are you using remote journaling? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3Journaling on the target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5Test journal verification as follows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6

Executing a planned role swap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8Interactive role swap procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8Executing a controlled role swap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-9Target to become source processing . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-11Source to become a target processing . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12When the role change is complete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12

Role swap errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13If journaling could not be started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13If you have triggers on the database. . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-14

If the role swap was unplanned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-15Remote journal unconfirmed transactions. . . . . . . . . . . . . . . . . . . . . . . 11-15If the last sent journal entry cannot be retrieved . . . . . . . . . . . . . . . . . . 11-16

Role swap journal entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-18

After the role swap is complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-19Examining Report MRR330. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-19Viewing the OMS400 message queue . . . . . . . . . . . . . . . . . . . . . . . . . . 11-20Defining matching configurations on the new source . . . . . . . . . . . . . . 11-20

Object definition in reverse mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-23Cross reference definitions retained. . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-23

Starting mirroring after the role swap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-25Executing the STROMS command . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-25

Resetting the roles to their original status . . . . . . . . . . . . . . . . . . . . . . . . . . 11-27Ending journaling on active files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-28

Do you want the role change to be permanent? . . . . . . . . . . . . . . . . . . . . . . 11-29

Tasks executed during a role swap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-31Initial Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-31Target to Source Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-34Source to Target Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-36Completion Processing (Source and Target) . . . . . . . . . . . . . . . . . . . . . 11-39

Journaled Stream File Mirroring

Whats in this chapter? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

About Journaling IFS Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

OMS/400 v8.2 SR-2 Product Manual xi

Contents

IFS on iSeries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2Supported file systems and object types . . . . . . . . . . . . . . . . . . . . . . . . . 12-2

How IFS mirroring works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3How to set up OMS/400 mirroring of IFS objects . . . . . . . . . . . . . . . . 12-3What Objects can be mirrored? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3How do object changes and new IFS objects get mirrored? . . . . . . . . . . 12-4How do you verify IFS Synchronization . . . . . . . . . . . . . . . . . . . . . . . . 12-4Important configuration considerations. . . . . . . . . . . . . . . . . . . . . . . . . 12-5

Configuring IFS Mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10Selecting IFS objects for mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-10Refining IFS object mirroring definitions . . . . . . . . . . . . . . . . . . . . . . 12-12Establishing a sync point for IFS object mirroring . . . . . . . . . . . . . . . . 12-15Locating the starting sequence number for mirroring . . . . . . . . . . . . . 12-16Starting mirroringinitial startup. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-17

Monitoring/Managing the IFS Mirroring Environment. . . . . . . . . . . . . . . 12-18Performing a Sync check for IFS objects . . . . . . . . . . . . . . . . . . . . . . . 12-18Implementing IFS Authority Repair for *ATTR Synchk Level . . . . . . 12-26Determining IFS Object Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-28Ending journaling for an IFS object . . . . . . . . . . . . . . . . . . . . . . . . . . 12-32Resynchronizing *HLD objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-32Verifying the IFS mirrored environment . . . . . . . . . . . . . . . . . . . . . . . 12-35Adding IFS objects for mirroring from the Object Status screen . . . . . 12-39

Role swap with stream file mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-40

IFS object journal codes supported by OMS/400. . . . . . . . . . . . . . . . . . . . 12-41

IFS mirroring limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-43

Implementing iSeries Clustering

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1

What is clustering? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2

Clustering components and terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3Cluster Resource Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3i5/OS levels and cluster components . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4Cluster Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5Switchover or failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5IP address takeover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6Exit programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6Simple cluster example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7Application CRG automated configuration data area (ISV data area) . 13-11What happens when the primary node is down? . . . . . . . . . . . . . . . . . 13-11

xii OMS/400 v8.2 SR-2 Product Manual

Contents

Configuring iSeries Clusters

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-1

Defining clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2Preliminary configuration steps to clustering. . . . . . . . . . . . . . . . . . . . . . 14-2

Defining a new cluster. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4

Working with clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-9Next steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-11Adding a node to an established cluster. . . . . . . . . . . . . . . . . . . . . . . . . 14-11Adjusting Cluster version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-13Performance tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-14

Adding nodes to a device domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-16

Deleting nodes from an established cluster . . . . . . . . . . . . . . . . . . . . . . . . . 14-17

Defining Cluster Resource Groups

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-1

Configuring a ClusterProven application. . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-2

Creating cluster resource groupsbuilding your own definitions . . . . . . . . . 15-3Defining CRG configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-3

Working with Cluster Resource Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-4Before adding nodes to a device CRG. . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5Creating device CRGs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-5About the CRG exit program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-6Starting the CRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-12Defining each nodes role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-13Adding and removing nodes from the CRG definition . . . . . . . . . . . . . 15-13Adding nodes to a device domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-15Adding devices to a device CRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-17Changing device status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-18Removing nodes from a device CRG . . . . . . . . . . . . . . . . . . . . . . . . . . 15-19Changing CRG attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15-19

Configuring OMS/400 in a Cluster

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-1

How does OMS/400 mirroring fit in? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-2

Configuring OMS/400 with a ClusterProven application . . . . . . . . . . . . . . . 16-3Configuration flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-4Application CRG configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-5

OMS/400 v8.2 SR-2 Product Manual xiii

Contents

Generating the data CRG and creating links . . . . . . . . . . . . . . . . . . . . 16-11

Associating the CRGs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-14Creating the OMS/400 mirrored object list for the application . . . . . . 16-16Next steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-17

Configuring OMS/400if application is not ClusterProven . . . . . . . . . . . 16-18Configuring the primary node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-18Backup and replicate nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-19

Defining objects for mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-21Additional tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-21

Remote journaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-22Configuring remote journals in a CRG . . . . . . . . . . . . . . . . . . . . . . . . 16-22

Starting the CRG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-25

Viewing current Status/Role of nodes in a recovery domain. . . . . . . . . . . . 16-27

Initiating a switchover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-28Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-28Switchover in a device CRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-31Indoubt status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-32

What initiates a failover? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-33Distress messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-34Remote journal switchover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-34

Using OMS/400 in a ClusterOMS/400 Group Mode

What is group mode mirroring? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-1When to use group mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-1When not to use group mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-2

How group mode works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-3

Establishing group mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-5Group mode commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-5Establishing group mode mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-6

Creating a new group mirroring environment . . . . . . . . . . . . . . . . . . . . . . . 17-7Adding a link to a group and sub group definition . . . . . . . . . . . . . . . 17-10Creating the source side of the first link. . . . . . . . . . . . . . . . . . . . . . . . 17-12Creating the target side of the link. . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-12

Mirroring in a group mode environment . . . . . . . . . . . . . . . . . . . . . . . . . . 17-13Working with two sets of screens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-13Establishing object definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-14Defining objects in a group mode environment. . . . . . . . . . . . . . . . . . 17-14Generating the mirrored object list . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-17

xiv OMS/400 v8.2 SR-2 Product Manual

Contents

Viewing the results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-17Using group mode sync check. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-18Group mode PLM definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-19Jobs activated when mirroring is started . . . . . . . . . . . . . . . . . . . . . . . . 17-19Starting mirroring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-20Maintaining and monitoring OMS/400 . . . . . . . . . . . . . . . . . . . . . . . . 17-22Ending Mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17-24

ClusteringPlanned Downtime

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1

Planned downtime for a primary node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-1

Shutdown procedures to IPL the primary system in a data CRG. . . . . . . . . . 18-2Before you begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-2Resetting the cluster and CRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18-4To IPL a node defined to multiple CRGs . . . . . . . . . . . . . . . . . . . . . . . . 18-7

ClusteringHandling Node Failure

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1

Cluster Services node failure/partition scenarios . . . . . . . . . . . . . . . . . . . . . . 19-1Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-1Detected node failure scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-3Cluster partition scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4Cluster switchover scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-4

Error recovery scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5If a cluster becomes partitioned. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-5Inquiry message response options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-9Partition stateoptions for recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-9OMS/400 partition state inquiry message . . . . . . . . . . . . . . . . . . . . . . . 19-12Cluster operator possible actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-12Restarting a partitioned cluster node. . . . . . . . . . . . . . . . . . . . . . . . . . . 19-13Recovery and rejoin when partitioned nodes have been removed . . . . . 19-14Recovery on a node with a pending state that is stuck . . . . . . . . . . . . . . 19-16Data CRG and application CRG orientation error . . . . . . . . . . . . . . . . 19-17OMS/400 link and CRG out of phase . . . . . . . . . . . . . . . . . . . . . . . . . 19-18

Independent Disk Pools

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-1

Mirroring with Independent Disk Pools (iASPs) . . . . . . . . . . . . . . . . . . . . . . 20-1Mirroring to/from an ASP or Primary iASP . . . . . . . . . . . . . . . . . . . . . . 20-2Mirroring to/from Secondary iASPs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-3

OMS/400 v8.2 SR-2 Product Manual xv

Contents

Switchable Independent Disk Pool Requirement . . . . . . . . . . . . . . . . . . . . . 20-6General requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20-7Tower switchable between physical systems. . . . . . . . . . . . . . . . . . . . . . 20-8DASD switchable between logical partitions . . . . . . . . . . . . . . . . . . . . . 20-9

OMS/400 Performance Tuning

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-1

Improving iSeries performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2Optimizing response times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-2Maximizing system and application performance . . . . . . . . . . . . . . . . . 21-2

Maximizing communications performance and throughput. . . . . . . . . . . . . 21-5Important configuration settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-5TCP/IP settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-6APPC settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-6Authority checking sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-7

Improving Direct Access Storage Device (DASD) performance . . . . . . . . . . 21-8Tips for improving disk subsystem - journal receiver ASP performance . 21-8

Improving Vision Suite application performance . . . . . . . . . . . . . . . . . . . . 21-11Tips for maximizing job performance . . . . . . . . . . . . . . . . . . . . . . . . . 21-11Work management and memory management tips . . . . . . . . . . . . . . . 21-11Improving journaling performance on the source and target system . . 21-14

Maximizing target system throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-17Diagnosing target system performance . . . . . . . . . . . . . . . . . . . . . . . . 21-18Improving the performance of application programs when journaling. 21-19Other general guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-19

Changing the number of apply jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-20

Working with OMS/400 advanced settings . . . . . . . . . . . . . . . . . . . . . . . . 21-22Hashing starting position (Lib Obj) . . . . . . . . . . . . . . . . . . . . . . . . . . 21-22Memory manager memory space in Kilobytes . . . . . . . . . . . . . . . . . . . 21-23Configuring communications block size . . . . . . . . . . . . . . . . . . . . . . . 21-23User space block size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-24Allow open-ended transaction routing. . . . . . . . . . . . . . . . . . . . . . . . . 21-24Maximum user queue run-ahead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-25Maximum entries blocked per user queue entry. . . . . . . . . . . . . . . . . . 21-25Journal entry length for electronic send . . . . . . . . . . . . . . . . . . . . . . . . 21-25Filter Trigger/RI transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-25Object selection technique. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-26

Collecting OMS/400 performance data . . . . . . . . . . . . . . . . . . . . . . . . . . . 21-26Saving the Monitor and related journals . . . . . . . . . . . . . . . . . . . . . . . 21-27

xvi OMS/400 v8.2 SR-2 Product Manual

Contents

MQSeries Exit Programs

MQSeries sample programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-1Role swap exit program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-1End MQSeries program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-5Start MQSeries program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22-7

Mirroring MQSeries with OMS/400

High Availability for MQSeries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-1

What is Required for Replicating MQSeries . . . . . . . . . . . . . . . . . . . . . . . . . 23-2Required Types and Numbers for Links . . . . . . . . . . . . . . . . . . . . . . . . . 23-2Journaling IFS Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-3Options for Mirroring Websphere MQ to Facilitate Role Swap . . . . . . . 23-5Required IBM PTFs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-5Configure the MQ environment before configuring OMS/400 . . . . . . . 23-5

MQSeries mirroring configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-6Configuration overviewroad map . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-6*JRN link for AMQAJRN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-7MQ IFS object selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-8Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-9

Configuration notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-10Journal Manager configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-11Configuring Mirroring for MQSeries 5.x Objects . . . . . . . . . . . . . . . . . 23-12MQSeries 5.x and i5/OSOMS/400 IFS object data link . . . . . . . . . . 23-13

About the record MQ image command. . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-16MQ/400 recovery considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-17MQ/400 environment considerations . . . . . . . . . . . . . . . . . . . . . . . . . . 23-17

Role Swap Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-18Creating a role swap exit program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-19Sample exit program for the message journal link . . . . . . . . . . . . . . . . . 23-20

Starting MQSeries mirroring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-21

MQSeries initial sync point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-22

Executing a role swap for MQ/400 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-23Preparing the source system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-23Deleting MQSeries user spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-24Preparing the target system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-24Swapping the former primary MQ system to become a backup system . 23-26Restart OMS/400 mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23-27Frequently used MQ/400 commands . . . . . . . . . . . . . . . . . . . . . . . . . . 23-29

OMS/400 v8.2 SR-2 Product Manual xvii

Contents

Reference Topics

Using OMS/400 Commands

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1Commands grouped by function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-1Running a remote command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-5

ACCESS (Access). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-6Access codes to enable Clustering features in Vision Suite OMS/400 . . 24-6Entering new access codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-7

CFGFRMJRN (Configure From Journal) . . . . . . . . . . . . . . . . . . . . . . . . . . 24-8

CLROMS (Clear OMS/400) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-9

CRTEXCLST (Create Exclusion List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-11

CRTLSTBDIP (Create listener binding IP interface). . . . . . . . . . . . . . . . . 24-12

ENDLSTNER2 (End listener2). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-13

ENDOMS (End OMS/400) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-14If you call ENDOMS from a CL program . . . . . . . . . . . . . . . . . . . . . 24-15

ENDOMSGRP (End OMS group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-16If you call ENDOMSGRP from a CL program. . . . . . . . . . . . . . . . . . 24-17

INZOMS (Initialize OMS/400) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-18

OMS400 (Object Mirroring System). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-19

OMSADVSET (OMS Advanced Settings) . . . . . . . . . . . . . . . . . . . . . . . . 24-20

OMSAPYMON (OMS/400 Apply Monitor) . . . . . . . . . . . . . . . . . . . . . . 24-23

OMSCHGJRN (OMS/400 Change Journal) . . . . . . . . . . . . . . . . . . . . . . 24-25

OMSCHGROLE (Change OMS/400 Role) . . . . . . . . . . . . . . . . . . . . . . . 24-27

OMS400GRP (OMS/400 group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-28

OMSCRCSTS (OMS/400 CRC Sync Check/Object Repair Status) . . . . . 24-29

OMSIFSSEL (OMS/400 IFS Object Management) . . . . . . . . . . . . . . . . . 24-32

OMSIFSSTS (OMS/400 IFS Object Status) . . . . . . . . . . . . . . . . . . . . . . . 24-34

OMSJRNSTS (OMS/400 Journal Statistics Report) . . . . . . . . . . . . . . . . . 24-36

OMSNETACT (OMS/400 Network Activity) . . . . . . . . . . . . . . . . . . . . . 24-37

OMSNETSTS (OMS/400 Network Status) . . . . . . . . . . . . . . . . . . . . . . . 24-38

OMSOBJAUT (OMS/400 Object Authority) . . . . . . . . . . . . . . . . . . . . . . 24-39

OMSOBJINZ (OMS/400 Object Initialization) . . . . . . . . . . . . . . . . . . . . 24-41

xviii OMS/400 v8.2 SR-2 Product Manual

Contents

OMSOBJREP (OMS/400 Object Repair) . . . . . . . . . . . . . . . . . . . . . . . . . 24-43

OMSOBJSEL (OMS/400 Object Selection) . . . . . . . . . . . . . . . . . . . . . . . . 24-45

OMSOBJSTS (OMS/400 Object Status) . . . . . . . . . . . . . . . . . . . . . . . . . . 24-46

OMSPRTDBR (OMS/400 Database Dependencies Report) . . . . . . . . . . . 24-50

OMSRMTCMD (OMS/400 Remote Command) . . . . . . . . . . . . . . . . . . . 24-51

OMSRPTJRN (OMS/400 Journaled/not Journaled Files Report) . . . . . . . 24-55

OMSRSTOBJ (OMS/400 Restore Object) . . . . . . . . . . . . . . . . . . . . . . . . . 24-56

OMSSAVOBJ (OMS/400 Save Object) . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-59

OMSSNDIFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-63

OMSSYSACT (OMS/400 System Activity) . . . . . . . . . . . . . . . . . . . . . . . . 24-65

OMSSYSSTS (OMS/400 System Status) . . . . . . . . . . . . . . . . . . . . . . . . . . 24-66

OMSVFYIFS (IFS Verify Utility) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-67

OMSVFYTRG (OMS/400 Verify Trigger) . . . . . . . . . . . . . . . . . . . . . . . . . 24-68

OMSWRKREL (Work with Physical File Relations) . . . . . . . . . . . . . . . . . 24-70

OMSWRKTRG (OMS/400 Work Trigger) . . . . . . . . . . . . . . . . . . . . . . . . 24-71

PRDLIBCHK (Production Library Check). . . . . . . . . . . . . . . . . . . . . . . . . 24-72

RSTOMS (Restart OMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-73

RTVLNKINF (Retrieve Link Information). . . . . . . . . . . . . . . . . . . . . . . . . 24-74

RTVLNKSTS (Retrieve link status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-77

RTVOBJSTS (Retrieve OMS/400 Object Status) . . . . . . . . . . . . . . . . . . . . 24-87

RTVOMSSTS (Retrieve OMS/400 Role Status). . . . . . . . . . . . . . . . . . . . . 24-88

STRLSTNER2 (Start listener2). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-89

STROMS (Start OMS/400) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-90Starting mirroring with a remote journal . . . . . . . . . . . . . . . . . . . . . . . 24-93If you call STROMS command in a CL program . . . . . . . . . . . . . . . . . 24-93

STROMSGRP (Start OMS/400 group) . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-94STROMSGRP with a remote journal . . . . . . . . . . . . . . . . . . . . . . . . . . 24-96If you call STROMSGRP command in a CL program . . . . . . . . . . . . . 24-96

SYNCHK (OMS/400 Synchronization Check). . . . . . . . . . . . . . . . . . . . . . 24-97

SYNCHKERR (Process SYNCHK Allocation Errors). . . . . . . . . . . . . . . . 24-100

SYNCHKGRP (Sync check group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-102

SYNCHKIFS (IFS Sync Check) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-104

OMS/400 v8.2 SR-2 Product Manual xix

Contents

SYNCHKJRN (OMS/400 Synchronization Check - Journal) . . . . . . . . . 24-106

VSIPRODUCT (Vision Product Master) . . . . . . . . . . . . . . . . . . . . . . . . 24-108

VSIRCDMQM (Record MQ media image) . . . . . . . . . . . . . . . . . . . . . . 24-109

VSIRMTCALL (Vision Suite Remote Call). . . . . . . . . . . . . . . . . . . . . . . 24-110

VSIRMTCAL2 (Vision Suite Remote Call) . . . . . . . . . . . . . . . . . . . . . . . 24-112

VSIRMTCMD (Vision Suite Remote Command) . . . . . . . . . . . . . . . . . 24-114

VSIRMTCMD2 (Vision Suite Remote Command2) . . . . . . . . . . . . . . . 24-116

VSISETPWD (VSI Set Password) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-118Creating or Changing a Password . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-119

WRKAPYDTA (Work with Apply Data) . . . . . . . . . . . . . . . . . . . . . . . . 24-120

OMS/400 Screen Reference

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-1Access to OMS/400 menus, screens, and functions . . . . . . . . . . . . . . . . 25-2Access to OMS/400 Maintenance menu DB2 screens and functions . . . 25-3OMS/400 Maintenance menuaccess to IFS screens and functions. . . 25-4OMS/400 group mode and clustering screens . . . . . . . . . . . . . . . . . . . . 25-5

Remote Link Selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-6

OMS/400 Object Mirroring System (OMS/400 main menu) . . . . . . . . . . 25-12

OMS/400 System Definition Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-13System Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-14Journaling Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-16Miscellaneous Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-18SYNCHK and Object Repair Definitions . . . . . . . . . . . . . . . . . . . . . . 25-22

OMS/400 Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-26OMS Object Selection (OMSOBJSEL) . . . . . . . . . . . . . . . . . . . . . . . 25-27Select Libraries to Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-28Select Objects to Mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-29Library Cross Reference selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-30Library Cross Reference definition . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-31Production Library Monitor selection . . . . . . . . . . . . . . . . . . . . . . . . 25-32Production Library Monitor definition . . . . . . . . . . . . . . . . . . . . . . . . 25-34Work with Exclusions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-36Edit Exclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-37

OMS/400 Object Status (OMSOBJSTS) . . . . . . . . . . . . . . . . . . . . . . . . . 25-39

Object Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-42Windows associated with Object Status options . . . . . . . . . . . . . . . . . 25-46

xx OMS/400 v8.2 SR-2 Product Manual

Contents

Windows associated with Object Status function keys . . . . . . . . . . . . . 25-56OMS/400 Object Allocation State . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-61

OMS/400 Journal Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-64Journal Manager (Add/edit Journal) . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-67Journal/Link Association. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-73Journal Manager (History) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-75Work with Remote Journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-78Work with RDB Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-83

OMS/400 Inquiries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-85System Activity Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-86System Activity Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-90OMS/400 Network Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-91OMS/400 Network Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-93

OMS/400 Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-96

OMS/400 Miscellaneous Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-97

IFS object mirroring screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-99Stream File Object Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-99Stream File Object Status (Work with Inactive Objects) . . . . . . . . . . . 25-103IFS Synchronization Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-105Object ID Index Rebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-107

Group mode and clustering configuration screens

OMS/400 Group Control Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-110Start OMS/400 Group Jobs (STROMSGRP) . . . . . . . . . . . . . . . . . . 25-112

Group Control Centerlink status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-113

Group Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-115Windows associated with Group Maintenance options . . . . . . . . . . . . 25-117Object Definition for group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-119Windows associated with Group Maintenance function keys . . . . . . . 25-121OMS/400 Group Control Center - Sub Group and link status. . . . . . 25-122Sub Group Maintenance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-124Windows accessed by Sub Group Maintenance options and function keys . . .

25-126

Link ID Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-129Windows accessed by Link ID Maintenance screen options . . . . . . . . 25-131Windows accessed by Link ID Maintenance screen functions . . . . . . . 25-134

Cluster Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-136Windows accessed through Cluster Maintenance options . . . . . . . . . . 25-138Windows associated with Cluster Maintenance functions . . . . . . . . . . 25-139

OMS/400 v8.2 SR-2 Product Manual xxi

Contents

Application CRG Configuration (ISV Data Area) . . . . . . . . . . . . . . . 25-148

Cluster Resource Group Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-151Windows accessed by Cluster Resource Group Status screen options 25-152Cluster Resource Group Maintenance . . . . . . . . . . . . . . . . . . . . . . . . 25-154Window accessed by Cluster Resource Group Status screen function key . . . .

25-156

Using OMS/400 Reports

Generating and interpreting OMS/400 reports . . . . . . . . . . . . . . . . . . . . . . 26-1

MRR040: Configuration Listing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-3

MRR240: Role swap verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-4

MRR280: Journal Receiver Analysis Report. . . . . . . . . . . . . . . . . . . . . . . . . 26-5

Role swap reportsMRR320, MRR330, MRR335, and MRR600. . . . . . . 26-7

MRR430: Objects Journaled/Not Journaled . . . . . . . . . . . . . . . . . . . . . . . . 26-9

MRR440: File Dependencies Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-11

MRR480/481: Production Library Monitor Report . . . . . . . . . . . . . . . . . 26-13PLM messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26-16

MRR860: Trigger Configuration report . . . . . . . . . . . . . . . . . . . . . . . . . . 26-22

OMS/400 Security Maintenance

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-1

Accessing Security maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27-2

Allocating authority to specific OMS/400 functions . . . . . . . . . . . . . . . . . . 27-2

Allocating authority to multiple OMS/400 functions . . . . . . . . . . . . . . . . . 27-5Granting authority with command key F6 . . . . . . . . . . . . . . . . . . . . . . 27-9Revoking authority with command key F7 . . . . . . . . . . . . . . . . . . . . . 27-10Allocating authority with the OMSOBJAUT command . . . . . . . . . . . 27-11

Appendices

Objects Installed / Internal User Profiles

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Objects created by the installation process . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Vision Suite Internal User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3VSIOWNER Special Authorities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4VSIUSER, OMS400, and ODS400 User Profile Special Authorities. . . . A-7

xxii OMS/400 v8.2 SR-2 Product Manual

Contents

OMS/400 Jobs

Jobs activated by the STROMS command . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1Scheduled jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-5

OMS/400 Messages

Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

OMS/400 Limitations

Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1OMS/400 Version 8.1 limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1IFS stream file mirroring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2Field-level security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2

Configuration issues and workarounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3MREREXP allows an exit program execute. . . . . . . . . . . . . . . . . . . . . . . D-3CCSID environments other than 65535. . . . . . . . . . . . . . . . . . . . . . . . . D-4OMS/400 subsystem does not end on the target . . . . . . . . . . . . . . . . . . . D-5Managing journals without Journal Manager . . . . . . . . . . . . . . . . . . . . . D-8Deleting orphaned user spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-9

Use RSTOMS to Restart after a Target System Failure

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1How RSTOMS Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1When to Use RSTOMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2When to Use CLROMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2

Use RSTOMS to Restart OMS/400 After a Target Failure . . . . . . . . . . . . . . . E-3

Restarting MQSeries Fails after Running an Exit Program

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-1

Group Mode Conversion

Converting existing links to group mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-1Overview of the conversion process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2Restricted state required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2Group Control Center screen - auto-assignment. . . . . . . . . . . . . . . . . . . G-5Rules for naming groups, sub groups, and IDs . . . . . . . . . . . . . . . . . . . . G-5Transferring the links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-8Specifying group properties of a link. . . . . . . . . . . . . . . . . . . . . . . . . . . . G-9Group mode and apply jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-11

OMS/400 v8.2 SR-2 Product Manual xxiii

Contents

Reattaching the group to a journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-11Deleting unused auto-assigned groups and sub groups . . . . . . . . . . . . . G-12Accessing OMS/400 group mode with the OMS400 user profile: . . . . . G-13

Journaling to a Tape Device

Journaling to a tape device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . H-1Recording journal transactions to tape. . . . . . . . . . . . . . . . . . . . . . . . . . . H-2Applying the transactions to the target . . . . . . . . . . . . . . . . . . . . . . . . . . H-3

Maintaining Control Values

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-1

Selecting Which MRCTLVP Control File to Edit . . . . . . . . . . . . . . . . . . . . . . I-2

Summary List of Control Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-3

Accessing and Using the Control File Maintenance Interface. . . . . . . . . . . . . . I-8Edit a Control Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-9Add a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-11Copy a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-13Instances of a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-14Copy Control Files to Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-15Change Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-16

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I -16

Mirroring Special Object Types

Mirroring SQL Collections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-1Setting Up SQL Collections to be Mirrored . . . . . . . . . . . . . . . . . . . . . . . J-2After SQL Collections are Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-5

Stored Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-6Registering Stored Procedures and User Defined Functions in the Database . .

J-6Stored Procedures and User Defined Functions. . . . . . . . . . . . . . . . . . . . . J-7

Glossary

Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

xxiv OMS/400 v8.2 SR-2 Product Manual


OMS/400 v8.2 SR-2, with ASP13 EnhancementsThe following enhancement was provided in the OMS/400 v8.2 SR-2 release, with ASP13 applied.

V6R1 CompatiblityOMS/400 v8.2 SR-2, with ASP13 applied, is compatible with the IBM i5/OS V6R1 operating system.

OMS/400 v8.2 SR-2 Base Release Changes and EnhancementsThe base release of OMS/400 v8.2 SR-2 provides enhanced support for the i5/OS V5R4 release features and enhancements to replication capabilities and group mode support. Also, as a result of V5R4 enhancements and to improve interface synchronization for mirroring between OMS/400 and ODS/400 products, some functionality was moved to OMS/400 from ODS/400.

The following sections provide information about these new features and enhancements:

Support for V5R4 on page xxvi

data area and data queue authority journal entries on page xxvi

journal minimized data value *FLDBDY on page xxviii

journal object limit on page xxviii

Enhancements to OMS/400 on page xxviii

logical file mirroring on page xxviii

minimized journal entries with sync check support on page xxix

OMS/400 v8.2 SR-2 Product Manual xxv


enhanced group mode support on page xxix

QDFTJRN data area support on page xxxi

Additional Information or Changes on page xxxii

New Control Values on page xxxii

Changes to OMS/400 Commands on page xxxii

Support Changes for Journal Entry Type on page xxxiii

Changing the Number of Apply Jobs on page xxxiv

Mirroring to Secondary iASPs on page xxxiv

Mirroring Special Objects on page xxxiv

IMPORTANTIMPORTANTIt is important to note that this OMS/400 v8.2 SR-2 release supports i5/OS version V5R2 and higher only.

Support for V5R4The following sections provide descriptions of V5R4 features that are supported in OMS/400 v8.2 SR-2. It is important to note that these features are available on systems with an i5/OS of V5R4 only.

Data Area and Data Queue Authority Journal EntriesWith the release of i5/OS V5R4, authority changes to data area and data queue objects are now journaled in database journals (except DDM data areas which cannot be journaled). Additionally, the creation of either a data area or data queue are journaled.

These new journal entries allow for the replication of the create for a data area or data queue, as well as the replication of both database changes and authority changes to these objects to occur through OMS/400. Previous to this release and the release of V5R4, authority changes to data area and data queue objects were replicated through ODS/400.

The following journal code and entry types are supported for replicating either creates or authority changes:

xxvi OMS/400 v8.2 SR-2 Product Manual

Support for V5R4

See Journaling function extensions on page 3-2.

To automatically replicate creates of data area and data queue objects through OMS/400, the library where the data area or data queue resides must be configured to the PLM. Also with the PLM global value of Auto Correct Default Journaling Properties enabled and the Capture Creates definition appropriately set, object creates (CRs) in the libraries for both data area and data queue objects are automatically captured. For a description of these values, see the tables PLM global values on page 4-5 and PLM library definition fields on page 4-7.

Authority changes will still be sync checked through ODS/400 If you were previously replicating data area and data queue object authority changes through ODS/400, no action is required (these definitions should remain in ODS/400).

For systems running the OS described, the behavior with this OMS/400 v8.2 SR-2 release installed is as described below:

the same OS version of V5R2 or V5R3 on source and target, the replication of Data Area and Data Queue objects occur as designed prior to the release of V5R4 and OMS/400 v8.2 SR-2

The replication of authority changes and creates for these objects occur through ODS/400 (when configured) and the replication of database changes occurs through OMS/400.

a V5R4 source to a V5R2 or V5R3 target, the source will capture creates of Data Area and Data Queue objects and replicate them to the target via the OMS/ODS interface (per design and implementation in releases of VSEE prior to VSEE 8.2/4.2 SR-2)

For E Journal Code (*DTAARA), entries include:

For Q Journal Code (*DTAQ), entries include:

EE - Create Data Area QA - Create Data Queue

ZA - Authority ZA - Authority

ZO - Owner ZO - Owner

ZP - Primary Group ZP - Primary Group

ZT - Auditing ZT - Auditing

OMS/400 v8.2 SR-2 Product Manual xxvii


Journal Minimized Data Value *FLDBDYWhen creating or changing a journal, a new value that is available for V5R4 is now supported in OMS/400 v8.2 SR-2 on the Journal Manager screen. The value *FLDBDY (field boundaries) is available for the parameter Journal Minimized Data. The value *FLDBDY allows minimizing file entries on a field boundary. If this value is selected, then the existing value of *FILE cannot be specified. See Journal Minimized Data on page 9-7.

Journal Object Limit ValueA new parameter, Journal Object Limit, was added to the Journal Manager screen for OMS/400 v8.2 SR-2. The Journal Object Limit parameter allows you to set the maximum number of objects that can be journaled to the journal. The maximum number of objects that can be associated with one journal is now either 250,000 (*MAX250K) or 10,000,000 (*MAX10M). This value can be selected for the Journal Object Limit parameter when the journal is created; the selected value can be viewed when the journal definition is edited. The value of *MAX10M was added as a part of the V5R4 features. See Journal Object Limit on page 9-9.

Enhancements to OMS/400The following product functionality was added as part of the OMS/400 v8.2 SR-2 release to provide enhanced replication capabilities, enhanced group mode support, and extended API use.

Logical File MirroringWith this enhancement, the replication of logical files was added to OMS/400 v8.2 SR-2, when a PLM definition exists. It will provide the ability to replicate changes to logical files using the journal entries deposited in the database journal associated with the physical file with which the logical file has dependencies. This enhancement allows for changes to physical files and logical files to be processed in order, both in OMS/400 and by the same apply job.

Previous to this release, changes to logical files were replicated through ODS/400.With this enhancement, the following is provided:

Logical files can be viewed in Object Status, displayed with its unique file type of *LF. See Object Status screen on page 20.

Logical file creates are captured automatically. It is important to note that the journaling for a logical file is based on the journaling for the associated physical file. See Auto Correct Default Journaling Properties on page 4-6.

xxviii OMS/400 v8.2 SR-2 Product Manual

Enhancements to OMS/400

The PLM now monitors logical files. See Libraries with associated logical files on page 4-3.

The selection of logical files for replication is handled like the selection of physical files. A physical file and its associated logical file selected for replication are automatically assigned to the same apply job. See Libraries with associated logical files on page 4-3.

Sample sync check is supported for logical files. See Sample Sync Check Mode on page 8-2.

A product refinement (CR 15555) addresses environments where joined Logical Files (*LF) have based-on Physical Files (*PF) that are journaled to separate journals and replicated in separate and different links. During a new product installation or a product upgrade to OMS/400 8.2 SR-2 ASP10, this change provides product logic that will select the journal of the correct based-on *PF with which to journal/replicate the joined *LF.

Minimized Journal Entries with CRC Syncheck SupportAn enhancement was made to OMS/400 as part of the enhanced replication capabilities to correct an issue noted in V5R3 related to Journal Minimal Data working fully with CRC Syncheck (CRCSYNCHK). OMS/400 will now handle checksum errors when processing minimized journal entries for both an apply job in recover mode and for a file that is being processed with a CRC sync check and repair command. (No documentation changes were required for this enhancement.)

Enhanced Group Mode SupportEnhancements for group support include the following:

Object Status refinements which include Object Status updates with Electronic Send and updating *HLD status. (No documentation changes were required for this enhancement.)

Remote journal activation in a multi-node group. See Starting mirroring on page 17-20 and Ending Mirroring on page 17-24.

Support for IFS replication in a multi-node group.

Since IFS replication and related functions work as originally designed at the *LNK and *GRP level, the subgroup (*SGP) option is not necessary and will no longer be displayed on the IFS Synchronization Check (SYNCHKIFS) and Electronic Send of IFS Object (OMSSNDIFS) screens. Only *LNK and *GRP will display. See Issue the SYNCHKIFS Command on page 12-20 and Completing an electronic send on page 12-33.

OMS/400 v8.2 SR-2 Product Manual xxix


PLM and Object Status EnhancementsThe following are enhancements added to the PLM for this release.

Global values

For an OS of V5R3 or V5R4, new global values include the Dependent Object Action and the Auto Correct Default Journaling Properties parameters.

The Dependent Object Action determines what happens when an object is added to a link with dependent objects that also need to be added, but that reside in a different library that has no PLM definition. Choices are:

*ADDPLM add the PLM definition automatically.

*ADDOBJ add dependent object to the link but do not add the library definition.

*NONE (Default) Ignore the dependent files.

The Auto Correct Default Journaling Properties determines if the PLM job should automatically create the QDFTJRN area if it does not exist in a library assigned to the PLM. (See the section QDFTJRN Data Area Support on page xxxi for more information on this data area).

See Configuring the PLM on page 4-4 and PLM global values on page 4-5.

Capture Creates

The Capture Creates value identifies the object types that you want to be automatically journaled upon creation in libraries configured to the PLM (dependent on the OS version of V5R3 or V5R4). In order to capture object creates, the QDFTJRN data area must exist (see the description of the Auto Correct Default Journaling Properties parameter as defined in Global values above.

See PLM library definition fields on page 4-7.

New error status and object status value

The following lists the new values:

*JRNERR is a new error status. If *YES is specified for the Auto Correct Default Journaling Properties parameter, and a library monitored by the PLM is defined in two links which have different journal definitions configured, a JRNERR error will occur in the Capture Creates column of the PLM.

See Correcting a *JRNERR error in the PLM Capture Creates Column on page 4-10.

xxx OMS/400 v8.2 SR-2 Product Manual

Enhancements to OMS/400

*PNDJRN is a new status value for objects. It indicates when a *FILE, *DTAARA or *DTAQ is created, until the journal transaction is received that starts mirroring the new object, the *PNDJRN status appears momentarily as an interim status before the object transitions into active status. You may or may not see it, depending upon system performance.

See Object status of configured objects on page 3-21.

QDFTJRN Data Area Support

The QDFTJRN data area is a feature implemented in i5/OS V5R3. With the OMS/400 PLM global value of Auto Correct Default Journaling Properties enabled, the QDFTJRN data area is created in libraries that are configured to the PLM. Then, with the Capture Creates definition in the PLM appropriately set, object creates (CRs) in those libraries are captured and automatically journaled using the journal specified in the d

Documents

VISION SUITE Enterprise Edition™ OMS/400™—Object …visionsolutions.custhelp.com/ci/fattach/get/53392/1283803785... · † Symantec and NetBackup—Symantec Corporation