Dieter W. Storr Efficient Usage of Adabas Replication
Dieter W. Storr
Efficient Usage of Adabas Replication A Practical Solution Finder Edited by Stephen Fedtke
VIEWEG+ TEUBNER
Bibliographie information published by the Deutsche Nationalbibliothek The Deutsche Nationalbibliothek lists this publication in the Deutsche Nationalbibliografie; detailed bibliographie data are available in the Internet at http://dnb.d-nb.de.
1st Edition 2011 All rights reserved
© Vieweg+ Teubner Verlag I Springer Fachmedien Wiesbaden GmbH 2011 Editorial Office: Christel Roß I Maren Mithöfer Vieweg+ Teubner Verlag is a brand of Springer Fachmedien. Springer Fachmedien is part of Springer Science+Business Media. www.viewegteubner.de No part of this publication may be reproduced, stored in a retrieval system or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permiSSion of the copyright holder. Registered andjor industrial names, trade names, trade descriptions etc. cited in this publication are part of the law for trade-mark protection and may not be used free in any form or by any means even if this is not specifically marked. Cover design: KünkelLopka Medienentwicklung, Heidelberg Printing company: STRAUSS GMBH, Mörlenbach Printed on acid-free paper Printed in Germany ISBN 97B-3-834B- 1730-3
Preface When I presented my experiences with the Event Replicator for Adabas at the International Users' Group Conference in Prague, 2010, Software AG and conference attendees inspired and encouraged me to write a book about replication to share my knowledge. This book will discuss the basies of the Event Replicator and show how to set-up files for replication and create the definitions for destination, subscription, GFB, initial state and the new ADADBS fuoctian.
Not a11 utility functions can currently be automatically replicated on a nonmainframe platform. An example is file changes that require special handling on the subscription, the replicator eogine and the target site. My book will walk you through the process step by step. From a disaster and recovery standpoint, copying databases to the same or other h ardware platforms becomes increasingly important. This book explains the difference between mirroring and replicating and shows the pros and cons of both tedmiques. In tests with production-sized data of 160 m illion records, communication problems occurred, parameters weren't calculated correctly and RPL buffers and SLOG overflowed. The initial-state procedure was too time-consuming and a workaround had to be found.
In production with 1,400 updates per second, the source database showed higher CPU time and batch jobs ran much longer when replication was turned on. Despite users' statements that the replication works correctly and comparisons between source and target are not necessary, seH-written comparison programs sometimes show differences. Three methods will be discussed how to compare source and target files to ensure that both are identical. Since database data is available in local or wide area networks and on public Web sites, security issues become even more important. One chapter in this book explains the available security software protecting the components during the replication process. Last but not least, this book will also show the very important recovery function. Normally, the Even t Replicator Server restarts automatically after an abn ormal end and is able to recover any lost replication. But in some cases, data is lost and the replication must be replayed.
VI
Preface
My special gratitude goes out to Larry Frazin, who supported me with replication tests. John Donnelly, Albert Stetson, Victor Tisuela, Hazel Baeza, Gary Walker and Chris Jonas who sent parameter values from their organizations. Roseanna Torretto monitored resources on the mainframe with RMF and Strobe. The team from Software AG, Wolfgang Weiss, Becky Albin, Alex Burggraf and WH Heynen, who were always available for tuning discussions and product sup-
port. My thanks also to Michelle McGowan for her proofreading skills and emotional support. Dieter W. Starr Sacramento, Califomia, U.S.A, August 2011
Contents Preface .. .... .... ... .. .. .. .. .... .... ... .. .. .... ... .. .. .. .. ... .. .. .. ... .. .. .. .... ... .. .. .... .... ... .. .. .... .... ... .. .. .. .. .... ... V Table of Figures ......................................................................................................... XIII
1
Replication Basics .............................................................................................. 1.1 Today's Challenge .................................................................................. 1.2 Replicating or Mirroring .. .. .. .. ..... .. .. ..... .. .. .. ............. .. ............. .. ............. 1.2.1 Mirroring ................................................................................................. 1.2.2 Replication .. ........... .............................. ........... ............... ........... ............... 1.3 Reasons for Replication ......................................................................... 1.4 Check Your Intentions Before Starting .......................... ...................... 1.4.1 Mirroring or Replication? ...................................................................... 1.4.2 Usage of Replicated Database .............................................................. 1.4.3 Measure/Compute and Determine Your Needs ................................ 1.4.4 Avoid Mistakes .......................................................................................
1 1 3 3 4 5 7 7 8 9 10
2
Different Ways to Replicate ............................................................................. 2.1 General Requirements I Basics ... .. .. .. ... .. .. .. .. ........... .. .. ........... .. .. ........... 2.2 From Adabas to Adabas on the Mainframe ....................................... 2.3 From Adabas on the Mainframe to Adabas on Linux, UNIX or Windows (LUW) ................................................................................ 2.4 From Adabas on the Mainframe to Non-Adabas Databases ...........
13 13 14 15 17
Definitions and Parameters ............................................................................. 3.1 Getting Started .......... .......................... ........... ............... .......................... 3.2 Source or Subscription Database (V8.1.3) ........................................... 3.2.1 Workload Manager (WLM) .............. ............... ............... ........... ........... 3.2.2 ADARUN Parameters ........................................................................... 3.2.3 ADADBS Replicate Files .. .. .. ... .. .. .. .. .. ... .. .. .. .. ........... .. .. ........... .. .. ........... 3.3 Replicator Engine - Reptor (V8.1.3N3.2.1) ........................................ 3.3.1 Workload Manager (WLM) ...... .. .. .. ........................ .. .. .. .................... .. .. 3.3.2 SLOC File ................................................................................................ 3.3.3 Replication System File .. ................... ............... ............... ...................... 3.3.4 ADARUN parameters ........................................................................... 3.3.5 Event Replicator lnitialization Parameters ......................................... 3.3.6 Define the Global Format Buffer .......................................................... 3.3.7 Define the Destinations .............. ....... ............... ............... ...................... 3.3.8 Define the Subscriptions ....................................................................... 3.3.9 Define the Transaction Filter Definitions ............................................ 3.3.10 Define the Initial-State ...........................................................................
19 19 22 23 23 24 25 25 26 26 27 29 31 35 36 37 38
3
Conlenls
VIII
Unload and load parameters ................................................................ Entire Net-Work (Wep V6.2.1) - Mainframe ..................................... AOARUN parameters ........................................................................ ... Parameter Statements ............................................................................ Entire Net-Work (WCP V7.3.3) - LUW .............. .. .. .. ..... .. ............. .. ..... Parameters ............................................................................................... Service.config ... .. .. .. .. ..... .. .. .. ..... .. ............. .. .. .. ......... .. .. .. ......... .. ............. ... KZOO8.KERNEL ...................................................................................... Xts.config ... ............. .. ..... .. .. .. ..... .. ............. .. .. .. ......... .. .. .. ......... .. ............. ... Entire Net-Work (WCL V1.3.1) CIient ................................................. Windows Service ................................................................................. ... UNIX Oaemon ........................................................................................ Xts.config .............................................................................................. ... Service.config .......................................................................................... Oirectory Server - xtsurl .cfg ................................................................. Adabas on Windows (V6.2.1.1) ............................................................ General ..................................................................................................... Parameters ............................................................................................... EntireX Broker (V8.0.1) .......................................................................... EntireX Broker (V7.3.4) .......................................................................... Event Replicator Target Adapter ......................................................... Schema and Replicated Oata ................................................................
38 41 41 42 43 43 43 44 44 44 44 45 45 45 46 46 46 46 48 48 52 53
4
Compare Files of Source and Target ... .. ............. .. ......... .. ..... .. .. .. ......... .. .. .. ..... 4.1 Compare Amount Fields ....................................................................... 4.2 API USR40]]N - User Exit ................................................................ ... 4.3 Compare Highest ISNs (fOPISN) .......................................................
57 58 59 60
5
Recovery After a Crash ..................................................................................... 5.1 Replay with a Token .............................................................................. 5.2 Replay Without a Token ........................................................................ 5.3 Replay-only Mode .................................................................................. 5.4 Initial-state .............. .. ......... .. .. .. .. ..... ......... .. .. .. ......... .. .. .. ..... .. ............. .. .....
63 64 67 68 68
6
Problems and Solutions .................................................................................... 6.1 Source or Subscription Oatabase .......................................................... 6.1.] Replicator Buffer (LRPL) Overflow ..................................................... 6.1.2 High CPU UsageofSource OB ............................................................ 6.1.3 AOAFRK - Transactions Tumed Off .................................................. 6.1.4 Source OB didn't come down ............................................................... 6.1.5 File Changes Won't Replicate ............................................................... 6.2 Replicator Engine (Reptor) ................................................................... 6.2.1 NAB Overflow ........................................................................................ 6.2.2 Replicator Buffer (LRPL) Overflow .....................................................
7] 71 71 72 79 79 80 86 86 87
3.' 3.5 3.5.1 3.5.2 3.6 3.6.1 3.6.2 3.6.3 3.6.' 3.7 3.7.1 3.7.2 3.7.3 3.7.4 3.7.5 3.8 3.8.1 3.8.2 3.9 3.9.1 3.9.2 3.9.3
Contents
6.2.3 6.2.4 6.25 6.2.6 6.2.7 6.2.8
6.2.9 6.2.10 6.2.11 6.2.12 6.2.13 6.2.14 6.2.15 6.2.16 6.2.17 6.2.18 6.3 6.3.1 6.3.2 6.3.3 6.3.4 6.35 6.3.6 6.4 6.4.1 6.4.2 6.4.3 6.4.4 6.45
6.4.6 6.4.7 6.4.8 7
IX
SLOG Overflow .... .... .... ....... .... .... .... ... .... .... ... .... .... .... ... .... .... ....... .... .... ... RSP 153 from the Target OB ................................................................ . RSP 113 from the Target OB .. .... .... ... .... .... ... .... .... .... ....... .... .... ....... .... ... RSP 98 from the Target OB .................................................................. . RSP 162 from theTarget OB .. .. ... .. .. .. ... .. .. .. .. .... .... ... .. .. .... .... ... .. .. .... .... ... Special characters are not correctly replicated .................................. . Wrong Replicated File in SLOG ... .. .. .... ... .. .. .. .. .... .... ... .. .. .... ... .. .. .... .... ... RSP 148 From Target OB ...................................................................... . Node is unreachable ... .. .. .. ... .. .. .. .. .. .. .. ... .. .. .. .. .... ... .. .. .... .... ... .. .. .... .... ... .. .. Communication Problem ..................................................................... . SLOG data disappeared ..... .... .... .... ....... .... .... ... .... .... .... ... .... ....... .... .... ... Replication is too slow .......................................................................... . Initial state is too slow ........ .... .... .... ... .... .... ... .... .... .... ... .... .... .... ... .... .... ... New AOAFRI Message ........................................................................ . Reptor under Stress .. .... .... ....... .... .... .... ... .... ... .... .... .... ... .... .... .... ... .... .... ... Replication with wrong FOT/GFB ...................................................... . Target Oatabase ..................................................................................... . RSP 52 from the Target OB .................................................................. . RSP 176 from the Target OB ................................................................ . RSP 98 followed by RSP 113 ................................................................ . RSP 113 on several files ........................................................................ . RSP 153 - Oisplayed on Reptor ..... ... .... .... ... .... .... ....... .... .... ... .... .... .... ... RSP 162 - LBP Space Problems ........................................................... . Utilities ..... ... .... .... .... ... .... .... .... ... .... .... .... ... .... ... .... .... .... ... .... .... .... ... .... .... ... Replay with more than 60 files ............................................................ . Replay with ERROR-139 .... .... .... .... ... .... .... ....... .... .... ... .... .... .... ... .... .... ... Replay with ERROR-140 RSP 254 ....................................................... . Replay with ERROR-140 RSP 131 Suhcode 70 ... .. .... .... ... .. .. .... .... ... .. .. Replay with ERROR-1 40 RSP 131 Subcode 61 .................................. . Replay with ERROR-I4$ - Token .. .. .... ... .. .. .. .. .... ... .. .. .. .. ... .. .. .... .... ... .. .. Replay Abended with SOC4 ................................................................. . Replay with Res ponse 131 Subcode 61 .. .... .... ... .. .. .. .. .... .... ... .. .. .. .. .... ...
Monitors .. .... .... .... .... ... .... ... .... .... .... ... .... .... .... ... .... .... .... ... .... .... .... ... .... ... .... .... .... ... 7.1 What can be monitored? ....................................................................... 7.1.1 Source OB on the Mainframe ................................................................ 7.1.2 Replicator on the Mainframe ..... .... ... .... .... ... .... .... .... ....... .... ....... .... .... ... 7.1.3 Entire Net-Work (WCP) on the Mainframe ........................................ 7.1.4 Network -LineorCircuit .. .... .... .... ... .... .... ... .... .... .... ....... .... ....... .... .... ... 7.1.5 Firewalls, Routers, Load Balancing Systems ...................................... 7.1.6 Entire Net-Work (WCP) on Windows ..... .... ... .... .... .... ... .... ... .... .... .... ... 7.1.7 Adabas on Windows - Command Log ...............................................
89 90 92 94 95 95 96 97
100 100 101 101 102 103 104 105 105 105 106 106 107 108
109 112 112 112 113 113 114 114 115 117 119 119 121 121 124 126 127 128 129
Conlents
X
Self-Written ........ ........... .................................. ............... ........... ........... ... RPL and NAß Buffer Overflow ............................................................ 5tOG check on Reptor .... ............... ........... ........... ............... ............... ... Compare two SLOGs and Open Destination ..................................... SLOG Check for Logged Files ... ........... .. .. .. .. ....... .. .. .. .. ....... .. .. ........... .. . StOG Space and Number of Records Check ..................................... Check Messages on DDPRINT .. .... .... ... .. .. .... ... .. .. .. .. .... ... .. .. .. .. .... .... ... .. . Target Check - Ping ............................................................................... Destination Report ........... .. .. .. .. ... .. .. ........... ....... .. .. .. .. ....... .. .. .. .. ... .. .. .. .. ... Subseription Report ............................................................................... RPL Flag Cheek in ADAREP .................... ............... ............... ........... .. . Analyze WCP Log .................................................................................. Determine Highest ISN Currently Used ................ ............... ........... .. . Compare File Components After Replieation .................................... Optimize for Infrastrueture (041) ................ ............... ........... ........... .. . General ..................................................................................................... Dimensions .............................................................................................. KPIs of Event Map AdabasEventRep .................................................. BuHt-In Rules .......................................................................................... Dimensions - Destination ..................................................................... KPIs of Event Map AdabasEventRepDest .......................................... BuHt-in Rules- Destination ..................................... .......................... .. . Dimensions - Input Queue ................................................................... KPIs of Event Map AdabasEventRepinQueue .................... ........... .. . BuHt-In Rules .......................................................................................... Dimensions - Subseription .... ....................... ............... ........... ........... .. . KPIs of Event Map AdabasEventRepSubscr ...................................... BuHt-In Rules ... .. .. .. .. .. ....... .. .. .. .. ... .. .. ........... ....... .. .. .. .. ....... .. .. .. .. ... .. .. .. .. ... How to Monitor a Component .............................................................
129 129 132 134 138 139 141 142 144 146 148 151 152 152 153 153 155 155 156 156 156 157 157 157 158 158 158 158 159
Security ................................................................................................................ Souree Database Adabas ....................................................................... Adabas SAF Security (ADASAF) ......................................................... Adabas Security (ADASCR) ................................................................. Adabas Data Eneryption (Ciphering) .................................................. Adabas Multi-elient Files ...................................................................... Replicator Adabas ............ .......................... ............... ............... ........... ... Adabas SAF Security (ADASAF) ......................................................... Entire Net-Work (Wep) Mainframe V6.2.1 .... ... .... .... .... .... ... .... .... ... .. . Entire Net-Work SAF Security (NETSAF) .......................................... Encryption Vl.1.2 .. .... ....... .... .... .... ... .... .... .... ... .... .... .... ... .... .... ... .... .... ... ... EntireX Broker ........................................................................................ EntireX Security ... .. .. .. ....... .. .. ... .. .. .. .. ....... .. .. .. .. ....... .. .. .. .. ....... .. .. ... .. .. .. .. ...
163 163 163 164 164 165 165 165 165 165 166 166 166
7.2 7.2.1 7.2.2 7.2.3 7.2.4 7.2.5 7.2.6 7.2.7 7.2.8 7.2.9 7.2.10 7.2.11 7.2.12 7.2.13 7.3 7.3.1 7.3.2 7.3.3 7.3.4 7.3.5 7.3.6 7.3.7 7.3.8 7.3.9 7.3.10 7.3.11 7.3.12 7.3.13 7.3.14
8
8.1 8.1.1 8.1.2 8.1.3 8.1.4 8.2 8.2.1 8.3 8.3.1 8.3.2 8.4 8.4.1
Contents 8.5 8.6 8.6.1 8.7 8.8 8.9 8.10 8.10.1 8.10.2 8.11 9
XI
Network .. ................... ........... ............... .......................... ............... ........... Entire Net-Work (WCP) LUW V7.3.4 .................................................. Encryption V1.1.2 .................... ............... ....... ............... ............... ........... Entire Net-Work (WCL) Client V1.3.3 ................................................. Event Replicator Target Adapter ... .. ... .. .. .. .. ........... .. .. ....... .. .. ........... .. .. Adabas ADASCR on Linux, Unix, Windows ..................................... Natural Security ........... ....... .. .. ... .. .. .. .. ....... .. .. .. .. ....... .. .. .. .. ....... .. .. ........... NSC .......................................................................................................... Natural SAF Security .......... .. .. .. .. .. ... .. ... .. .. .. .. ........... .. .. ....... .. .. ........... .. .. Non-Adabas on Linux, Unix, Windows .............................................
166 167 167 167 167 167 168 168 168 168
Append ix ............................................................................................................. 9.1 Subscription DB - ADARUN parameters ........................................... 9.2 Reptor -ADARUNparameters ...................... ............... ...................... 9.3 Definitions Target DB - Windows ....................................................... 9.3.1 Parameters - db251.ini .................. .............................. ............... ........... 9.3.2 High Water Marks .................................................................................. 9.3.3 Activities .................... .............................. ....... ............... ............... ........... 9.3.4 Buffer Pool Statistics .............................................................................. 9.4 Test Results .. .. .. .. ....... .. .. ....... .. .. .. .. ... .. .. .. .. ... .. .. ....... .. .. .. .. ........... .. .. ........... Natural Monitor Programs ................................................................... 9.5 9.5.1 Ping Target Database .. .. .. .. .. .. .. .. .. ... .. .. ... .. .. .. .. ........... .. .. ....... .. .. ........... .. .. 9.5.2 Check Messages on DDPRINT ............................................................. 9.5.3 RPL and NAB Buffer Overflow .. .. .. .. ... .. .. .. .. ........... .. .. ........... .. .. .. .. ....... 9.5.4 SLOG Check on Reptor ......................................................................... 9.5.5 Compare two SLOGs ....... ... .............................. ............... ........... ........... 9.5.6 Analyze WCP Log .................................................................................. 9.5.7 Checksum Program ............ .............................. ............... ........... ........... 9.5.8 Compare Amount Fields ....................................................................... 9.5.9 Parse Adabas Report for RPL Flag ...................................................... 9.5.10 Determine Highest ISN Currently Used ............................................. 9.5.11 RPLJOREP - SLOG Check ..................................................................... 9.5.12 READF30P - Read SLOG Content ....................................................... 9.5.13 RPL-POO2 - Compare File Components .............................................. 9.6 WCP Log Windows ............................................................................... 9.7 ADARPL Replay SOC4 Dump .............................................................. 9.8 Assembler Programs ........... .... .......................... ............... ........... ........... 9.8.1 Sieep/Wait ............................................................................................... 9.8.2 Get Dataset Name ............... .............................. ............... ........... ........... 9.9 EntireX V8.0.1 Parameters .....................................................................
169 169 171 173 173 175 175 176 177 180 180 181 183 185 186 189 190 192 194 197 200 203 204 206 213 216 216 218 220
Bibliography ............................................................................................................... 223 Index .................... ....... ............... ............... .............................. ........... ............... ........... 225
Table of Figures Figure 1: Figure 2: Figure 3: Figure 4: Figure 5: Figure 6: Figure 7: Figure 8: Figure 9: Figure 10: Figure 11: Figure 12: Figure 13: Figure 14: Figure 15: Figure 16: Figure 17: Figure 18: Figure 19: Figure 20: Figure 21: Figure 22: Figure 23: Figure 24: Figure 25: Figure 26: Figure 27: Figure 28: Figure 29: Figure 30: Figure 31: Figure 32: Figure 33: Figure 34: Figure 35: Figure 36:
Architecture of Adabas Replication on the Mainframe Source: Software AG ..... .. .. .. .. .. .. .. ..... .. .. .. ............. .. ............. .. ............. Mirroring - ADADBS TRANSACTrON SUSPEND Function .... Reasons for Replication .................................................................... Homemade Replication .... .. .. .. .. .. .. .... ... .. .. .. .. .... ... .. .. .. .. ... .. .. .... .... ... .. .. General Requirements - Buffer Usage ........................................... Replication from Adabas to Adabas on the Mainframe .............. Replication from Adabas to Adabas on Linux, UNIX or Windows (LUW) .......................................................................... Replication from Adabas to non-Adabas Databases ................... Determine Length of RBL and FBL .... ... .. .. .... ... .. .. .. .. ... .. .. .... .... ... .. .. Determine Number of Commands ................................................. Determine Type of Commands ....................................................... Compu tation for Mbps Bandwidth .... .... ... .... .... .... ... .... ....... .... .... ... Used Software Versions ................................................................... Buffer Usage in Subscription Database .......................................... Replication Status in Adabas Report .. ... .... .... .... ... .... .... .... ... .... .... ... Buffer Usage in Reptor ..................................................................... SLOG File Shown in Adabas Report .. ... .... .... .... ... .... .... .... ....... .... ... ADARUN Parameters of Reptor ..... .... .... ... .... .... .... ... .... ... .... .... .... ... Main Menu Adabas Replicator Subsystem ................................... Display Global Format Buffers Using Replicator Subsystem .. ... Add Global Format Buffer Using Replicator Subsystem ............ List and Select Predict Files Using Replicator Subsystem ........... Select a Predict Files Using Replicator Subsystem ....................... Select a Predict File Using Replicator Subsystem ......................... Save the Selected Predict File Using Replicator Subsystem ....... List Included New Predict File Using Replicator Subsystem ... .. Create New Destination Using Replicator Subsystem ................ Define New Destination Using Replicator Subsystem ................ Define New Subscription Using Replicator Subsystem ... .... .... ... Define New Transaction Filters Using Replicator Subsystem .... Perform Initial-State Using Event Replicator Subsystem ............ Destination Parameters .... .. .. .. .. .. .. .... ... .. .. .. .. .... ... .. .. .. .. ... .. .. .... .... ... .. .. Subscription Parameters .................................................................. Global Formats (GFB) from Predict ................................................ SYSRPTR Unload all Parameters in Batch .... ....... .... .... ....... .... .... ... SYSRPTR Load all Parameters in Satch .........................................
2 4 6 6 13 14
16 17 20 20 21 21 22 22 24 25 26 28 31 31 32 32 33 33 34 34 35 36 36 37 38 39 39 40 40 41
XIV
Figure 37: Figure 38: Figure 39: Figure 40: Figure 41: Figure 42: Figure 43: Figure 44: Figure 45: Figure 46: Figure 47: Figure 48: Figure 49: Figure 50: Figure 51: Figure 52: Figure 53: Figure 54: Figure 55: Figure 56: Figure 57: Figure 58: Figure 59: Figure 60: Figure 61: Figure 62: Figure 63: Figure 64: Figure 65: Figure 66: Figure 67: Figure 68: Figure 69: Figure 70: Figure 71: Figure 72: Figure 73:
Table of Figures
ADARUN Parameters (DDCARD) for Entire Net-Work (Wep) on Mainframe ....................................................................... Parameter Statements (DDKARTE) for Entire Net-Work (Wep) on Mainframe ....................................................................... service.config Entire Net-Work (Wep) on Open System ............ KZ008.KERNEL Entire Net-Work (WCP) on Open System .... ... xts.config Entire Net-Work (WCP) on Open System ................... xts.config Entire Net-Work Client (WCl) on Open System ....... service.config Entire Net-Work Client (WCl) on Open System xtsurl.cfg Directory Server Entire Net-Work Client (WCl) on Open System ................................................................................ Adabas Windows Parameters .. ....... .. .. ....... .. .. .. .. ....... .. .. .. .. ........... .. . Adabas Windows Buffer Pool Statistics ......................................... webMethods EntireX Parameters (V7.3.4) ..................................... Parameters for Target Adapter for SQl Database ....................... Generate Field Table - Source: SAG ............................................... Generated XML Schema 'Create' - Source: SAG .......................... Generated XMl Schema ' Insert' - Source: SAG ........................ .. . Generated XML Schema 'Update' - Source: SAG ........................ Generated XML Schema 'Delete' - Source: SAG .......................... Compare Source and Target Files - Amount Fields .................... Natural Program to Count Amount Fields ................................... Result of Natural Program to Count Amount Fields ................... Result of Natural Program to Count Amount Fields ................... Result of Natural Checksum Program ........................................... Compare Highest ISN (TOPISN) and Others .. ............................. Adabas Report Records loaded, TOPISN and MAXISN (Mainframe) ....................................................................................... Adabas Report Records Loaded, TOPISN and MAXISN (Windows) .......................................................................................... Compare Highest Used ISN OCl) .................................................. Compare Highest Used ISN (Output) ............................................ Replay Function and its Components ............................................ Replay Modes .................................................................................... Start Replay Vsing Event Replicator Subsystem .. ........................ Initiate Replay Using Event Replicator Subsystem ...................... ADARPL Replay Output without a Token ................................... Checksum Program to Compare After Replay .......................... ... SYSREPTOR - Perfonn Initial-State ............................................... SYSREPTOR - Perfonn Initial-State ............................................... lRPL Overflow ............... ....................... ............... ............... ........... .. . High CPU Time - 19:00 Start of 9 Batch Programs ......................
42 43
43 44 44 45 45 46 47 47 52 53 54 54 55 55 55 57 58 58 59 60 61 61 61 62 62 63 63 64 64 67 68 69 69 71 72
Table of Figures
xv
Figure 74: Figure 75:
73
Figure 76: Figure 77: Figure 78: Figure 79: Figure 80: Figure 81: Figure 82: Figure 83: Figure 84: Figure 85: Figure 86: Figure 87: Figure 88: Figure 89: Figure 90: Figure 91: Figure 92: Figure 93: Figure 94: Figure 95: Figure 96: Figure 97: Figure 98: Figure 99: Figure 100: Figure 101: Figure 102: Figure 103: Figure 104: Figure 105: Figure 106: Figure 107: Figure 108: Figure 109: Figure 110: Figure 111:
Duration of 9 Batch Jobs With and Without Replication ........... . Duration of 9 Jobs With and Without Replication and Source OB Parameters ..................................................................... . Duration of 9 Jobs Without and With Replication ...................... . Strohe Report - Adabas Source Database ..................................... . Strohe Report - Adabas Replicator Engine .. .... .... ... .... .... ....... .... ... Buffer Usage Between Source OB and Reptor ............................. . High CPU Time - Adabas Source Database - Used Parameters ADADBS REPLICATION .nd DSBI=OFF .... ... .. .. .... ... .. .. .. .. .... .... ... High CPU Time - Event Replicator Subsystem Global Parameters ............................................................................ . ADADBS REPLICATION DEACTIVATE ... .. .. .... .... ... .. .. .. .. .... .... ... ADAFRK - Transactions Turned Off ........................................... .. Source OB Waiting for Replication Message ................................ . Manual File Change Procedure - Dataflow .. .. .. .. .. .. ....... .. .. ......... .. Manual File Change Procedure - SLOG Check .......................... .. Manual File Change Procedure - SLOG Check .......................... .. Manual File Change Procedure - FTP Predict Changes to Windows ...................................................................................... .. Manual File Change Procedure - Predict Change Report ........ .. Manual File Change Procedure - Dataflow ................................ .. Manual File Change Procedure - Open the Destination ........... .. NAB Overflow on Reptor .............................................................. .. N AB Overflow Message ................................................................ .. NAB Overflow High Water Mark ................................................ .. LRPL Overflow Reptor .. .... ....... .... .... .... ... .... .... .... ....... .... .... ....... .... ... LRPL Overflow Reptor High Water Mark .................................. .. Adabas Report SLOC file ............................................................... .. Response Code 153 Shown in Reptor .. .. ....... .. .. .. .. ....... .. .. .. .. ....... .. .. Response Code 153 - CLOG Adabas Windows ......................... .. Response Code 153 - not shown in CLOC of Adabas Windows .. ... .. .. .. .. .. .. .. .. .... ... .. .. .. .. .... ... .. .. .. .. ... .. .. .... .... ... .. .. Response Code 113 - Message in Reptor ..................................... .. Response Code 113 - ISN Reusage ............................................... .. Response Code 98 Shown in Reptor and Parse Program .......... .. Response Code 162 Shown in Reptor ........................................... .. Response Code 162 - LBP and WRITE_LIMIT ........................... .. Special Character not Translated Correctly ................................ .. Refresh SLOG .................................................................................. .. Response Code 148 - Entire Net-Work or OB not Up ............... .. Response Code 148 -NAT3148 ...... .... .... ... .... .... .... ... .... ....... .... .... ... System Management Hub - Connectivity Check ....................... ..
73 74 74 74 75 76 77
78 79 79 79 80 81 81 82
83 85 86 86 86 87 88 88 89 90 90
91 92 93
94 95 95
96 97 97 97 99
XVI
Figure 112: Figure 113: Figure 114: Figure 115:
Table of Figures
Computer Management - Services Check .... .... .... ...................... .. . 100 Node is Unreachable ........................................................................ 100 Communication Problem .. .... ................... .... ........... .... ....... .... ....... ... 100 ADAMACIC - Apply ADASA V from Mainframe Directly to Windows ........................................................................................ 103
Figure 116: Figure 117: Figure 118: Figure 119: Figure 120: Figure 121: Figure 122: Figure 123: Figure 124: Figure 125: Figure 126: Figure 127: Figure 128: Figure 129: Figure 130: Figure 131: Figure 132: Figure 133: Figure 134: Figure 135: Figure 136: Figure 137: Figure 138: Figure 139: Figure 140: Figure 141: Figure 142: Figure 143: Figure 144: Figure 145: Figure 146: Figure 147: Figure 148: Figure 149: Figure 150: Figure 151:
ADAFRI Message - SLOG Tumed Off .. ........... .......................... ... Reptor Under Stress - User Gone Message ................................... Response Code 55 - Wrong FDT/GFB ........................................... Response Code 52 Showed in Reptor ............ .. .. .. ......... .. ............. .. . Response Code 176 Showed in Reptor ........................................... Response Code 98 and 113 Showed in Reptor .............................. Response Code 113 Showed in Reptor from Target .. .. ............. .. . Response Code 153 Showed in Reptor - from WCP/WCL ......... Response Code 162 Showed in Reptor from Target DB .............. Response Code 162 - LBP and WRITE_LlMIT on Target DB ..... Response Code 162 - LBP and WRITE_LlMIT on Target DB ..... Response Code 162 - LBP and WRITE_LlMIT on Target DB ..... Response Code 162 - LBP and WRITE_LlM IT on Target DB ..... Response Code 162 - LBP and WRITE_LlMIT on Target DB ..... ADARPL Replay > 60 Files .............................................................. ADARPL Replay ERROR-139 ......................................................... ADARPL Replay ERROR-140 RSP 254 .......................................... ADARPL Replay ERROR-140 RSP 131 SC 70 ............................... ADARPL Version and Zap Level... .. ..................... .... ....... .............. ADARPL Replay ERROR-140 RSP 131 SC 61 ............................... ADARPL Replay -Create Token .................................................... ADARPL Replay ERROR-148 ......................................................... ADARPL Replay SOC4 ..................................................................... ADARPL Replay SOC4 - RPL Cleanup ......... .. .. .. ......... .. ..... .. .. .. ..... ADARPL Replay SOC4 - Create Multiple Token ......................... ADARPL Replay SOC4 - RPL Cleanup .......................................... Monitoring Replieation Parts - Graphie ........................................ Monitoring Replieation Parts - Tools ............................................. Monitoring - Number of Commands per Seeond ........................ Monitoring- High Water Marks- Souree DB .. .. .. .. .. .. .. ............. .. . Monitoring High Water Marks - Reptor ....................................... Monitoring TLOG - Adjustments ................................................... Monitoring TLOG - ADARPP ........................................................ Monitoring TLOC - Explaining Elements ..................................... Monitoring Destination Statistics on Reptor ................................. Monitoring Entire Net-Work (WCP) - Mainframe ......................
103 104 105 105 106 107 108 109 109 110 110 110 111 111 112 112 113 113 114 114 114 115 115 116 116 117 119 119 120 121 122 122 123 124 124 125
Table of Figures Figure 152: Figure 153: Figure 154: Figure 155: Figure 156: Figure 157: Figure 158: Figure 159: Figure 160: Figure 161: Figure 162: Figure 163: Figure 164: Figure 165: Figure 166: Figure 167: Figure 168: Figure 169: Figure 170: Figure 171: Figure 172: Figure 173: Figure 174: Figure 175: Figure 176: Figure 177: Figure 178: Figure 179: Figure 180: Figure 181: Figure 182: Figure 183: Figure 184: Figure 185: Figure 186: Figure 187:
Entire Net-Work (WCP) - MainframeDiagnostic Utilities GCL) ................................................................. Monitoring Network - NetQoS ............. ............... ............... ........... Monitoring Network - Browser, GUt iPhone .............................. Monitoring Firewall Analyzer - ManageEngine .......................... Entire Net-Work (WCP) on Windows Log .................................... Natural Parse Program for WCP on Windows Log ..................... Adabas Command Log on Windows ............................................. Check NAß and RPL Overflow GCL) ... .. ......... .. .. .. ......... .. ............. Check NAß and RPL Overflow (Output) ...................................... SLOG Check on Reptor GCL) .......................................................... SLOG Check on Reptor (Input) .......... .. .. .. ......... .. .. .. ..... .. ............. .. .. SLOG Check on Reptor (Output) .................................................... Compare two SLOGs Open Destination GCL) ............................. SLOG Check for Logged Files ... ......... .. .. .. ......... .. .. .. ..... .. ............. .. .. Manual File Change Procedure - SLOG Check ............................ Monitor Program: SLOG Check for Logged Files - READF30P SLOG Number of Records and Space Check GCL) ........... ........... SLOG Number of Records and Space Check (Output) ............... Read Output Queue of ActiveJob - EJESLNK GCL) ................... Output of Natural Parse Program .. ........... ..................................... wcr, Network and Target DB Check - r ING - GCL) ................ SYSAOS ßatch - Display Reptor StatisticsDestinations GCL) .......... .............................. ............... ........... ........... SYSAOS Batch - Display Reptor Statistics - Destinations Output ... .......................... .............................. ............... ........... ........... SYSAOS Batch - Select one Destina tion - Output ....................... SYSAOS ßatch - Display Reptor Statistics Subscriptions GCL) .. .. .. .. .. .. ... .. .. .. .. ....... .. .. .. .. ....... .. .. .. .. ... .. .. ........... .. .. SYSAOS Batch - Display Reptor StatisticsSubscriptions - Output ..................................................................... SYSAOS ßatch - Select one Subscription - Output ... .. ............. .. .. Check RPL Flag GCL) ....................................................................... Adabas Report RPL Flag Check - (Output) .................................. RPL Flag Check Report - (Output» .. .. .. .. ......... .. .. .. ..... .. ............. .. .. Analyze wcr Log ............................................................................. Create and FTP an Adabas Report to a Windows Server ........... Create Adabas Report and FTPtoaWindowsServer ................. Analyze wcr Log (Source: SAG) ................................................... Optimize for Infrastructure (041) - Analytics Overview ............ Optimize for lnfrastructure (041) - KPI Subscription User Transaction .........................................................................................
XVII
125 126 127 127 128 128 129 131 131 132 133 133 138 138 139 139 140 141 141 142 143 144 145 145 146 147 147 149 150 151 151 152 153 154 159 159
XVIII Figure 188: Figure 189: Figure 190: Figure 191: Figure 192: Figure 193: Figure 194: Figure 195: Figure 196: Figure 197: Figure 198: Figure 199: Figure 200:
Table of Figures Optimize for Infrastructure (041) - KP' Destination Replicated Transactions ................................................................... Optimize for lnfrastructure (041) - Destination Adabas Calls Committed ............................................................................... Optimize for Infrastructure (041) - Total Replicated Transactions .. ....... .... .... ........... .... ........... .... ........... .... ........... .... ....... ... Adabas SAF Security (ADASAF) - Source: SAG .......................... Adabas Multi-dient File ................................................................... WCP Encryption - Source SAG .......... .. .. ....... .. .. .. .. ....... .. .. ... .. .. .. .. ... ADARUN Parameters Subscription Database .............................. ADARUN Parameters Reptor ......................................................... Adabas for Windows Parameters db251.ini ... .. .. .. ....... .. .. ........... .. . Adabas for Windows High Water Marks ...................................... Adabas for Windows ADANUC Activities .................................. Adabas for Windows Buffer Pool Statistics ... .. ........... .. .. ........... .. . Replication Process - Number of Commands per Second
160 160 161 164 165 166 170 172 174 175 175 176
(cps) ..................................................................................................... 177
Figure 201: Figure 202: Figure 203: Figure 204: Figure 205: Figure 206: Figure 207: Figure 208: Figure 209: Figure 210: Figure 211: Figure 212: Figure 213: Figure 214: Figure 215: Figure 216: Figure 217: Figure 218: Figure 219: Figure 220:
Replication Process - Number of Commands per Second Spreadsheet 1 ..................................................................................... Replication Process - Number of Commands per Second Spreadsheet 2 ............... .... ....... .... ........... .... ........... .... ........... .... ....... ... Monitor - Natural Program Ping Target Database ...................... Monitor - Natural Program Check DDPRINT Messages ........... Monitor - Natural Program RPL and NAB Overflow... ........... .. . Monitor - Natural Program SLOG Check Reptor ........................ Monitor - Natural Program Compare 2 SLOGs .. ........... .... ....... ... Monitor - Natural Program Analyze WCP Log ........................... Monitor - Natural Program Checksum ......................................... Monitor - Natural Program Compare Amount Fields ................ Monitor - Natural Program Parse ADAREP for RPL Flag ......... Monitor - Natural Program ISNHIGH - Check Highest ISN .... Monitor - Natural Program RPL30REP - SLOG Space Check ... Monitor - Natural Program READF30P - Read SLOG Content Monitor - Natural Program RPL-P002 - Compare File Components .. ........... .. .. .. ... .. .. .. ........... .. .. ....... .. .. .. .. ....... .. .. .. .. ... .. .. .. .. ... Monitor - WCP Log Windows ........................................................ RPL SOC4 Dump ................................................................................ Assembler Program Sleep/Wait .............. .... ........... .... ....... .... ....... ... RPL SOC4 Dump ................................................................................ EntireX V8.01 Parameters ................................................................
178 179 180 183 184 186 189 189 191 193 196 199 202 203 206 212 215 217 219 222
1
Replication Basics
1.1
Today's Challenge
In today's world you must keep your enterprise competitive and your customers happy, therefore, it is critically important that your business systems have instant
access to changed data. Same organizations copy their Adabas datahase data to a data warehouse or to a relational database (RDBMS) located on Linux, UNIX or Windows, and use offthe-shelf software to process the copied data. Time and cast savings are also reasons to access copied Adabas data on nonmainframe platforms. Some batch jobs ruo on these platforms faster and cast less compared with running them on the mainframe. But it can be awkward and timeconsuming to decompress the data, file transfer it to the open system, campress and reload it.
Other organizations duplicate their Adabas database for disaster and recovery using backups and even protection logs to be up-to-date. This data-copy procedure is only possible on the same hardware platform. Open transactions on protection logs or handling problems with back-ups can easily lead to a corrupted target database. A third-party software company supports this approach with protection logs and even copies mainframe ADASA V back-ups to non-mainframe platforms. New Adabas releases on the mainframe and non-mainframe platforms makes it difficult or even impossible to keep up with Adabas format changes. The drawback of these methods is that your customers do not have instant access to the changed data, and the data is not updated in real-time. Another way is to mirror on a hardware-level your data or disks. Although synchronized mirroring is an update in real-time, you do not have instant access to the mirrored data. In addition, disk data errors will also be mirrored. Companies who want to copy parts of a file such as sets of records and fields or field values to the target database must write programs for this approach and then maintain this homemade software. The most practical solution for these problems is the Event Replicator for Adabas, a highly flexible event-publishing tool that efficiently deli vers changed data in real-time from Adabas to Adabas and to any RDBMS or middleware. Only committed Adabas modifications on a transaction level will be asynchronously replicated. D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_1, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
2
1 Replication Basics
Event Replication tor Adabas on Mainframe Architecture
,,
-,
SO"P, HTTP, SMTP, JOYO, .""',
""\lvo,
1
,.,............ ~,,~
I ,~
Intel,atlon PI.tfo<m
wM Entir ..X
IBM MQSeris
1= ' 1
Figure 1: Architecture of Adabas Replication on the Mainframe - Source: Software AG
The following chapters explain in detail the replication process and its parameters, show the architecture of various replication models, and give YOll guidance for possible problems and their solutions. One chapter is dedicated to security and describes how to protect each level in yOU f replication path. Examples of parameters, Natural and assembler source code complete this book as a guide and support for Adabas replication questions. • • • • • • • • • • •
The difference between replication and mirroring: chapter 1.2 The reasons for replication: chapter 1.3 What to check before starting and avoid mistakes: chapter 1.4 Different ways to replica te: chapter 2 Definitions and parameters: chapter 3 Compare files of source and target - self-written programs: chapter 4 Recovery after a crash: chapter 5 Problems and solutions based on own experiences: chapter 6 Monitors - self-written and from Software AG: chapter 7 Security: chapter 8 Appendix - many programs and parameter examples: chapter 9
1.2 Replicating or Mirroring
1.2
3
Replicating or Mirroring
For many years, companies backed up their mainframe databases to tapes and stored them at a very safe place, sometimes deep in a mountain storage. In case of a recovery after a disaster, the computer center mostly could not receive the backup tapes because streets, tunnels or bridges are unusable and airplanes are not aUowed to fly. In other cases the packages sent by the posta! service arrived only with a few tapes. One missing tape out of forty backup tapes is no backup at all. From a security stand point unacceptable to lose sensitive data, such as social security or credit card numbers.
1.2.1
Mirroring
One possibility to eliminate the above mentioned problem with tapes is to mirror the data from one disk to another disk. Mirroring is based on microcode on a disk array controller or via server software. It is typically a proprietary solution and not compatible between various storage vendors. Examples are EMC 5700 or enterprise storage server ESS Shark from IBM on enterprise servers (mainframes). Using peer to peer remote extended distance (PPRC-XD) from IBM, data will be copied over thousands of mHes between two ESS Sharks. SYMMETRIX remote data facility (SRDF) from EMC mirrors synchronized data to a remote back-up site, where the source and the target storage can be located on an enterprise server (mainframe) or on an UNIX box. Benefits
• Asynchronous disk mirroring can provide better physical protection by supporting extended physical distances. • No loss of committed transactions in synchronous storage (mirroring/RAID) on a CPU failure. Limitations • No protection from data corruption. • Secondary site is not guaranteed to be transitionaIIy consistent, in the case of asynchronous mirroring. • Client application must be re-started after faHure and need to be aware of failure. • Synchronous mirroring and RAID devices can add overhead to application performance. • Redundant/specialized high availability hardware/software can be expensive and restricted to use for backup purposes onIy. • Secondary copy of data is not available for use - Iow hardware utilization. • Need to replicate everything on disk, no seIectivity of data replication.
1 Replication Basics
4
IBM's FlashCopy copies nearly instantaneously entire volumes to other volumes (snapshot). It sets pointers and copies tater the entire image of volumes. The TimeFinder funcHon from EMC works similar. The miefar funcHon must be very carefully used in regards to Adahas and Hs buffer pooL Updated blocks might be still in the buffer pool or disk l/Os are only partially done when the fla sh copy function is used . The new ADADBSTRANSACfIONS-SUSPEND function takes care of the buffer flush and new update commands synchronizing it during the snapshot function. Without the transaction-suspend function, the database must be down during flash copy to avoid a datahase corruption. Pre-defln&d
timewindow Suspend
Read only: update requests are queued Resume
Read
~.J. Source
Data
Source: SAG
ADADBS TRANSACTIONS SUSPEND,nSYN=60,TRESUME=120
Figure 2:
1.2.2
Mirroring - ADADBS TRANSAcnON SUSPEND Function
Replication
Mirroring is very often called replication. But there are two main differences, Mirroring copies the tracks of a disk or 1/0 blocks and the mirrored data cannot be direct1y used for read-onIy processes. Replication repeats the database transactions on the target site and the replicated data can be instantly used for readonly processes. Benefits
• Warm Standby systems can be configured over a Wide Area Network, providing protection from site failures. • Ability to more quickly swap to the standby system in the event of failure, as backup database is already on-line. • Data cormption is typically not replicated as transactions are logically reproduced rather than VO blocks mirrored.
1.3 Reasons for Replication
5
• Automatie switeh over for clients using a switching mechanism, no dient restart needed. • Originating applications are minimally impacted as replication takes plaee asynehronously after commit of the origina ting transaction. • The warm standby database is available for read-only operations, allowing better utilization of backup systems. • Ability to resynehronize and easily switch back to primary system when it becomes available without loss of data. • No need to replicate everything on disk, data ean be selected for replieation. Limitations
• Warm Standby system will be out-of-date by transactions committed at the active database that have not been applied to the standby. • Protection is limited to components supporting Warm Standby (e. g. DBMS data sources may be protected but file systems may not be supported).
1.3
Reasons tor Replication
In today's finandal environment, many companies and state and federal agendes look at migrating their core applications from the mainframe, Natural and Adabas to newer hardware platforms, database systems and programming languages Iike Orade, SQL database, Unix and .NET or Java . However, after a cost analysis, they cannot always justify the expense or get permission from their stockholders to spend a couple of million dollars just to be more in the trend.
There is no proof that such a migration leads to faster processing or is more seeure or even easier to use. They also do not take into account the cost of losing all of the expertise in Natural and Adabas and retraining staff members just to be more hype. I can remember back in the 90s, when companies were so proud to own an adaptable database system and a 4GL programming language. Programs developed on the mainframe could easily run under other hardware platforms, as Windows, UNIX, or 652000. Some organizations found it is faster and less expensive to program in Natural under MS Windows and use Single Point of Development (SPoD) to coordinate and transport programs between the mainframe and the pc. They decompressed relevant Adabas files on the mainframe, transferred them via FTP to the PC, compressed and re-loaded them into the Adabas da tabase running under Windows. They also found that some batch jobs using Natural and Adabas ran on a pe up to 90% faster and cost less money than on the mainframe. Surprisingly, some other jobs ran 100% slower but this could be that Adabas Fastpath, the optimization tool of SAG, is not available on the pc.
1 Replication Basics
6
[
-
1 ASSO
DUA
WOIK
Figure 3:
Reasons for Replication
._.
This type of replication was homemade, very time consuming and left the cast of decompressing jobs on the mainframe site .
Cop,. ef Productlon
o .....s.
ASSO
OAYA
WORK
Figure 4:
Homemade Replication
The next challenge was how to populate the tatest Adabas data faster from the mainframe to the pe in order to be up-ta-date. Replication is the buzzword and some companies advertise products to copy Adabas data by using back-ups and protection logs. Software AG offered to help with their product "Event Replicator for Adabas" to replicate data in real-time from the mainframe to Linux, UNIX and Windows.
1.4 Check Your Intentions Before Starting
7
For many years, companies have used the Event Replicator for Adabas to replicate for disaster and recovery, development, training. demos and Web access. Off-the-shelf software for non-Adabas databases requires leaving the Adabas databases on the very secure and stable mainframe and replicate its data to nonAdabas databases on Linux, UNIX or Windows (LUW).
1.4
Check Your Intentions Before Starting
1.4.1
Mirroling 01 Replicalion?
Chapter 1.2 explains the two main differences between mirroring and replication. Mirroring is often called replication. The updated blocks in the Adabas buffer pool that have not yet been written to the disks can cause problems for mirroring. Adabas read commands receive the updated information from the buffer pool if it is still not written by a buffer flu sh to the disko In contrast to the replicated data the mirrored data is not up-to-date. It is disk mirroring and not buffer mirroring. The replicated target has the benefit that you have instant read-only access to the in real-time delivered data. Can you take advantage of this benefit for your organization? The following questions should help you in yOUf decision process. You also will find in the following chapters detailed explanations to the most important questions about Adabas data replication. • 00 you want to use you r copied data in paral1el to your original database? You can run batch reports against the replicated database and save money, time, and decrease mainframe workload: see chapter 1.3. If the answer is yes, you must use replication. • 00 you accept the possibility that errors in disk tracks or blocks are copied to the target? Mirroring might already be supported by your hardware (raid technology). If you have a micro-code problem on your source disk and would like to switch your production over to your mirrored target database this won't help because the error was mirrored . There might be an error recovery possible bu t it will take time. If you accept these errors then mirroring can be the solution. • 00 you want the Adabas transaction to be asynchronously repeated in near real-time on the target database? If you want to use your replicated data instantly then you must use replication.
8
1 Replication Basics
1.4.2
Usage 01 Replicated Database
It is important for yOll to decide what to do with your replicated Adabas database
after it is copied from the mainframe. Chapter 2 explains different ways to replicate • General requirements, basics: chapter 2.1. • From Adabas to Adabas on the mainframe: chapter 2.2. • From Adabas on the mainframe to Adabas on Linux, Unix, or Windows: chapter 2.3. • From Adabas on the mainframe to non-Adabas on Linux, Unix, or Windows: chapter 2.4. The following questions should help you in your decision process. •
•
•
•
•
00 you want to provide areal-time database for disaster and recovery and replicate your Adabas database from the mainframe to another Adabas database on the mainframe? Even if it is a replicated database for disaster and recovery, the data can be used instantly for read-only accesses. lf the answer is yes, you must use the Event Replicator of Adabas. See chapter 2.2. 00 you want to reduce the mainframe costs and replicate in real-time your Adabas database from the mainframe to Adabas on Linux, UNIX or Windows? lf the answer is yes, the Event Replicator of Adabas is your choice. See chapters 1.3 and 2.3. 00 you want to create or support a data warehouse with real-time data from your Adabas database on the mainframe? Software AG supports data warehouse appliance vendors and their database architectures, such as for 062, MS SQL Server, MySQL, Orade, Sybase, Sybase ASE, and Teradata. lf the answer is yes, you must use the Event Replicator of Adabas and its target adapters. See chapter 2.4. 00 you want to replicate your Adabas database from the mainframe to Linux, UNIX or Windows to a non-Adabas database so you can use yOUT off-the-shelf software, which is written for relational databases only? Software AG supports several target adapters, such as for 062, MS SQL Server, MySQL, Orade, Sybase, Sybase ASE, and Teradata. lf the answer is yes, you must use the Event Replicator of Adabas. See chapter 2.4. 00 you want to keep your sensitive data on the secure and stable mainframe and use YOUT existing message-oriented middleware such as MQSeries to copy in real-time alt or parts of the data to a RDBMS on the open system? lf the answer is yes, the Event Replicator for Adabas is the best solution. See chapter 2.4.
1.4 Check Your Intentions Before Starting
9
00 you need Entire Net-Work (WCP) in order to replicate Adabas data from mainframe to mainframe or to Linux, UNIX, or Windows? You must use Entire Net-Work as a broker funcHon. You cannot use webMethods EntireX. For me it makes more sense to use one broker function to replicate Adabas to Adabas and Adabas to non-Adabas databases. In contrast to Entire Net-Work, webMethods EntireX has Hs own reliable safety mechanism (persistent store). See chapter 2.2. • 00 you need a message-oriented middleware, such as MQSeries, or a broker function, such as webMethods EntireX? 00 you already use a broker function and Natural RPC getting mainframe Adabas data from a non-mainframe platform? See chapter 2.4. •
1.4.3
Measure/Compute and Determine Your Needs
Moving through the process on the way from the subscription or saurce database to the destination or target database must be passed, such as middleware, broker, network, router, and firewall . Parameters and the bandwidth of the circuit have to be detennined or adjusted. It is therefore a good idea to detennine your needs before you start with replication. The following questions will heIp to determine what information is important to collect and you wiJI find the answers in chapter 3. • How many Adabas modification commands (new, delete, update) do you expect per second? This information is important to detennine buffers in Entire Net-Work as weil as apart of the fonnula to determine the bandwidth (Mbps) to be used for the connectivity. See chapter 3.1. • How long are the record (RB) and format buffers (FB) per Adabas command? The number of commands per second is part of the formula to determine the bandwidth (Mbps) to be used for the connectivity. See chapter 3.1. • What line speed (circuit) and what type of connection do you need between the mainframe and Unux, UNIX or Windows servers, such as 0C3 or IPSec VPN tunnel? The line speed is crucial for the in real-time replication and shouId be determined for peak times. See chapter 3.1. • 00 existing lines have sufficient speed and are they shared with other applications, such as Web sites or ftp processes? If you calculate a line needed for 20 Mbps then an OC1 line with 51.8 Mbps can be too slow if used also by other applications. And keep in mind that the replication process sends back an acknowledgement to the Replication Engine. A duplex circuit would be a benefit. See chapter 3.1. • Are the Adabas modification commands send from batch and/or online programs? Batch programs send Adabas commands faster than online users can hit the enter-key. The number of Adahas commands is important to determine
1 Replication Basics
10
buffers in Entire Net-Work as weil as apart of the formu la to determine the bandwidth (Mbps) to be u sed for the connectivity. See chapter 3.t. • How many Adabas files should be replicated? The number of files per transaction is a factor in the formula to determine the number of attached buffers (NAß) of the Replication Engine. The Replicator Engine keeps all file updates of one transaction before sending them to the target database. See chapter •
3.3.4. 00 you plan to replicate only same fields of a file? The throughput of data rep-
lication to Adabas destinations is improved with version 3.3. SPl of the Event Replicator for Adabas by filtering format buffers. New parameters allow to specify before (SFFILTERGFBBI) and after-image (SFFILTERGFBAI) format buHers. This will reduce the decompress process time of the entire buHer. See chapter 3.3.9. • How many records per file? This information is important to determine the time needed for the initial-state process. Files with over 100 million records can take hours. The initial-state function reads record by record and sends store-with-ISN commands (N2) to the target database. Tests showed that based on an Adabas command log on Windows a fast connection can replicate approximately 300 Adabas commands per second. See test results in appendix, chapter 9.4. • 00 you need additional broker software, such as EntireX or Entire Net-Work?
1.4.4 Avaid Mistakes Ouring many years of experience with replication for Adabas V3.2.1, Iran into some problems and would like to help you to avoid the following mistakes. Problems and solutions are explained in chapter 6. •
• •
•
•
00 not create your replicated database on a pc, use a server instead. A local drive (C-drive) on a PC might not handle the traffic, use disk arrays and raid technology (RAID 5) in a SAN box to store the replicated database. 00 not log or trace your replicated data in a production environment. Oepending on the volume of replicated data, it can slow down the replication process. 00 not log the before image (OSBI=OFF) if it is not necessary. It is an overhead in data transfer between the subscription database and the Replication Engine. Chapter 3.2.3 shows the AOADBS commands. 00 not use slow lines (circuits) as a connection between the mainframe and open system servers (Linux, UNIX, Windows). A data traffic jam can affect the subscription database and the Replicator Engine, such as CPU time, buHer and SLOG overflow . See chapters 6.2.2 and 6.2.3 for more information . 00 not define your Adabas and replication buffers too smalL It can stop the replication process on the subscription database because there is no overflow area. Only the Replicator Engine has such an area (SLOG).
1.4 Check Your Intentions Before Starting
11
• Define your SLOG large enough to keep the replicated data for a couple of days if the target database is temporarily not available. lnitial-state and/or the REPLA Y function are necessary to restore the missed data. • 00 not underestimate the time you will need for the initial-state process, especially if files with large amount of records are involved. Attachment chapter 9.4 gives you an idea of commands per second (cps) going through all the replication components. • Keep in mind that one Replicator Engine may not be sufficient. The number of update commands per second, the number of files in one transaction, and the number of files to be replicated are responsible for the decision. • 00 not replicate files without a valid destination. It can be a big task to c1eanup the SLOG file during an ongoing replication process. See chapter 6.2.9. • 00 not wait to install monitor routines or software to check error messages or response codes reported on the subscription database and Replicator Engine (DDPRINT) - especially for ISNs not replicated. Chapters 4 and 7 explain how to compare and what monitor routines are available. Plan to have routines in place when file changes must be applied during a program migration. File change replications from Adabas to Adabas won't be done automatically in some cases. Chapter 6.1.5 explains in detail what to do.
2
Different Ways to Replicate
2.1
General Requirements I Basics
The subscription (source) database with the data to be replicated and the replicator engine or Reptor to receive and edit the updates for the destination (target) database are necessary.
Both datahases the subscription and the Reptor contain one replication buffer (RPL), defined with the parameter LRPL. Other buffers, also known from regular databases, play an important role during the replication process, such as the Adabas buffer pool (LBP) and the 1/0 pool (LFIOP) for asynchronous buffer flu shes.
I Subscription
RPL Suffer
l
lBP Buffer!.
-'~ r
110
Buffer
I /J
Replication Engine
-
Oatabase Adabas
=
Raplor Adabas
S V C
-
ASSOfOATA
Figure 5:
,
Mainframe
RPl Butrer D
,
~BPB"ffejj
•,
m
•
110 Buffer
~ RPL
SYSTEM
I
"\S: SLOG
General Requirements - BuHer Usage
In addition to the mandatory Adabas system file, the following files are part of the Replicator Engine (Reptor): • Replication system file that contains the replication parameters, such as descriptions of destinations, subscriptions and the global formats (GFB) . • Subscription log or SLOC file as the overflow area of the replication buffer should also be defined. D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_2, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
2 Different Ways 10 Replicate
14
• A transaction log (TLOG) might also be used for performance and tuning. It is the command log of the Reptor and should not be activated at a regular replicaHan process because of the overhead in the system.
Chapter 3 describes the parameters for each database and chapter 6 explains problems and solutions for incorrect defined buffers and parameters.
2.2
From Adabas 10 Adabas on Ihe Mainframe
The repUcation from an Adabas database on the mainframe 10 another Adabas database on the mainframe is mostly used from companies 10 build a back-up database in real-time for disaster and recovery (DIR). In contrast 10 a mirrored database, the replicated database can be used at any
time in parallel 10 the original database in read-only mode. In a case of DIR all applications can be switched directly to the replicated database and used in read and update mode. The following components are necessary to replicate:
I SubscriptiOf1
Database Adabas
Figure 6:
I
Mainframe
=
Replicator Engloe Adabas
I
Entire
Net·
W""
I :
Target Dalabase Adabas
Replication from Adabas to Adabas on the Mainframe
Source or subscription database
Additional Adabas parameters must be defined and existing ones updated. For more information see chapter 3. Replicator Engine or Reptor
This is a basic Adabas nudeus loading at start·up some additional replication modules. Adabas parameters should be set·up at least with the same values as the source or subscription database. For more information see chapter 3. In addition to the known Adabas system file, the following files are part of the
database • Replication system file that contains descriptions of destinations, subscriptions and the global formats (GFB) .
2.3 From Adabas on the Mainframe 10 Adabas on Linux, UNIX or Windows (LUW)
15
• Optional subscription log or SLOG file as the overflow area of the replication buffer. Entire Net-Work or WCP
Entire Net-Work is also called WCP to differentiate between Net-Work and Network. wep is acting as a broker and passes Adabas direct calls including its buffers to the target database, such as control block, record buffer, and format buffer. For a description see chapter 3 and Figure 12. You must use at this time Entire Net-Work as a broker function to replicate Adabas to Adabas. You cannot use webMethods EntireX. For me it makes more sense to use one broker functio n to replicate Adabas to Adabas and Adabas to nonAdabas databases. In contrast to Entire Net-Work, webMethods EntireX has its own reliable safety mechanism (persistent store). If a connection to the target is no longer available and using Entire Net-Work the transaction will be stored in the subscription log (SLOG) of the Replicator Engine. EntireX will save the transaction in its persistence store, allowing the system to recover to a known point without loss of data.
I had discussions with Software AG and they promised to discuss intemally the approach using also EntireX for Adabas to Adabas replication. Target or destination database
The Adabas target database receives Adabas direct calls from the Replica tor Engine through Entire Net-Work (WCP). Values of parameters and buffers should be set in the same way as for source or subscription database.
2.3
From Adabas on Ihe Mainframe 10 Adabas on Linux, UNIX or Windows (LUW)
The replication from an Adabas database on the mainframe to another Adabas database on Linux, UNIX or Windows is used by companies who use the replicated database to save time and costs for their batch processes. Accessing the replicated database in read-only mode from the Web can also eliminate using networks with all its components between the mainframe and Web servers.
16
2 Different Ways 10 Replicate
The foll owing components are necessary 10 replicate:
I
II
Mainframe
SubScription Database Adabas
Figure 7:
I :
Replicator
Engine Adabas
=
Entire Net·
Wo,
WCP
Network
Firawall ROut8rs Circuil
eie.
II
Linux , UNIX, Windows
Entire Net·
Wo,
WCPIWCL
;=
I
Target Dalabase Adabas
Replication from Adabas 10 Adabas on Linux, UNIX or Windows (LUW)
Source or subscription database
Additional Adabas parameters must be defined and existing ones updated. For mOTe information see chapter 3. Replicator Engine or Reptor
This is a basic Adabas nucleus loading al start·up same additional replication modules. Adabas parameters must be set-up al least with the same values as the source or subscription database. For more information see chapter 3. In addition 10 the known Adabas system file, the following files are part of the
database • Replication system file that contains descriptions of destinations, subscriptions and the global formats (GFB) . • Optional subscription log or 5LOG file as the overflow area of the replication buffer. Entire Net·Work or WCP on the mainframe
Entire Net-Work is also called WCP to differentiate between Net-Work and Network. WCP is acting as a broker and transmit Adabas direct calls induding its buffers from a dient to the remote Adabas target database. The buffers indude the Adabas control block, record buffer, and format buffer. For adescription see chapter 3 and Figure 12. Network
The network with its components, such as lines or circuits, firewalls, routers and load baJancing system, connects WCP on the mainframe with WCP on LUW. Entire Net-Work or WCP on LUW
WCP on LUW ships Adabas calls from a dient to a database through WCL
2.4 From Adabas on the Mainframe to Non-Adabas Databases
17
Entire Net-Work Client or WCL on LUW
An Entire Net-Work Client uses the Entire Net-Work 7 e-business message protocol to access Adabas d atabases. The dient must be installed on any machine from which you wish to access Adabas databases. A Directory Server is needed to store management data for Entire Net-Work in the form of Universal Resource Locator (URL). Target or destination database
The Adabas target database receives Adabas direct calls from the Replicator Engine through Entire Net-Work (Wep). Values of Adabas parameters and buffers should be set in the same way as for the source or subscription d atabase,
2.4
From Adabas on Ihe Mainframe 10 Non·Adabas Dalabases
The replication from an Adabas d atabase on the mainframe to non-Adabas database on Linux, UNIX or Windows is used w ith the replicated database for off-theshelf software or to replicate further with non-Adabas database replication software, The following components are necessary to replica te:
I
II
Mainframe
Subscripton Dalabase Adabas
Figure 8:
=
Replicator Eng ine Adabas
=
"
Entire X Broker
MQSeries Queues
1=
Networl< Firewalls Roulers Circuit ~, .
FirewaHs Routers Cireuit eie.
II 1=
linux, UNIX, Windows E~'
ReplicatOf Target Adapter
I
Targel Dalabase
~ Oracie , SOL, SYBASE, ete,
JL 1=
MQSeries Queues
'GM
Read Queues Save 10 OB
Replication from Adabas to non-Adabas Oatabases
Source or subscription database
Additional Adabas parameters must be defined and existing ones updated. For more information see chapter 3.
18
2 Different Ways 10 Replicate
Replicator Engine cr Reptor
This is a basic Adabas nucleus loading at start-up same additional replication
modules. Adabas parameters must be set-up at least with the same values as the source or subscription database. For more information see chapter 3. In addition 10 the known Adabas system file, the following files are part of the database
• Replication system fil e that contains descriptions of destinations, subscriptions and the global formats (GFB) . • Optional subscription log or SLOG file as the overflow area of the replication buffer.
EntireX Broker (wM EntireX) on the mainframe
EntireX is a message-oriented middleware with broker function. WebSphere MQ (message queue) on the mainframe
MQ is a message-oriented middleware from mM transferring data under the control of a queue manager from point A to point B. One company replicates approximately 50 files from the mainframe over to MQ queues where back-end distributed programs drain the queues and populate to Sybase tables. WebSphere MQ (with IBM WebSphere MQ Client Attachment Feature enabled) can also use the Event Replicator Target Adapter to replicate data to a relational database. Event ReplicatorTarget Adapter on Linux, UNIX, or Windows (LUW) It is necessary to communicate with EntireX Broker on the mainframe and replicate to the non-Adabas target database. The adapter transforms and applies replicated Adabas data to a relational database, such as DB2, MySQL Server, Sybase, or Teradata.
Target or destination database(s)
Any relational da tabase, such as DB2, MySQL Server, Sybase, Teradata, and O rade. Program 10 empty the MQ queues It needs a program to empty the MQ queues and write it to the target database if
WebSphere MQ was only used as a message-oriented middleware (MOM).
3
Definitions and Parameters
3.1
Getting Started
It is necessary to get the following information before YOUf start:
Source database ADARUN parameters, especially • • • • • • •
LBP, the Adabas buffer pool LFIOP, <25% of LBP, the Adabas 1/0 pool, regarding number of buffer flushes NAß, the formula in the manual is not corfeet, can cause NAß overflow LRPL, size and how to avoid overflow - there is no SLOG ASYTVS=YES, asynchronous Val-Sec I/Os FMXIO=>l, parallel LFIOP 1/05 REPLICA TION=YES
Replicator Eogine or Reptor ADARUN parameters, espedally • • • • • • •
LBP, the Adabas buffer pool, at least the same as the source database LFIOP, the Adahas 1/0 pool, <10% of LBP, regarding number of buffer flushes NAß, the formula in the manual is not corred, can cause NAß LRPL, size and how to avoid overflow - there is no SLOG ASYTVS=YES, asynchronous Vol-Ser I/Os FMXIO=>l, parallel LFIOP I/Os REPLICA TION==NO
Replicator Engine or Reptor SYSRPTR parameters, especially •
LOGINPUTIRANSACf=70, threshold of RPL buffer before using SLOG
Entire Net-Work (WCP) server ADARUN parameters (mainframe) • PROG=NETWRK • TARGETID= unique within the NET-WORK • NAß= not lower than Reptor OB • LU=250000, not lower • NC= number of commands, for example 2000 Entire Net-work (WCP) dient parameters (Windows) Hardware for Adabas on Linux, UN IX, Windows • •
Server, not a PC Disk arrays I storage area network (SAN), not the C-drive
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_3, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
20
3 Definitions and Parameters
Bandwidth of the line/circuit between the mainframe and Windows • Depends of the number of bytes and commands to be sent to the target database
• Best should be a ] 00 Mbps duplex circuit. Tests with two 60/70 Mbps circuits using IPSec VPN tunnel were not very successful regarding the speed. To determine the bandwidth of the circuit, the number of bytes passed through Entire Net-Work to the target must be know n. The following Apas/lnsight re-
quest RBLSUM is very helpful to calculate.
-
DBID 000311 RBO RBLSUM
m
,,
..
2010-08-26 TDIZ 13:.f9: 07 Ta 16:"3 111 LlNE
,---------- ---------------- ---------
"" " ,."" """ "" "" """ "" ""
~
,
~
sO,01l5 8,028
357 ,788
77 ,915 36,527 89,335 228,078 353,108
'"
36,770 3,351, 57 0
'"
4,939 7,595 252,291 25 , 243
'"
6 , 314 71 0,645 9,082
.
,~
,
3,515 2 , 444 , 411
~
~
,~
~
~
~
1 0725 2 00 1 1247
8 ,373,20 4 691,U3,928 17, 4 H,475 19,468,891 4,645,420 99 ,213 , 930 43,079,176 45 ,212 64,273,960 269,795,179 29,UO 938,410 1 , 982 , 295 90,377,244 5,149,572 38,402 774,982 H7,611,060 1,271,480
"
~
m
, ----------------, ---------
0.00
86,100,300 10,725 . 00 715.933,188 2,001 .00 33,958,710 435.84 28,381,479 "7 .00 8,933,500 100 . 00 111,530,142 489 . 00 69,lU,9H 193.00 256 ,086 1 , 320.03 1 00,345,330 2,729 .00 991,290,269 2 92.7 9 86,327 1 73.00 7,161,550 1,450.00 2,035,460 268.00 143,011,305 566 . 85 5,477,731 217 .00 64,669 122 . '9 1 ,059,236 1 67.76 1 5 2,6U, 509 214.97 10,135,512 1,116.00 270 . 00 735,950 209.37 2,001,972,609 919.00
, O.
",
'" '"
'"
1524 2729
'" '" '" '" '" ,".
1450 1075
..
1116
'"
'" '" '"
'"
533,955 1 ,7",753,865
0.00 1,OU.DO 1 ,906.00 223.89 533.00 52.00 435.00 122.00 233.05 1 ,748.00 80 .50 60.00
'" "" '" '" "" ".
72.73 122.74 235. 86
'" "
'" "" '" '" "
~
m
,
1043 1906
'" '" " '" '" '" '" " '" '" '"
1749
". ". '" '" '" '" '"
1021
Determine Length of RBL and FBL
Figure 9:
The fo llowing is an example of batch traffic by determining the number and type of commands using the performance monitor Apas/Insight from CA. ~.
~n
100315 100315 100315 100315 100315 10031 5 100315
M
19 19 20 20 20 20 21
Figure 10:
=
"'" ---------- -----------,~
M
~
7B 79 80 81 82
874,107 1,488,111 1 ,517, 170 1, 581,223 1 ,467,842 740,750 11,484
.."
~
~
,-,
,~
~~ ~,
~
" -----------,-" ,• """ ,, ," ,
11.4 19.4 19 .8 20 . 6 19 .1
11.2 18 .9
0.>
0.>
...
Determine Number of Commands
,~
~
~
" --------------755,656 1 ,278, 291 1,324,734 1,396,234 1,318,48a 697 ,74 9 9,958
21
3.1 Getting Started
Update - "Al" D
Figure 11:
- 5,250,944 107,254 - 8,207,106 533 - 1,912,246 13,565,304
(.xe1~ng
ET
~
BT)
Determine Type of Commands
Regarding the number of bytes to be replicated, the replication process will send the following data through the line. Keep in mind that only update commands will be replieated : no seareh, value, or ISN buffers are used. The following formula shows that for file 44, at least a 17.3 Mbps line is needed. CBL • Adabas eontrol block 1.ngth RBL _ Ac:Iab.s r.cord bu.f:f:.r 1.ngth FBL • Adabas tOra&t buf:f:.r 1.ngth :an _ bit. per byt. _ 8 Number ot c: ......... nd. per •• c:ond to be replic:.ted • 1 , 400 (12 byt•• + CBL + RBL + FBL) • BPB Hax value per c:ommand tor tile 7 - only 8,028 commands): (12 + 10725 + 1906) • B _ 101,144 bits * 1,400 • 141.6 Mbp. Mo.t c:oaasnd
Figure 12:
(ne. d s t l •• s t s uch bandwidth)
Computation for Mbps Bandwidth
Source database in general • How many gigabytes of data (ASSO and DATA) • How many files to be replicated Expeeted traffie • 1,500 update eommands per second are eonsidered to be high • Traffie from online and/or batch Figure 13 shows the used software versions for tests. The target Adabas database was upgraded to V6.2. It also shows the path from .NET Web programs on Windows to aeeess Adabas data on the mainframe using EntireX Broker and RPC Server. lf the replicated database ean be used for read-only Web aecess then EntireX Broker on Windows would be suffident.
22
3 Definitions and Parameters
OB
8.1 .3
6.1.8.03
RPL Buffe,
CSlZOOl
NATN ....... 2.3
Entll'9X RPC Server
,
EntlreX Broker ~~~ 8.0.1
FNAT 4.2.4.3 RPC 6.2.3.1
Wi .... dO\NS
Mainrrarne
Figure 13:
3.2
Used Software Versions
Source or Subscription Database (V8.1.3) Meinffame
Subsctiption Catabase Adabas
RPL Buffer11 LBP BufferU
110
Buffer
I.iJ.
Repliclllioo Engine
...
Reptor Aclabas
s
l~
,,-_
n
RPL BUffer
,
:
~
nLBP BUfferU.
i h;o---l -B~ffer I
\'c7! ASSO/OATAj
Figura 14:
Buffer Usage in Subscription Database
RPl SYSTEM
SLOG
3.2 Sou rce or Subscription Database (V8.1.3)
3.2.1
23
Workload Manager (WLM)
The subscription or source database must have the same priority as the replicator engine (Reptor) . Source SAG: "If an Adabas nudeus gets generally CPU constrained, that is it approaches the
processor capacity limit and if you are not yet ready to try Parallel Services then put this nudeus into SYSSTC or into a low service dass of high importance. Adabas can ill afford to get preempted out of the processor. lf Adabas processes a substantial share of calls originating from batch during high online periods put Adabas into a higher service dass of somewhat lower importance than the response time goals of the TP monitor. However this is not recommended, when the TP monitors concurrently executes transactions, which access other databases like OB2. A high CPU consumption in OB2 could then delay transactions doing Adabas calls! With not much batch activity during online periods Adabas and crcs could be in the same importance service dass."
3.2.2
ADARUN Parameters
Besides the most important parameters for performance (LBP, LFIOP, NAB, ASYTVS and FMXIO), the following parameters must be defined in addition for the replication process: Source database ADARUN parameters, especially •
ADARUN REPLICA TION=YES
This parameter loads at start time of the Adabas nudeus the repIication moduleAOARPN . •
ADARUN LRPL=700M.
The RPL buHer holds the compressed data to be replicated and should be defined larger than LBP and large enough to avoid an overflow because on the source database does not exist an overflow area (SLOG). • RPLSORT=YES (default) Transaction data are sorted by a key consisting of the fUe number, ISN, and relative update number. All modifications for a given ISN in a file are consolidated before replication occurs. If you do not want to sort to occur, specify RPLSORT=NO.
• RPWARNINCREMENT=1-99 (10 default) Warn increment that indicates that the replication pool usage has exceeded the threshold set by the RPWARNPERCENT parameter. • RPWARNINTERVAL=xxx (60 seconds default) Suppress waming messages after xxx seconds.
24 •
3 Definitions and Parameters RPWARNMESSAGELfMIT=xxx (5 default)
The number of RPL pool usage waming messages that can be issued to the console before message suppression begins. •
RPWARNPERCENT=O-99 (0 default) The threshold for RPL pool usage at which warning messages should be sent.
Appendix, chapter 9.1 and 9.2 shows the ADARUN parameters of a source database used by a company with 57 subscriptions spread across 4 LPARs running on 8 separa te Replication STes.
3.2.3
ADADBS Replicate Files
Run also the ADADBS utility to turn on the files to be replicated and turn off the overhead of the before image log (DSBI). ADADBS REPLICATION FILE=006,ON,T ARGET~302,DSBI=OFF ADADBS REPLICA TION FILE=fnr,ON,T ARGET=reptor-db,DSB1=OFF ADADBS REPLICA TION FILE=fnr,ON,T ARGET=reptor-db,DSBI=OFF ete.
The Adabas report displays the repUcation status of the files and how the before image of updates has been set. In the below example, DSBI was set to the default value ON: 'Collect before images of updates = Yes: In later tests, it was set to OFF. e.nip) .................................
• • • ••••••••••••••••••••••••••••••••• ,
(ST-ADA-CALC-EIlAT)
2010-03-0~
13:5~ : 15
LOB f i l . No Cont-in LOB fi. ld . NO RPLUPDATEONLI
No
Fil. i. replicated : Raplicator targ. t
Coll. ct hafo.,. e.nip)
Figure 15:
ID
~9..
ot update.
• I ••
302
Replication Status in Adabas Report
It is very time consuming to manually check the report of the replication settings
for example 200 files. I wrote a parse program in Natural, which displays these flags in areport. See also the chapter describing self-written monitor tools: 7.2.10.
3.3 Replica lor Engine - Replor (V8.1.3N3.2.1)
3.3
25
Replicator Engine - Reptor (V8.1.3N3.2.1) Mainframe
SubSCfiplion Database Adabas RPl Buttern LBP BulferU
r--
=r~
~ /1
Buffer
Figure 16:
3.3.1
-
RepliCation Engine Replor Adabas RPl Buffer
,-
,
•, •
m
n
~LBPBi~U '0
Buffet
.'%-LL
\\
ASSO / DATA
SYSTEM
RPL
'\\ SLOG
Buffer Usage in Reptor
Workload Manager (WLM)
The source database must have the same priority as the replicator engine (Reptor). SourceSAG: "lf an Adabas nudeus gets generally CPU constrained, that is it approaches the processor capacity limit and if you are not yet ready to try Parallel Services then put this nucleus into SYSSTC or into a low service dass of high importance. Adabas can ill afford to get preempted out of the processor. lf Adabas processes a substantial share of calls originating from Batch during high online periods put Adabas into a higher service dass of somewhat lower importance than the response time goals of the TP monitor. However this is not recommended, when the TP monitors concurrently executes transactions, which access other databases like OB2. A high CPU consumption in OB2 could then delay transactions doing Adabas calls! With not much batch activity during online periods Adabas and CICS could be in the same importance service dass."
26
3 Definitions and Parameters
3.3.2
SLOG File
The subscription log file (SLOC) is an Adabas file and is used as an overflow area if the threshold setting of Reptor's RPL buffer (LRPL) is reached. The size should be targe enough to hold a couple of days not replicated updates (transactions) if the destination is not available. Many companies reserve an entire 3390 pack for theSLOG. 2011-01-05
. . . . . A D A B A S BASIC SERVICBS . . . . . - Di . pIey ril" wyout -
13 :59: 16 DBtD 312
**** •• • •• •• •• •• •
PDIU'042
•••••••••••••••• Reoord
i12665
TOP ISM Ha>< ISN . _ " , ud Minimwo ISM Si". or ISN ..•.. NWIIbe" of Updat.. ISN Reu •• q a .
912661 20000079
Sp • .,.
R
ADAM l'i1 • ••••••• Ciphar..:!. F ile . .
Coupled ril • • • . . Blk per DS Satant
Ha>< Cotapr Re" Lnqth
2009-10-03 13 : 49 : 49 2011-01-05 13:28 : 38 50'0
~.o/D.ta
1\11\
Date loaded .. . O.ta o! l •• t updata
......
.. Elyt.. 15117738
Padd1ng
High •• t Index :t.e".l P.l'LUPOATZONLY . No USERlSN No MIXDSDBV . . No Spanned rec •• No Raplic:ation .. No Uni~ . r ••1 Encodinq
No No
,,
•
lndx Comp
...
No NOACEXTZNSION No NUlPE indic.. .• 1 Pri"ileged U.. No PGMREntESH
..- ..
...
Blk per VI Ext.nt Blk per NI Bxt.ont o Multi Cli.nt Pile 0 I'r. . .~". .~.ilabl. f'or f'il • • x t.nt.: At 1 ••• t 134 Extent.
,, , " . . "",
,, ,,, '"" ,, ,
, .=ß , ,
$p.c • • 11oe.ted 1 Unu .ed Elloek. I Cyla. ~ ~ I Cyla. ----1--------1-------------------1 ------------------------1-----------------~.
LU
MOO' 33110 MOO' 3390 MOO' 33110
un Nn
23585 135000 1 080000
.. 000
33110
,n
2250000
15000
,
~m
Figure 17:
~,
,
1221176 1082"7 2"7
'"
...,
12"760 1 1217 .... ' 1 1082"" 1
134811 1065256
31145
2250550
1860"11
12 .. 03
,,
SUX:; File Shown in Adabas Report
Once transactions have been written to the SLOG system file, the Event Replicator Server processes them using a throttling mechanism so that only a limited amount of RPL pool space is used at a time.
3.3.3
Replication System File
The Reptor's system file is an Adabas file and holds all definitions of subscriptions, destinations and global formats for each file to be replicated. This information can be unloaded and reloaded with the utility ADARPD that is loca ted in the Natural library SYSRPTR. During the Reptor' s start, all information from the system file will be read into its internal memory .
3.3 Replica lor Engine - Replor (V8.1.3N3.2.1)
27
Parameters can be changed with two different utilities: • SYSRPTR - ADABAS EVENT REPLICATOR SUBSYSTEM changing permanently values in the system file. • SYSAOS - changing temporarily values in the internal memory. After each change in the system file, the refresh function must be executed to upda te Reptor's internal memory. See Figure 15 - Buffer Usage in Reptor.
3.3.4
ADARUN parameters
ADARUN parameters for the Replicator Engine or Reptor, especially • LBP, the Adabas buffer pool, at least the same as the source database; with SLOG file, data will be written and read . • LFIOP, the Adabas UO pool. <10% of LBP, to avoid long waiting time during buffer flushes; see also ASYNTVS and FMXIO. • NAB, the formula in the manual is not correct, can cause NAB overflow . The number of files in a transaction must be inc1uded into the formu la: 410 x number files in one transaction. • LRPL, define larger size as LBP, at least define the same size as on the source database. To use SLOG as an overflow area, a threshold should be set by using the parameter LQGINPUTTRANS. • ASYfVS=YES, asynchronous Vol-Ser UOs; data to be written and read from the SLOG file. • FMXIO= >1, parallel LFlOP UOs, determine the value after discussing with your system programmer (most organizations: 6-8). • REPLICA TION",NO, YES should only be used for the source database. • LU=200000, unload and load Reptor parameters for more than 150 files need this value. • NT= greater than or equal to 15. • NC", greater than 10; the maximum number of elements in the command queue. • NU", greater than the maximum number of users desired; each destination creates one UQE. • RPLPARMS=FILE, the replication parameters are read from the Replicator system file. • RPWARNINCREMENT"'1-99 (10 default) Warn increment that indicates that the replication pool usage has exceeded the threshold set by the RPW ARNPERCENT parameter. • RPWARNINTERVAL=xxx (60 seconds default) Suppress waming messages after xxx seconds.
28
3 Definitions and Parameters
Example of Reptor ADARUN parameters: ADARUN ASYTVS_n:S ADARUN lFMZ..lo- S
ADARUN CT>o180
CCHO.ND LrKIT TIHB
ADARUN D810-200
DATABASE ID NUNNBER POR REPTOR
ADJUUJN DEVI(:E- 3390 ~w
LBP-150OOOOOO
~w
LFP-300000
LEN BUFR POOL UM INTZRNIU. n
~w
LDBugP-I00000
LEN 01' UNlQUZ DBSCRIPTOJI. POOL 151t>100P; 3/B/Ol
LPIOP-13000000 L1:_ 12000
LEN 01'
~w
~
ALLOW ACCESS !'ROM OTHBR NBT-WOP./t NODBS
~w
LOGGI_nS
LOG BASIC ADALOO RECORO
~w
~m
~w
""_NO
~w ~w
~w
~w
urne"
POOL
BUI'R FLUSH POOL
LEN :IBN LJ:ST 'fABLE
JICB
LOGm-ns
LOGSB-YES
~w
~m
~w
LOGla-NO
~w ~w
LOGIo-OO LP-8000
•
~w
LWlU'2_S000
WORJI> PART 2 JD 1/1B/l
~w
LQ0020000
L1!NGTH 01' SEQUEN'l'IAL
SORT
~w
L5_150000 L0-200000
~w
1MP-500000
LENGTH 01' WOlUI: POOL
~w
+
ADARUN M:lDE-e«JLTI
PRQ'rECTJ:ON BLOC:KS -
~
40>60>150
WOJUI;:
PART 1 - .;ro 1/18/1
~
~R
TJIBLZ
RPULD 2/17/10
INTBRMlWIATII USER Bt1FFER MULTI roll. V62
ADARUN NABa420
• ATTACHED BUTTERS 30>50 NSH CLASS 07/02/96
ADARUN NCW120
NUMIU!R 01' CQZ' 5
ADARUN NH_20000
NUKBER 01' HQE' S ALL USBRS
ADARUN NJ:$NIIQ-SOOO
•
ADARUN NONOES-NO
ADARUN N'I'W15
OON-OESClUPTOR S&ARCIIl!:S 03/03/03 ~ OF ACTrvz CIO'S PER USER ~ OF THREAOS
ADARUN NU>o4000
NUKBER OF USERS
ADARUN QPENRQ-NO
---> --->
ADARUN HQCID-SO
ADARUN PLOGRQ-NO
HQE'S ZACH USER
DEFAULT DEFAULT. TBS
~w~
ADARUN QElLKSrz_ 32760 ADARUN SVC-241 ADARUN =-900
ADARUN TLSCMD_1800 ADARUN
~lBOO
TRANS TIME LDUT T:IME LDUT I'OR $X cotea.NDS OON- ACTIVITY T:IME LIMIT
ADARUN THAE_ 1800
OON-ACTIVJ:TY T:IME LJ:MIT
ADARUN UEX,200EJ:IT2R
HANDLJ: BOTH P AN!) C LOGS
ADARUN
O~ _ 3390,DUALCLS _ 15000
<---
100 CIL
EVENT REPLICATOR PARMS AOARUN REPLlCATION-NO ADARUN LRl'l.-700M AOARUN RPLPARMS-FILJ: AOARUN RPWJIRNINCREMI!NT-l ADARUN RPWlUINMES$AGKLJ:MIT-5 AOARUN RPWJIRNPERCEHT-O
Figure 18:
ADARUN Parameters of Reptor
3.3 Replica lor Engine - Replor (V8.1.3N3.2.1) •
• •
• •
29
RPWARNMESSAGELlMlT=xxx (5 default) The number of RPL pool usage waming messages that can be issued to the consoie before message suppression begins. RPWARNPERCENT=O-99 (0 default) The threshold for RPL pool usage at which warning messages should be sent. If SLOG file is used, consider to check the values for ASYTVS, FMXIO, LBP, LDEUQP, LFIOP, LP, NH and NISNHQ. If data is sent through Entire Net-Work (Wep), the Entire Net-Work parameters LU, NAB and Ne must also set as described for the Reptor. See documentation http://documentation.softwareag.com/Adabas / Distribution.
Appendix, chapter 8.2 shows the ADARUN parameters of a souece database used by a company with 57 subscriptions spread across 4 LPARs running on 8 separate Replication STCs to balance the workload and MQ is LPAR-specific.
3.3.5
Event Replicator Initialization Parameters
Event Replicator initialization parameters can be specified in two ways: • Defined in an OS dataset or as member of a POS and read from the DDKARTE statement of the startup job • Defined online using the Adabas Event Replicator Subsystem and read from the Replicator system file at startup Each record in the DDKARTE statements must start with ADARPD and using the following parameters: • • • • • •
DAT ABASE - lD and DBCONNECT DBID (default database ID) DESTINATION - DTYPE etc. GFORMAT (global format) INITIALST ATE LOGINPUTIRANSACfION defines the threshold of the RPL buffer before using the SLOG. Tests with values higher than 75% and lower than 50% can cause performance problems, for example Reptor is looping or source OB uses high epu time.
Depends on the target database, filters and broker functions (EntireX, MQSeries, Entire Net-Work), other parameters must be supported. • ETBBROKERID (default webMethods EntireX ID • ETBBROKERNAME (EntireX Broker Stub Program) • FBV ALlDA TION • FILTER • GLOBALS
30
3 Definitions and Parameters
• GOrEN •
GQFULLDELAY
• • • • • •
IQUEUE IRMSGITERVAL IRMSGLIMIT MAXOUTPUTSIZE (max output message size) MAXRECORDSIZE (max decompressed record length) MAXVARRECORDSIZE (max variable decompressed record length)
• MQQMGRNAME (default WebSphere MQ Queue Manager) • • • • • • • •
NPAD ACALLS (number of parallel Adabas calls) RECORDPLOGINFO RESENDBUFFER RETRYCOUNT (number of retry attempts) RETRYINTERVAL (retry attempt interval) SUBTASKS (number of subtasks) SUßT ASKWAIT (subtask wait time) TLOG (transaction log)
• VERIFYMODE •
See documentation
http://documentation.softwareag.com /Adabas / Distribution.
In my experience for the Adabas destination, it is easier to define first the parameters for a couple of files by using the Adabas Event Replicator Subsystem (online) and download all parameters. This dataset can be updated and reloaded to the system file or used as input for the DDKARTE statement. See chapter 3.4, Unload and load parameters. Use for all global formats (GFB) the online system and create from Predict all fields needed before the unload. Unfortunately, there is no batch function to create the GFB from Predict. It can be a 'life-time job' to type in 150 fields each for 200 and more files. From the online 'Main Menu' of the Adabas Event Replicator Subsystem, the functions destination definitions, subscription definitions and global format buffer definitions must be selected. Files for the initial-state definitions can also be defined. I recommend creating the components in the following order. Otherwise, you will get the error message that the GFB is not defined, for example. • • • •
Global Format Buffer (GFB) Destination Definitions Subscription Definitions Initial-State Definitions (if needed)
31
3.3 Replica to r Engine - Reptor (V8.1.3N3.2.1)
10:25:48
..... A D A B A S
V.re 3.1.1
EVEN'l' REPLlCATOR SUBSYSTEM . . . . .
Hain Menu Ce>
F G J: Q R
S ?
2()09-()1-()9 M-ap()Ol()
I'Unction Adainietrator I'Unction. D
Entar-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PFS---PF9---PF10--PFll--PF12---
Figure 19:
3.3.6
Main Menu Adabas Replicator Subsystem
Deline the Global Format Buffer
Before you start, you will need the Adabas view name from Predict to create the global format buffer (GFB). 10:J4:()1
..... A D A B A S
EVEN'l' REPLJ:CATOR SUBSYSTEM . . . . .
Li et of Global Format Suffe re
2()09-()1-()9 M-apllJO
Gl00SS9 G100591 Gl00S92
G100S9J
Gl00S94
G100S95
Gl00S96
G100S91 Gl00S9S G100S99
Entar-PF1---PF2---PF3---PF4---PFS---PF6---PF7---PFS---PF9---PF10--PFll--PF12---
•
Figure 20:
Display Global Format Buffers Using Replicator Subsystem
Add a new format by hitting the
-key. On the next screen type in the GFB name, mark Predict parameters with '5' and press the <Enter>-key.
32
3 Definitions and Parameters
Companies using the following standard naming convention to define the global format buffer: GXXXYYY - for example GlO0590 •
G
=
abbreviation for global format buffer
• XXX = subscription database id, for example 100 • YYY = subscription file number, for example 590 ..... A D A B A S
10:35:18
EVEN'l' REPLlCA'1'OR SUBSYSTEM . . . . .
Global I'onoat
Bu~t.r
2009-01-09
H-JU>1120
C........nd_> Entar-PI'1---Pr2---i'1'3---PI'4---rI'S---PI'6---Pr7---i'1'8---rl'9---1'1'10--1'1'11--'1'12--Help b i t Hode Sa".
•
Figure 21:
Add Global Format Buffer Using Replicator Subsystem
Mark the selected file with '5' and press the -key to accept this selection. 10 : 41 :18
..... A D A 8 A S
,.,
rl1e
>
"
BS-PRINTBR-PROPERTIES
,
-
EVENT REPLlCATOR SUBSYSTEM . . . . .
Liat of Predict ril ••
IFDIC-(lOO,201)
BS-P~NTER-PROPERTIES-ADA
BS-ST-RBQ-LOG BS-ST~-REQUEST
DIETBR-USER-REQUEST CIS-CNTL-PROCESS CIS-RUN-CONTP;OL CIS-RUN-OONTROL-AUDIT etI-REASON-CODE etI-REASON-CODE-LOG etI-REVIZIi'-GROUP etI-RBVIZW-GROUP-LOG
U A A A A U U U U U U U
2009 - 01 - 09 M-PJ:CIUl'J:
Maat.r 1'11.
--------------------------------
BS-PRINTBR-PROPERTIES-ADA
CP-CON'l'ROL-ADA CP-RUN-ADA CP-IWN-LOG-ADA ST-REVIZIi'-ADA ST-RZVIZW-LOG-ADA ST-REVIZIi'-ADA ST-RZVIZW-LOG-ADA
COIOIIIand _>
Ent.r - PP1 --- P!'2 --- PP3 ---PP4 --- PP5--- PP6 --- PP1 --- PP8 ---PP9 --- PP10 --PPll -- PP12 --r.xi t
Figure 22:
Accpt
+
List and Select Predict Files Using Replicator Subsystem
Moonu
3.3 Replica lo r Engine - Replor (V8.1.3N3.2.1)
33
The next screen shows the Predict Parameter. 10,4& , 29 ..... A 0 A B A S rDIC- (100,201)
----------
• DIETER-VSER-REQUEST
•
Gen.ration
...
2009 - ()1 - 09 M-RP1121
(0:100590
IOn N _ •..•.. l'il.ID ••••••• T.r'l.t ~il. ID
EVENT REPLICATOR SUBS!ST!!M . . . . .
In~ormation
Va.r
,
D.~
_
..
DBIO
~"
----------
Adab . . . . . ."'. ion Oc:curr.n..... u • .cI ,..,11 ~ormat . .
c-nd _ >
Enbar-PP1 --- PP2 ---PP] --- Pr4 --- PP5 ---PP 6--- PP7 --- PP8 --- PP9--- PPI0 -- PFlI -- PP12 --H.1p Exit zx.c S.l Unl"" Man\!
Figure 23:
Select a Predict Files Using Replicalor Subsystem
Press the -key to EXEC the generation of the GFB for this file number. 10,50 : 48 ..... A 0 A B A S I'DIC- (100 ,201 ) 10100590
Gd N _ . .
Pil. ID .. . T.r'l.t ~il. ID
----------
EVENT REPLICATOR SUBS!ST!!M . . . . .
• ST-AOA-CALC-EOA'l'Z
•
Gen.ration
In~ormation
+-----------------------------+ Maba. V.raion ...• 17 I Oc:cur",. nc •• u • .cI . . • ! I TU11 ~ormat ..•...• !
( ! /N)
+-----------------------------+
----------
_
..
Adab . . .... r .ion Oc:curr .n..... u • .cI .. Pull format: . .
Figure 24:
Select a Predict File Using Replicator Subsystem
Accept everything and press the <ENTER>-key.
2001l-01-09 M-RP1121
3 Definitions and Parameters
34
ARrO0132 ,
ro~t
1 0:52:37
buLLe "
~ . n. r.~d
..... A D A B A S
. u~ c.
•• Eully
EVBNT RBPLlCATOP. SUBsrsTZM . . . . .
Global
r o~t
•
anNam.
.,
,Co
L Fi. ld ID
,,, ,, LAS'r - CHGD-DATZ-TlME ,
, • •• •• •• •
LOG-COUNTZR BN'l'J:TY
LAST-eRGO-USER
CALC - CODI!:
SlIT-DAß
1 En-DAß-9C 1
JU:P-DATJ:
1 DATA
C-nd
BuEt. "
~n9th
..
15 . 0 50 . 0 15 . 0
' .0
10 . 0
' .0 ' .0 ' .0
250 . 0
2009-01-09 N-RP1122
1 of: 9 Fon>a t BuE!'. "
M,B,i" Q,50,A AC,15,A AD,8,A JJ!:,lO,A
Ar,B,A AG,B,A AB,S,A AI,250,A
- >
Bnte,,-PFI---PF2---PF3---PFf---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
•
He lp
Figure 25:
Save the 5elected Predict File Using Replicator Subsystem
After the format buffer was generated successfully (see ARF00132 message at the top), press the -key to save. The message' ARFOO022: New GFB added' will be displayed. Press the -key and the new GFB has been added to the list of global format buHers. 10:55
,.,
"
.h._ A
tI
A 6 A S
EIlEN'!' U5'Ll CA'1'OR SUßST8TI!:M H •••
N_
------------
S. 1
N.....
8.1
N. . .
2009-01-09 N-RI>1l30
Li.t ot G1ob.1 Pormat Butt.r.
8. 1
N .....
G100589 G100590 G100591 G100592 G100593 G10059<1 G100595 G100596 G100S97 G100598 G100S99
eo-and
_ >
Ent. r-5'P1---5'P2---5'P3---5'P
Figure 26:
C.n
bit
Acid
List Included New Predict File Using Replicator Subsystem
3.3 Replica lor Engine - Replor (V8.1.3N3.2.1)
3.3.7
35
Define the Destinations
Destination definitions can be created for • •
Adabas: data is replicated to one or more Adabas files webMethods EntireX or EntireX Broker: replicated data is written to an output queue via webMethods EntireX Broker • WebSphere MQ: replicated data is written to an output queue via IBM WebSphereMQ • Null: data replication is tested without actually sending the date to a destination • File: replicated data is written do the CLOG, using TLOG URBL TDOD records
16:44 : 45
. . . . . A 0 A B A S BVENT RBPLlCATOR SUBSYSTEM . . . . . er.A t . N • • o..tinAtion Code A I!: I"
N M
?
20011-01-08 M-RP12g0
Function Cr.At. er.At. er.At. er.At. er.At.
Ad&bA. o..tinAtion Broke r o.. tinAtion I"il. O.etinAtion Null O•• tinAtion MQ o..tinAtion
U.lp
Exit eode ..
A
Ent.r-PI"1---PF2---PI"3---PI"4---PI"5---PI"6---PI"7---PP8---Pl"g---PI"10--PI"l1--PI"12--Exit Exit
Figure 27:
Create New Destination Using Replicator Subsystem
Companies using the following standard naming convention to define the destination DXXXYYY - for example 0200590 • • •
0 = abbreviation for destination XXX = target database id, for example 200 YYY = target file number, for example 590
36
3 Definitions and Parameters
ARFO0020 , N... d
H.*" A D A B A S ~.
D•• tination Act! ....
,
lUlo. t.oqqinq
N
D • • tination N _
~'"Y Inta", .. l ~'"Y
...
D200590
EllBNT RBPLlCATOP. SUBSYSTEM . . . . .
D•• ein.eion o.tinition
-
SeI
I:nput DBID
2009-01-09 N-RP1235
Input File
Tarq. t
Tarq. t
DBID
1'11.
~--
eo"nt
.~--
Ettor k t i =
ALTACTION
lUIa1qn Le .... l Completion Level
2
SLOG Writ. Level SLOG a..d. r.. ... l Adabaa Level
2 2 0
2
_ >
eo-&nd
Bnta r-PI'1---Pr2---PI'3---P"f---PFS---PF6---PF7---PF8---PF9---1'1'10--1'1'11--1'1'12--Halp
Figure 28:
3.3.8
Se ....
•
Define New Destination Using Replicator Subsystem
Define the Subscriptions
Companies using the following standard naming convention to define files oE the subscription or source database: sXXXYYY - for example 5100590
•
S = abbreviation for subscription or source
.. XXX = subscription database id, for example 100 • YYY = subscription file number, for example 590 10:05:38
. . . . . A 0 A B A S EVl!N'l' RZPLICA'1'OR SUBSYSTEM . . . . . Sub.cription o.tinition
2009-01-12 M-RP1410
OB100/.590 to 200/.590,_ _ _ _ __
O•• cription
Sub."ription N.... o.t.-. Al.ph. ~ lIrchit. "tur. ~ Sub. "ription V. r . ion O •• r D.t.-. Wia ~y b •• nd Bu tt.r N.......
TLOG V.lu ••
O •• r
Input Lav.l Filter Lav . l OUtput La .... l Filter Mat.,hed . . Filter Not Match.d Filter I9I\or. d . .
o..tin.tion Name Li . t Fil. -r. l . t..:!. P.r.... ter • . . . . . Sub."ription Ac:ti.... ......... o. • .,ti.... te it til. a • .,ti... ated Incr.ment Initi. l 8t.-.t. Count
,, ,, ,,
y
Y
N
o..tin.tion Fil . -bl. t..:!. P.rma FOl:fll&t Buttar
Command_>
Ent. r-PF1---PI'2---PFJ- - -PFf-- - PF.5- - - PF6 - - - PI'1 - - - PFS - - - PI'9 - --1'1'10--1'1'11--1'1'12- - ..... it
Figure 29:
s . ....
Define New Subscription Using Replicator Subsystem
37
3.3 Replica lor Engine - Replor (V8.1.3N3.2.1)
3.3.9
Define the Transaction Filter Definitions
From the SAG V3.3 Guide: Event Replicator for Adabas 3.3 SPI introduces two new parameters, SFFILTERGFBAI and SFFILTERGFBBI, that allow you to specify before and afterimage format buffers for records selected based on fields defined in the filter definition for a subscription file. This resolves the conflict that occurs when the transaction filter definition for a subscription file (SFILE) definition references a field that is not inc1uded in the format buffer (or global format buffer). These parameters can be used to improve the performance of Event Replicator processing. For example, if most records for a large format buffer are being rejected due to a transaction filter based on the contents of a small number of fields, it may help to specify the key fields in a filter format buffer so that, for most records, only the fjeld s required to make acceptance/rejection decisions are decompressed instead of the entire buffer. Filter Format Buffers
This information is also stored in the Replicator system file and can be maintained using the Adabas Event Replicator Subsystem. A transaction filter definition specifies filter conditions for replication, based on the values of fields in the database records. 16,49 , 53
..... A 0 A B A S
EVENT REPLlCATOR SUBS!ST!!M Filt.r Condition
*" •••
2()lO - ()!i - 28
M-RP1155
Tra n •• ction Filt.r N...... . , •. MfFILT - - ----- Soure. -----Ta%'9.t -----(iroup Fi.1d PB NU I_li'. Condition F i.1d PB NU I_li'. 2nd 11n., Baq1n u.nll'th Baq1n u.nll'th
T.rll'.t Valu. 1 - - - -
~ntar-PF1---PI2---PF3---Pr4---PF!i---PF6---PF7---PF8---PF9---PF10--PFl1--PF12---
H. lp
Figure 30:
hit
S.".
•
Define New Transaction Filters Using Replicator Subsystem
3 Definitions and Parameters
38
3.3.10 Define the Initial-State Before the replication process can begin, the target database must be in synchronization with the source database. The initial-state process will replicate record by record using STORE with ISN (N2) and End-of-Transaction (ED commands. It can also be initiated by adescriptor but using the ISN seems to be mOfe camman to eliminate duplicates. Depending on the connection between the mainframe and the server, i t can take 1- 2 days to replicate 150,000,000 ISNs of a file over to the target, as shown by tests. I recommend us ing a different way of initial-state in this case. Decompress
the files of the source Of subscription database, transfer (FTP) it over to the open source server and reload it into the target database. For Adabas, it requires a compress before the reload. This process is faster and can be done in a few hours. 16:01:22
. h ._ A tI A 6 A S
Code D I P
R S T V ?
EIIl!:N'l' RJ:PLlCA'l'OR SUßSYSTI!:M H ••• AdIIJ.niat.rat.ion
2010-05-28 N - RPllOO
F1.Inction Da \:.aba.. ID
Pa rtor. lnitial-Stat. Intor.ation lnitiata P.aplay SY.~ F1.Inction. Ta~t Adaptar Global V. lu•• pL<)(i
H.1p Exit
Code
_> Ent. r-PF1---pr2---PF3---PFf---PF5---PF6---pr7---PFS---PF9---PF10--PF11--PF12---
COlIIIU.nd
Figure 31:
3.4
Perform Initial-State Using Event Replicator Subsystem
Unload and load parameters
It is very time consuming to define 200 subscriptions, destinations and global formats by using the online system SYSRPTR. It is preferable to define only a couple of files online and unload this file as a POS member or a dataset. It is then
easy to copy and modify the parameters for other files with ISPF toots. 183 unloaded files will end in more than 142,000 lines of parameters.
3.4 Unload and load parameters
39
Destination parameters LOGON SYSRPTR lUIARPD OJ:ST:INAT:ION NJIMJ:-' 0300006' lUIARPD DTYPE-ADABAS lUIARPD OREPLJ:CATEUTJ:_ NO lUIARPD DACTrlBaNO lUIARPD DTLIUIABAS_ O JUlARPI) DRETRYINTERVAI.-GLOBAL lUIARPD DRETRYCOlJN'r-Ql.OBAL DLOGooYBS '0< ~ D'rLAS$J:G!f_ 2 0
~ ~ ~ ~ lUIARPD
JUlARPI)
~,
,,- ,= ,0 ,-
DTL$LOGREAD_ 2 0 0 DTLSLOGWiI.lTEa2 DAII'ILII:_ 6 ,DJUDBJ:D_ 100 ,DATrILII:_ 6 ,DATDBID-300 DAREPLlCATBUTlaNO
,-
(anip)
Figure 32:
Destination Parameters
Subscription parameters JUlARPI) SUBSCRIPTION lUIARPD $$TATUS-ctJRRENT JUlARPI) NAMB_'Sl00006' $DJ:SC-'DB100/006 TQ 300/006' ~- SACODB_O ~- SACTJ:VJ:-YJ:S ~- SDBSTlNATION-'D300006' ~- SJ:NCRI:MENTIS-NO ~~ SIDESTlNATION-'D300006' STLI'ILTERooO ~- STLINPUT002 ~ 0 ~- S'rLOUTl't11'oo2 ,_ 0 ~- SWCOOB_O ~- S'l'UQ,TCH_ O ~- STLNOMATClI_O ~- STLIGNOlU!_O ~- SDBACTJ:VATE_YES ~- SFlLE_6,SFDBID-100
~~~~~~-
~(anip)
Figure 33:
S~PLlCATSJ:NSE~r-rES
S~PLlCATEUPDATEarBS S~PLYCATEDELETEarES
S~PLlCATENOTCIUlNGBD-rBS
SGFORMATB:I_ 'G1OOO06' SGFORMAT~_'G1OOOO6'
Subscription Parameters
Filter Format Buffers
Software AG introduced two new subscription parameters with Event Replicator for Adabas V3.3 allowing you to specify before and after-image format buffers for records selected based on fjelds: SFFILTERGFBBI and SFFILTERGFBAI.
40
3 Definitions and Parameters
Global Fonnats (from Predicl) Global Po""....t G100006
rB-'AA,S,P,AB,SO,A,AC,15,A,AD,8,A,AE,10,A,Ar '
',1,A,AG,lO, A,AH ,8,A,AI,B,A,AM1, S ,P,AM2,S' , ,P,AM3,S,i',AM4,S,P,AMS,S,P,AM6,S,P,AM7 ,5' ', P ,ANB,5,P,AM~,5,P,AM10,S.P,AM11,5,p,AM1'
'2,S,P,AM13,S,P,AM1f,S,P,AM15,S,P,AM16,S, '
'P,AM17,S,P,AM18,S,P, AM19 ,S,p,AN20,S,P,AM' '21,S,P,AN,2,U,AO,2,U,AP,8,A,AT,8,A,AQ,5,'
'P,AR,5,P,AV,8,A,AX1,7,p,AX2,7,p,AX3,7,p, ' 'AX4 ,7,P,AXS,7,P,AX6,7,P,AX7,7,P,AX8,7,P, '
'AZ9,7,P,AZ10,7,P,AZll,7,P,AX12, 7 ,P,AX13, ' '7,P,AX14,7,P,AX15,7,P,AX16,7,P,AX17,7,P, '
'AX18 ,7,p,AZ19,7,p,AX20,7,P,AX21 ,7,p,AX22 ' , ,7,P,AX23,7,P,AX24,7,P,AX2S,7,P,AX26,7,P'
, ,AX27,7,p,AX28,7,i',AX29,7,p,AZ30,7,p,AX3 '
'l,7,P,AZ32,7,P,AX33,7,P,AX34,7,P,AX35,7,'
'P,AX36,7,P,AX37,7,P,AX3B,7,P,AX3g,7,P,AX ' '40,7,P,AX41,7,P,AX42,7,P,AX43 ,7,P,AX44,7 ' ',P,AX45,7,P,AX46,7,P. '
Figure 34:
Global Formats (GFB) from Predict
It is recommended to back-up weekly all definitions from Reptor's system fil e. lf needed you can reload the saved parameters or use it to build another Replicator
Engine. Ln example of Figure 35, file 10 is the system file in database 302 (Replicator Engine), which stores destinations, subscriptions and global formats. It unloads all destinations beginning with D]91*, subscriptions beginning with 5039*, initialstates beginning with 1039* and global formats beginning with G039*. An unloaded system fil e for 183 files contains more than 142,000 lines of parameters, for example for dataset DIETERDBID302.DEFIN.TEXT. IIRPULD
&DC NATBT,OI:PT-ST,OB-Tl!:ST,S!SOUT-",
11 PRH-' S!S_STRPTR, AtJTOooON, PROF1LI!:_REPTORT' 11* PRH-' WlD1o-O ,HJlXCL-O ,MT-O , IN-D, lWTQooON ,EDPS1ZI:_64 ' 11* PAlUoJIo(' IN-D, 10_' , , ' , ,WlD1o-O ,HJlXCL-O ,_0, ' , 11 * 'I!:DPS1ZE_64,INTEK$_ 1 ' ) IIDOl'R.lNT IIs!sUDUKP
IIDDCAP.D
DD SISOUT-* DD S!SOUT-" 00'
ADARUN OB-00302,SVC-214,MODI:-MULT1 IICMPRINT DD SfsotJTa * IICMinlFOl DD D$N-DIETJ:R.DBI0302.DI:r.IN.TI!:XT, 11 DCB-(REC_ra,LRECL-BO ) ,
11 11
IICMSmIN
OD
*
DISP-(NZW,CATLG,DELll:TB), UNIT-S!SDA,SPACE-(TRX, (25,251,RLSE)
LOQON S!SRPTR
$!$PROr
RPULD ENTIT!-DE,NAMB-D191*,DBIo.00302,FNR-Ol0,RELATED-N RPULD ENTIT!aSB,NAMB-S03g* ,DBIo.00302, nm.Ol0 ,RELATEo-N RPULD ENTIT!_IS,NAME-I03g*,DBIo.00302,nm.Ol0,RELATED-N RPULD ENTIT!_IS,~3g*,DBIo.00302,nm.Ol0,RELATED-N
!I
Figure 35:
SYSRPTR Unload all Parameters in Batch
3.5 Entire Net-Work (wer V6.2.1) - Mainframe
41
Example in Figure 36 loads all unloaded parameters (NAME=*) from dataset 'DIETERDBID302.DEFIN.TEXT' into RPL system file 10 of Reptor database 302. /IS'rRRVLtYr JOB (ST34ST, ST01, 4000T) , • RPULDTEST ,DIJ:TER' , II MSGCLASS-G, NOTIn_'SISUID, TIKJ:_1UO II·Ml\IN HOLD-NO,CLASS- P10 ,LlNJ:s_ ggn II.~T PR,DONAME_ , DESor-vTAM . STTN8002
/I-
11. /I. /I-
-
LOAD DEFINITIONS FRON P.J:PTQR SISTEM FILE TO WORlt I'ILB 1
II.OELBTE
BnC PGMooIEI'BR14
11.~01
/I. /I.
11.
DD DSN-DIETER.DBID302 . DEI'IN.TEXT, DCs-(RZC_n , LRECI.-80), DtsP-(M:XI,DIU.BTJ: , DUoBTJ:). UNITaSYSDA,SPACE_('rRX, (25,2S),RLSE)
/I-
IIRPULD EXEC NATBT,DEPT-ST,Da-TEST,S I SOUT-*, I I PRM-' SIS_STRPTiI.. AUTOooON , PROl'lLBooRBPTQRT '
11* PRM- ' NADlQooO , to.XCI.-O ,NT-O. lMooD,AUTOooON , EDPSIZg.,64 ' 11* P~(' n.D , lD_ '· " ',NADIQooO,MAXCt.-O,MrooO,· , 11* 'EDPSIZE_U,INTENS_l') IIDDPRINT IlsySUDUMP
DD SISOUT-* DD SYS()UToo* IIDDCARD DD * ADARUN Ds-tl0302, SVC-214 , M:XI~TI IICMPRINT DD SISOUT- · IICHNII.FOl DD DlSP-SHR , DSN-DIETBR . DBID302 . DEFlN. TEXT IICMSININ CD * LOGON SYSR.PTiI. RPLOO NAME_* , DBII)oo302, FNR-10 , P.J:PLACB_Y
/I
Figure 36:
3.5
SYSRPTR Load all Parameters in Batch
Entire Net·Work (WCP V6.2.1) - Mainframe
Entire Net-Work (wep) is needed to replicate Adabas from the mainframe to Adabas on the mainframe, Windows, Linux or UNIX. lt passes Adabas direct commands and its buffers to the target database.
3.5.1
ADARUN parameters
ADARUN parameters for the Entire Net-Work on the mainframe, especially
• er (default 60), the maximal time in seconds for interregion communication. It should prevent a command queue element and attached buffer from being held for a long period of time for a user who has terminated abnormally. A value up to 180 (seconds) is observed at companies. • LU, the intermediate user buffer needs a value more than 167,000. A value of 250,000 is necessary with high amount of replicated updates. • NAß, the number of attached buffers should be set not lower than the value defined in the source database and Replicator Engine.
42
3 Definitions and Parameters
.. NC, the maximum number of command queue elements (CQE). Each call from the Adabas nudeus is assigned a command queue element. In one installation, 1,421 update commands per second were ohserved and the value was set to 2000. • SVC, the supervisor call (ar router) must correspond to the number used for the Adahas SVC installation. • TARCETID, the unique Entire Net-Work target ID oE anode. • See documentation http://documentation.softwareag.com/Adabas I WCP62 ....
Read by OOCARD DD-statement: Tb. followinq p .. " ..... t.r. . .r .
in u •• for thi . ..... n :
•
(AIl1'laAS VERS:ION 8 . 1 .3 )
lUIARUN PAiIMS I'OR ADlUIETXX
ADARUN SVC_242 ADJUUJN
NAB-~OO
ADARUN LU-2 5 0000 ADARUN NC-2000 ADARUN FORCE-N
'* '* '* '*
MUST BE UNlQUE WITHIN N1!T - WORJ: */ SHQULD aB 255 < TARGBTID < 65535 . , SUPPLY ADABAS SVC NUMBIIR
INCR. FRON 655 35 FOR RIIPLlCATOR
*' *'
( . nip)
Figure 37:
3.5.2
ADARUN Parameters (DDCARD) for Entire Net-Work (Wep) on Mainframe
Parameter Statements
The Entire Net-Work parameter statements describe the Entire Net-Work environment and the network connection for this node. • • • • •
NODE, defines the node's name and operating system DRIVER, defines the !ine driver type, as VTAM, CTCA, TCPI, TCPX, ete. LINK, defines the link to another node TRANSLAT, heterogeneous platform considerations See documentation: http://documentation.softwareag.com/Adabas I WCP621mfr/install ....
3.6 Entire Net-Work (WCP V7.3.3) - LUW
43
Read by OOKARTE OO-statement: NODZ ONE BUITBRS-(2S6,,",2S61'l,2H) DRIVER
TCPI API-oES,
LINll SBJlV008
TCPI ACQUIRBooN, INETADDR-nnl.nn2.nn3.n4, RBSTART-(60,S) , SERVZRID-l 7102, Jl'BIGHT-10
Figure 38:
3.6
Parameter Statements (DDKARTE) for Entire Net-Work (Wep) on Mainframe
Entire Net·Work (WCP V7.3.3) - LUW
Entire Net-Work (WCP) on the open system is necessary to access Adabas on Linux, UNIX or Windows (LUW).
3.6.1
Parameters
• Oon't activate the trace. It is an overhead (110s) and can slow down the replication process. • WCP is located on a Win2008 server SERVOO8. Tests with Win2003 server went very weil but this version is no longer supported by Microsoft. Win2008 server experienced same authority problems and all Software AG products cannot be located in one folder (SAG folder). • Communication parameters see WCP on the mainframe. • Apply WCP733XOO3 - WCPv733 Hotfix #3 for Windows, Linux and UNIX to avoid RSP 153 on the Adabas target database. Hotfix should be induded in WCPv7.3.4
3.6.2
Service.config
Il~er v,,,'
Figure 39:
tonfog
Not ..pdd
service.config Entire Net-Work (WCP) on Open System
44
3.6.3
3 Definitions and Parameters
KZOOB.KERNEL
Figure 40:
3.6.4
KZOOS.KERNEL Entire Net-Work (Wer) on Open System
Xts.config Il ~t. ( onlog
Figure 41:
3.7
~ot"pad
xts.config Entire Net-Work (Wer) on Open System
Entire Net-Work (WCL V1.3.1) Client
Entire Net-Work eHent is necessary to access Adabas databases. One dient per machine is sufficient.
3.7.1
Windows Service
• This is the appHcation stub on Windows dient. • Located on a Win2008 server SERV008. • Perform the system administration using the System Management Hub (SMH ).
3.7 Entire Net-Work (WCL V1.3.1) Client
45
•
Entire Net-Work uses information stored in a Directory Server to send and receive messages from the dient to the database and back. It is critical to the functions of Entire Net-Work V7. • Software AG also recommends setting ADABAS_TIMEOUT on the dient side (WCL) to the same value as the transaction time (TI) on the remote database to avoid RSP 153.
3.7.2
UNIX Daemon
• This is the application stob on UNIX daemon. • Perform the system administration using the System Management Hub (SMH) . • Entire Net-Work uses information stored in a Directory Server to send and receive messages from the d ient to the database and back. It is critical to the functions of Entire Net-Work V7.
3.7.3
Xts.config
11 KtS (o"f,,)
"ot., pad
scfg. f11 eenc 0 _1 cu :jjnu 1: O?cnvname-w1 ndows-12 52
SAGXTSDSHOST_localhost
SAGXTSDSPORTa4952
NET-\IoQRK_W:::L
Figure 42:
3.7.4
xts.config Entire Net-Work Client (WCL) on Open System
Service.config
Figure 43:
service.config Entire Net-Work Client (WCL) on Open System
46
3 Definitions and Parameters
3.7.5
Directory Server - xtsurl.cfg
Figure 44:
xtsurl.cfg Directory Server Entire Net-Work Client (WCL) on Open System
3.8
Adabas on Windows (V6.2.1.1)
3.8.1
General
• Choose for Adabas on Windows a server and da not use a PC At least from an installation point of view, Adabas on Win2008 server acts totally different compared with the Win2003 server, for exarnple the ADADIR folder. It is very tricky to define large container files in one contiguous space. Database components ASSO, DAT A, WORK, TEMP and SORT should be 10cated on disk arrays (raid-5) in the SAN box. A controller should support at least two logical channels. One for the D-drive (ASSO, WORK) and the E-drive (DATA, SORT, TEMP). • Command log should be activated to observe the speed and to detect response codes. Don't use the C-drive for the command log.
3.8.2
Parameters
Among several Adabas parameters, the followin g ones are very irnportant • LBP The higher the value for the buffer pool size the better. Values with 400M (419,301,376) were always used to 99%. In contrast to Adabas on the mainframe, Adabas on Windows displays buffer pool statistics.
• WRITE_LIMIT This parameter determines the frequency of buffer flu shes. Adabas on Windows does not have an I/O buffer for asynchronous I/Os. The buffer flu sh
47
3.8 Adabas on Windows (V6.2.1.1)
therefore should not take too long time. Tests showed that a value of 25% caused a long waiting time for the Reptor to send the next transaction. A value of 5% was more eHicient. Observed on the Reptor, a buHer flush on the target database brought the replication process for 23 seconds to a halt and then continued replicating for 37 seconds . • BFIQ=O This parameter sets the limit of parallel buHer flush I/Os. Zero (0) means no limit. Tests with different values did not show improvements. Ve r .ion 6.2.1.01 High Water Hark.
~
Databa. e 251 Area/Entry
Sire
---------User Queue
" 3,H5,728 " 393,216 90,000
393,216 16,777,216
,
786,449
Date/Time
---------
12-,J7,N-2011 12-,J7,N-2011 12-,J7,N-2011 12-,J7,N-2011 12-,J7,N-2011 12-,J7,N-2011 12-,J7,N-2011
" " "" "" " "
17:26 13:33: 13:33 13:33: 21 : 49 13:32 :2 7
419,430,400 419,301,376 419,333,120 332,790 99,937
12- ,J7,N- 2011 13:32 : 27
23,552
,
"
'00
12-,J7,N-2011 16 :39 12-,J7,N-2011 13:33: 12-,J7,N-2011 15 : 59
Adabas Windows Parameters
Databa.e 251
Pool A11ocation CUrrent Hiqh .. ater Internal Workpool
.
99\) 99\)
)
''>
Lo9ical Reada Phy.ical Reada pool Hit Rate
~ Ve raion 6.2.1.01 Burre r Pool Statiatie.
on 12-,J7,N-2011 20:29 :39
419, no, 400
Butte r Pool Sire
419,301.376 419,333,120 19,030,016 2,451,456
54, 03B, 642 337,971 99.'" 1 ,905,917
Figure 46:
----------,
12- ,J7,N- 2011 16:19:55
"
Butter Pool Protection Area Ac:tive Area Group CODIIIli t Tranaaction Time
• , , ", ", ", " ,, ",, , ,, ,, ",, " •
High Water
31,744
(~)
Figure 45:
,, ", ,,
>0,
CoaImand Queue Hold Queue C1ient Quaue HQ Uaer Liait Threada Workpoo1 15M Sort Compl_ Search Attached Burrer
.-
In Uae
on 12-,J7,N-2011 20:29:09
67,490 2,556
,, ,
.",
Total To Pree $pace Wri te Liait Moditied
Adabas Windows Buffer Pool Statistics
5\ ) : 0\ ) :
20,971,500 665,600
.""
48
3 Definitions and Parameters
3.9
EntireX Broker (V8.0.1)
webMethods EntireX Broker is needed replicating Adabas data from the mainframe to non-Adabas data on Linux, UNIX and Windows (LUW). The Event Replicator Target Adapter is also necessary on LUW to communicate with the EntireX Broker. Depends on the target database, different target adapters must be used. Figure 46 shows the target adapter for SQL databases. EntireX Broker is also used to access Adabas data located on the mainframe with a program located On Windows, for example .NET. On the mainframe site is also a Natural RPC server necessary. But this is not necessary for the replication process. Please see a parameter example of EntireX Broker V8.0.1 in chapter 8.9, EntireX V8.0.1 Parameters. See graphie for RPC proeess Figure 12.
3.9.1
EntireX Broker (V7.3.4)
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• • Entir.x Broker Attribute Pile .,' .3 • •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
........................................................................ 'MOOULII : ETBAHHZ 'SOURCE !.OCATION: HK. ENTIR& . V134 .AT'l'RB . LOCSRCE ' ruNCTION:
lIND(:
(ETBAHHZ )
.----------------------------------------------------------------------. •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• • Broke r
ape<::U'ic:: Attribut. •• /
o e f'inition of 91=-1 " ' a ourc:e •
• . . . . . . . •••••• • 7 3 : Global par_tara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DBPAUl.TS • BROIlER BROUR-ID ACCOUNTING
-~ CLIBNT- NONACT CONV-OBfiWLT LONG- Bt1PPBR- DEPAULT NUM-CLIENT NUM-CONVERSATION NUM-LONG-BurFKR
--~ NUM-SERVICE
--..,....
NUM-SHORT-BUFPER
SECUP..ITY SERVICE-UPDATES SHORT-BUFFBR-DBPAULT
""""-~ NUM-COKBUF
--"'"
EXB113
,.,
_ 00
,~
2000
'"
'"
400 00 30000
'" '" " HO ,
tOO OO
_ 00
1000
•
t.urn on SMP recorda t.ype 245
• AJU" r ec_nded • CONVERSATION. par
SERVICJ:
• LONG BUFPER. par SERVICJ: ••• • • up fram 20~ B/12/09 ·"a i a. f'rom 15000 Ot/ l0/03 • • r.i ••d fra. 20000 - db Ot/l0/03 • Oa . . Hupp "'C:omDanded • No ••c:urity ..ith AJU" ," • " .".ad ATTRIBUTE f'il. • SHORT BUFPER. par SERVICJ:
"0
'"
""
trac.
'"'"
off if
"'. "0
but. dyn..-ic
IO.X-UOWS UOW-HSGS IO.X-HSG
50000 • rrf' 01/10/07 to match AJU" •• rvi oa 500 ali •• of IO.X-HBSSAGES-IN-UOW 1000000
DEFB~
HO
,ro~
~-
.
49
3.9 EntireX Broker (V8.0.1 )
'STORE-TYPE 'STORE UWSTATP
,
~ .~
..
• Cold ta cl •• " ' . ta". /Hot to k . .p l}OIIf .t.tu. intor.ation ..:1 t"OII!. 10 ~
• o r ...,....
-
'0 • ".1 • • .---------------------------------------------------------------------• ADJP.lU.S P.to" • ---------------------------------------------------------------------OErJWLTS ~~
.
~
4096
BLltSIZE OBIO
m
~
J'ORCE-COLD
•" • , '"
20000
~,~
0"""" ~
TRACE - LI!!VI!!L
• • •
"0
-,-
cl . .. " . u.. P . t o".' bump up trOOl ctet.ult 1k 6/11/09 rrt
.---------------------------------------------------------------------_. • • High ConT Non-.ctivity
•
L~t .
tor S. ".,.ica Control Manag. r
'l'ItBUFNUM _ 3
ABEND-LOOP-DBTZCTION _ YBS ABEND-MKICIRY-DUMP _ NO NUH-SBRVICE-B%TBNSION _ lWTQ NUH-SUSSCRl:BER-TOTAl. _ AUTO NUH-TOPIC-EXTENSION _ AUTO NUH-TOPIC-TOTAl. _ AUTO PRIVATZ-IPC _ NO 'STORE-VERSION _ 2 TRANSPORT _ NET-TC'
. . . . . . . . . . . . . . .. 7 . 3: DIV par_tara ••••••••••••••••••••••••••••••••••• • OBI'AULTS _ OIV
. . . . . . . . . . . . . . . .7.3: NET p . r _ t a r.
.................................. .
DErJWLTS _ NET
ADASVC _ 2 14
"""'-NO
IUBL _ 65535
""""'" -
NO
HAllS NCQJ:
124
383
HODB TIME
113 90
NUH-CCOM _ 3
. . . . . . . . . . . . . . . .7.3: SSL p.r..... ter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DEI"JU1LTS _ SSL • PORT _ <port_no> • HOST _ • KBY-LABBL _ • TRUST-STORE - <tru. t_. tora> • RESTART _ YBSlno • RETRY-LIMIT _ UNLDtln • RETRY-TDIZ _ lOS • REUSE-lUIDRESS y •• INO • VBRIFI-CLIBNT _ Y•• INO
. . . . . . . . . . . . . . ,,7.3: TCP p.r..... tar . DEI"JU1LTS _ TCP HOST _ h .. dc.l.c.h ..... t . 9<>" PORT _ 50513 STACK- NANI!! _ HWTCP RESTART • IES RETRY-LIMIT • 20 RETRI-TDIZ _ 3 CONNECTION-NONACT IH REUSE-lUIDRESS - YES
.......... . .......... . ....... . .... .
50
3 Definitions and Parameters
DEI!'AULTS • SECURlTY . . . . . . . . . . . . . . . 7.3 : S.rvic. d.finition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DBI!'AULTS • SBRVICE CONV-LDnT CONV-NONACT LONG-BurRR-LDnT MJIX-UOWS NOTlrr-EOC SERVER-NONACT SHQRT-BurnR-LDnT TPANSLATlON UOW-MSGS
• RRl" 07/20/05 Ch.n'J..:i t'rOlll. 248
• . n . ur. EOC not.ific.tion • RRl" 07/20/05 ch.n'J..:i t'rom 2008 ~~
• CNH 05/09/00 dem' t
SAGTCHA
r.quir. tr ... d.tion
'00
MII t SVRSC, MIItSVRSC , MIItSVRSC, MIIZSVRSC,
SBRVICE SBRVICE SBRVICE SBRVICE
._--------------------------------------------------------------------_. Rap1ic.t.or S.rvic. Definit.ion •
._--------------------------------------------------------------------_. u ..... u
•• u • •7.3
: S.rvic. definition. u •• u . . . . . . . . . u •• u . . . . . . . . .
DBI!'AULTS • SBRVICE CONV-LDnT CONV-NONACT LONG-BUFFER-LDnT MJIX-UOWS NOTlrr-EOC SERVER-NONACT SHORT-BurnR-LDnT TPANSLATlON DEFERRED UOW-MSGS SERVER SBRVER
~~
...". ...'"
1208
~,.
50000
• bump up per Victor 6/12/09
•
Al . .. - .... tch broker ...... 1 • . n . ur. EOC not.ific.tion • lU. ..
~,.
~
REPLlCATION R1!PLlCATlON
SERVICE SBRVlCE
AA'
INlT
._--------------------------------------------------------------------_. Short.ar Con ... Non-act.i ... ity t.'--out. . . .d MIlZ Tr.na1.tion Routin • . . . . . . . . U . . . . . 7.3 : S.rvic. definition . . . . . . . . . . . . . . . . . u . . . . . . . . . . . . DBFJWLTS • SBRVICE CONV-LDnT CONV-NONACT LONG-BurRR-LDnT MJIX-UOWS NOTlrr-EOC SERVER-NONACT SHQRT-BurnR-LDnT TPANSLATION UOW-MSGS
~~
••
~,.
>0, HO 2008 ~~
~~
'"
• MIIt Tran . 1ation Routina
MIIZSVRTD, SERVICE MIIZSVRTD, SBRVICE MIItSVRTU , SBRVICE MII t SVRTD, SBRVICE
~~
PING
3.9 EntireX Broker (V8.0.1 )
51
.
.---------------------------------------------------------------------_ ---------------------------------------------------------------------_. • ._--------------------------------------------------------------------_. • ._--------------------------------------------------------------------_.
. •
.
•••••••••••• • • v7.3: Servie. deEinition a •••••••••••••••••••••••••••••• DE FAULTS _ SERVICE CCINV-LIMIT CCINV-NQNACT LONQ-BUFrER-LIKIT NOTIrr-EOC SERVER-NQNACT SHOlI.T-BUITER-LINIT TRANSLATION
•
~,
•• m ,.
~,.
~,. ,~
ACLASS, SERVZR BeLASS, SERVZR CCLASS, SERVZR
ASERVER, SERVICl! BSERVER, SERVICII: CSERVER, SERVICl!
ASERVICl! BSERVICII: CSERVICl!
._--------------------------------------------------------------------_. • Servie. apeciEic Atuibutea / Tutorial Non-Con ... araational Sarvice • _--------------------------------------------------------------------_. •
.
•••••••••••••• v7 . 3: Servie. deEinition • •••••••••••••••••••••••••••••• DEFAULTS _ SERVJ:CE CCINV-NONACT SERVER-NONACT TRANSLATION
,. ,. SAGTCHA
CLASS-ETB,SERVER-TUtori.l,SERVICE-N~ltiSrvl CLASS _ETB,SE~tori.l,SERVlCE-N~ltiSrv2
•
CLASS-ETB,SERVER-TUtori.l,SERVICE-NcHoaeply CLASS_ ETB, SE~tori . l , SERVlCE-Nclfi thRep11' CLASS-ETB, SERVER-Tutori.l , SERVICE-NcHoaeplyAal'
.----------------------------------------------------------------------. • .----------------------------------------------------------------------. •
•••••••••••••• v7.3: Sarvie. deEinition a •••••••••••••••••••••••••••••• DEFAULTS _ SERVICE CCINV-NONACT SERVER-NONACT TRANSLATION' CLASS- ETB,SERVER-TUtorial, SERVICJ:-CvS-ckVround CLASS-ETB, SERVER-TUtori.l , SERVICZ-CVOa tePromSrvAa y CLASS- ETB,SERVER-TUtoria l,SERVICJ:-CvDa taToSrvAal' CLASS-ETB, SERVER-TUtori.l , SERVIcz-cvo.mooeravOuiea CLASS_ ETB, SE~tori.l, SERVI~Hold CLASS-ETB,SERVER-TUtori.l,SERVICJ:-CvPar.lleLAay
•
CLASS _ETB,SE~tori . l,SERVlCE-C"UnitOfWork
• _____________________________________________________ - - - - - - - - - - - ______ 0
•
0 ______ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - _ _ _______________ •
•
. . . . . . . . . . . . .....7.3: Service deEinition a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
52
3 Definitions and Parameters
DB~TS
• SERVICB
CONV- NONACT NOTln-BOC SERVZR- NONACT TRANSLATION
8M
CLASSooE'l'B , SBRVER-Tu tori.l ,SERVlCEooRaqu•• t CLASS _B'l'B,SERVER-Tgtori.l,SERVI~.it
*----------------------------------------------------------------------* • 5.rvi.,. Attribut.a / NATUPAL S.rvic•• *----------------------------------------------------------------------* .~"if"i"
P.PC
.. . .. . . . . . . .. . ,,7.3: Service d.tinitiona .. . . .. . . . . . .. . . .. . . .. . .. .... . . DIU'lWLTS _ SBRVICB COHV-NONAC'r 5M NOTln-BOC NO SERVZR-NONACT TPANSLATION CLASSooRPC , CLASSooRPC ,
SBRVBR-SRVl ,
SUVlCE-CALLNAT
SBRVBR-MHZSRVl,
SBRVlCE-C~ A T
*• ._--------------------------------------------------------------------* ZN'I'IRE/x Attach Manaqer t..t •• rvi" •• *._--------------------------------------------------------------------* .. . .. . . . ..... .
v7 . 3 : S.r'I'ic. definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
_ SBRVICB CONV-NONACT 5M NOTIrY-BOC NO SERWR-NONACT TRANSLATION OAOTCKA
DB~TS
,.
-,-, ,_. ,_.
''''''' ''''''' ''''''' '''''''
ATCLASS. SERVER ~,
SERVER
~,
'''''''
SERVER
'-, ATTBST,
SERVICE SERVICE ATTBST, SERVICE ATTBST, -,~ ATTBST, SERVICE
ATTACH
CBCSRCH SDLDSTC SDLDINTl SDLDINT2
._--------------------------------------------------------------------_. END OF DEFINITIONS ._-------------------------------------------------------------------- _ •• • •••• •• •••• • •••••• END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 47:
3,9,2
.
webMethods EntireX Parameters (V7.3.4)
Event Replicator Target Adapter
The Event Replicator Target Adapter transforms and applies replicated data to one relational database at a time, such as D82, MySQL, Oracle, SQL Server, Sybase, or Taradata.
3.9 EntireX Broker (V8.0.1 )
53
Example for SQL Database '.qlr.p 'Mon Feh 07 03:15:20 PST 2011 .ource.r•• rv. r.~/RBPLlCATION/ART del.tebeLor.in •• r t- tru. me •• aqepr. t .tchcount-20 cLo.t.ba ••• ba tchcoun t-O under.cor. . tru • • ource .captur. _ Lal •• aql.rrorcontinu. .true oompatib1. 23-ta1 •• cLo.t.ba ••. nu11tortypedecima1_ t.1a. occurr.nce- tru. webda". c.ch. ai z . .25 . tartup.bui1dn~r-1048
aqla.rv.r.portn~r-l'33
. ou rce.maxr.c. i". 1.n-32768 aqlr.p.".rbo •• _O da t.ba ••. conn. ctionr.u. _tru. aql •• rv. r . ho.tn...-.c.!.haqlc3,,1 a ource.tr.c. .O brok.r. ra.rv.r.ddrw>utxx brok.r . captura_Lal •• a tartup. count-603 quo taa trinqwtru. dat.ba •• . dbn.....-ADT aourca.id-hwdc . 1 .cahwn.t . qov\ 50513 brok. r.tr.c. .O brok. r . maxr. c . i". 1 . n_ 32768 brok.r. idaxxxx . ql •• ~ . r . pa .a worg-xxxx 1ow.rc. . . .t.l •• cLo.t.ba •• . u •• r d*Linaamp tyva 1u._ tru. brok.r . • • ittimaw20S . ql •• ~ . r . u •• rn. . . .ourca.akipconn.ctionwL.l •• • ql •• rv. r . dbn.....-Adaba . cLo.t.baa •. nul l tortypatloat-L.l •• brok.r ••• rv.r.ddr-xxxx aourca . aourcatYP'"'BROI'ZR
_.a
Figure 48:
3.9.3
Parameters for Target Adapter fOT SQL Database
Schema and Replica!ed Da!a
The XML schema for the data is created from the generated field table (GFB) for the subscription that processed the replicated data. Each of the create, insert, update or delete operation will create the SQL table in the relational database management system (RDBMS). Generated Field Table GFFT
The fjeld table is created when you generate a global format buffer (GFB) for a subscription in Event Replicator for Adabas. See chapter 3.3.6. It is generated from Predict file definitions.
54
3 Definitions and Parameters
,•
---
L OB N _
, ,••
--------------
M
top -------------
PE.RSONNBL-ID
,, M _
•• • •
AB ~
PIRST-NAME
AI)
MIDDLZ-I
~
MAR-$TAT
.....
-"
• ---------- , ----------B B B B B
~,m
0
,
0
"• "• • N N
0
S_SINGLB D~~ _~D
, , ,m ,"" '" , , ,• , 1 AG SEX
I'ULL-AI)DRJ:SS
B B B
~
BA AL
B
~,
TELEPHONE AN ARn-CODE 10M PHONE BD ~ ,JOB-TITLE
B B B B
BD LE./WB-DUB BV LEIWB-TlUIEN
N N
~
, ,••• ., ,
,.n
LBAVE-DATA
Figure 49:
•, "", • "• " ' .0
N 0 N N N N
0 N 0
' .0 N
Generate Field Table - Source: SAG
EXAMPLE "Create": <Eve nt Ra_'I' Pil_'EMPLOYBES-PILJ:' Op-'Cr•• t.o' T~'200'I06/27-
15 ;20:42.""65'
.tt-'mu'/>
~'10'>
n . . ._ 'PZRSONNEL_ID' ai_ 'I' tmt-'a trinq' pro-'O' l.n_ '8 ' key-'~k'l> n . . . . ·PIRST - NANE· . 1_'2' fmt-' . trlng' prc_'O' l a n. ' 20'/> n . . . . 'NAME' ei_')' ~t- '. trinq ' pro-'O ' lan_' 20 ' kayw'ky '/ > n . . . . 'MIDOLE-NAME' ai_'4' fmt-'.t~inq' prc- 'O' l.n_' 20 '/ > nam._' MAR_STAT' .i_' S' fmt-' . trinq' prc-'O' l .n-' l '/> nam._' SEX , .i_'6' fmt-'.trinq' prc_'O' l . n_ ' l'/> nam._'BIRTH' .i_'8' fmt-'dat.' p~c_ ' O' l.n_ ' 10 ' k~'ky'/> n . . . . 'ADORESS-LlNE' . i _ '9' fmt - ' . trinq' prc-'G' l . n_ '2G'
nam._'CITI ' .i_'10' fmt-' . trinq ' prc-'O' 1.n-' 20' k.y_ 'ky'/> n . . . . 'POST-OODB' . i _ 'll' fmt - ' . trinq ' prc-' O' l . n _ ' lG'/> nam._'~I' .i_' 12 ' fmt-' . trinq' prc-'G' l.n-'J ' /> n . . . . 'AREA-OODB' .i_'lJ' fmt-'.trinq' prc-'O' l . n_'6'/> n . . . . 'PHQNB' . i . ' 14' fmt- ' . trinq ' 1'ro-'O' 1. n . ' 15'/> nam._ 'DBPT' . i_ 'lS' f . t - ' .trinq' 1'ro-'O' 1. n _ '6 ' k .y-' ky'/> n . . . . 'JOB- TITLB' . i.'16' fmt-' . tring' pro-'G' l . n_'25' k .Y"' ky'/> n . . . . 'CURR-OODB' .i.'18' fmt-'.trinq ' 1'ro-'O' 1.n. 'J' att-'~'
"", _ _ ' :INCOMI:' />
/>
"",. . ._ ' INCOMI:'
/>
att-'~'
Figure 50:
Generated XML Schema 'Create' - Sourre: SAG
55
3.9 EntireX Broker (V8.0.1)
EXAMPLE "Insert":
Pr.~1x_'N'
Part-'l '
&n_ '40~1 ' >
ISN_'l' Op-'In •• rt' FNR-'10'> ai_ 'SOOOSiOO' k.y-'uk'/> a1_'SIMONE'/> ai_ ' ADAM' kay_ 'ky'/> a1_'M'/> ai_ 'I"/> ai_'1~52/01/30' kay- ' ky'/> .1 _ ' ~' ai_ '26 AVENUE RHIN ET DA' att_ 'mu' 1x-'l'/> .i_' 10' ai_ 'JOIGNY ' kay- ' ky '/> . 1 _ ' 11' ai_ '1~300'/> .i_ ' 12 ' ai_'I"/> . i_ ' 13' ai_ '1033'/> .i_'14' ai_'44864858'/> .1_' 15' a1_'VENT5~' k .y-'ky'/> .i_'16' ai_ ' CHEI' DE SERVICE' kay_ ' ky'/> a1_'ll' a1_'FRA' att-'pa' 1x.'l' 9&i.'17'/> ai_ ' l~' ai_ ' 15~~BO' att-'pa' ix-'l' 9ai_'17'/> a1_'20' a1_'23000' 1x_'l' 1x2_'1' a tt-'mu' 9.1-'17'/> ai_'21' ai_' l~ '/> a1_'22' a1_'5'/> ai_'24' ai_' 1~~~0801' att-' pa , ix-'l' 9ai_'23'/> a1_'25' a1_'1~990B31' att_'pa' 1 . . '1' 9ai-'23'/> ai_'26' a i _'I"RE' att-'mu' ix_ ' l'/> a1_'26' a1_'ENG' att-'mu' 1x_ ' 2'/> . i_ ' l ' .1_'2' . i- '3' .1_'S' . i _ ' 6' .i_'8'
Figure 51:
Generated XML Schema ' Insert' - Source: SAG
EXAMPLE "Update":
Figure 52:
Generated XML Schema 'Update' - Source: SAG
EXAMPLE "Delete":
Figure 53:
Generated XML Schema 'Delete' - Sou rce: SAG
4
Compare Files of Source and Target
Despite users' statements that the replication works correctly and comparisons between SQurce and target are not necessary, self-written comparison programs sometimes show differences. Many times Adabas response codes are the reason that records oe ISNs are not replicated. The system log (DDPRINT) of the subscription database and the Replicator Engine shows response codes but normally, there is no routine in place to check for erfOTS. Chapter 6 points out the reasons and chapter 7 describes the monitor routmes to detect response codes, errors and high water marks and how to notify the relevant grOll ps .
-
• '1\_.
Rap l leated Productlon
Produ etion Oatabas.
D at.base
ASSO
ASSO DATA WORK
DATA
W ORK
? Figure 54:
Compare Source and Target Files - Amount Fields
Three methods will be discussed how to compare source and target files to be sure that both are identical.
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_4, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
58
4.1
4 Compare Files of Source and Target
Compare Amount Fields
Counting amount fields of files in both subscription and target databases and compare the result is easy to accomplish. Appendix, chapter 9.5.8 and Figure 211 show the Natural program. <.nip> 11.1. RBAD HULTI-FBTCH 'MULTIFBTCH CONTRIB ADD POST-TAlI:-CN'l'RB-AMT TO 'POST-TAlI:-CN'l'RB-AMT ADD l'RE-TAlI:-CNTRB-1oH'l' TO 'l'RE-TAlI:-CNTRB-AMT ADD DB-POST-TAlI:-CNTRB-AMT TO 'DB-POST-TAlI:-CNTRB-AMT ADD DB-PRE-TAX-CNTRB-AMT TO 'DB-PRE-TAX-CNTRB-AMT ADD LOG-COUNTI!R
Figure 55:
Natural Program to Count Amount Fields
WINDOWS :
CONTRIBU'I'IDN FILZ CHECK Smeo.R.Y POST-TAlI:-CN'l'RB-AMT 27 , 673 , 968 59 PRII:-TAX-CNTRB-AMT 29,942,205,909 . 37 DB-POST-TAlI:-CNTRB-1oH'l' 26 , 347 , 293.89 DB-PRII:-TAX-CNTRB-AMT 25,380,190,817 . 46 LOG-~ 839,8B7 , 724 RECORDS REl\D: 146,223,112 MAINriUIME :
CONTRIBU'I'ION FILZ CHBCK SUIoeQI.RY POST-TAlI:-CN'l'RB-AMT 27,658,136 50 pg-TAlI:-CNTRB-1oH'l' 29 , 942 , 205,909 37 D8-P08T-TAX-CNTRB-AMT 26,331,461 80 DB-PRE-TAX-CNTRB-AMT 25 , 380,189,01 •.•• LOG-~ 140,074,151 noad _ith Hu1ti:r. tch Record8 Read : 146 , 223,098
Figure 56:
'"
Result of Natural Program to Count Amount Fields
Figure 56 shows that the file on the target database (Windows) counts 14 records more than the file of the subscription database (mainfrarne). It can be that the file on the target database was not empty before the initial-state or a replay function was restarted.
4.2 AP! USR4Q11N - User Exit
4.2
59
API USR401 1N - User Exil
Many files don't contain amount fields and other comparisons must be found. Fortunately, Natural has the capability with its APIs. The program CHECKSUM uses Natural's ArI USR4011N to compare two Adabas files. 0010 8ampl. CHECKSUM 0020 1 Provid. OBIO. 0030 Pro .. id. f'i1. name in 'r:1L11: provid. Fil. Number in 'FILII:-NBR 0040 Pro .. id. f'i1. name in VIEW 0050 Provid. • tull OOM definition to11owinq VIEW 0060 Pro .. id. th8 LlU:CL in 'OOM 0070 0080 0090 0O", ot CHECK8UM aa CHltSM006 I'ile 6 0100 OBrINB DA1'A LOCAl. /. « « < INU' <187> 0110 'OBI (NS) (N5) /. « « < INI1' <250> 0120 INI,. <006> /. « « < 0130 'I'ILII:- NBR (NS) INI1' <, 81'-CALC-BDATB' > /. ««< 0140 'FILII: (Al2) VIEW 81'- NC- CALC- EDATB /. « « < 0150 IoOG-COUNTBR (PI5 .0 ) /. « « < 0160 0170 ENTI1'Y (ASO) LAST-CHGD-OATB-TIME (AlS) 0180 LAST- CHGD - USER 0190 (A08) CALC-CODB (AlO) 0200 E!T-DATE (AOS) 0210 B.... -DA'l'B-9C (A08) 0220 UP-DATE (AOS) 0230 (A250) 0240 Rl!:I)EPINB OOM 0250 0260 'DOM (Al65) ««< 6
,, ,•
•
•
..
,,, '" ,, ,, ,, ,,, ,,
,,, , ,•
,
0490 0500 0510 0520 0530 0540 0550 0560 0570 0580 0590 0600 0610 0620 0630 0640 0650 0660 0670 0680
m.
,
'*
OBI'INB SUBR()UTINB HASH-R'l'N ~1' "USR1040N " '1040 ASSIGN 14011.1'UNC _ 1 ~1' "USR4011N" 14011 ASSYGN 14011.1'UNC 2 ASSIGN 11023.MS *CPU-1'lMB R. RB10D MUL1'I-rBTCH ON OOM 8Y ISN ASSIGN 14011 ."rI!:XT _ 'OOM ~T "USR4011N " '4011 END- RB1oD ASSIGN 14011.1'UNC _ 3 ~1' "USR4011N" 14011 ASS:1GN 11023.MS • •CPU-TIME - 11023 . MS ~1' "USR1023N" 11023 DI8PLAY '08:10' 11040 . 08 'Recorda' *COUNTZR (R.) 'Ch.ck.um' '4011.HASH 'CPU 1'~' '1023.1'rHB (EH-HH :1I:SS.1') BND-SUBROU'l'INB
Figure 57:
Result of Natural Program to Count Amount Fields
Appendix, chapter 9.5.7 shows the entire Natural program 'CHECKSUM'.
60
4 Compare Files of Source and Target
..Database 300
ASSO
DATA
WORK
Figure 58:
Database 400
ASSO
OATA
WORK
Result of Natural Checksum Program
The program reads all records of the source and the target database, creates checksums and number of records. 80th number of records and the checksums must be identical, see Figure 58.
4.3
Compare Highest ISNs (TOPISN)
Anather way to make su re that the source and target files are the same is to compare the number of records of both files. But this won't be sufficient because you can have the same number of records in a file but the highest used ISNs are different; and this leads to erraT messages (RSP 113) during the replication process. Also, to compare the MAXISN won't work. MAXISN on both source and target can be the same but the number of records loaded can be different. The Adabas report shows both the number of loaded records and the maximal used ISNs of each file . Manually comparing Adabas reports of 200 files and more can be too time-consuming . At first, I wrote a parse program to compare programmatically the two reports. I included also in a spread sheet the TOPISN, REUSEISN and MAXISN fields. It showed in later tests that if the target files are not initially loaded with REUSEISN, it is a problem and leads to errors.
61
4.3 Compare Highest ISNs (TOPISN)
Source Database - Adabas on Mamframe File Records Number Loaded
122
12,434, 148
Figure 59:
TOP·ISN 12,440,
973
Target Database - Adabas on Wmdows
MAX·ISN
ISN Records Reusage Loaded
12,501 ,
Ye,
215
12,434, 148
TOP-ISN 12,440,
960
MAX·ISN
ISN Reusage
12,449,
Enabled
279
Compare Highest ISN (TOPISN) and Others
The disadvantage of using a full Adabas report in batch is that it can take up to 30 mmutes to finish the job with 200 fil es. In addition, some organizations must pay for used CPU time and I/Os. Source OB Mainframe 09:58:46 DBID 39
•••••••••••••••• • Fil. 122 ••••••••••••••••
·····ADABAS - Di.p1ay ST-UVIZW-LOG
Rec:orcb lO.&.c:l 12434148 TOP ISN . . . . . . . . . . . . 12440973 Ha .. ISN • ..peete
Figure 60:
Adabas Report Records Loaded, TOPISN and MAXISN (Mainframe)
Target database Windows Databa •• 2S1, Fi1.
122
(ST-REVIEW-LOG
Hi",h.a t Inc:le>< Level: 4 Top ISN: 12,440,960 R.eord. loaded: 12,434,148 La . t FOT ~fication: I8N .,.,uaa<;re: Enable
Figure 61:
26-~-2011
Paddin9 Faetora:
ASSO
Maxim". ISN • ..peetec:l: 03-~-2011
10 : 24:47
5\ , DATlI.
5\
12,449,279
11 : 21 : 59.055000
$pace r e u . a",e: Ciph.rin",:
Enabl .... Di.abl ....
Adabas Report Records Loaded, TOPISN and MAXISN (Windows)
Ouring my researches, I came along with a Natural program written and published on SAG-L in 1999 by Lewis Pritchard that determines the highest ISN in a file. Since there is neither an equivaIent Adabas nor a Natural function available (get the highest used ISN), I used this program and adapted it for my dient. Now, the Natural program uses the Adabas command 'Ll' with an 'F' in command option 2 to get the next highest, unused ISN (thanks to Larry Frazin).
62
4 Compare Files of Source and Target
The first parameter is the DSIO, the second parameter the startmg file number and the third parameter the number of files to be reported. 11 * -------------------------------------------------------------1/* D.teno.ine the hi'lh •• t u •• d ISNa per ~il. 11 * ISHHICH 112 ,1,10 1/* --- - -11 * I I 1/* DBID
+----------
"+
I I +------
1/* ,,>
start with t i l . nUJaber
+---- nwober ot fil •• to be reported / ' + ------ - ---------- - --------------------- - ---------- - -----------
1/*
IIISNHIGH
IUlEC NA'l'ßT ,OJ:PT-ST ,tI~EVL, SISOUT-+ ,Tnm_lOO, PRM-' IMootI ,MADlOooO • MAXCLaO , _ 0 ,LTaggngg , AtJ'l'OooON, DUaJIBEND' IISy.SOUT PD SISQUTw* t!CMPRTOl OD SISOUToo* IlslSIN PD. LOQON DIETER
If
".
ISNHIGH 112,1.10
"
Figure 62:
~
Compare Highest Used ISN OCL)
ISNIIIGH
Paq_ D1HI):
DBID: DRID: DBID: DBID: DBID: DBID: DBID: DBID: DBID:
Figure 63:
,
m m m m m u> m u> m u>
112 , 1 ,10
LIB-DIBTI!:R
03/28/11 ~,
~ , ~,
~ , ~,
~ , ~,
~ , ~,
~ ,
,, ,• ,,,• "
1 H:IGHJ:ST RIGHJ:ST RIGHJ:ST RIGHJ:ST RIGHJ:ST HIGHJ:ST HIGHJ:ST HIGHKST HIGHJ:ST HIGHBST
ISN: ISN: ISN: ISN: ISN: ISH: ISN: ISH: ISN: ISB:
08:14:2.
'", '" 1145 '" U5690 '"
llO0997
'""
Compare Highest Used ISN (Output)
The Natural program ISNHIGH is located in appendix, chapter 9.5.10.
5
Recovery After a Crash
Normally, the Event Replicator Server restarts automatically after an abnormal end and is able to recover any lost replication. But in same cases, data is lost and the replication must be replayed, as reported in chapter 6 with some response codes from the target database and Entire Net-Work. The new ADARPL utility and its REPLA Y function is similar to the known regenerate function of ADARES. ADARPL needs the protection log of the subscription database and must be run against the subscription database.
Mrh
•
RPL Buff., 160 MB
Figure 64:
Replay Function and ils Components
The replay can be run in the following three modes:
• Synchronized • Unsynchronized • Replay-only eo&. Po
S ?
Allowa you to:
Run replay proc ••• inq in P.eplay-only 1IIOd.. Run "apl..y p"""' • • • ing in .yncl>ronized lIlOdoo. Get help on thi. _nu . Ib,it the Adal>a. _ n t Replicator Sub. y . _
Figure 65:
Replay Modes
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_5, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
64
5.1
5 Recovery After a Crash
Replay with a Token
Initiate Replication Replay
From the 'Event Replieation Subsystem' and main menu seleet 'Administration' and from the administration menu select 'R' for initiate replay. In synehronized mode - that is Software AG's recommendation - the replay fune·
tion suspends new Adabas transaetions, reaetivates fil es, subseriptions, destinations that are inaetive and writes all new data to SLOC. lt also synchronizes the data with the new Adabas transaetions when processing is eomplete. ..... A 0 A 6 A 5
16:01:22
EIIl!:N'l' Rl!lPLlCA'l'OR SUßSYSTI!:M . . . . . Adlt.i.ni.tration
Funetion
Coda
D 1
P R 5 T V ?
2010-05-28 M-RPllOO
Dat&ba.a 10 P.rfODl Initial-Sute PLOG Infor.ation lnitiate R40p1ay Sy.tam Funetion. Ta~t Adapte r Global V.lue. Help B"it
Code COIOIIIand
_>
Bnte r -PF1- · -PP2---PF3---PF4-·-PF5---PF6---Pf7--·PF8---PF9---PF10--PFll--PF12--Help .... i t
Figure 66:
Start Replay Using Event Replicator Subsystem
ARrO0147: R40play proe ••• initiated - Tok.n-1582B 16 : 42 : 38 . . . . . A D A 6 A S EIIl!:N'l' Rl!lPLlCA'l'OR SUßSYSTI!:M . . . . . Initiate Raplieation Rapl.y
2010-12-23 M-RP2010
Synehroniz:.d DBID Automated Timeout Fr_ Date/Time To D.te/Time Start D.te/T ime o..tination N _ Li . t Sub.eription N_ Li.t
COIOIIIand
'"
N(Y or N)
'"'--2()10-12-20
+ • D251()09_
()2:0():00
D251010_
0251011_
_>
Bnt.r-PF1---PP2---PFl---PF4---pr5---PF6---Pr7---PFB---PF9---PF10--PF11--PF12--H. lp Z"it Sub S.l W.nu
Figure 67:
Initiate Replay Using Event Replicator Subsystem
5.1 Replay with a Token
65
DBID
Spedfy the database ID of the Adabas database from which you want replicated transactions replayed. Automated
lndicate whether or not you want the replay automated or not. Valid values are Y (perform an automated replay) or N (da not perform an automated replay). The default is N. NOTE: lf you have set the Record PLOG Information (RECORDPLOGINFO) parameter to N (or NO), you caIUlot set the Automated fie ld to Y. lf you specify N for the Automated field, there are manual steps you must perform. Specifically, once you have initiated the replay on this screen, a token is generated that must be used in a manually created ADARPL utility job. In addition, prior to running the ADARPL utility job you might also have to issue
a force-end-of-PLOG request to the Adabas database and wait unHI the resulting PLCOPY job has copied or merged the latest PLOG data set. If you set the Automated Held to Y, none of this manual processing is required . Timeout
Optionally, specify the length of time, in seconds, at which the replay request should time out. The default is 900 seconds. From DatefTime
Spedfy the date and time from which replicated transactions should be replayed . Dates should be specified in YYYY/MM/DD format; times should be specified in HH:MM:SS format. Replay processing will start with transactions in the PLOG that ended at or after this date and time. From dates and times must be earlier than the CUTTent da te and time and earlier than the specified end date and time. To DateITime
Specify the date and time to which replicated transactions should be replayed. Dates should be specified in YYYY/MM/DD format; times should be specified in HH:MM:SS format. Replay processing will stop with transactions in the PLOG that ended before this date and time. End dates and times must be later than the specifi ed start date and time.
66
5 Recovery After a Crash
Start DateJTime The date and time of the PLOG entries that should be used as a starting point for
the replay processing. This date and time are used to identify the PLOG with which to start replay processing. Dates should be specified in YYYY/MM/DD format; times should be specified in HH:MM:S5 format. Replay processing will search the PLOG with this start date and time first for records that match the other replay processing criteria listed on this screen.
A start date and time must be specified if an automated replay is requested. Destination Name List
Tab to these fjelds and type in the names of up to three destinations for replay processing. If you would prefer to seleet the names from a list, place the cursor on one of the three fields and press PF6. If you need to enter more than three destinations and to review the complete list of destinations, type an X in the singlecharacter space for this fjeld and press Enter. A screen appears on which you can maintain the eomplete list of destinations. When the replay request is initiated, transactions will be replayed that were originally destined for the destinations on this list.
lf you want to seleet all destinations for replay processing, tab to the first large spaee for the Destination Name List field and enter an asterisk (.. ). Note that onee you have entered an asterisk in the first field, you can no longer seleet any specifie destinations (errors will oecur if you try). In some versions, the file list is limited, see ehapter 6.4, Problems and Solutions.
Subscription Name List
Tab to these fields and type in the names of up to three subscriptions for replay proeessing. If you would prefer to seleet the names from a list, plaee the cursor on one of the three field s and press PF6. lf you need to enter more than three subscriptions and to review the eomplete list of subscriptions, type an X in the singlecharaeter spaee for this field and press Enter. A screen appears on which you ean maintain the complete list of subscriptions. When the replay request is initiated, transactions will be replayed that were originally solicited by the subscriptions on this list lf you want to seleet all subscriptions for replay processing, tab to the first large space for the Subscription Name List field and enter an asterisk (.. ). Note that onee you have entered an asterisk in the first field, you can no longer seleet any speeific subseriptions (errors will occur if you try).
67
5.2 Replay Without a Token
Up to Event Replicator V6.2, the file list is limited, see chapter 6.4, Problems and Solutions.
Important info: do not use the HALT command for Reptor if data is in SLOG. A Reptor restart will delete this leftover.
5.2
Replay Without a Token
Replay without a Token performs an unsynchronized Replay. All fil es to be replayed must be defined in the job. There are also other parameters that might be necessary, as FROMDATE, FROMTIME, TODATE, and TOTIME. 14: 33: 46 14:33 : 46 14: 33: 47 14:36 : 49
:rAT2000 IZP403l IEPlB9l IEP404l
A 0 A R P L
JOB STREPLAY (JOB59127) SBLZC'l'EO sn STREPLAY - STARTZO - TIM&-14.33.46 PllQEILEM PROGRl\M ATTRIElUTBS ASSlGNKD STREPLAY - BNOZO - TXME_14.36.49
va . l
SKl
0810 _
00039
st...:ted
(ln SAR)
2010-10-20
14:33 : 45
Par_ter.: lUIARPL R&PLAY lUIARPL ~600000K lUIARPL rla$-74
lnitiali"'ation h ... c:lfhak. for Reptor 302 a ucc • •• ful, Tarmin.tion hanc:lfh.ke for Raptor 302 .ucce•• ful
tok. n _ 15045
Total PLOG Block. Read _ 29787 Total "-t>lic.t.d tr .....ction . _ 21285 Kiqhw.ta r mark in r ep1ic.tion pool _ 1634940 T~.tamp of 1 •• t committad tr .....ction • 2010 - 10-15 14:28 50 Total " a p1ic.tad tr ... . . ction • • • nt to hpto" T."qat 10 302 • 21285
A 0 A R P L
Figure 68:
Tarainatad no.,..11y
2010-10-20
14 : 36:47
ADARPL Replay Output without a Token
After the REPLA Y, the source and target file 74 were checked with a self-written checksum program, see appendix, chapter 9.5.7.
68
5 Recovery After a Crash
10-10-20 10/20/2010 14 55: 30 . 0 Started CHltSM014
File FILE-OH DBID
Che ck. um Campari. oft Fil.' : 74 CPU T ....
beorda
OBID be1nq .cc•••• d : ~y
Fi.ld AE
~rom
14:55:30
3!J
Fil. 159 r •• d on wr 2: 1209074'"
39 2386' 4946D1UDl1707A80P526lAA1'17068BB655C6APC 00 : 00 : 00.0 DElID beinq ace ••• e
23866 Counter. match
Check....... .... tch 10/20/2010 14 56:24 . 8 End.d 00:00:54.8
Figure 69:
5.3
Checksum Program to Compare After Replay
Replay-only Mode
Replay-only mode processing performs replay processing on the replicated transactions in the PLOG, but discards any new Adabas transactions
5.4
Initial-state
In some cases, the target file is corrupted and a Replay won't work. There are two ways to fix the target file:
• Initial-state using the Adabas Event Replicator Subsystem Synchronization will be done automatically. Disadvantage: huge files (>100,000,000) can take too long because the replication process using Adabas commands to replicate • Decompress source file, compress file, re-Ioad target file Synchronization must be done manually Benefit: Adabas utilities are faster than single Adabas commands From the 'Event Replication Subsystem' main menu seJect 'Administration' and from the administration menu T for Perforrn lnitial-State.
69
5.4 Initial-sta te
16:01:22
..... A D A B A S
EVEN'l' REPLlCATOR SUSSYSTEM . . . . .
Adaoini.tration
2()1()-()5-28 M-P'Pll()()
I'uneUon D I
Databa.a ID ~r~orm I:nitial-St..ta PLOG Inf'o"",.Uon I:nitiata Raplay Syatam l'unetiona Tarqet Adaptar Global Valua. Halp Exit
P R
S
T V ?
Coda ...
CommatId
_>
Bntar-PF1---Pr2---PF3---PF4---PF5---PF6---Pr7---PF8---PF~---PF10--Pr11--PF12---
Kalp
Figure70:
Exit
SYSREITOR - Perform Initial-State
16:13 : 15
• •••• A D A B A S
EVEN'l' RBPLICATOR SUSSISTEM •• •••
Parf'or. I:nitial-Stata Initial-Stata N..... Sal
IDBI:D I:Fila I
+0100 1 +01003
Salaetion Critaria
2()10 - ()5 - 28 M-P.P4012
. .. ISl
0<
ISN Li.t
A A
CommatId _ > Entar- PF1 --- PF2 --- PF3 --- Pr4 --- PP5 --- PF6 --- PP7 --- PPS --- PF~ --- PP10 -- PF11 -- PP12 ---
Halp
Figure 71:
Exit
Sub
SYSREITOR - Perform Initial-State
Menu
6
Problems and Solutions
OUTing many replication tests problems occurred in the following areas and here are same solutions based on my Qwn experiences. • • • •
Source or Subscription Database Replicator Eogine Target Datahase Utilities
6.1
Source or Subscription Database
6.1.1
Replicalor Buffer (LRPL) Overflow
The Replicator buffer must be defined in the source datahase and in the Replicator Eogine by using the LRPL parameter. An overflow in the source database leads to a halt of the replication process for the file using this buffer at the time of the overflow happened because 00 overfl ow area (SLOG) is available. In general, the same situation happens with a replication overflow buffer in the Replicator Engine, even if an overflow area (SLOG) is defined but without a threshold. See also chapter 6.2, Replicator Engine. 13 : 47 :01 DBJ:D 134
, ,, ,, ,, 'W, ,, ,, 1'001 ". ,, 1'001 ,
Pool /
Qu. u.
Attached autt. r(NAB) C~nd Qu. u . (NC) (LJ"P) Fora. t Pool ,~, Hold Queu. ISN-Liet Tllbl. (LI) 'oq. ~. Tllble (LQ) Ue. " Que u e Unique OE Pool (DUQ) Securi ty (LCI') UQ Pil . Li e t (UQP) ATM Tran e. (:nO) Wo"": Pool (LWP) Red<> (LRDP)J: ,~) Replic.tion
Figure 72:
2011-01-13 1'AC!1H02
. . . . . A 0 A B A S BASIC SERVICBS . . . . . High W. t. r ~rk .
,
Si" .
1638400 19200 3000000 1134056 5000 20000 312312 60000 10000 96360
I I I
I I
I I
I I
, ,, , ,, I
I \ U.ed I
2152116 6528 2111111840 60088 1072 12784 115500 6208
D.t.
T ......
I
,
I I I I I I I I
13.1 34.0 911.11 5.2 21.4 63.9 36 . 11 10.3
I I I I I I I I
39000 I
4 0 .0 45 .8 0 .0 88.2
I 2011 - 01 - 13 09:51:14 I
, " "" "
1 50 0000
687124 I
5 24288000
4624837116 I
"
I I I I
2011-01-13 2011-01-13 2011 - 01 - 11 2011-01-13 2011 - 01 - 13 2011-01-13 2011 - 01 - 10
08 : 10 : 04 10 :08 20 : 18:43 11 : 24:011 09:48:30 09:411:06 19 : 01 : 18
'"
I I I I I I
, , 2011-01-12 13 : 13 : 14 , ,,
LRPL Overflow
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_6, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
6 Problems and Solutions
72
Tests in January 2011 with mass updates showed that more than SOOM should be set for the LRPL parameter.
6.1.2
High CPU Usag. 01 Soure. DB
When RPL was switched on in the production database and 9 batch jobs started eru time and the EXCPs of the source database increased dramatkally. The production database used more than double the eru time during replkation. Also, the 9 batch jobs that would normally finish in 2.3 hours now took 13.3 hours. in parallel, the
Based on statistics, these 9 batch jobs update 6 million records per haur update commands per secand.
Of
1.666
The table of Figure 73 dis plays the high eru time occurring in production on 12 Jan 2011 at 19:00 when the 9 batch jobs started and replication was active. Rep1icatioo was turned off on 13 Jan 2011 at 8:00 letting the 9 jobs fin ish before the online time began, JOB
IN TB TIME
PROGRAM
CPU TIME
EXCP TOTL
OB OB OB OB OB OB OB
AOARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN
0:03:45.83 0:03:03.99 0:02:04.08 0:00:15.25 0:42:1 1.47 0:47:04.52 0:41 :43.81
953,021 843,886 629,517 21 ,540 5,053,538 2,823,878 1,940,700
12JAN2011 :15:00: 10.41 12JAN2011:16:00: 10.41 12JAN2011 :17:00: 10.43 12JAN2011:18:00: 10.43 12JAN2011 :19:00: 10.43 12JAN2011 :20:00: 10.43 12JAN2011 :21 :00:10.43
OB OB OB OB
ADARUN ADARUN ADARUN ADARUN
0:41:37.33
2,278,851
0:15:04.88 0: 11 :15.67
3,748,049 5,823,365 2,749,801
13JAN2011 :07:00:10.44 13JAN2011 :08:00:10.44 13JAN2011 :09:00:10.44 13JAN2011 :10:00:10.44
(snip)
SOURCE SOURCE SOURCE SOURCE SOURCE SOURCE SOURCE (snip)
SOURCE SOURCE SOURCE SOURCE
0:06:54.78
(snip)
Figure 73:
High CPU Time - 19:00 Start of 9 Batch Programs
Figure 74 compares the both single and total duration of the nine jobs in December 2010 without replication (2:20 hours) and in January 2011 with replication (13:22 hours).
73
6.1 Sou rce o r 5ubscription Database
24 December 2010 Wlthout Replicatlon Fro m - To
Job
Durat ion
12 January 2011 Wlth Rephcatlon From - To
Durat ion
5031
19:01-21 :00
1:59
19:02 - 07:27
12:25
5032
19:01 - 20:58
1:57
19:02 - 21:38
2:36
5033
19:01-20:57
1:56
19:01-07:11
12:10
5034
19:01-21:06
2:05
19:02 - 07:58
12:56
5035
19:01-21 :21
2:20
19:01 - 08:22
13:21
5036
19:01-21:18
2:17
19:01 - 08:23
13:22
5037
19:01-20:59
1:58
19:01 -07:29
12:28
5038
19:01-20:59
1:58
19:01-07:30
12:29
5039
19:01-21 :00
1:59
19:01 - 07:33
12:32
TOT
19:01 - 21 :21
2:20
19:01 - 08:23
13:22
Figure 74:
Duration of 9 Batch Jobs With and Without Replication
After experiencing such a huge difference when replication was tumed on, the following tests in a different environment (LPAR) under production-like conditions (database, parameters, etc.) were run with only 20% data. Figure 75 shows four different tests with parameters of the source or subscription database and the duration (elapsed time) of the 9 parallel running jobs.
2
YES
40min
3
YES
74min
4
YES
Figure 75:
8
61 min
Duration of 9 Jobs With and Without Replication and Sou rce DB Parameters
Figuee 76 shows the CPU time of the souece oe subscription database with and without replication tumed on . The parameters are displayed in Figure 75.
74
6 Problems and Solutions
(PU Times ~ ~-----------------------
,, +-----
. (PU Time
20
o 1 w/o RPl
Figure 76:
2 w/RPL
3w/RPL-t
4w/RPlH
Duration of 9 Jobs Without and With Replication
The Strobe report (Figure 77) shows that the Adabas module ADANC6, responsi· ble for buffer pool activities, has most activities in the source database (up to 95<>/0) bu t not in the Replicator Engine. The module ADANC8, responsible for compress and decompress, surprisingly is not shown in the Replicator Engine, even if the decompress process takes place in the Reptor. Adabas Source Database - Strobe report SECTION
.~
. ~~ . ~,
. ~~ .~ . ~~ .~~ .~
. ~~
. SUPII:RVS
Figure 77:
LlNE
PROCEDURE!FUNCTIOK
- ~.
~co
SVC 114
-" _co
~"
~~.
~"
ADAIOS
-"
-"
SrARrING LOCArIOM
PROCEDURE LEMGrB
CPU SOLO
51.U 12.61
ADABAS BUFRit POOL MNGJ:R ADABAS SYSTEM SERVICES
." ."
~~
ADAlIAS THREAD SELECTIOK ADABAS CXPIUISS tlV'l' HNl)I,.R
.u
." ." .'" ." ."
ADASAS USR!BYP EXIT CALL ADABAS 1/0 PROCBSSING ADABAS QUlCUE PROCJ:SSING
ADABAS FORMAt TP.ANSLATOlI SUPERVISOR SJtRVIC!C9
IGCOO2U.
Strohe Report - Adabas Source Database
Adabas Replicator Engine - Strobe report ~= ,~
~
. ~-
-.
SECrIQN
~,
. St1PJ:RVS
IGc:0024A
..~ ~-
-co
~~
.~
~~,
.~
fNC 114
.~-
~~,
. ~-
.NUCLEUS
. ~-
Figure 78:
-"
IBAWSLIt;
-"
PROCE!IIiRII:/n.mC'l'ION
U~
~
~
~,
_co
-"
~.
-"
~~,
PSBSTft
S"tS'lEM SUVl:CJ!.S St1PERVlSOR SERVICES ADABAS USR!HTP DIr CALL ADABAS BurnR POOL MMGER ADABAS 1'IIRZAD s&UCrlON ~
~~
ADABAS ~r rRANSLATOR ADABAS QUEUE PROCBSSING SUSPEND LOCK SZRVl:CZ ADABAS 1/0 PROCBSSING
Strohe Report - Adabas Replicator Engine
SrARrING LOCArIOt/
_m~
LEMGrB
,~
~w
21.27 13.U !l.O!l 9.18 1.21 .00 3.64 2 .13 2.13 2 . 13
6.1 Sou rce o r Subscription Database
75
LBP and LFIOP at Source and Replicator Engine Buffer Usaga Durlng Repllcallon
• Da ' a F/ow·
OB 13. (PRODI Soure . I S"b sc rlp1lon OB
L
ru
L_
I
RH 8uff. , RPl _5 H,2U ,000 U .....d
lBP - 10 ,000,000
I
I
OB 312 jR.plorl R. pllc.1or Eniline
"
I,
'---
I
J
" ~
,~'''"
LFIOP _ gOO ,OOO _ 25 .. 01 LBP
8
1];. 000 .' "u ,h . .
~u''' '
000 .' "u ,h.,
~ . ""
I
..... , TU .. .
I
..!J. lBP - UOO .OOO
ry.
1/0 Bufl .. lFIOP - 25 .. ollBP
I
RPl8uH. , RPl _5 2. ,2 U,OOO 13"u u d
J
I ~u". '
$lOG .... 30
Dieter Storr - 14 Jan 2011
Figure 79:
Buffer Usage Between Source OB and Reptor
The Adabas buffer pool (LBP) on the Replicator Engine was set to a very low value of 3.6M compared with 70M on the Source database. lf updates on the Replicator Engine cannot be passed in time from its RPL buffer to the target database then they must be stored into its subscription log (SLOG), an Adabas file. And these updates must be passed through Reptor's buffer pool (LBP) and l/O pool (LFIOP). lf the data to be replicated cannot be passed fast enough from the source database to the Reptor then the RPL buffer of the source overflows. It is also a CPU overhead on the source database to ask very often the Reptor whether to be ready to hand over the next transaction.
Recommendation: LBP size of both source database and Replicator Engine should be the same, at least 150M.
76
6 Problems and Solutions
•• •• • 11. D 11. B 11. S
12:11:21 DBID 34
Ar..
-------- - ----- Pool a --------- - ----
Sort
(~S).
Int. u ••" Bu~~. r Suff. " Pool Format pool ISR Liat Tabl.
49920
(LU). 500000 .. 150023680
(~P)
5500000 (LI) .. 5000 (LQ). 20000
(Ln).
S~. Cmd. Table Work 5'001 Attachad Buttar Sec:urity Pool
(loWP) .. 1500000 (NAß). 400 (l.ci') .. 10000 (LDI!UQP). 60000
UQ-DB Pool rluah 1/0 Pool (L .. rop) .. 13000000 Br". R
(MSGBUP).
0
--------- Miacellanaoua -----------
bad only •••• ion (READONLY) UTI only •••• ion (UTIONLI) OPEN
1'1"0".
(OPENRQ)
~ qu.ir..:l
DIB Bntry
(LOCAL)
NO
(NT) (NONDBS) (AOSLOG) (BATeH)
Data p~t.ction Are. (LP) lqno". work part .. (IGNDTP) WORlt-Part-4 Are. (UlTP) WOR!t- P • .,t - 2 (LW!U'2)
Ar..
(SVC)
""""
=.
C_nd loo9qinq C....... nd Loq<Jinq YES
'" 00 '"
=~
""""" =" """"" =" ='0
=.
00 00 00 32756
,,
~
LOGSIZE DUAL CLOG Si z . DUAL CLOG 0.....
.= . .
,~
Figure 80:
.. .
NO
NO
Hwaber of Thraad
NO NO
(IGNDIB)
1.oca1 nuelau a
SVC
BASZC
SERV'l:C!E$ • •• • •
Di.pley P."..... ter.
,
00
30 HS NO NO
2011-02-24 PACPD02
------------- Qu.ue. -----------------(NC) 100 C....... nd Qu.u. Hold Qu. u . (NH) .. 40500 U•• r Qu. u. (NU) •• 1000
------------ TLme Window. ------------300 3600 3600 3600 900 3600 180 3600 ISO 3600
Tran •• ction T~ (TT) Me>< T.,an •• ction T...... (MXTT) Nonactivity JU:C-u •• ., (TNM) Non.cti ... ity ET- U••., (TNAE) Nonactivity zxu-u •• ., (TNAX) Me>< Nonacti ... ity T ...... (Mn'NA) T~ Limit Sx-Cmda (TLSCMD) Me>< T~ t"o., Sx-Cmd.. (MXTSX) C _ n d T~ (CT) SmS60 Inte.,...a1 UNTNAS)
-------- u ••., Specitic Limit. --------Hold Qu. u . L.im.it (NJ:SNHQ) 10000 CID. pe., U•• " (NQCID) 50 ISN pe" TBl: El_nt(NSISN) 51 ------------ Butt"• ., Pool -------------But"t."t"lu. h Du.,. (Tn.t1SH) 1 1'• .,.11.1 LFIOp 1/0 (~IO) .. B Aaync. by Vo1-S." (AS!TVS) HS ------------ Replic.tion -------------P.eplic.t:ion (REPLICATION) .. . l!:S
118000 00
,
43000
'"
---------- p.,ot. ction Loq<Jinq PLOG ".qui.,.d (PLOGRQ) 00 DUAL PLOG Siu (DUALPLS) 13500 (DUALPlD) 3390 DUAL PLOG D.... ic. NPLOG ...•...•..••..•...•..••..• 0 - ----------- Oth • ., S • .,...ice. ------------Tri'1\l'.r. end Procedure. (SPT) NO D. lte S ..... V.cility (DSF) NO C.ch. r .. cility (CACHE) NO Tran •• ction Man.q• ., (ATM) NO TCP/IP SUppOrt (TCPJ:P) NO Ext. I:.,.,or Reco .... ry (SMGT) NO 2 Ph.... C..-it Suppo.,t (DTp) NO Revi. w Support (REVIInf) NO
High CPU Time - Adabas Source Database - Used Parameters
The I/O buffer (LFIOP) is responsibIe to do asynchronous write I/Os to disk after fil led with blocks from the buffer pool (LBP), caUed buffer flush. It should be smaller than 25% of LBP minimizing Reptor's wait time to do the next buHer flush.
6.1 Sou rce o r Subscription Database
77
LRPL at Source and Replicator Engine
The RPL buffer of both Source database and Replicator Engine should have at least the same values. lf the RPL buffer of the Replicator Engine is also used to store data into the SLOG then the RPL buffer of the Replicator Engine must hold also the data from the SLOG to the target database via the buffer pool (LBP) and the replication pool (LRPL). Recommendation: LRPL=700M ADADBS DSBI=OFF 00 not collect before images of data storage for replication during the update of a
record on a file. OSBl=QN is only necessary for filtering data in a user exil. The parameters controlling the replication on the source or subscription datahase per file should be: JlDJIDBS REPLlCATION PlLE-006,0N, TARG.I!T-312 ,DSBlooOPP JlDJIDBS REPLlCATION I"ILE_ 001 ,ON, TARG.I!T-312 ,DSBlooOl"I" JlDJIDBS REPLlCATION PlLE-008 ,ON, TARG.I!T-312 ,DSBlooOPP .~.
Figure 81:
ADADBS REPLICATION and DSBI=OFF
ADARUN ASYTVS=YES .nd FMXIO=8 (m.x 16)
The FMXIO parameter sets the limit on the number of 1/0 operations that can be started in parallel by LFIOP flush processing. The value of FMXIQ must be adjusted after discussions with the system programmer if parallel access volumes (PA V) are available and the SLOG file is used causing replication data to be written and read from the SLOG file. Recommendation: both source database and replicator engine should be set to ASYTVS=YES and FMX IO>l, depends how much parallel 1/0 activities can be handled for PAVs. Log Input Transaction f LOGINPUTTRANS
This parameter defines the threshold of Reptor' s RPL buffer before using the Adabas file SLOC. It was reduced from 75% to 50%, regarding a former recommendation from Adabas Technical Support to avoid Reptor's lock in stress situations. Now, SAG recommends setting the threshold to 70%.
78
6 Problems and Solutions
AlU'O0045: o.ta"lt info "p:t.~d ..... A D A B A S 08:22:42
EVBNT RBPLlCATOP. SUBSrSTZH . . . . . Global Valu..
,
Subta a k .
Mo. ......._
;===:" !:~:~y ~.~ . ~~ . ~~~~~~ .. ~
OUtput Siz • . . , •..••..•• -
Enti"eX Brok." Stilb N _ Input Requ •• t M.s<;ll Lim.i t
100000
BltDmTSO
....
N N
Po"",,",t Bu tt." Validation
60
~cord Pt.OG information .... y _ _32767 Hax aecord Siz.
Retry Interval . . .
;-;-;===:i'
Lo'J Input Tran.action . ..
070
Max Variabl e Record Si",.
.••
Retry Count •.. , •.. , .. .••. .••
32167
10
, -"
2011-02-08 N-RPIIIO
Rl'L U. "9.
50 ,
~.t.art RPL U •• qe .•..••..• - '0 \ Input Q\Mou. !.eval . . . 0 No Match Leval • . ..• . .••..• . .. 0
01>_ Compla t1cm Leva l . . Compl. tion t. .... l
..• . .••..• . ..
,,
Rooq\MIat b e . i ....." LevMIat Zr"or Loo ....1 0 St.tu. Requ. •• t Le ... l ... . .. . I-Stat. Start Raqu •• t Loov.l
I-State Compl.tion Lev.l Retr ......... t Req\MIat r.. ....1
,,, ,
Subta . k ~tiv.tion Wait Open D•• tination. at Start C-nd - > Znt.r-PF1-- -PF2---PF3---PFf ---PF5---PF6-- -PF7---PFB---PF9---PF10--PFll- -PF12--Ha lp
Figure 82:
High CPU Time - Event Replicator Subsystem - Global Parameters
Use the Log Input Transaetion field to specify whether or not the Event Replicator should use its SLOG system file as a temporary storage loeation for incoming compressed replication transactions, before they are queued for processing. Once transaetions have been written to the SLOG system file, the Event Replicator Server processes them using a throttling mechanism so that only a Iimited amount of Event Replicator Server replication pool space is used at a time. Depends on the RPLPARMS parameter setting (FILE, PARMS, BOTH), LOGINPUTIRANS can be read from DDPRINT and/or from the system file. More than one replicator engine (Reptor)
Based on the number of files to be replicated and the number of files in one Adabas transaction, it is recommended to separate heavy updated files for Reptor A and B. This can be valid for 100 and 200 replieated files or transaetions containing 15 and 20 updates. The Reptor collects all updates for one transaction before it sends to the target database. Source DB stopped to replieate all files If you use UTILONLY=YES before you apply mass replication parameters in batch it will stop all replications.
6.1 Sou rce o r Subscri ption Database
lUIlUIBS ADADBS lUIADBS lUIlUIBS
REPLICATION REPLlCATlON REPLICATION RBPLlCATION
79
FlLE-OOl ,N:lDlrY ,DEACTlVATII:, TARGET-312 FlLE_002,N:lDlFT , DBACTlVATB , TARGET-312 FlLE-006,N:lDIFY,DBACTlVATB,TARGET-312 FlLE-012 ,N:lDlrY ,DBACTlVATB, TARGET-312
lUIADBS RBPLlCATION FlLE-201 ,N:lDlrY ,DBACTlVATB, TARGET-312
Figure 83:
ADADBS REPLICA TION DEACfIV ATE
Software AG recommends using the SY AOS function 'Modify file parameters' to activate w/o stopping the users.
6.1.3
ADAFRK - Transactions Turned Off
DDPRINT showed the message ADAFRK dbid transaction turned off. 14: 39: 32 14: 39 : 32 15:58:05 15: 58: 05
Figure 84:
ADAJ'RJ 00302 U... 01' SLOG I'or dAt
AOAFRK - Transactions Turned Off
This message displays after the last transaction in the SLOG has completed. Regarding to Messages and Codes, no action is required for this informational message.
6.1.4
Souree DB didn't eome down
ADAEND Replicator Engine - Reptor came down AOAEND for source database didn't work - received the message: ADAr1J: 0013' Waitinq t.or replication dAta to b
Figure 85:
Source OB Waiting for Replication Message
Solution :
.. Bring up the Replicator Engine .. Subscription or source database can hand off the replication da ta .. Subscription or source database comes down automatically from former ADAEND .. The sou rce database must receive AOAENO before the Reptor.
80
6 Problems and Solutions
6.1.5
File Changes Won'! Replica!e
Changes of replicated production files in the source database must also be done at the target database. Adabas does not replicate automatically file changes in Adabas on Windows. The following process must be done manually:
#1: lock file #4: change file #7: unlock
Figure 86:
file
#2: SLOG ompty 1
#3: dos. destination #5: chante file #6: unlink/link GFI
#1: open destination
Manual File Change Procedure - Dataflow
#1: Lock the file in the source or subscription database, effectively stopping replicalion.
• ADADBS OPERCOM STOPF=fi!e,PURGE stops a1l users who are using the specified file and delete their user queue elements - don't use STOPI=l,PURGE, logical inconsistencies in the database can occur (see Utilities Manual- OPERCOM: Issue Adabas Operator Commands ) • ADADBS OPERCOM LOCKU=fil e locks file for all non-utility use #2 Verify whether Reptor's SLOG is empty or no pending transactions are displayed for the relevant file(s). If not, wait before continue with the next step. • Display Replicator Stalistics •
SYSAOS
• • • • •
Replicator Management F Display Replicator Statistics B Replicator Statistics SLog statistics for items ... On file .. xxxxx (total on SLOC file) PF6 = individual destination SLOG statistics
81
6.1 Sou rce or Subscription Database
• • • • •
Display Destination Statistics SYSAOS Replicator Management F Display Reptor statistics D Destination Statistics
15,24,11 ~p1icator
302
Rep1icat.d tran.
. . . . . A D A B A S BASIC SERVICES . . . . . Rep1icator Stati.tic. / ..... .a !l"
/ by t . .
Total trn . Pendin!l . . Me" '!le. Tot ....!l. Byte• • ,nt to all de.tination. Tot byt•• .
32,71~
On
~i1e
11 ,146 13,~54
. ,
Me •• aqe • • . . ayt. • . . Coamit. "" Bac:kout• . . , Dele ted total.
SLoq . tati.tic. tor itema n.lO
2()10 - 10- 14 PRPTSI0
~rOlll.
input que u e.
Me •• a!le. Syta. Co.ait. S ac:kout.
2,83~
~play dbid/token cnt n..tina tion . 109 <::nt
PF1 --lIe lp
PF3--E.dt
Figure 87:
1 5,35,20 ~ plic: a tor
n..t
N .....
--------
D251018 D251035 D251035 D251035 D251035 (.nip )
Figure 88:
PF4 ----~~.,..h
PF5-------DBID/Tokan
PF6 -------De.t, SLOG
PF7 ---
pn---
•
PF12 -----
Manual File Change Procedure - SLCX:: Check
,.,... _ _._ _.. '"
2010-10-14 PRPTS04
. . . . . A DAS A S BASIC SERVICBS' . . . . - n..tin ation Stati ' tic ' -
,
Total plndinq trana
".
3,091 5,764 5,954
Manual File Change Procedure - SLCX:: Check
2 ,098
""
82
6 Problems and Solutions
#3 Close the destination if SLOG is empty
• SYSAOS • Replicator Management • A Activate/Deact/Open/Close • Y Close Destination #4 Implement the file chan ge in the source or subscription database If not already done: SYSDIC I M Maintenance ET / Extract Maintenance / Add and Build an Extract • SYSDICBE / U Unload Migrate, Identification '" Extract name I L Load Migrate • Start SYSDIC / Generate Adabas File in batch • FTPthe Predict report from the mainframe to a Windows drive •
( . nip)
000018 I /PRDLDPIL EXEC
NATBT , OEPT-ST , Oa-,ZNV , PRM- ' ~,Z~FP , ~'
000019 II~NT 00 DIS P- (,PASS),SPACE_ (TRK, (lO,lO),RLSZ) ,DSN_ "TEMPOOl 000020 / /SYSIN 00 . 000021 LOQON $YSDIC 000022 MENU 000023 GENERATE I'DT
000024 FlLE-Io-DIBTER-TEST-ADABAS\ 000026 000027 000028 000029 000030 000031 000032 000033 000034 000035 000036 000037 000038
OB-STRS-OBl12 \ Oamt-112 \ LOAD-N\ REl'LACJ:-I'DTaN\ Ul'tl-I'DT-T\ Ul'tl-l'~N '
REl'LACB-ZMPTY_N' REl'LACJ: - CRlTaN ' RENUMIIBbN% OAT~Y '
to:rsor-n STOPP.Y rl:N
000039 1 * 000040 Ilrrp
&XBC 1'GM-rrp , RBG:l0N_4N,P~ ' (TXNBOUT 100 TRACI: BXYT' 00 SYSOUT-* 000042 IISYSl'RZNT 00 SYSOUT- . 000043 IISYSTCPD 00 O:lSP-SHR , OSN_SYS1 . TCPl:P.PARHt.IB(TCPDATA) 000044 IISYSrrl'tl 00 DISP-SHR,OSN_ SYS1 . TCi'Ii'. i'ARHt.IB (c rrPDATA) 00004511rrPINl OOO:lSP-(SHR , l'ASS),OSN_*.i'RDLDFlto.N . CHPRINT 000046 IIINPUT on OlS P-SHR,OSN-D I BTBR.CCARDs( rr l'LOGON) 000041 /I 00 * 000048 CD Ri'L- rxLECIlANGES 000049 ASCII 000041 l lOUTPUT
000050 POT I/DD : rTPINl 000051 <;)UIT 000052 END (.nip)
Figure 89:
Manual File Change Procedure - FTPPredictChanges toWindo ws
6.1 Source or Subscription Database
13:44 : 1ii
•••••
PREDI C T 4.5 . 2 Gen . rate ~. ~il. DIETER-TEST-ADABAS STRS-DB112
83
.....
...
2010-11-17
01'11 . ID Containad in DA par. . .ter OA<::tion FILB_999 ODBFnlT I'NDEr-' 01 ,All., 80 , A ,DE' r i . ld: r I ELDl I'NDEr- ' 01,AB,10,A' ri.ld: rIELD2 I'NDEr- ' 01 , AC , PI! , Fi . ld: PE-I'IELD I'NDEr- '02,AD , 10 ,U, NU' ri.ld: PE-FIELD2 I'NDEr- ' 02,AE,3,U,NU'
'h< PDBnr
m
Fi . ld : I'IELD -76 I'NDEr-' 01,CZ,7,A,NU' Fi. ld : I'IELD -7 7 SUPDE_ 'S l-AA ( 1 , 80) ,AB(1,10)' Fi. ld : SUPl!Rl LOADFILE NOl\.CEX'l'ENSIOt!'-NO MIXDSOzv-n:S DATAFRM-ncS HAlClSN-1271 NAMEaDIE'l'ER- TI!ST-ADAB FILB_999 MINISN-l ASSOPI'AC_I0 DATlU'I'AC_ I0 PGHREFRESH_NO
ISNSlUa3 INDKZCOHPRKSSION_ncS ISNREUSE_n:S DSREUS_TES H1oXDS_O Hl'.XNI _O HAXUI _O CIPHER-NO HAXRECLooS060 UISI ZE-18 NISIZ_ 18 DSSI ZE-18 DSDZV-3390 . . . . . PR E 0 I C T 4 . 5.2 1 3:44:19 Gen . rate ~. ~il. DIETER-TEST-~ OFil. ID . . . . . . . . . . . . . STRS-DB112 Containad in DA
.....
PRBDICT 4 .5 .2 Gen. ra te ~. ~il. -
.....
'h< PDBnr
.....
01'11. 10 . . OIB'l'ER - TI!ST - ~ Databa . . 10 .. STRS-D8112 OIC23U ~ I'ILII: ' OIBTI!R - TI!ST-~ • GBHERATED . FIELD OATA I'IN HAT9995 Natural •••• ion t.rminatad normal l y .
Figure90:
...
2010-11-17
m
11/17/10 1 3:44:19 2010 - 11- 1 7
pmr ii9 9 PDBnr 112 IHPLEMI!NTATION AHD DOCU 0
Manual File Change Procedure - Predict Change Repo rl
6 Problems and Solutions
84
#5 Implement the file change in the target datahase • Automated process An event-driven pracess will automatically parse the Predict report for DEVFDT and LOAD FILE information and update the target database. Figure 91 - shows the dataflow of the file change process. It can be automated on the mainframe site. Updates on the open system site must wait until all transactions for the file(s) to be replicated are no langer in the RPL buffer or the 5LOG file. It also should be discussed whether file changes can be done before or during
a program migration. New files: can be done before the program migration. New fields, descriptors and superdescriptors: can be done before the program migration. Adding new fj elds into a PE group: must be done during program migration. Field changes: must be done during program migration. Release descriptors: must be done during program migration.
• Manual process Remote Desktop Connection Adabas DBA Workbench Select a Database List Files and Select Seroll down using the file or descriptor tabs Apply all changes #6 Unlink and link the GFB to get and save the new field formats on Reptor's system file • • • • •
SYSREPTOR G Global Format Buifer Definitions Select the name of the global format, e. g. G300009 Mark Predict parameters Unlink (PF6)
#7 Unlock the file in the source database to restart the replication • •
ADADBS OPERCOM UNLOCKU=fi!e Unlock the specified file for utility use and restore it to its pre-Iocked status for non-utility users
6.1 Source or Subscription Database
Onlin. SYSOICBE EXTRACT
85
OB 1.2_ UAT
Maln1r.m.
Blich SYSOIC
CST69
Parse Info to load new flies Of change exisling files
Figure 91:
Manual File Change Procedure - Dataflow
#8 Open the destination • • • •
SYSAOS
Replicator Management A Activa te!Deact/Open/Close K Open Destination
08251 CSTZOO7 1 csnoOl
86
6 Problems and Solutions
1 0:56:18 Replic:ator 302
. . . . . A D A B 11. S
BASIC
Sarvice
Codo
•u r , • ,
,• ,, ,
Activau. laa tina tion
Acti". t . D81:0/ril.
o ••cti.... t. Subac ription O•• cU .... t a O•• tina t ion
O••cti.... t. DBlo/ril.
U
Actl",at.o DSID Open O•• tin.tlon
Open
2010-11-08 PRPTD02
Sa rti.,.
Codo
Activat. Subacription
U
SERVICES •••••
- Replic:ator Ac:tivate/De&c: t/Open/Clo •• -
I~u .
D••.,ti... ate DBID
eIo •• o.atinatlon elo •• lqu.... Exit
Ha lp
CO
Subacripticm O •• tin.tlon ..•• :::::::: lqua u a . .
o.tab•••
ID ••••
Pil. PFl----- 5OF2------ PF3------ PF4------ 5'F6----- PF1----- PF8----- PFl2----Ha lp Exit
Figure 92:
Manual File Change Procedure - Open the Destination
6.2
Replicator Engine (Reptor)
6.2.1
NAB Overflow
The Replicator Engine uses for each update command (store, update, delete) in one transaction aseparate attached buffer (AB). It co1lects and holds a1l update commands until the transaction receives an end-of-transaction (ET) command. It sends then all Adabas commands of this transaction to the target database .
_.,Ip"', ......., •• 11'
I
NII.wt l
Figure 93:
I
ADAP18
.- -_. --......, -
-U211
1 I
NII.0421
1 I NIl.·... I
11so Itoutoors
~-
"nNo, 1.......
~
"
.1 ...". ~ ~
1-
~
NAB Overflow on Reptor
Al c:-.d to 0810
Figure 94:
."
_
300 FNR
NAB Overfl ow Message
18 RSP
2 5 4 aubcode
3 ISN
D8 300 Destination
er_rg,t)
87
6.2 Replica lor Engine (Replor)
RSP 254 = An internal error occurred during processing of an attached buffer (buffer overflow) Subcode 3 = CQEFLAG is not equal to CQEFAß plus CQEFW16 Solution: Replicator: NAß 420 is too small and should be increased . Each update command (store, update, delete) in one transaction (ET) needs one attached buffer. The formula in the manual is not correct. It must be: NAß = 41 x 10 x number of source databases (e. g. 1) x number of updates per transaction (e. g. 15) NAß=41 x 10x1 x 15=6,150 The high-water-mark of the attached buffer (NAß) is observed with the AQS command.
- -Tb •
• "tu.l ~or
biqh - ... t . r - ... rk . (. xcapt bu~f . rpool)
th. major pool .
~,-
HIGH-~TER-~
-----------------------------------------------
-""'" DUO -POOL '" -""'" -""'" "'Q -""'" lU'L -POOL ,e -""'" TBI -POOL ~
TB8 -POOL
'"
-""'"
U<;!P - POOL IiORJI>-POOL XID - POOL
Figure 95:
6.2.2
'"
23040 w_ 100000 300000 560056 ~ ~~ 157286400 ~~ 10000 12000 20000 4000 ~ 4000 ~ 500000
~ -
"'"' --
-
,,~
,, ", ,, ,, "" "" , , '" '", , , ,, ", "" '" , ,• "" ,, , " , ", "" "
1715456 1920
on
29888
...
149875480
17248 3168 53112
NAB Overflow High Water Mark
Replicalor Buffer (LRPL) Overflow
The Replicator buffer must be defined in the source database and in the RepUcator Engine by using the LRPL parameter. An overflow in the source database leads to a halt of the replication process because no overflow area is available.
In general, the same situation happens with a replication overflow buffer in the Replicator Engine, even if an overflow area (SLOG) is defined . The trick is that you have to set a threshold in Reptor's RPL buffer. If the threshold is reached, for example 75%, all incoming transactions will be stored into the SLOG area.
88
6 Problems and Solutions
After new tests in Oetober 2010 with mass updates the parameter LRPL is set in both source database and Replicator Engine to 600MB. The high-water-marks
._.
show now for the souece database 80% used and for the Reptor 74% used .
I DI.n ......-
--013.2
(_ _I
I
LIt'l.
,.mp,·,Zr 'IIMB
r.cords
De-eomp ISled
LIt'L_
''''''1
I
.
\
\
SLOG • AdMI •• nie
\
.... it .. Cri
r.cords
--
-
I
ErotIR Noot· ~.
ARF •. 3.t.t, ..expanded LRPL rrom 160M B 10 30 0MB
-S .t RPl limit 10 75 %
Globe l V.lu.5Ilog Input Trans Belion 07 5
.1 ••• 11 CrI
Figure 96:
-SlOG will b. " lied lIfter 75 % SLOG 111 un d
LRPL Overfl ow Reptor
The high-water mark of the attached buffer (NAß) is observed with the AQS
command. Tb• •etual ~or
h1qh- ... t . r-.arka th. _jor pool, (.xcept bu.f:f:.rpool)
-
ADARUN PARM
U
'" "" "
'.
~L
"m
n, UQ
-"",L -"","
-"",L -"",L -"",L
-"",' -"",L
-"","
- "",L -"",L
00" - POOL WORK-PQOL XID - POOL
Figure 97:
.c "
'"
23040 W~ 100000 L>~ 300000 560056 ~ " ~~ 1572B6400 ~~ 10000 12000 L' " 20000 4000 ~ " 4000 ~ " L_ 500000
"' " ,,~
.., ""
HIGH-~TER-~
1115456
1920
, .,.," ., '" " .,., '" ,•• .,., .,., "'" on
211BBB
...
0 0
14I1B754BO 0
0
17248 3168 53112
0
LRPL Overflow Reptor H igh Water Mark
89
6.2 Replica lor Engine (Replor)
6.2.3
SLOG Overflow
The overflow area of Reptor's replication buffer (SLOG = subscription or source log) should be defined with sufficient space to hold all transactions from the source database for a couple of days in case the network or the target database have problems and the destination is c1osed. 1I is recommended 10 use an entire 3390-disk for SlOG 15:01 : 52 OBIO 302
•••••••••••••••• *••• *••• *•• ** •• *
. . . . . A 0 A B A S BASIC S&RVICBS . . . . . - Oi.p1ay I'il . Layout ST-SLOG
bco,,~ loadood . . TOP ISS •..•...•..•• Ha" ISS . xpac:Ud Min~ ISS ...•.. Siz. o f! ISS . . Rumba., of UpdaU. ISN bu•• q. S~ce Rau.aqe ADAM l'i1. Ciph• .,ed. ril. Coupl.d l'i1 •• Blk p"r OS Itxt. nt Blk p"r UI Itxt ... t Blk p"r NI Ext. nt F"• • •pa". a ... ailab1a
I D. ... LiI I 'l'ypoo TyI
,
,
2010-09-24 PtlRI'042
35625 35532 5000655
2010 - 01 - 25 13 : 55:09 Oau loadad. Dau of 1a.t updau 2010-09-24 15 : 01:08 Max Comp" bc Lnq1:h 5060 "".o/OaU Pa cldinq •..• n/n
,
Hiqh •• t Inde" La .... l
4 ByU. 529H
,.. ,..
RPLUPDATBONLY . No USZRISN No MIXD$OIV ••••• No Sp... nad. "." . . No iteplic.tion .• No uni ....".al Encodinq
No No
N=. , o o
f!o" fil .
,
•••
Ind>< Comp
No
PGlCP.EFRIISH
,
NOACEXTENSION .. No MO/PI! indic •• NO
,..
Total Chanqed Blk. .. . 31102 Multi CH.nt I'il• . .. . 0 a"t.nt.: At l.a. t 134 B"tant.
Space allocaud I Bloch I Cy1& . I
FrOlll. RJIBN
To RABN
I unu •• d I BLOCJtS
/
Cy 1& •
, ------------------------1-----------------, ,, ", , , ,
----I--------I-------------------I 5891
ASSOI 3390 ACI ASSOI 3390 UII ASSOI 3390 NIl
,
,
291000
'"
1100 I
~.~
3390 OSI
995700
6638 I
Figure 98:
1780 304671 1677
7676 I 304816 I 304616 I
0 194 296556
1098
996250 I
892920
5952
Adabas Reporl SLOG file
Check the follo wing parameters if SLOG is used as an overflow for the RPL buffer on Reptor
• • • • • •
• •
ASYTVS FMXIO LBP LDEUQP LFIOP LP NH N ISNHQ
Async Buffer Flush Based on VolSer# Max Number of Parallel I/Os by LFiOP Flush Proc Buffer Pool Unique Descriptor Pool Asynchronous Flush Pool Work Part 1 Number of Hold Queue Elements Number of ISNs in Hold Queue for Users
90
6 Problems and Solutions
6.2.4
RSP 153 from the Target OB
According Messages and Codes V6.2 SP2, Adabas can only handle one call at a time. Adabas response code 153 is reported by the Replicator Engine in DDPRINT: 11:07:34 ADArS4 00302 Replication • .,ror: Adabaa deatination 0251011 11: 07: 34 AOAJ'54 00302 Soure. DBID 39 rm:t 11, Ta"qat Dsto 251 FNR 11 AD.U'18 N2 caod to DBID 251 rm:t 11 RSP 153 . utx:ode 16... 8 18N 75423 13:00:04 AD.U'54 00302 a.plieation a.,ror: Adab •• deatination D251044
13; 00: 04 ADl\.l'S4 00302 Soure. DBID N2 c:md. to DBIO 251 I'NR
ADAJ'18
39 FNR 44 RSP
4', Ta"qat DBIO 153
. ub~
251 FNR
16448 ISN
ADAF54 2010-11-22 13:00 :04 Replication • .,ror: Adabaa deatination 0251044 ADAJ'54
Soure. DBID
AllJI.F18
N2 caod to DBID
39 I'NII.
251 FNR
44, Tarqat DBID
... RSP
251 PNR
...
522015
44
153 aubcode 16"'8 ISN
522016
ADAP54 2010 - 11- 22 13:00 :04 Rap11cation • .,ror: Adabaa ~atination 0251044 ADA:f'54 Soun::. OElIO 39 1"NR 44, Tal
Figure 99:
Response Code 153 Shown in Reptor
The command log of the target database shows that the reported ISNs are not replicated. For file 44, the missed 52 lSNs are 522015-522029, 1088638-1088673, and 1088678. Surprisingly, the response code is not reported in the command log of the target database and therefore seems to be set by the ADALINK routine in Entire Net-Work. ~n
~
l:OA IOD
,~
2113174 2713175 2713176 2713177 2713178 271317\1 2713180 2113181 2113182 2713183 2113184 2713185 2713186 2713187 2113188 271318S1 2713190 (anip)
22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-N(lV-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010 22-00v-2010
Us.R-IO
NODlI:-ID
~"'
loI)2(lIJ:J:l/loI)2
,,~
...... ...... ...." ....,"" ......
,~
------------------------------------------------------------------------------------------Canip)
Figure 100:
"" """" ""'"' "" "" "' "" "" "'
13:00
00:05 00:05
""'0' "" "" "' "" "" "' ""'
13 :00 13:00 13:00
00:05 00:05
13 :00 13:00 13:00
"
"" "" """ """ ,,"" ," "
.•.
STCIlIU51 STCIlIU51 STCKK251 STCIlIU51 STCIlI(251
· .lI:. · .8. · .8 . · .B. · . 8 . · . B. • . 8 . · .B. · . 8 . · . 8. · . 8 . · .B. · .8. · .B. · .8. · .B. · .8. · .B. · .8. · . B ... B . · .B. · . 8 . · .B ... .8 • · .B. · . 8 . · .B. · .8. · .B. · .8. · .B. · .8.
N>
N>
.,.,., N>
.,
0'
"'
tt tt .N>
.., . 0" . N>
.N> .N>
"" """ "" "" " ,,," ,, ,
Response Code 153 - CLOG Adabas Windows
00000140/ @. 0000013B/: . 00000131:/>. 00000135/5 .. 0000013C:/<. 00000140/ &.. 00000000/. 0000013C:/<. 00JA012B/+ .. 00000000/. 00000000/ ... 00000138/, . 00000000/ ... 00000150/P. 000001~0/P.
00000131"/? . 00000130/_.
522008 52200\1 522010 522011 522012 522013
,"
522014
,° ,
522030 522031 522032 522033 522034
6.2 Replica lor Engine (Replor)
91
This response code is caused by a Natural batch program, job STCHK25l, reading arecord from file 44, and it is the same file as the file to be replicated. In another case, file 23] was read, when file ]] was replicated. As another customer reported, this also happened w ithout active replication and two batch programs try to read records from the replicated Adabas database on Windows. The following example shows that file ] 1 of database 251 received response code ] 53, when trying to store ISN 75423 via a N2-command . The command log shows that ISN 75423 is missing at the same time a LF-command was issued for file 231 . .. "''''"" DDPRlN'r o~
lUlAI'18
.. "''''"" th.
REC
N2 COIIIod
a.pu.r:
u.
~nd
DBID
log ot th.
DATE
79219 22-NOV-2010 11 :07:35 79220 22-NOV-2010 11 :07:35 79221 22-NOV-2010 11 :07:35 79222 22-NOV.201 0 11:07:35 79223 22-NOV-2010 11 :07:35 79224 22-NOV-2010 11 :07:35 79225 22-NOY.2010 11 :07:35 79226 22-NOV-2010 11:07:35 79227 22-NOV-2010 11:07:35 79228 22-NOY-2010 11 :07:35 79229 22-NOY.201 0 11:07:35 79230 22-NOV-2010 11 :07:35 79231 22-NOV-2010 11 :07:35 79232 22-NOY-2010 11 :07:35 79233 22-NOY.201 0 11:07:35 79234 22-NOV-2010 11:07:35 79235 22-NOY-2010 11 :07:35
Figure 101:
75423
153 . ubcode 16448 ISN
I:a~t da~ •• :
DUR
'OW
11 PSi'
251 nIR
•• •• •• •• •• "• •• •••
USER-ID
CMDRSP AD2(H EX)I
.. 8 ...8 . .... - ... .. 8 ... 8 .....- ... .. 8 ... 8 .....- ... .. 8 ... 8 ..... - ... .. 8 ... 8 ......... .. 8 ... 8 .....- ... .. 8 ... 8 ..... - ... .. 8 ... 8 . .... - ... .. 8 ... 8 ..... - ... .. 8 ... 8 .....- ... .. 8 ... 8 ......... .. 8 ... 8 ..... - ... .. 8 ... 8 .....- ... .. 8 ... 8 .....- ... .. 8 ... 8 ..... - ... .. 8 ... 8 ..... - ... .. 8 ... 8 .....- ...
N2 N2 N2 N2 0P N2 N2 N2 N2 N2 LF N2 N2 N2 N2 N2 N2
o o o o o o o o o o o o o o o o o
0000004EJN...
000000821 .... 000000681k... OOOOOOCDJ... OOOOOOOOJ .... 000000751u ... OOOOOOE9J... OOOOOOSOIP... 000000041.... OOOOOOSOIP... 000004F4I... S ooooooaEJ ... 000000881.... OOOOOOCF/.... 000000851.... OOOOOOA7/ .... 000000801....
FILE IS"
11
TH 10A IOD
••••••••• • ••• ••••• •••••• •••••• •••••••• ••• •••••• ••
11 11 11 11 11
75414 3 75415 5 75416 15 75417 20 01 • 75418 1 75419 16 75420 19 75421 12 7542217
11 11 11 11 11 11
754241 4 7542518 75426 4 75427 6 75428 9 754291 1
11 11 11
•
'"
..
1
Response Code 153 - not shown in CLOG of Adabas Windows
According to Empower, this response code is known since December 2009. What is new that same records as part of a transaction were not replicated, they d isappear. lt seems at this time that the response code 153 doesn't come from the target database; it is coming from Entire Net-Work. Sending a simple PING from CICS does not create RC153; but sending it from batch, RC153 is repeatable. Based on the trace, the Adabas session ID contains binary zeroes. This has been solved with WCP733X003 - WCPv733 Hotfix #3 for Windows 2003 Server from 7/31/2009 and Hotfix #4 for Windows 2008 Server. Entire Net-Work's link routine was fixed. • • •
Adalnkx.dll Adamplnk.dll and others
v6.2.1.38 v6.2.] .38
The solution is also available for UN IX and Linux.
92
6 Problems and Solutions
For v734
• Adalnkx.dll • Adamplnk.dll • and others
v6.2.1.48 from 3/4/2010 v6.2.1.48 from 3/4/2010
Software AG also recommends setting ADABAS_TIMEOUT on the dient side (WCL) to the same value as the transaction time (!T) on the remote database.
The reason for the RSP 153 seems to be dear now: ISN's are in HOLD state on database, Natural runs with parameter WH=ON and ADABAS_TIMEOUT is lower than TRANSACfION_TIME on Adabas. But it still doesn't explain why same updates of the transaction did not replicate and others of the same transaction did.
6.2.5
RSP 113 fram the Target OB
The errOT codes are parsed from REPTOR's DDPRINT. The Reptor can determine
between three different actions: • The record will be updated if the record already exists. • The record will be inserted if an update carmot find the record . • No action if the record to be deleted does not exist.
14: 37: 03 ADAF54 00312 Soure. DBID 134 rm:t 122, Tar'i. t DBID 134 JrNR 122 ADAF18 N2 CIIId to DBID 134 JrNR 122 RSP 113 .ubcode ISN 12440914 ADAFCV Tb. r .cord. to be in • • rted. a1r. ac:ly . xi . t . On th. "r'i. t DBID/fil . ~ Th. r.cord. will be updated. ADAF54 2011-01-05 16:39:59 Replieation .rror: Ac:labaa da.tination D251112 ADAF54 Soure. DBID 134 JrNR 112, Tar'i.t DBID 251 JrNR 112 ADAF18 11:1 CIIId to DBID 251 JrNR 112 RSP 113 .ubcode ISN 435139 ADAJ'CU Tb. r.eord. to be da1.ted d.o,. . not . xi a t on th. "r'J.t DBID/fil . 19:13:41 ADU54 00312 Soure. DBID 134 JrNR 154, T.r'J.t DBID 251 PNR ADAF18 Al CIIId to DBID 251 JrNR 154 RSP 113.ubcoda ISN ADA!'CU Th. r.cord. to be upc:lated c:loaa not. .xiat. on t.ha "r'J.t. DBID/fl1. ~ Th. r .cord. will be in.a rted.
154 33
20: 16: 44 ADAr54 00312 Sourea DElID 134 JrNR 148, Tar'iat. DElID 251 JrNR 148 ADAF18 N2 c:md to DDID 251 PNR 148 RSP 113 aubcoda ISN n430 ADAFCV Tha r acord. to be in.arted. .1ra.d.y a xi .t.. on tha "rqat DDID/fila ~ Tba racord. wl11 be updatad .
Figure 102:
Response Code 113 - Message in Reptor
93
6.2 Replica lor Engine (Replor)
Reasons jor RSP 113 ISN REUSAGE was not enabled on the target files. ADAREP displays two values Enabled, lnactive It means that ISN REUSAGE is set to this file, and there are no UPDATEs or IN-
SERTs being executed at the moment (no ISNs are being reused at the moment when ADAREP was run). Enabled, active It means that ISN REUSAGE is set to this file, and UPDATEs or INSERTs are be-
ing executed at the moment (ISNs are being reused at the moment when ADAREP was run). Oataba •• 251, ril.
122
(ST-RBVIEW-LOG
High •• t Index Le. . 1: 4 Top ISN: 12,440 , 960 Rac:ord. loaded: ~.t
FDT
Paddinq rac:tor.: ISN ._c:ted:
1.9SO
~im"",
S' 12,449,279
5 ' , DATA
12 , 434 , 148
~tic:.tion:
ISN re" • • q . : Enab1ad, .c:ti.... Proqr .... r . tr •• h : Di.ablad
Figure 103:
06-JAN-2011 12 :35:31
03-JAN-2011 11 : 21 : S9 .0SS000 Sp.c:.
re".aq.:
Ciph.rinq:
Enab1.d Di.ablad
Response Code 11 3 - ISN Reusage
Target files were not refreshed for an initial-state or replay function. Solution: Close all destinations Close subscription for fil e(s) Take one file with most activities Turn on ISNREUSE for files Verify the flag Reload file 122 and reset the flag Use SYSREPTOR to create a TOKEN (sync) for 0251122 and S251122 FEOFPL in production Start PARSEPLOG and determine the PLOG dataset names Create the REPLAY job (concatenate the datasets and update the TOKEN #) Start the REPLA Y job REPLAY will open the subscription and destination fo r file 122 and coordinate new updates with updates from the PLOG datasets • Verify that no more RCI13 take place • If this test was OK, redo it for the other 6 files
• • • • • • • • • • •
94
6 Problems and Solutions
MAXISN
An N2 command was issued with ISN larger than the MAXISN in effect for this file in the target database. Under Windows, Adabas extents only 1 block if the MAXISN is not sufficient.
6.2.6
RSP 98 !rom the Target OB
Errar codes parsed from REPTOR's OOPRINT:
17:02 , 11 AnAr5. 00]12 Rap11cat1on error, Adabaa ~.t1nat1on D251080 17 : 02; 11 l'oDAI'S4 00312 Soure. DBID 134 FNR 80, Tar ~ t DBID 251 FNR ADAP18 N2 c:md to DBID 251 PNR 80 RSP 98 aubc:oda U622 ISN
AC,.,.S. 2011-01-05 17:02:10 Replication . "10010 : Adabaa dea tination 0251080 ADAP54
ADJ\F18 ADAPCU
Soure. DBID 134 PNP. 80. Targa t DBID 251 PNR 80 BI cmd to tllUD 251 P'NR 90 RSP 113 aubc:ode IBN Tha " . cord to be d.. not .xi. t on tha ta rge t DDIO/fil e
000001
Start dat.- 2011-003
000002
Jan"ary
90 1
1
Start tiJDe. 01: 55: 02
3, 2011, Monday
FNR/RSP/CNT 14 98 23 PNR/RSP/CNT 80 98 280
FNR/RSP/CNT PNR/RSP/CNT FNR/RSP/CNT PNR/RSP/CNT FNR/RSP/CNT PNR/RSP/CNT FNR/RSP/CNT
90 113 280 112 98 224 112 113 10 122 113 8101 148 113 1 154 113 1 221 113 10 32
•••••••••••••••••••••••••••••••••••••••••••••••••••••• 501.•••• ch.ck th. l'oDABI\.S r •• pon •• code. ! ••••••••••••••••••••••••••••••••••••••••••••••••••••••
Th. abov• • rror. wer• •xtr.cted fraa th. fo1.1.owinq data •• t . REPTOR . DDPRINT . G0045VOO
Figure 104:
Response Code 98 Shown in Reptor and Parse Program
Reasons Jar RSP 98
Uniqueness violation of unique descriptor detected during store/update if subtransactions are not activated, or otherwise at end of subtransaction. The third and fourth bytes of the Additions 2 field contain the name of the descriptor which caused the uniqueness conflict The descriptor or superdescriptor is defined as unique and the store command tries to add arecord with the same existing value. Ln this case, fil e 80 was empty and the first store with ISN 1 resulted into RSP 98.
A test with a Natural program and without the Reptor could not repeat the response code.
6.2 Replica lor Engine (Replor)
6.2.7
95
RSP 162 from the Target OB
Error codes parsed from REPTOR's DDPRINT: 21,05 , 16 AOAP54 00312 ~plie.tion . ""0'" Adaba a da a tination 0251044 21,05:16 ADAII'54 00312 So"re. DBID 134 nIJI. 44, Ta"q. t DBID 251 nIJI. 44 Jll)AFl8 Al cmd to oBIo 2 5 1 FNR 44 RSP 162 aubcode 11473 ISN 35249065 21:05:1~ ADAII'54 00312 ~plieation a"ro,,: Adaba. da.tination D251046 21:0 5: 19 ADAP54 00312 Sou"e.oSIo 134 FNR 46 , Ta"q.t oBIo 2 5 1 FNR 46 lUIAr18 Al cmd to DBZD 251 nIJI. 46 RSP 162 . ubcode 17473 I8N 4732732 Jll)AF54 2011-01-07 21 :05: 18 Raplication Adaba. da.tination 0251046 lUIAr54 80"ro. DBIo 134 FNR 46, Ta"qa t DSID 251 nIJI. 46 Jll)AF18 Al cmd to oBZo 251 FNR 46 RSP 162 . ubcode 17473 ISN 4738881 lUIAr54 2011-01-07 21 : 05 : 18 Rap1ication . "rO": Adaba . da . tination D251046 Jll)AF54 Sou"e.oSIo 134 FNR 46 , Ta"q.t oBZo 251 FNR 46 lUIAr18 Al cmd to DBZO 251 nIJI. 46 RSP 162 . ubcode 11473 18N 6023043 ADAP54 2011-01-07 21 :05 : 18 Raplication Adaba. da.tination 0251046 Jll)AF54 So"rea osm 134 FNR 46 , Tarqa t OSIO 251 FNR 46 lUIAF18 Al cmd to OBZO 251 FNR 46 RSP 162 aubcode 11473 ISN 6024172 (.nip)
. ""0":
. ""0" :
Figure 105:
Response Code 162 Shown in Reptor
RSP 162 means that no additional space was available for the Adabas buffer pooL Increase the value of the LBP parameter. Because the buffer pool overflow is normally caused by too many blocks in the buffer pool waiting to be written to disk, specifying a low value for the WRITE_LIMIT parameter is recommended. This parameter is similar to LFIOP on the mainframe but without 1/0 pool and I/Os are not done asynchronously. Solution : 01d .ith RSP 162 : \ ~-I-PARSBT, \ ~-I-PJlR8BT ,
•• ttinq or LBP-157286400 a.ttinq or WlUTB_LIMI'1'a25
Na.: ' ~-I-PARSBT, ' ~ - I-PARSBT ,
Figure 106:
•• ttinq or LBP-419430400 a.ttinq or WlUTB_LIMI'1'a5
Response Code 162 - LBP and WRlTE_LlMIT
See also chapter 6.3.6, RSP 162 - LBP Space Problems.
6.2.8
Special characters are not correctly replicated
Comparing one file (27) from the source database (39) with files from the replicated target database (251) showed that the special character, the caret sign or circumflex "V, was not translated correctly.
96
6 Problems and Solutions
11/0<1/2010 14: 00: 17 .7 Start..:!. CHKSM027
File FILE-02? DBID
Record8
Comp.ri. on 21 CPU Time
DBID t..inq ."'''''' •• ..,,:
WV-l
Ch. ~k . um
Fil. ' :
39
~PYMT-THRU-DT
SV-I BOD7Z8D4E360E3C809Z460C48340404040404040404040404040404040404040
39
1 6D025Z9031B7&ACFD6911rzC9A62083C7l4ß2AOE 00:00 : 00 . 0
DBID belng ."'''''' •• ..",
251
SV-I ?PTMT-THRU-OT SV-I 07D7E8D4E360E3C809Z460C48340404040404040404040404040404040404040 251 1 SFU'''002aMtl22U6'CEOAJmlI3AF778C78CCE025 00: 00 : 00 . 0
»»>
Check_ ....... do not _tch
««<
11/04/2010 14:00:17.8 Endad 00 : 00:00.0
Figure 107:
Special Character not Translated Correctly
The CCSID of the EBCDIC code page in Entire Net-Work and/or Adabas are responsible for this error and must be changed. Prom the IBM documentation, with EBCDIC CCSID 37 the caret should be X'BO'. The following parts contain code pages: • • • • •
Adabas mainframe Replicator mainframe Entire Net-Work mainframe Entire Net-Work Windows Adabas Windows:
6.2.9
Wrang Replicated File in SLOG
At a client-site, we tried to replicate a file in error with a file number not available at the target database. Subscription, destination and global format were defined and the data was saved into the SLOG fil e waiting until the target fil e is available. We could not correct the mistakenly defined Reptor definitions because of the waiting SLOG data until we refreshed the SLOG file. The SLOG file is a system file in Adabas and therefore, it cannot be done if the nuc1eus is up and running. To try it online with SYSAOS leads to the errar "E09: Unknown subcode for rsp 064". Also, the ADADBS utility in batch as weil as UNLOAD, DELETE and LOAD get an error message.
6.2 Re plica lo r Engine (Replor)
97
The foJlowing steps are necessary: • Change the parameter file for the Replicator From ADARUN RPLPARM5=FILE To ADARUN RPLPARM5=NONE • Bring down the Replicator (ADAEND) • Bring up the Replicator (with the adjusted parm) • Refresh the SLOG file, for example file 30 • Change the parameter fil e for replicator From ADARUN RPLPARM5=NONE To ADARUN RPLPARM5=FILE • Bring down the Replicator (ADAEND) • Bring up the Replicator (with the old parameter RPLPARM5=FILE)
................ ................
17:34 : 53 OBIO 302 Fil.
30
Re<::o",d,a loaded TOP ISN
Figure 108:
••••• A 0 A B A S BASIC $&RVlCl!:S ••••• - Oiap1ay Fil. Layout -
2010-0g-23 PDRI'042
ST-SLOG
o
o
Date 10adad Date of 1aat update
2010 -01-25 13 : 55:0g 2010-0g-23 17 : 32:25
Refresh SLCX:;
6.2.10 RSP 148 From Target OB Normally, the response code 148 or NAT3148 means that the database is not active. Is the database in a network and Entire Net-Work (WCP) is used, the following messages can be displayed : ADAr54 200g-02-03 11 : 07 : 14 Repli",ation . rror: Adaba a daa tination D187044 ADAr54 Soure. OBID 134 rNR U , Tarq. t DBID 187 rNR U ADAF18 OP c::md loo DBID 187 FNR RSP 148 a ub<::oda 8224 ADAF54 200g-02-03 11 : 07 : 14 Rep1i",ation . rror : Adaba a da.tination D187 0 44 ADAF54 Soure. OBID 134 rNR 44 , Ta"'q. t DBID 187 rNR U ADAF18 "1 c::md to DBID 187 rNR U RSP 148 a ub<::oda 8224 ISN 146148454 11 : 07 : 15 ADAPCQ 00312 o.ati na loion 0187044 1 . ba1nq el0.ad 11:17 :46 ADAF8N 00312 Cloa. r . qu.at r .e.i9ad tor deatination D187044 11:17 :46 ADAPBW 00312 Daatinaloion 0187044 eloaad on all ta.ka
Figure 109:
Response Code 148 - Entire Net-Work or OB not Up
NAT3148 Oataba •• 202S1,N.two",k ID SO gSl cur",.ntly not aeti9 •. Sub<:: so
Figure 110:
Response Code 148 - NAT3148
98
6 Problems and Solutions
The message is given if • •
The da tabase is defined LOCAL=YES in ADARUN and Accessed from anode other than the loeal
The subcode 50 is documented as
•
'50: Set in MPM routine MPM12. (mainframe systems)'. Neither MPM nOT MPM12 are further documented in ADA813 or ADA821 manuals.
Subcodes for RSP-148 w ill be marked in Manual Messages and Codes as 'Internal Information' in the future, starting with ADABAS 8.2.
Solution: Check the foUowing and TestaTt if ne<:essary by using the System Management Hub and/or Windows' Computer Management
System Management Hub • • • • • • • • •
Resources Click on Entire Net-Work Server Click on Servers Click on the + sign to open the server in question, e. g . CST86 Click on the + sign to open the next level Right-click on the server to open a pop-up window Click on Start Kernel Click on the server one level above to see the status The status should be Server xxxxx Status Started
Connectivity • • • • • •
Click on Kerneis The kerneis with server names displays In the right coIumn, the kerneI names, server names and the status are displayed Click on the kernel name in the left column and you will see the databases and its connections Expand databases and dick on one to see in the right column the status Right-dick are to ping, refresh and other functions
6.2 Replicator Engine (Reptor)
99
r--:.system Management
",f.. ~Hosts :3 I c$UOO7.clllstrs.c .... qov ..'-GI; ~~ors
.. Q Directory Server
• !i Erobre Net-Work dient p........ Erobre Net-Work Server
.ä servers d-~CSTZOO7 • 0 1(2007
., 9 lCerrW •
.
KZOO7 on CSTZ007
"'''I 112 on ADAN7S I 39 on flDI>N'l5 I 251 Local
.. ...... Cornections
Q.-
l .. Net-Work 7,2.x Nodes
,+'--5jl System MaMQemert l-kJb
•.ra
Web Services stack
.. i!:I wetirlethods EröeX 6.0
Figure 111:
System Management Hub - Connectivity Check
Computer Management
Make also su re that two Windows services of Entire Net-Work are running. Right-click on MyComputer I Manage I Services and Applications / Services Select (high-light) and a right mouse dick Software AG Entire Net-Work Client Administration Service Software AG Entire Net-Work Server Administration Service • If necessary select 'Restart'
• • • •
100
6 Problems and Solutions
-,_ ....... - _•. -
__. -- .. .__ _. - .... -_.. - -..... ...
-.......... ......
-.Figu re 112:
.-
....
~.
Figure 113:
~ ~
~. ~.
~
~.
~
~.
~
node MVSSY7
Node is Unreachable
Use System Management Hub and Windows Computer Management. See chapter 6.2.10, RSP 148 From Target OB.
6.2.12 Communication Problem This problem can occur if the target database or the Net·Work (WCP) is down: RSP 148: Adabas nucleus is not active RSP 224: Entire Net·Work (WCP) - reply timeout <s nip> ADAF54 2009-02·03 11;07 ; 14 Rep1ication a rror ; Adabae destination 0187044 ADAF54 Soure. DBlD 134 FNR 44, Tar'i. t DBJ:O 187 FNR 44 ADAF18 Of c:..t to OBIO 187 FNR RSP 148 subcode 8224 ADAF54 2009-02·03 11;07:14 Rep1ication . rror; Adaba , de.tination 0187044 ADAF54 Soure. OBtO 134 FNR 44 , Tsr'iet OBIO 187 FNR 44 ADAI'18 Al c:..t to DBJ:O 187 FNR 44 RSP 1U a ubcode 8224 J:SN 146148454 11 ;07; 15 ADAJ'C<;l 00312 Destination 0187044 ia bain'i cloaed 11;17;46 ~N 00312 elo e a r~.at rae.ivad ~or de e tination 0187044 11;17;46 ADlU'8W 00312 Destination 0187044 c10sad on a11 tad;s
Communication Problem
~
~.
Solution:
Figure 114:
~
~.
6.2.11 Node is unreachable ~raR
~
~.
Computer Management - Services Check
17;12;35 NET0107t; Link VH006 disconnected
~
6.2 Replica lor Engine (Replor)
101
Solution:
Use System Management Hub and Windows Computer Management. See chapter 6.2.10, RSP 148 From Target OB.
6.2.13 SLOG data disappeared The Replicator Engine was stopped with a HALT command instead of ADAENO.
6.2.14 Replication is too slow There are several components in the path from the source to the target database, which can be the reason for the slow replication, especially when you replicate from Adabas on the mainframe to Adabas on Windows: Replicator Engine or Reptor
The replication buffer can be too small and the parameter LRPL must be increased to minimize the overflow area in SLOG. Check also the Adabas buffer pool (LßP) and the size of the 1/0 pool (LFIOP) . For SLOG usage check whether asynchronous 1/0 by volume is activated (ASYTV5=YES) and parallel LFiOP I/Os (FMXIO=x) are set to a value greater than 1. Replication data is written to and read from SLQG. Make sure that the length of intermediate user buffer area (LU) is set to 200,000. The recommended value of 167,000 is not sufficient to accommodate more than 1,200 update commands per second with a high number of files per transaction. The number of attached buffers (NAß) must be set to 41 x 10 x 1 x number of files in one transaction. Reptor holds all updates of one transaction before submitting it to the target database. And each file uses one attached buffer. Entire Net-Work (Mainframe)
The number of attached buffers (NAß) and the length of intermediate user buffer area (LU) should have the same value as defined for Reptor. Network
Line or circuit between the mainframe and the open system server. Adabas on Windows
Remove ASSO and OAT A from the hard drive C of the PC or server and define both on a SAN box with fast channels and disk arrays (raid-S). For example Edrive for ASSO and WORK and F-drive for DAT A and SüRT and TEMP.
102
6 Problems and Solutions
Reduce the dUTation of a buffer flush by specifying the percentage of modified blocks permitted in the buffer pool beiore an implicit buffer flush is taken. Tests showed that a good value is to set WRITE_LIMIT=5. Keep in mind that during a buffer flush no update command will be selected from the command queue and the ReptoT waits to submit the next transaction.
Limit the number of parallel 1/0 requests by a buffer flush and allow earlier processing of concurrent liDs from other threads by using the parameter BFIO_PARALLEL_LIMIT. Tests in a Windows environment with values between o and 50 showed that the value 0 brought the best replication performance and did not result in an 1/0 erfOT during asynchronous I/Os.
6.2.15 Initial state is too slow Tests showed that a large file with 17 descriptors and 167 million ISNs would take approximately four days to replicate by using Replicator's 'Initial State' func· tion. To bring the target database in an initial state with 200 files can take weeks. Based on many replication tests, up to 417 records can be replicated per second. Even if you can tune the replication process up to 1000 records per second, it would take approximately 46 hours to have one file at the target. Another possibility is to decompress 200 files, FTP, compress and reload into the target database. This process takes nearly 3 days. In the meantime, the source database continues to update and the records to be replicated must be collected in SLOG.
A possible solution is ADAMAGIC (distributed by TREEHOUSE) to FTP the compressed backup from the mainframe to Windows, separate DVT and DAT A and restore it with ADAMUP into the target database. In December 2010, ADAMAGIC was under development for Adabas 6.2 for Windows. Users would like to have such a tool supported by Software AG. A decompressed file takes 3-4 hours to FTP. The same compressed file takes only 1 hour to FTP. It seems at this time, that the backup dataset (VB) can be ftp'ed direct1y to the Windows server.
6.2 Replica lor Engine (Replor)
C___M_a_ ,"_,,_a_,"_ e___)
Figure 115:
103
(
VVlndo\IVs CSTBB
)
ADAMAGIC - Apply ADASAV from Mainframe Direclly to Windows
6.2.16 New ADAFRI Message Based on messages in DDPRINT, 5LOG was tumed off without an explanation. ADAFRI 00302 SLOG turne
Figure 116:
o~~ ~or
deatination 0191144
ADAFRI Message - SLOG Tumed Off
There was no reason displayed in the log why 5LOG was tumed off. The ADAFRI message is also not described in former Error and Messages Manuals. According to the new Manual ARK331, ADAFRI means the following.
104
6 Problems and Solutions
LOGINPUTfRANSACTlüN is set to ALL or 1-99 and the SLOG system file is not loaded. You have specified LOGINPUITRANSACTION as ALL or an integer from 1 to 99, but an SLOG file has not been defined for the Event Replicator Server. If you really want the LOGINPUTIRANSACTION parameter set to one of these
values, deHne an 5LOG file to the Event Replicator Server. For more information, Tead Setting Up Subscription Logging, in the Event Replicator for Adabas Administration and Operations Guide. It still does not make sense that the
message points out 'SLOG tumed off' and the error message says SLOG not defined. At least this erraT message needs a clarification from Software AG. eTrOT
6.2.17 Reptor under Stress • OB 302, Replicator Engine, was locked and didn't respond • Used a lot of CPU time - seemed to be in a loop • AOAREP CPLIST job was in waiting status and ended after timeout • AOS was locked and must be cancelled, when functions for OB 302 were requested • The TSQ session with the locked AOS must be cancelled • Nuc1eus of 06302 couldn't be normally ended (AOAENO) • Operation tried a couple of times to end with HALT command • Finally, after a couple of yoyos (recycling), the nucleus started to respond again. • Then, Replicator Engine continued to empty the SLOG • Based on the OOPRINT-log, RPL tried to repeat already successfully replicated new records • See DIETERRPLTMPM2.0DPRINT.G0689VOO = more than 116,595lines From the restarted Reptor OOPRINT: <.nip> ADAP54 Soure. DBID 39 PNR 55, T.rq.t OBID 251 PNR 55 ADJU"18 N2 CIIId to DBl:O 251 mR 55 RSP 113.ubcode l:SN 2551776 ADAFCV Th. r.cord to be in •• rted .1r•• dy .xi.t. on th. tarq.t DBIO/til. ADAFCY 'l'h. r .cord will be upd.oo.ted. 17 : 03: 34 ADAM93 00302 U•• r qon. Job ADAAi'P83 U•• r 10 C306D9n01)011)1B11 17:03:34 ADAM93 1)0302 U•• r gon. Job ADAArP82 U• • r 10 C306D9FE000101t7 17 :11:01 SEFM008 • SAF SBCURITI ~L (V8.1.2 - BUILD 001)2) STARTED 1 9:251:10 ADAPRl!; 00302 U• • ot St.OG tor da~ •• -r. 1ated input 151 : 251: 10 ADAFRlt 1)0302 tran.action. turned ott
Figure 117:
Reptor Under Stress - User Gone Message
6.3 Target Database
105
SAG Tech Support recommended setting the threshold of RPL buffer to 50%. After a high CPU time and a slow handshake between the subscription database and Reptor, Becky Albin from Software AG recommended setting it back to 70%.
6.2.18 Replicalion wilh wrong FOT/GFB lUIAB'7F 00312 Al d.compr ••• ion re.pen. .
Figure 118:
55 .ubc:ode
0 . ub.cr iption S13.017
Response Code 55 - Wrong FDT/GFB
A decompression fa ilure occurred d uring the subscription phase of the Event Replicator for Adabas processing. File changes on the subscription database was not applied in Reptor's global format buffer (GFB). The forma t buffer for the after image (AI) does not fit. Solution :
Oelete the old format and create the new one from Predict.
6.3
Target Database
6.3.1
RSP 52 from the Target OB
FOT on source and target are different. The rightmost two bytes of the ADD2 field contain the sub-code, the leftmost two bytes the name of the field. This problem can happen during program migrations with file changes and the changes are not done at the target database. Adabas on Windows does not automatically replicate file changes. A special customized procedure must be developed to synchronize file changes on the source and target database. See also chapter 6.1.5, ' File Changes Won' t Replicate' . The following error messages (ADAF1 8) are collected from Reptor's active DDPRINT and sent by e-mail to the DBA group to be checked. (.nip) lUIAI"18 lUIAI"18 lUIAI"18
N2 CIDd to DBID N2 CIDd to DBID N2 CIDd to DBID ~~, N2 CIDd to DBID lUIAr18 N2 CIDd to DB:lD lUIAI"18 N2 CIDd to DBID FNR!RSP/CNT 116 52 7513
191 191 191 191 191 191
FtIP.
rNR rNR rNR rNR rNR
116 116 116 116 116 116
RSP RSP RSP RSP RSP RSP
"" "" ""
.uboode a ubc:ode auboode a ubc:ode .uboode a ubc:ode
•••••••••••••••••••••••••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••• ••••••••••••••••••••••••
Pi•••• ch.ck th. AOAßAS r •• pon •• code.!
Figure 119:
Response Code 52 Showed in Reptor
.9602 .9602 .9602 . 9602 U602 . 9602
". ". ". ". ". ".
145861 145863 145871 145892 14590. 145907
106
6.3.2
6 Problems and Solutions
RSP 176 from the Target OB
The inverted list in the ASSO was corrupted for file 75 in the target database 25l. This was probably a sign of later problem with the HP disk arrays - two raid-5 disk arrays failed at the same time. DDPRINT of Reptor: (an1p) 11:38:08 ~54 00302 S-p1ieation arror: Adabaa daatination D251074 11:38:08 ADl\.F54 00302 Soure. DBID 39 FNR 74, Tarqat DBID 251 FNR 74 ~18 N2 c:md. to DBID 251 FNR 74 RSP 176 . ub~ 35841 18N 35320183 ~54 2010-10-15 11:38 :08 Raplieation .rror: Adaba. da.tination D251074 ~54 Soure. DBID 3S1 PNR 74, Tarq.t DBID 251 PNR 74 ADA:I'18 N2 c:md. to DBI:D 251 FNR 74 RSP 176.ubcoda 35841 ISN 35320190 ADA:I'54 2010 - 10 - 15 11:38 :08 S-plieation . rror: Adabaa daatination D251074 (anip)
Figure 120:
Response Code 176 Showed in Reptor
It was also unusual that the target database ended abnormally during the replication process.
Solution: Unload with ISN and load to re-build the corrupted inverted list.
6.3.3
RSP 98 followed by RSP 113
The target database rejects a store command with ISN 1 (N2) in empty file 80. The following delete command (EI) with ISN 1 results in ISN-I-not-found message. The rest of stores and deletes with ISNs 2-35 ended with RSP Q. Response Code 98 could not be repeated, as requested from Tech Support of SAG (#5037205). The unique super-descriptor contains of an alphanumeric value and ten asterisks (""), for example 'RISTMOOOOO10183 ......·..·•........'. In former Adabas versions for the mainframe were problems with its unique descriptor pool, defined by LDEUPQ. There is not such parameter in Adabas for Windows but maybe the internal DEUQP has not been cleared or there are problems with the asterisks. From SAG's messages and Codes: 'Uniqueness violation of unique descriptor detected during store/update if subtransactions are not activated, or otherwise at end of sub-transaction. The third and fourth bytes of the Additions 2 field contain the name of the descriptor which caused the uniqueness conflict:
6.3 Target Database
107
CMDRSP
FILE
o 00000000I... o 00000068111... o 00000000I ...
eo eo
2203960 07.JAN·2011 02 :53:27
0
2203961 07.JAN·2011 02 :53:27
0
ADAN5S .$ . .... E1 ADAN5S .$. ____ N2
2203962 07.JAN·2011 02 :53:27
0
ADAN5S
2203969 07.JAN·2011 02 :53:27
0
ADAN5S .$. .... N2 98 4F4100001 .. AO
2203970 07.JAN·2011 02 :53:27
0
ADAN5S .$ . .... E1
2203971 07.JAN·2011 02 :53:27
0
ADAN5S
2203979 07.JAN·2011 02 :53:27
0
ADAN5S
2203980 07.JAN·2011 02 :53:27
0
ADAN5S .$. .... N2
2203981 07.JAN·2011 02 :53:27
0
ADAN5S .$. ... , ET
2204291 07.JAN·2011 02 :53:35
0
ADAN5S .$ . .... E1
2204292 07.JAN·2011 02 :53:35
0
ADAN5S
2204293 07.JAN·2011 02 :53:35
0
ADANSS .$ . .... ET
2204301 07.JAN·2011 02 :53:35
0
ADAN5S .$ . .... E1
2204302 07.JAN·2011 02 :53:35
0
2204303 07.JAN·2011 02 :53:35
0
ADAN5S .$ . .... N2 ADAN5S .$. ____ ET
2204310 07.JAN·2011 02 :53:35
0
ADAN5S .$ . .... N2 98 4F4100001 .. AO
2204311 07.JAN·2011 02 :53:35
0
ADAN5S
2204312 07.JAN·2011 02 :53:35
0
ADAN5S .$ . .... ET
2204320 07.JAN·2011 02 :53:35
0
ADAN5S
2204321 07.JAN·2011 02 :53:35
0
ADAN5S .$ . .... N2
2204322 07.JAN·2011 02 :53:35
0
ADANSS
$ .... ET
.•.
.... ET
o 00000000I.,, o 00000000I ...
0
R
eo eo 0
(ether files)
eo eo
$ .... E 1 113 00000000I...
(snip)
$ .... N2
o 00000068Ih... o 00000000I ...
ISN
"
" " ,
+
+
2
0
o 00000000I ... o 00000068Ih... o 00000000I ...
eo eo
o 00000000I... o 00000068I> o 00000000I ___
eo eo
0
33
"
(o1her files)
0
" "
eo eo
35
(snip)
.•.
.... E1
o 00000000I... o 00000000I ...
R
0
(snip)
$ . .... E 1 113 00000000I...
.•.
.... ET
o 00000068I>. o 00000000I ...
+
eo eo
,+ 2
0
(snip)
Figure 121:
Response Code 98 and 113 Showed in Reptor
Solution:
• • •
Define aB files in the target databases to be replicated with REUSEISN and setup the MAXISN with the same values as in the source database Start the initial-state process RSP 98 was no longer observed during the replication process.
6.3.4
RSP 113 on several files
The specified ISN was invalid because of • N2 command was issued with ISN equal to 0 or larger than the MAXISN in eHect for the file; Adabas on Windows surprisingly adds only 1 block as a secondary allocation (extent) . • N2 command was issued and the specified ISN was assigned to another record in the file;
6 Problems and Solutions
108
•
L1/L4, EI, Al or 51/52/54 (with FB) command was issued for a non-existent ISN;
• L3/L6 command faund an lSN in the index which did not exist in the Address Converter; • Replication definitions: source and target DB/FNR were the same, for example from 06134 FNRl54 to D6134 FNRl 54 instead of to 0625] FNRl54. There is no check in SYSREPTOR to avoid this. • Files on the target database were not defined with REUSEISN. Later during the replication process and after closing the destinations, files were correctly defined with REUSEISN. All files should be defined correctly before the replication process begins. 14: 37: 03 ADAJ'54 00312 Sour". DBID 134 I'NR 122, T."q. t DBIO 134 FNR 122 N2 caod to DBID 134 I'NR 122 RSP 113 .ubcode ISN 12440974 A1JUCV n.. ".cord to b
ADAJ'lB
ADAF54 2011-01-05 16:39 : 59 ~lieation a rror: Adaba. dea tination D251112 ADAF54 Sourea DBID 134 PNR 112, T.rgat DBID 251 PNR 112 ADAF18 11:1 cmd to DBID 251 PNR 112 RSP 113 aubcoda ISN 435139 ADA!'CU Tha racord to ba de1a bad doa. not. a .. i a t on tha targa t. DBID/ti1 a 19: 13: 41 AnAP54 00312 Sourea DBID 134 PNR 1 5 4, T.rgat DBID 251 PNR ADAF18 Al cmd to DBl:D 251 PNR 154 RSP 113 aubcoda l:SN ADAFCU Tha racord to ba updabad doa. not a .. i a t on tha targat DBID/ti1a ~ Tb. racord will ba ina. rtad .
154 33
20:16:44 ADAF54 00312 90urea DBl:D 134 PNR 149, T.rga t. DBl:D 251 rNR 149 ADAF18 N2 cmd to DBl:D 251 PNR 148 RSP 113 a ubcoda ISN B1430 ADAFCV Tha r a cord to ba in .artad .1r•• dy a xi a t.. On tha tar9a t. DBl:D/til a ~ Tha racord will b. updabad .
Figure 122:
Response Code 113 Showed in Reptor from Target
Solution: •
Define in the target databases all files to be replicated with REUSEISN and setup the MAXISN with the same values as in the source database • Start the initial-state process • RSP 113 was no longer observed during the replication process
6.3.5
RSP 153 - Displayed on Reptor
Adabas response code 153 is reported by the Replicator Engine and the displayed ISNs are not replicated. The command log of the target database doesn't show this response code. See Software AG ticket SR#5006563 (Adabas on Windows). Explanation and solution see chapter 6.2.4 - RSP 153.
109
6.3 Target Database
.r.mur18
N2 c-:I. to DBlD
REe DATE
DUR
79219 22-NOV·2010 11 :07:35 79220 22-NOV·2010 11 :07:35 79221 22-NOV·2010 11 :07:35 79222 22-NOV·2010 11 :07:35 79223 22-NOV.2010 11 :07 :35 79224 22-NOV·2010 11 :07:35 79225 22-NOV·2010 11 :07:35 79226 22-NOV·2010 11 :07:35 79227 22-NOV.2010 11 :07:35 79228 22-NOV·2010 11 :07:35 79229 22-NOV·2010 11 :07:35 79230 22-NOV·2010 11 :07:35 79231 22-NOV.2010 11 :07:35 79232 22-NOV·2010 11 :07:35 79233 22-NOV·2010 11 :07:35 79234 22-NOV.2010 11 :07:35 79235 22-NOV·2010 11 :07:35
Figure 123:
6.3.6
251 mR
0 0 0 0 0 0 0 0 0 0 16 0 0 0 0 0 0
11 RSI'
153 . ul:>co&. 16448 ISN
CMDRSP USER·ID AD2(HEXY FILE .. 6 ... 8 .••••- ••• N2 o 0000004E1N ... 11 .. 8 ... 8 . ....- ... N2 o 000000821 .... 11 .. 8 ... 8 . ....- ... N2 o 0000006B11o:... 11 .• 6 .. ,6 .••••- ••. N2 o OOOOOOCDJ .... 11 .. 6 ... 6 . ....... OP o OOOOOOOQJ •. .. 0 .. 8 ... 8 . ....- ... N2 o 000000751u .. 11 .. 6 ... 6 . ....- ... N2 o OOOOOOE9I.... 11 .• 6 ... 6 .••••- ••. N2 0 11 .. 6 ... 6 . ....- ... N2 0 11 .. 8 ... 8 . ....- ... N2 0 11 .. 8 ... 8 ......... LF o 000004F....... 5 231 .. 6 ... 6 .••••- ••. N2 o 0000008E1 .... 11 .. 6 ... 8 . ....- ... N2 o 000000881 ... 11 .. 6 ... 6 .....- ... N2 o OOOOOOCF/.... 11 .. 6 ... 6 .••••- ... N2 o 000000851.... 11 .. 8 ... 6 . ....- ... N2 o OOOOOOA7/.... 11 .. 8 ... 8 . ....- ... N2 000000801 .... 11
o
75423
I5N TH IOA IOD 10W 75414 3 0 0 0 75415 5 0 0 0 7541615 0 0 0 75417 20 0 0 0 0" 0 0 0 75418 1 0 0 0 7541916 0 0 0 75420 19 0 0 0 7542112 0 0 0 7542217 0 0 0 08 1 0 0 7542414 0 0 0 7542518 0 0 0 75426 4 0 0 0 75427 6 0 0 0 75428 9 0 0 0 7542911 0 0
Response Code 153 Showed in Reptor - from WCP/WCL
RSP 162 - LBP Space Problems
This response code is shown in Reptor's OOPRINT: 2 1 , 05 : 16 AnAP54 00312 ~plieation . rror: Adaba. da.ti n ation 02510 4 4 21 :05: 16 .r.mur54 00312 80u>'c.OBID 134 1'"NR 44 , Tarq. t DSto 251 rNR U ADAF18 Al cmd to OBto 251 mR 44 RSP 162 .ubcoda 17473 ISN 35249065 21: 05: 19 .r.mur54 00312 Rap1ication . r>'or: Adaba. daatination D251046 2 1 , 05 : 19 AnAP54 00312 Soure.ODIo 134 mR 46 , Tarq.t ODto 251 mR 46 lUIAr18 Al cmd to DBtD 251 rNR 46 RSI' 162 aubcoda 17473 I8N 4 732732 ADAF54 2011 - 01 - 07 21 : 05 : 18 Rap1ication . rror , Adaba a daatination 02510 46 lUIAr54 80u>'c. DBtD 1 3 4 rNR 46, Ta rq.t DB tD 251 rNR 46 lUlAFl8 Al cmd to OBto 251 mR 46 RSP 162 .ubcoda 17473 ISN 4738881 lUIAr54 2011-01-07 21 :05:18 Rap1ication . >,>,or: Adaba. da . tination D251046 AnAP5 4 Soure. ODlD 134 mR 46, Tarq.t OBto 251 FNR 46 lUIAr18 Al cmd to DBZD 251 rNR 46 RSI' 162 aubcoda 17473 I8N 6023043 ADAF5 4 2011-01-07 21:05:18 Rap1ication . rror: Adaba. da.tination 0251046 ( . n ip)
Figure 124:
Response Code 162 Showed in Reptor from Target DB
RSP 162 means that no additional space was available for the Adabas buffer pool. Increase the value of the LBP parameter. Be<:ause the buffer pool overflow is normally caused by too many blocks in the buffer pool waiting to be written to disk, specifying a low value for the WRITE_LlMIT parameter is recommended. This parameter is similar to LFIOP on the mainframe but on Adabas for Windows is no I/O pool available and I/Os are not done asynchronously. Ta decrease the WRITE_LlMIT parameter from 25% to 5% means that more often a buffer flush takes place but each buffer fl ush will be done in a shorter time.
6 Problems and Solutions
110
Solution: Old vitb RSP 162 , • • ttinq o. LBP-157286400 \ADANUC- I-PJlRSZT , •• ttin<;r o. WRI'1'ILLDllT_25 \ADJWUC-J:-PARSET ,
N. .. , \ADJWUC-J:-PARSZT , • • ttinq \ADANUC-I-PJlRSZT , •• ttin<;r
Figure 125:
o • LBP-419430400 o • WRI'1'ILLDllT-!;
Response Code 162 - LBP and WRITE_LIMIT on Target OB
Buffer usage after expand the LBP parameter ADAOPR-I-STARTED ,
24-JAN-2011 14 : 22 : 04, Ver. ion 6.2 . 1.01 (Windo... )
Databa • • 251 , atartup . t ~
20-~-2011
Ve r . ion 6.2.1.01 , PID 3752
13 : 30:"
Ve r . ion 6.2.1 01 Static P.r..... ter.
~
Databa • • 251 P,.. . ourcea
-
:
16,177,216
~
ao
Lo<Jging :
nll,UO,tOO 3,145,728
on
2'-~-2011
14 : 21:57
'"""
~ ~
=
~o=
Option.:
'l'JU.JNCAT:lON , AUTO_ EXPAND
, ,
U •• rexit. :
Clogla yout :
\A[lAOPR-I-TZRMINATED ,
Figure 126:
24-JAN-2011 14 : 22 : 04 , alapa.d
t~ :
00 : 00 : 00
Response Code 162 - LBP and WRITE_LIMIT on Target OB
24-JAN-2011 14 : 22 : 04, Ve r.ion 6.2.1.01 (Windo •• )
~PR-I-STARTED,
D.tabe • • 251 , .tartup . t 20-~-2011 13 : 30:44 ~ Ve r . ion 6.2.1.01, PID 3752 ~
D. tabe.e 251 R.. . ource.:
Ve r . ion 6.2 . 1.01 Par. . . t e r .
Dyn~c
NISNHQ
on
24-~-2011
14:21:57
" '"
90,000 3 , 00 0 3,000
Group CO!IIIIli t :
\ ADAOPR- I -TERKINATED ,
Figure 127:
3 , 000
" 24-JAN-2011 14 : 22 : 04,
e 1 ap .~
t i.e : 00:00:00
Response Code 162 - LBP and WRITE_LIMIT on Target OB
6.3 Target Database
111
\ ADAOPR-I-$TARTED, 24-JAN-2011 14 : 25:47, Ve r . ion 6.2.1.01 (Window.) Oatab& •• 251, .ta rtup at 20-JAN-2011 13 :30: 44 ADANUC V.r . iOD 6 . 2.1 . 0 1 , PID 3752 Oatab& •• Area/Bntry
'"
---------U •• r Qu.u.
.~
,,
BuE~ . r pool Pro taetion Ar • • Ac:tiv. Ar.a Group Co:ami t Tranaaction T~
"
419,430,400 332,790 99,837
Hiqh Water
----------
0
4 ,096 0 22,624,256
786,448 0 0 28,672 0 32,654,336
0
'00
--------" "" ., " "
tlat./T~
20-JAN-2011 24 - JAN- 2011 20-JAN-2011 20 - JAN- 2011 0 20-JAN-2011 20-JAN-2011 20-JAN-2011 0 0 0 20-JAN-2011 0 20-JAN-2011
,, " • " " , ,, ,
,
"
•
,•, •
• ,
" "
3,145,728 393,216 393,216 16 ,777,216
on 24-JAN-2011 14:25:41
0
90,000
(~)
Figure 128:
Zn u ••
Si",. >00
Coaaand Qu.ua Hold Qu.u. Cl i.nt Queu. HQ U•• r Li.m:it Thr.ad. Workpool ISN Sort Compl_ S.areh Attach.d 8u~E. r
"
ADANUC V.ra ion 6.2.1 Kigh Wat.r Harka
: 13: 14:21 15:44 14:03 15:44 14:14:41 13:30:45 14 : 13 :56
13:30:45
0 21-JAN-2011 12:13: 20-JAN-2011 14:03: 0
Response Code 162 - LBP and WRITE_LIMIT on Target DB
\ ADAOPR-I-STARTED, 24-JAN-2011 14 :29:48, V. raion 6.2.1.01 (Window.) Oatab& •• 251, . tartup at 20 - JAN- 2011 13:30 : 44 lUIANUC V.r.ion 6 .2. 1 .01, PItI 3152 ~
O.tab& •• 251
8ut~.r
V.r.ion 6.2.1.01 pool Stat:i.tic.
on 24 - JAN- 2011 14:29 : 41
419 ,430, 400
RABN. pr.a.nt
pool A11oc:ation CUrrent Hiqhwat.r Internai Workpool
5\ ) 1 \) 4\)
0\ )
22,624,256 32,654,336 19,030 ,016 2,453,504
1/0 Stati.ti".
Lo<;iical b.da Phy . i"al bad. Pool Hit Rat. Phy.i"al Write .
~,.
'"94.2 \ "
0 0 0
~U
=""" NUCSRT 8u~E.r
4,359
,,, •
-------------
uro
Fluah.a
-------------Total
"
To !'r•• Spa". Write Li.m:it Moditied
0
5\ ) : 0\ ) :
20,911,500 104,448
\ ADAOPR- I-'l'I!RKINATEO ,
Figure 129:
Response Code 162 - LBP and WRITE_LlMIT on Target OB
""
112
6 Problems and Solutions
6.4
Utilities
6.4.1
Replay with more than 60 files
Version 3.2.1 caIUlot REPLAY more than 60 files. Software AG recommends start· ing multiple REPLAY jobs with 60 files each in parallel and setting the disposition of the PLOG dataset to SHR. It is plaIUled from Software AG to change it in a fu· ture release. A 0 A R P L
V8 . 1
SM1
OBIO _
0003~
Started
2010-04-2B
18:16:06
A[)ARpL RBPIoAY A[)ARpL FILES_ 006,007,009,010,012,013,016,019,021,023,028,033,O34,037 A[)ARpL FILES_03~,040,041,043 ,0 41 ,0 4B ,05 1 ,058,059,060,06 1 ,063,O66,066 A[)ARpL FILES_067,068,071,072,076,077,078,080,OB1,082,083,084,O86,088 AD~L FILES_090,091,092,093,094,096,097,099,103,104,105,106,109,110 ••• A[)ARpL FILES_111,113,116,119,123,124,125,130,131,133,135,137,138,140
...
ERROR-009, P. r. . . e. r . rror , too many .... lua . in • 1i.t Ch.ck th. par_t.r input. Supp1y no ..... r. th.n th ....... iJDum. nUlllbar o~ p.r_e.r .... lu •• parmitted, and rarun th. job , A 0 A R P L
Figure 130:
6.4.2
Termin.ted
2010·04·28
18:16:06
ADARPL Replay > 60 Files
Replay with ERROR·139
REPLAY received ERROR-139, ADARPL has exceeded the replication pool size allocated via the LRPL parameter. 80th RPL of the target database and the Reptor are only 2% used, according to the HWM . The utility ADARPL has its own RPL buffer. lncrease the default value of LRPL from 100,000 to 300,OOOK. Tests with many files to be replayed showed that a value of 600,000K is better. J:RRQR-139, ADARPL raplic.tion pool o .... r~low Incr•••• LRPL p.r_e.r .nd r .run th. job.
Figure 131:
ADARPL Replay ERRÜR·139
6.4 Utilities
6.4.3
113
Replay with ERROR·140 RSP 254
REPLAY received ERROR 140 with response code 254 and sub code 6 at loca Hon 1. 4
4
A DAR P L: Brror occurred durinq . .. ec:u tion : ERROR- 140 , Une~cted REPTOR r •• pon •• 254 .ubeode 6 loc.tion 1 2010-05-03 A DAR P L T.noin.ted
Figure 132:
4
17: 39 : 25
ADARPL Replay ERROR-140 RSP 254
The attached buffers (NAß) can be too small defined. ßased on the high-watermarks of the source database and the Replicator Engine, NAß is only up to 20% used. The Replication Utility Manual Version 3.3.1 does not describe a related parameter to the attached buffers. Subcode 6 means that the low-order 6 bytes of CQECKSUM (checksum of command queue element) do not equal UBCKSUM (checksum of user block check). This information seems to be not very helpful for a DBA. It also can be that the CT parameter limit was exceeded (tested with CT=180), the
nuc1eus terminates the user, genera ted the equivaJent of a BT command intemalIy, released the CQE and attached buffer space, and issued ADAM93 or similar message. This message was not detected during this ERROR-l40. No solution or explanation has been found to solve this problem.
6.4.4
Replay with ERROR·1 40 RSP 131 Subcode 70
The following REPLAY was running without a TOKEN: A DAR P L
va . 1
SKl
DBID _ 00134
Sarted
2010-12-23
12 :3B: 2B
~L
LRP L- 600000~
~
FILBS-006,007,00B,009,010,011 ,012 ,013 ,014 ,015,016 ,017 ,01B ,019 ,0 20 FILBSa021,022 ,023,0 24,025 ,0 26 ,02 7,02B,029,030,031 ,032,0 33 ,0 34 , 035 FILBSa036,037,03B,039,040,0 41 ,042,0 43 , 0 44,045,046,04 7 ,04B,049, 050 FILZSa051,052,053,054,055,056,057,058,059,060,061,062,063,064,065
~ ~ ~
A DAR P L : Error occur red dur1ng ....cution: ERROR-140 , Unaxpected RBPTOR r •• pon •• 131 .ubeode 70 loc.tion 2 A DAR P L T.noinatad 2010 - 12- 23
Figure 133:
ADARPL Replay ERROR-140 RSP 131 SC 70
12 :38 : 29
6 Problems and Solutions
114
RSP 131 has up to 111 subcodes bu t suhcode 70 is not found in Messages and Codes V3.3.2, nucleus response codes. Subcode 69 means th at a replay fo r the same DBID/FNR is already running.
ADARPL was running with the following version: Dat. 2007-01-13, V.r.ion 3.1, SM 1, B••• AZ311000 Zap. AZlllOOl AZlll008 AZ311011 AZ311054 AZ311011 AZ311073 AZ)11074 AZ3110B4
Figure 134:
6.4.5
ADARPL Version and Zap Level
Replay with ERROR·140 RSP 131 Subcode 61
Figure 135:
ADARPL Replay ERROR-140 RSP 131 SC 61
Subcode 61 means that an invalid request sent to Event Replicator Server. RBL is insu fficient, no FB provided on lnit handsh ake or other such error. Notify your Soft ware AG technical support representative.
Solution: Just restart the job.
6.4.6
Replay with ERROR·146 - loken
Taken 19655 was created. ARrO0147 : Rep1ay proce •• initiated - Token_ 19655 . . . . . A D A B A S EVEN'r UPLICATOR SUBSYSTEM • • ••• 12:12:34 lnitiate Rep1icatiot> Rep1ay
2010-12-23 H-RP2010
Synchronized OB1:D . . . . . . . . . . . . . . . . .. Automated Timeout , •..••..••..•..
_134
I'rom Date/Time .• . To Date/Time .. Start Date/Time • .
2010-12-20 2010-12-23 2010-12-20
D•• tination Name Li. t . Sub.cription Name Li.t
A D A Il P L
Figure 136:
VB. 1
SM1
DBID _ 00134
l'
(1' 010 N)
'00 02:00 : 13 11:55:00 02:00 : 13
+ •• • _ __
St..rted
ADARPL Replay - Create Token
2010-12-23
12:31 : 57
6.4 Utilities
115
The Token 19655 was not found. There are no replay processes active with the token number listen in the message.
ADARPL RJ:PLAI TQUN_19655 ADARPL RPLTARGETID_ 312 ADARPL ~600000~ l\. D l\. R P 10 :
BRROR-148,
Brror occurr..:! durinq ....cution:
~
19655 not tound in Reptor.
Inv •• tiqate th. cau • • ot th • • rror. eorr.ct i t an
2010 -1 2 - 23
Figure 137:
12 :31 : 5B
ADARPL Replay ERROR-148
Solution :
Deleted the TOKEN, created a new one and started the replay with the new TOKEN number.
Reason: The field 'Automated' (Figure 136: ADARPL Replay - Create Token) should be marked with N and not Y.
6.4.7
Replay Abended with SOC4
Created token 15825 with 183 destinations and subscriptions. The started ADARPL utility ended abnormally with error code SOC4 and reason code 10. This is normally caused because of protection exception, incorrectly linked modules, invalid pointer value, wrongly concatenated Adabas library, etc. l\. D l\. R P 10
va.l
SMl
DBID _ 00134
Stert..:!
2010-12-23
14 :51 :2'
ADARPL REPLAI TQUN_15B25 ADARPL RPLTARGZTID-312 ADARPL LRP~600000K
14: 51: 51 14:51:51 14:51:51 14:51:51
Figure 138:
END 01" SYMPTOM DUMP IZI"4501 STRZPLAl\. STl RZPLAI - ABZND-SOC4 UOOOO RZASON-00000010 TlME_14 . 51.51 IZI"4041 STRZPLAl\. - ZNDBD - TIME_14 51.51
ADARPL Replay SOC4
6 Problems and Solutions
116
Restarted the replay job with the latest Adabas steplib and with a new Taken 15826 but received the same SOC4. The dump can be viewed in appendix, chapter 8.7.
Solution: Cleaned up 15826. 1 6:24:35 Replicator 312
. . . . . A D A B 11. S
BASIC
SERVICES • • • ••
2010-12-23 PRPT002
Replicator Hanaq_nt
A D P
A<>t1 ... ate/&o.ct/~n/"lo •• Ci . pl ..}' Jteptor de f inition. D1aplay Rooptor atatiati"a
H L P
' . "form. Rl'LCl •• nup
,."torm.
RPl.Chack
P."form RPLRefr •• h
parameter aubayatam ?
Salp Exit
Code D.~ ••
ERPTOOl
C_nd
10 .. 312
(RPLPB-DATA-BASE)
_ >
PPl----- Pt2------ PPl------ PPt------ PP6----- PI7----- PPS----- PP12--- -Pile Sarv S"it
flalp
Figure 139:
ADARPL Replay SOC4 - RPL Cleanup
Solution:
Created multiple TOKENs with only a couple of files. ARPO0141 , RIopl.y p"oe ••• initiatad - Tokan-15828 16:"2:38 . h ._ A 0 A 6 A S EIIl!:N'l' RJ:PLlCA'l'OR SUßSYSTI!:M H ••• In1tiate bp11c:at1on bp1ay
2010-12-23 N- RP2010
Sync:hroniz:ad OBIO Au_ted T>.m.out
_13" N(YorN)
Fr.". Oate/T>.m. To Oate /T ~ Start Oate/T>.m.
2010-12-20
Oeatination N _ Li.t Sub. c:ription N_ L1. t
'''---
+
._-
0251009_
02:00:00
0251010_
0251011_
Command _ > Enter - PP1 --- PF.'2 --- PP3 --- PP .. --- PP5--- PP6 --- PF1 --- PP8 ---PP9 --- PP10 --PP11 -- PF12 ---
Figure 140:
ADARPL Replay SOC4 - Create Multiple Token
6.4 Utilities
117
Solution: Ran multiple Replay jobs in parallel, each with different TOKEN, and with the same shared PLOGs.
6.4.8
Replay with Response 131 Subcode 61
It seems that you cannot define more destinations than fit on one selection page (PF6).
JU!.F(J0156 : Re.pon •• 131 S~ 61 Rec.iv.d trOll!. nop1ic .. tor 1 7: 56:56 ..... A 0 A B A S EVENT RZPLlCATOR SUBSYSTEM ..... lniti.t. ~1ic.tion ~1.y
'" or
DBlO Automat.d
N(!
PrOll!. O.t./T~ To D.t./T~ Start O.t ./T~ D•• tin.tion Name
Li . t Sub.cription Name Li. t
N)
'"'---
T~out
2010- 12-20
+
201 0-12-23 M-RP201 0
D251130_
02 : 00:00
D251131_
D251132_
c-nd - > Ent.r-PP1- - -Pr2---PP3---PPf---PP5---PP6---Pr7---PP8---PP9---PPI0--PP11--PFl2--....it
Figure 141:
ADARPL Replay SOC4 - RPL Cleanup
A valid TOKEN was given when only a few files were selected to be replayed.
7
Monitors
7.1
What can be monitored?
Assume that you replicate from Adabas on the mainframe to Adabas on Windows, you can monitor the following parts:
eireuit
WCP ,.3.3
...
8.1.3
main fra me Replicator on the
mainframe
3
6.1.8.03
Entire Net-WorK or WCP on Ihe main-
Network I line or circuit
SYSAOS { Apas/lnsight I T RIM I Review
8.1.3
$Y$AOS { Apasllnsighl l
3.2.1
TLOG transaciion
6.2.1
Trace Hour1y Snapshot
frame 4
TARGET OB
Monitoring Re plication Parts - Graphie
Adabas on the 2
!
-,...-'-.<'
SOURCE REPTOR OB "-~~ '8.1.3J3.2.1 8.1.3 I'" r--,.t-~!: RPl Buffe, RPl Buffe. I
Figure 142:
8
.,,,.
[100 Mbps Une
jL
SLOG
100 Mbps duplex
Trace is very costly; snapshots are ree-
ommended
NetQoS
Always active
Different
Ask network people
5
Firewalls I routers I load balancing systems
6
Entire Net-Work or WCP on Windows
7.3.3
Trace I Log
Very costly, might be placed on a SAN box - not C-drive
Adabas on Windows
6.2.1
Command log
CostJy, no async
,
Figure 143:
I/0s
Monitoring Rep lication Parts - T ool s
Why is it necessary to monitor components in the path from the subscription to the target database?
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_7, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
7 Monitors
120
The following test scenario (test #14) shows that the subscription database sends 1,186 commands per second (cps) to the Reptor but the Reptor sends only 292 cps to Entire Net-Work (Wep). Based on the command log from the target database, the same amount of Adabas commands arrived. The question is, where is the bottleneck?
8
mbpsllne
clrcuil
OB
6.1.8.03
-...
CSlZO07
') 'OO,""')".~.(l\I
~.-
.=-
":5',23.,5;<&'OO
@
*.1'. "o3lI"'I-"''I8005 ~ROO
@ Figure 144:
~
'~;30:09- 1 G:05 :OG
21US_
~~ ~~
>
~ ~ m" ... ~ ~ )AAI_> ~ ~ BU,.,.>
Monitoring - Number of Commands per Second
Ln this case, the following measurements will improve the throughput:
• lncrease the Adabas buffer pool (LBP) on both subscription database and Rep!icator Engine. LBP on Reptor should not be defined smaller than on the subscription database • lncrease the replication buffer (LRPL) on both subscription database and Replicator Engine. LRPL on Reptor should not be defined smaller than on the subscription database • lncrease the threshold of the replication buffer (LOGINPUITRANS) on Reptor from 50% to 70%. Adabas commands can be longer replicated out of the RPL buffer and the usage of the overflow area SLOG can be delayed or avoided. • The number of updates and files per Adabas transaction from multiple users (online and batch) cannot be handled in time from one Reptor. Heavily used files should be dedicated to special Replicator Engines. One company is using for example 8 Replicator Engines. • Activate on the Replicator Engine asynchronous Vol-Ser I/Os (ASYTVS=YFS) and decide to set the parallel LFIOP I/Ds (FMXIO) to a value greater than 1 (normally 6-8) if data to be written and read from the SLOG file.
7.1 What can be monitored?
7.1.1
121
Source OB on the Mainframe
SYSAOS shows the high water marks (HWM) of some Adabas queues and buffers. A Session monitoring / U display resource utilization / H high water marks Critically important for the replication process is using the attached buffers (NAß) and the replication buffer (LRPL). An overflow of these buffers on the source or subscription d atabase w ill stop the replication process and an INITIALSTATE or REPLAY is necessary. . . . . . A D A B A S BASIC SERVICES " . . * High Wa t e r Mark .
11 :f3:44 DBID 39
, ,, ,, ,,, 'W, , ,, ,, ". (LRDP)l ,
Pool/Queue
Attached Buft:er(NAa) Coaa.and Que ue (NC) Format Pool (LI"P) ,~, Hold Queue XSN-Liat Table (LX) 'oq. ~. Tab1e (LQ) U. e r Queue Unique DE Pool (DUQ) Sec:u rity P ool (LCP) (UQF) UQ File Liet ATM Tran e. (:UD) (LWP) Work Pool a.do Pool ,~) Replication
Figure 145:
,
Si z e 2.5760 16800 2500000 560056 4000 9000 466312 60000 10000 1 44360
I I I I
,,, , ,, ,,
I \ Ueed I
uno
I 960 I
"
U28 I
" ."
6160 X
""
1 I
576 I
1500000 I
59908 I
314512800 1
131375292 1
20.3 1.2 o 5 o 7 3
,, ,, ,,, ,, "" ,"
2010-09-2. PACUB02
Date x I x I X I X
2010 - 09 - 2. 20 1 0 - 09 - 2. 2010-09-2. 2010-09-24 2010-09-24 2010-09-24
T ......
11 : 29 : U 11 : 19:59 l1 : 31 : U 11 : 19:59 11 :35: 14 11 :30:54
3 I 20 1 0-09-2. 11 :30:5 4
" " " "
9 I 2010-09-2. 11 : 29 : U 0.0 X
I
, I X I X I
,,, ,, ,, I
..
..
Monitoring - High Water Marks -Source OB
SYSAOS with the HWM funchon also runs in batch and a Natural parse program analyzes programmatically the data (see chapter 7.2).
7.1.2
Replicator on the Mainframe
SYSAOS
The Replicator Engine or Reptor contains of the Adabas nucleus and some Replicator modules. SYSAOS can also be used to show the high water marks (HWM) of some Adabas queues and buffers. A Session monitoring / U display resource utilization / H high water marks Critically for the replication process is using the attached buffers (NAß) and the replication buffer (RPL, parameter LRPL). An overflow of the attached buffers (NAß) w ill stop the replication process and an IN ITIAL STATE or REPLAY is necessary. A replication buffer (RPL) overflow w ill deactivate the destination if no SLOG is defined or activated. The parameter 'LOGINPUITRANSACfION' can be set to
7 Monitors
122
use its SLOG system file as temporary storage loeation for incoming compressed replication transactions, beiore they are queued for processing. A value set to 70%, for example, will automatically switch to the SLOG if the threshold is reached. Without setting a threshold, the SLOG won't be used, even if the SLOG is created and available. The Adabas buffer pool (LBP) is also important but its usage cannot be displayed with SYSAOS on the mainframe, in contrast to Adahas on Windows, see Figure 199. 11:14 : 45 DBID 302
••••• A D A B A S
Atu"h .. d But'!'.. " (MAll)
C_nd OUau.
(Ne) Fo ....... t 1'001 (LW) (NH) Hold Queue 15M- Li . " Tabl. (LI) Ood . Tabl. (LQ)
'~ .
U•• " Qu.u.
(~)
Uniqu.. DE Pool S . curity Pool UQ ril. Li . t A~ Tran • . Work Pool _ Pool
".
a.plic:-tion
Figure 146:
BASJ:C
SERVJ:CES •••••
Hi<;rh Watoll: Mark.
(DUO) (LCP)
(UQF) (XID) (~)
,, ,, ,, ,, ,, ,, ,
45312 I
23040 I 300000 I 560056 I
576 I
5712 I 276 I
20000 I 1236312 I 100000 I 10000 I 38U60 500000
314572800 I
I 2010-09-24 07: 48 : 28 I 2010-09 - 24 11: 13 : 14
4928 I
, ,,, ,,
53060
21322978() I
,,, ,, ,, ,, ,, ,,
I 201()-09-23 17 : 34 : 44 I 2010 - 09-24 11: ()9 : 02 I 201()-09-24 07: U : 56 I
10944 I
12000 I
(LRDP) I (~)
,,.,. ," ,,.,,• , " .., '-' , ,., ,., "" , ,., ,, '" , ,., ,, ," , ,., ,,
1720320 I
201()-09-24 PACUH02
10 . 6
2010-09-24 11: 13 : 14 2010-09-24 07: 49 : 30
67.7
+
+
Monitoring High Water Marks - Reptor
TLOG The transaction log (TLOG) will be activated on the subscription level by using SYSRPTR and the 'Subscription Definition' for each file logging is needed - see TLOG Values. 12:03:39
H . . . A D A B A S EllBN'l' REPLICAroP, SUBSISTBH . . . . . Sub. oription D.tinition
D6039/144 1'0 251/144,_ _ _ _ __
Deecription Sub.cription N _ U•• r Date Alpha Itey Archi t . ctur. Itey . , •..••. Sub.oription V.raion Ue.r Date Wide ltey •..••. Re • • nd Butt. r N..... . .
,,
S039144_
Sub. cription Aeti.... D•• oti .... te i t t i l . de.oti .... tad l n c _ n t Initial Stete Count
CUrrent
-' •
De.tination N _ Liet .. .
Figure 147:
2010-11-09 N-RP1410
y y N
Monitoring TLOC - Adjustments
Input Lav.l ..••..•..• Filter Lav.l OUtput La .... l .••..••.. Filter Matohed . . Filter Not Match.d Filter I
2 0 2 0
,,
7.1 What can be monitored?
123
The program ADARPR selects and prints the transaction log, the Adabas command log of the Replicator. IlplUTl.OG IISßPLIB
/I /I /I IIDDCARD lUIARUN
B.DC PGHooADARUN DD 0ISP-SHR,D~ . ARr . V321 ßST.LOADLIB 00 OISP-SHR,OSNooADABAS . VB1. USER.1IDALOJUl OD OISP-SHR,DSN-~ . VB1 . TEST.LOADLIB 00 OISP-SHR,OSN~ABAS . ADAUTL,VB1 . UTLIB
"
.
SVC_2U ,0IWICK_ 3390 ,08-302 00 DISP-SHR,DCB>oBUPNo-60 ,UNIT-(C'rAPE ,2) , OSn.DIBTER . CLOG . RPLT2 . 009 2410.T150104 00 DISP-SHR ,OSN-RBP'l'OR.CLOG.Rl'LT2 0092UO T1 5 1639, DCII-BUFNO-60 , UNI 'l'-An"-DDCLOG 00 DISP-SHR ,OSN-RBP'l'OR.CLOG.Rl'LT2 0092UO T1 53149, DCII-BUFNO-60, UNI'l'-An"-DDCLOG II0DDRucr; 00 SIS()UT>o * IIDOl'RINT DD SIS()UT>o * IISISUDUMP 00 OUlfil SISou-r-* 1I00MRTE 00 * *I\ECORDS l\SSIGNED QUEUE ZVENTS '0 l'RINT NO 0U'rl'U'l' FOR TIIB BVBN'r l'RINT ZVBNT RBC AN!) INl'U'l' '!'RANS SAME l\S 1 + FILB/lSN INFO ~~ARPl'.
IIDDCLOG II /I II /I II
• • • • ADARPl' •*
TLCCJMI>-l
*UC01U)S LOOGEl) WHEN '!'RANSACT. caa>LI!T *0 _ NO 0U'rl'U'l' *1 _ AN!) OUTPUT .w/o _ ALL *w/o _ ALL *YYIYMMDO *HIINMSSTH *IIYIMMJ;IO "HID§(SSTH *OUMP I FORMAT I EIO'l'H *HS I NO I~
*'lUIARl'l' OBSTINl'oTIONw' 02511 . . ' **lUIARl'l' SUBSCRIPTION_' S039144' lUIARPl' FROMDATB_ 20100924 ADARPl' PRa('l'IMB_14300000 **lUIARl'l' TODATB_20100924 **lUIARl'l' TOTna:_15045999 lUIARI'l' l'RINT-:rDRMAT lUIARl'l' STJ.TZ.-IBS
/I
.,., ., ,. ,
output: (.nip) URBLQJ:IB: URBLQ UIUILQI'NR : 1.. URBLQISN: 11,135 URBLQRSN: URBLQBFZ : 2 , 491 ,9 40 URBLQ'l"l'H: 2010-09-24 14 : 56: 53.60 URBLQIM'l': URBLQUPT: I URBLQRSl' : 0 URBLQSUS : 0 URBLQFMT : 2010-09-24 14 :5 6 :53 .51 URBLQLMT: 2010-09-24 14 :56:53 . 51
URBLI!IB : URBl. URBLLBN : 64 URBl.TLBN : 128 URBLTIMB : 2010-09-24 14 : 56 : 53.60 URBl.TIPB : AC URBLSN1oM: S0391 . .
35
URBl.VBR: 01 t1R8LPTIl': 5
URBLQfNR : 1.. UilBLQISN: 11 , 136 UilBLQRSN: 36 URBLQJ:IB : UiIBLQ URBLQBPZ : 2,491 , 941 URBLQT'1'M : 2010-09-24 14 : 56: 53.60 URBLQIM'l' : URBLQUPT: I URBLQRSl' : 0 URBLQSUB : 0 URBLQFMT : 2010 - 09 - 24 14 : 56 : 53 . 57 URBLQLMr: 2010-09 - 24 14 :56 53 . 51 URBLI!IB : URBl. URBLLBN : 64 URBl.TLBN : 128 URBLTIMB : 2010-09-24 14 : 56 : 53 , 60 URBl.TYPE : AC URBLDN1oM : URBLSN1oM: S039144 (.nip)
Figure 148:
Monitoring TLOG - ADARPP
URBLVBR: 01 URBLPTYl': 5
7 Monitors
124
Explanation of di fferent TLOG elements URSC
Continuation . l . . .nt
URBO
Dat& . l..... nt
UIUIE
End.-of-tran •• c:tion a l _
* •••9_
URBH URSl
nt
h e.der
Input . l ..... nt
URBL
Reptor Tran.action Loq Record Dafiniti on
URBP
Suba eription u •• " e xit par ..... u.r liU;
URBO URBS UJUl,T
U••" Exit Proqr ..... P.r.... Blocl< Reptor ata tu a/""'.pon •• e l _ n t Tran •• ction .l_nt.
URBU
ADJIlUII!: Extra.. t
URU URBZ
Subacription U•• ., laXit par ..... t.r blocl< U•• r Exit Pro'lr .... Pa"_ta" Block
hi • • FOFl
t. "
Figure 149:
H•• door U •• "
la_nt
Monitoring TLOC - Explaining Elements
Another way to determine the activities on Replicator Engine is to display the destinations statistics. Figure ] 30 shows the time the first transaction 0251018 (06251 file 018) was committed at 2010/11/02 16:26:45 and the last ET was done at 2010/11/02 16:51:07. In 1,462 seconds, 21,556 transactions were committed. These are 14.7 transactions per second for file 18.
The command log can show how many Adabas commands contain in one transaction (from ET to El). 17 ,31,31 ~plic:ator
..... A 0 A B A S
302
BASIC
SERVICES . . . . .
- S.l.ct.d O.atination Stati.tic.
S.l. cted O•• t Na-. : 0251018 S.1.ct..:!. o •• t ~ : Adabaa Total rap1icat..:!. tran.action. Total pendi"'1 tran.action. . . Total ~ •• a~ • • • nt ........ . Total cOllllll.it. Sloq 1ogv.d c:~t .......... . S10g delogg..:!. count 1_ f"or deatination on ,log Itema to del.t. trOll .log .. . Byt. , ,.nt to daatination .. . hnding byt•• tor da.tination P. nding ~.aag.a NuaotMor ot BT'.
T...... tran c ......... tted 21,556 2010/11/02 16:26:45
,
NUIlIbar o! ET' • . .
Figure 150:
7.1.3
2010 - 11- 02 PRPTS04
,, ,, ,, ,, , ,
T...... ot l •• t BT 21,556 2010/11/02 16:51 :07
Monitoring Destination Statistics on Reptor
Entire Net·Work (WCP) on the Mainframe
The trace function is an overhead and slows down the replication process. Therefo re, it is recommended not to activate it. Hourly snapshots are not helpful because they cannot show the real number of Adabas calls per second. The display shows only 18 Adabas calls per second during approximately 3 hours.
125
7.1 What can be monitored?
The calculation: 202005 api calls / 10855.943 sees = 18.6 per second 15 : 55,25 15 : 55:25 15:55:25 15 : 55:25 15 : 55:25 15:55:25 15 : 55: 25 15 : 55 : 25 15 : 55:25 15 : 55 , 25 15 : 55:25
NETP063I , Nln'P063I: NETP0631: NETP063I: NETP063I: NETP063I: NETP063I: NETP063I : NETP063I: NETP063I , NETP063I:
15:55:25 NETP0631: 15:59:13 NE~0 0 3I:
Figure 151:
Unk CSTt007 • StaU.Ue. ••• ---Byt..---• ------------+ WriU. 321.869M 30 . 3631t • 29.281X • 2 . 1611t • ---Total----
,
."
• • h . ~."" • Total • h . s.cond • ----------- • • h . S ... ond • • h . ~."" •
~. , 3 : 00 , 55 1085 5 -.>.pi C.l b -202 , 005 202,005 Total
hriod
--Moo . .. q • • --
" "
202,005
b'~
----------- •
" ", ,, ,
202,006
• Writa ------------+ 202,005 ~' . • + Roo.d CIId' . 202 , 006 " 202 , 006 " • " " +----------------------------------------------------------------------+ Dbid 251 lnaetiv. on KZ007 ----T•• k---202 , 005
---Ot:ruor----
~u,
~U,
N~
Monitoring Entire Net-Work (Wep) - Mainframe
Based on the Adabas command log. the target database received over 400 Adabas commands per second during the above mentioned time. The System Management Hub is not very helpful to determine the throughput of Entire Net-Work (Wep) on the mainframe. The statistics for a conneeted database shows the number of Adabas calls since wep startup. It seems to be the same as displayed in Figure 131. There are also two Entire Net-Work diagnostic utilities: • NETPFILl • NETPFIL2 NETPFILl is used to select the information to be printed from wep NETPRNT file, which contains tracing, logging and dump output. Selection parameters can be used to select a certain time and day, as weIl as loggin~ dump and trace records that match the title or any portion of the title. NETPFIL2 is used to search for a control block or storage area snapped by either the logging function or a dump. JOB (0), ' NET-WQRX', CLASs-A,MSGCLAS8-x,MSGLEVEI.-(l, 1) IIFILTEIU EXEC PGMooNETPFIL1 IIsTEPLI6 00 OSN-NBTWRIt . vr•. LOAO,OISP-SHR 11 00 OSN-wAL.vr•. LOAO,OISP-SHR llNETFlLE 00 OSN-NBTWRIt . vr•. NETPRNT,OlSP-SHR IIODCARO 00 * TBlS CCING!NT Wl:LL EIE PRltn'ED AT THE ElEGINlUNG OF 1lATE-20000316 STARTTEME_ 12570000 JmI)1'IME-12 5 80000
!lYOIJRJOB
11
load lib ~or NCP 10..:1 lib ~or ~ . er• • ted. by NCP TU OUTPUT
LOG-'rRACE
• LOG-IOOIlATA
,. •
nu.o-
TRACE_SENOOUT
IIDDPRIN'l'
Figure 152:
PD
51$01.1'1'-* ,DCB-(LRII:CI.-121 ,BL:K5lZE-1210, RECnc-FBA)
Entire Net-Work (Wep) - Mainframe - Diagnostic Utilities Ge L)
7 Monitors
126
As pointed out at the beginning of this chapter, tracing and logging is an overhead in WCP during replication and should ooly be used debugging errors. In a next release after V6.2, Software AG will drop support for both utilities
NETPFILl and NETPFIL2.
7.1.4
Network-LineorCircuit
- ---
NetQoS Pertomlance Centei'
_ _ _ t'l'.. _=<111 _ __ " _ _ _ ~ _ 0 0 _ _ _ _ _ .''''''''''
,
--- - ~
- _ ._ -
--~-------
-.---'-;;;;;:;;o-----'"""~"=~" ~"~-~-~
-_ _--_
,
1\
I. J . ...--:=~-...t......--=:-~:----. '.K
~. .
.
..,
,~
.:..
....
.,K
\
.:------f'~'--
.!;
,7 "
--"--'---
,~,-~-~-~ ' ~~~
Figure 153:
---------=- -""-"""1 -_._-........ .... --
----.--;;;""o----~ . ~ .~ ,
LI '1 ' ,"
I
--,._----',,,
,
,,~.
ri'. , '< J1-'1. , -'"] --,._----
Monitoring Network - NetQo$
Several tools allow you to monitor and optimize YOUT network bandwidth . You need for yOUf replication process a fast line to guaranty real-time data on your target database. Some of the monitors offer user interfaces based on browser, Windows GUI and iPhone application.
7.1 What can be monitored?
127
I
---------- -- [:: ----
Figure 154:
Monitoring Network - Browser, GUI, iPhone
Firewalls, Routers, Load Balancing Systems
7.1.5
A Firewall is an important perimeter defense tool that protects your network from attacks. Security tools like Firewalls, VPN, and Proxy Servers genera te a huge quantity of trafiic logs, which can be mined to generate a wealth of security information reports. ManageEngine Firewall Analyzer is a web-based, cross-platform, log analysis tool that helps network administrators and managed security service providers (MSSP) to understand how bandwidth is being used in their network. Firewall Analyzer analyzes logs received from different firewalls and generates useful reports and graphs. Trend analysis, capacity planning, policy enforcement, and security compromises are some of the critical decisions that are made simpler using Firewall Analyzer. ,s., ~"'l"""
f1iflFlrewallAnalyzer5 ..... _ .
-=- ......,
"""_... _. I _ _ .. _ !WDt
1\0
.............. _
..... _ ... _
"
-
,'".-
"" :: __..
,fGT ' 4
o T..... ' .. ·S_
o
T . . . . . ' . . . .- .. ;
-,
o T..... ' .. (S"". ..... '.. d)
o r.. _ " ' - . · ..... oT.. _ " , - ' ·
oT.. _ " , - , (........ ooi ...) • T ........... ...
Figure 155:
,.,.. ...... 00, ..".., T. , 2plI ..... . 1" " -00
~ .-.,
O M".AU T"" ••
·"1
.
. ,,- I Ad""O<"so_1 '" a !!.l *' ~
Trame Report.
1: . .
• F ... ••
_
"~a
>G'T..
."".. ,. .." .."
"
,-_.
~-=:maJ:a~
I..
..
1-·
I::.:::;' ...., .~ .. ...... ~'" ""· "'''1
""""" .
~ ~
*..,•." -*. " ,tl
~ ~
......
' 0.0'
,ut
.~.
-~,
-" ",... 111.0'
.U~
-
, ~.
",21
"' " ,n
'"
I :: :::.~'
,-, ..
~ mli~ll i m
Monitoring Firewall Analyzer - ManageEngine
-
..... ,.... ....... '... ... · ·,.. 1
~
~
~.
" "M•
.
.... . ....
""'., " , "" ,..,2
"
~
..,
~.
,.,..,.
. 11.0'
"' A'
"_0 •
-
.~ .
",,"
21.0' 10,"
'"
7 Monitors
128
7.1.6
Entire Net-Work (WCP) on Windows
Each Adabas command in the ~~~
wer log starts with the eye catcher
New ADABAS call ~~~ New ADABAS call ~~~
And continues for example w ith
• Start LCL call • Calling Alloeal extended_adabas OBIO=251 rc=O • Format and record buffers 15 : 53:08.630 ba'560 UIlt: (0.) _ N• • ADABAS "",11 _ N• • ADAIIAS ea11 15 : 53:08.6301:>0.'560 Lm< : (&A) - AC8 oontoont r..rt9ett_e%"SQ Bul'f.".O_Ud
0310: 0320,
1'2'11'231:
rDrAl.n~
oooooon
ror'OI"3FO
0330: n l'3I'o 15 : 53 08 646 4bS abD 15 : 53,08 646 tbSiObO
~.
15 : 53:08 U6 'b5 abO
~.
15 :53:08 646 4bSabD C."ip)
~.
Figure 156:
360041'14 4DICODOD · Oi\o>jU .. 6.ODM ... ' l'OF(lr'lFll " ... ~i'l~'
,.~ro"l!'2
.~
~.
tI'IIIJIT)
thr.ac\ bloo::k DOBDSU8
(0.) ADALIQ\l( v .".ion: 6.2.1.23 - Build-Ioor 0 "nd MClI BHB 0,, '21' AllALNlOI: eo.pUaUon Da .... : Oct 1 2008 'fta.: 15:18:31 (0.)
1'1."
_
ADABAS ca11 _
M." ADABAS .,.11 _
Entire Net-Work (Wep) on WindO\vs Log
The entire wep log can be viewed in appendix, chapter 8.6. The Natural parse program RDWCPLOG checks for the eye catcher ' New ADABAS call New ADABAS caU and counts the number of calls for each second. The report shows that 81 Adabas calls took place between the time 15:53:17.005 and 15:53:18.005 (one second ). I
v. g. ~.
, '"" '" '" '" '" '" '" '" '" .n
~~,
...
1022 1100 1119 1258 1322 1318 1458 H31 16H
,
Calh ~.,
." "
""" "" """ """ """ "" "" ,""
_. v.g.
...,
.
.,.11.
Figure 157:
10-09-13
""" """ "" """ """ "" """ ""
09.068 10.005 11 . 005 005 005 005 005 005 53:11 005 53:18 005 53:19 005 53:20 005 5 3:21 005 53 ; 22 53:23 on 53 : U .0> 53 ; 25 53:26.005 53 : 21.005 53,28.005 53:29.005 53 : 30.005
""" "" ""
""" " "
'" '"
ba1660 ba1560 ba1560 ba1660 (b5abO abs.bO 'b58bO (b59bO ba1660 ba1560 ba1560 ba1660 ba1560 ba1560 ab58bO 'b59bO 'bSabO ba1560 'b5abO ~~
ba1560 'b58bO
,n, ,U, ,n, ,n, ,U, ,n, ,n, ,U, =. ,n, ,n, ,U, ,n, ,n, ,U, ,n, ,U, ,n, ,U, ,u, ,n, ,U, ~. ~. ~.
~. ~. ~.
~. ~. ~. ~. ~.
~. ~. ~. ~.
,~
~. ~. ~. ~.
~. ~.
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
N... ADABAS N... ADABAS
_u _u
_ _ N. .. ~ cdl _ N... ADABAS _ N. .. ADABAS _ N. .. AlIA8Io$ _ N... ADABAS _ N. .. ADABAS _ N. .. ADABAS _ N... ADABAS _ _ N. .. ~ _ N. .. ~ N... ADABAS _ N. .. ADABAS _ N... ADABAS _ N... ADABAS _ N. .. ~ c.11 _ N... ADABAS _ N... ADABAS _ N. .. AlIA8Io$ _ N... ADABAS _ N... ADABAS _
_u _u _u _u _u _u __u u _u __u u _u _u
_u _u _u __u u
ADABAS ADABAS AlIA8Io$ ADABAS ADABAS AlIA8Io$ ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS ADABAS AlIA8Io$ ADABAS ADABAS
10-09-13
1619
Natural Parse Program for
N... N. .. N. .. N... N. .. N. .. N... N. .. N. .. N... N. .. N. .. N... N. .. N... N... N. .. N... N... N. .. N... N...
wer on Windows Log
11:23:26
"
_u _u _u _u _u _u _u _u _u _u .,.11
_
.,.11 _ .,.11 _
.,.11 _ "",-11 _
.,.11 _
.,.11 _
_u _u
""'-11 _ .,.11 _
.,.11 _ 23:26
7.2 Self-Written
7.1.7
129
Adabas on Windows - Command Log
As explained in chapter 7.1, it is very helpful to determine the number of Adabas commands per second on the target database to analyze bottlenecks. ADAr18 REC
79219 79220 79221 79222 79223 7922' 79225 79226 79227 79228 79229 79230 79231 79232 79233 79234 79235
N2 <3d to DBID
DATE 22~OV-2010 22~OV_2010 22~OV· 2010 22~OV-2010
22~OV-2010
22~OV-2010 22~OV_2010 22~OV· 2010 22~OV-2010
22~OV-2010 22~OV-2010 22~OV_2010 22~OV· 2010 22~OV-2010
22~OV-2010 22~OV-2010 22~OV_2010
Figure 158:
11 :07:35 11:07:35 11:07:35 11 :07 :35 11 :07: 35 11:07:35 11:07:35 11:07:35 11:07:35 11 :07:35 11 :07:35 11:07:35 11:07:35 11:07:35 11 :07 :35 11:07:35 11:07:35
251 FNR
DUR
D D
,, , ,, , ", ,, , D D
D
D
11 RSP
153
. ube~
16448 ISN
15423
CMD RSP USER-ID AD2(HEX)I FILE ISN TH 10A 100 10W •• 8 ... 8 ..... - ... H2 0 OooOOO'ElH... 11 75414 3 0 0 0 ..8 ...8 . .... - ... N2 0 oooOooB2I.... 11 75415 5 0 0 0 ..8 ... B. .... - ... N2 0 0000006BJk... 11 7541615 0 0 0 .. 8 ... 8 ..... - ... N2 0 oooOooCD/... 11 75417 20 0 0 0 ..8 ...8 . ........ OP 0 00000000/.... 0 010000 •• 8 ...8 ..... - ... H2 0 000000751u ... 11 754181000 .. 8 ...8 . .. N2 0 000000E9/.... 11 7541916 0 0 0 .. 8 ... 8 . .... - ... H2 0 oooooOSOIP... 11 7542019000 .. 8 ... 8 ..... - ... N2 0 oooOooDfl.... 11 7542112 0 0 0 .. 8 ... 8 . .... - ... H2 0 oooooOSOIP... 11 75422 17 0 0 0 .. 8 ...8 ......... LF 0 000004Ff/.... S 231 o8 1 0 0 .. 8 ...8 . .. H2 0 OOO0008E1... 11 7542f 1. 0 0 0 .. 8 ...8 . .... - ... N2 0 00000088/... 11 7542518 0 0 0 .. 8 ... 8 ..... - ... N2 0 oooOooCF/.... 11 75426.000 .. 8 ...8 . .... - ... N2 0 000000851.... 11 754276000 •• 8 ...8 ..... - ... N2 0 000000A7/.... 11 754289000 .. 8 ... 8 . .... - ... N2 0 oooOooBOI.... 11 75429 11 0 0
Adabas Command Log on Windows
Using a self-written Natural program, you can parse through the Adabas command log and count the Adabas commands per second. You can also use a text editor for Windows with search capabilities, such as display number of lines with '22 NOV 2010 11 :07:35' or 'N2' commands. Aselection function by columns (from/to) is beneficiary to search a command log size of 200 MB and more.
7.2
Self·Written
7.2.1
RPL and NAB Buffer Overflow
The length of the replication buffer (LRPL) and the number of attached buffers (NAB) can overflow on both the subscription or source database and the Replicator Engine. To automate the check of these buffers, the following job creates the high water marks by using SYSAOS in batch (statements 33-36) and a following Natural program parses the values (statements 48-50) and sends e-mails (statements 56-80) to the data base administration (DBA).
130
000001 000002 000003 000004 000005 000006 000007 000008 000009 000010 000011 000012 000013 000014 000015 000016 000011 000018 00001$1
000020 000021 000022 000023 000024
7 Monitors
IISTHMMJ02 ~ 11 NOTIFY_'SISUID, TIKB-NOLIKIT II*HkIN ~,SISTEM-SI5,CLASS_Pl0,USE~IETER II*~T
--------------* ~roIII
11* ----------- -------- -----------------------------------------11* 17 HalO 2009 DSTORR copied ~roIII RPLHN134 11* 1$1 Mar 2009 DSTORR lDIM .... q hOlll 50\ to 65 ' 11* 23 Dee 2009 DSTORR copied ~roIII RPLHlf312 11* 11*--------------------------------------------------11* Cr.ate Hiqh Wat.r Mark. DB302 u ain9 IoOS I PROD aeure. SIS 11*--------------------------------------------------IIRPLKWM EXBC PGH-NATBATCH, RKGIDN-OM, 11 PARM-'P~SIPROD ,SYS_ STRSYS,~N,~,ST~(LOQON SY$AOS;KENU) ,
--------------* --------------*
00002S IISTEPLIB
000026 11 000027 11 000028 IIDDCARD 000029 I/CMPRINT
000030 11** 000031 11 000032 000033 000034 00003S 000036
PR,DD~,FORHS_4 1 ,rcs-A8,CKARS-G 12S
11*--------------------------------------------------11* Tbi. job i • •ehedu1ed to run ..... ry 4 hour., a . Becky lUbin 11* Sottwar. AG r .comaanded . ESP _ DIETER.DB302HWM 11* 11* Tbi. job er •• te. and eheck. eh. hiqh •• ter mark. ot the 11* Rep1ieator _qine DB 312 and a.nda _ i l a i t IDIM > 6S \ 11* 11* DIETER .CNTL(RPLHW302) 11* 11* Dat. N_ Chan .... d
IICMSmlN A ,302
DD DISP-SHR,DSN-ADABAS.ALIl\.S. SIPROD. LOADLIB DD DISP-SHR,DSN-ADABAS.ALIAS. SIPROD. PGNLIB DD DISP-SHR,DSN-ADABAS.ALIl\.S.SIPROD.PAilKLIB DD DISP-SHR,DSN-ADABAS.CON'l'ROL.CARD(PRODN) DD DSN-DIKTER. HIIH.1U'L302 , RECftCIonA,LRECI.-133,BLltSIZE_0,UNlTaMISCIIA, OISP- (,CATLG) ,SPACK- (TRK, (10 , 10) ,RLSB) 00 *
ADABAS
NA'rURAL NATPA!Ut
by AOS
U H
",PIN
--------------* --------------*
000037 11*--------------------------------------------------000038 11* Ch.ek Bi9h Wat.r Marka of OB302 - Rep1ieator En9ine (REPTOR) 000039 11*---------------------------------------------------
000040 IIRPLCBECK EXBC NATBT ,OEPT-ST ,Os-DEVT , SISOUT_*, TIME_l00, 11 _ ' ~,MJ\Dl:o-O ,MAXCL-O ,MT-O ,LT-999999 ,AU'l'O-ON ,Ou-ABBND' IICMWItI'OI OD DISP-SHR ,DSN-oIBTER.IIWM.RPL302 input IICMWItI'02 DD DSN_OIETER, HIIH , PROD.RPL302 , output 11 RECrM-FB , LRECI.-79 ,BLll.SIz.s-O , UNIT-MISCDA, 11 OISP- (,CATLG) ,SPACK- (TlUI:, (10, 10) , RLSE) 000046 IICMPRINT DD SISOUT-* 000047 I/CMSYlIIN CD * 000048 LOGON DIETBR 000049 DWSLOGBW 000050 FIN
000041 000042 000043 000044 000045
000051 11* 0000S2
1/*
IF RPLCKBClt.N.Ro-O TIIBN
000053 11* ---------------------------------------0000S4 11* B-.... i l Hiqh Watar Mark. Lowar Tban 6S\ 000055 11* ---------------------------------------0000S6 II*EMAl:Ll BXEC PGM-l:KJBFTOl,RBGIDN-4096K,D~50 000051 IlsrSTSIN 00 * 0000S8 000059 000060
000063 000064
SUBJECT{Biqh Water Marka Lowar Than 65 \ - OB302) BJ\TCB DATl\.SET( 'DIETER . HMM . PROD.RPL302') IlsrsPROC 00 DSN_SIS2.CLIST,DISP-SHR IISYSTSPRT DD SISOUT-* 11 BNDIP 1/ l:F RPLCHBCIt , N RC- 12 TUN
000065 000066 00006' 000068
11** ---------------------------------------11** E-mail Hiqh Wate r Mark. Great.r Than 65\ 11** ---------------------------------------111DIIUL2 BXEC PGM-IKJBrrOl,REGIQN-4096K,OINAMIIBR-SO
000061 000062
SM'l'PNOTI! TO(DSTORR@STORRCONSULTJ:NG.CCM)
000069 IlsISTSIN
OD *
131
7.2 Self-W ritten
000010 000011 000012 000013 000014 000015 000016 000017 000018
000019 000080
000081 000082
SM'l'PNOTE TO ([email protected]) StJBJZCT(H1'lh WaU,r Mark. Gr •• u,r Th.n 65 ' - DB302) BATeR OATASET ( ' DIETJ:Jt, IIMM, PROD . RPL302 ' ) SM'l'PNOTI! TO ([email protected]) SUBJJ:CT(Hi'lh WaU,r Mark. Gnoa t . r Than 65 ' - DB302) BATCH DATASET ( 'DIETBR.IIMM. PROD.RPL302 ' ) SM'l'PNOTJ: TO (INro@STORRCON'SULT:lNG ,COM) StJBJZCT(Hi'lh Wau'r Mark. Gr.at.r Than 65 ' - DB302) BATeH DATASET ( ' DIETJ:Jt, IIMM, PROD . RPL302 · ) IISYSPROC DD DSN_SYS2 CLIST,DISP-SHR IISYSTSPRT PD SYSOQT-. 11 ENDI!' IIDELZTE DD DISP- (SHR , DBLETB) ,DSN-DIBTBR . IIMM . RPL302 IIDDl IIDD2 PD DIS P- (SHR,DELZTB) ,DSN-DlETJ:Jt.IIMM. PROD. RPL302
000083 000084 000085 11
Figure 159:
Check NAß and RPL Overflow QCL)
See the code of the Natural parse program in appendix, chapter 9.5.3 RPL and NAB Buffer Overflow. Output of the e-mail:
• •••• A 0 A B A S BASIC SERVICES ••••• High Wau,r Mark .
13:41:51 DBID 302
, ,, ,, ,, ,, ,, ,,
AtU,ch.d Bu~~. r(NAB) ,~) c:oaan.nd Qu.u. I'o,."..t Pool (Ln) ,~) Hold Qu. u. ISN- L1.t Tabl. (LI) S.q . Ood . Tabl.(LQ) ,~) U•• r OU_ Uniqu. Ol! Pool (DUQ) S.cur1ty Pool (LCP) UQ I'il. Li.t (UQI') ATM Tran •. (XID) Work Pool Ra<1o Pool (LRDP) I Raplication (RPL)
".
,-,
,
NAB Or RPL .,.ach. d 65 \
Figure 160:
, ,, ,, ,, ,, ,, , ,, , ,,
u. ..
I \ U. .d. I
, ,,, ". ,,, ,,.,,, ,,, "
2451600 23040 300000 560056 12000 20000 1236312 100000 10000 384360
1 26464
500000
129188
524288000
3685208!U
...'" ,,,, ,,••..,, ,,,,
54880
1012
••
"., ,, ,., ,., ,, , ,, ,., ,,
8624
1152
, ,, ", ,,• ,, "
Check NAß and RPL Overflow (Output)
2010-10-14 PACUH02
, ,, ,, ,, ,, ,, " " " ,, " " " ,,
2 010-10-08 20 1 0-10-14 2010-10-08 2010 -1 0 - 13 2010-10-08 2010-10 - 11 2010- 1 0-08
15:41:04 12:47:52 16:45:46 01:00:20 16:45:42 10:23:35 45:
2010-10-11
2 3:
2010-10-13
.
132
7.2.2
7 Monitors
SLOG check on Reptor
The following job submits SYSAOS in batch to get the Replicator statistic of the SLOG fil e. The online display of SYSAOS must be simulated in batch because the software does not know keyword commands, for example 0,302/ X / F / B / "FlN. The Natural program DWSLOGCK parses the output of the 'Replicator Statistic' fo r not yet replicated transactions. It creates areport with the Replicator Statistic. If the SLOG is empty then it sets the condition code 0 and writes 'SLOG is empty: If the SLOG is not empty then it sets the condition code to 12 and writes 'SLOG is
not empty - open the destination.' I/job ", .. rd
11*----------------------------------------------------------------* 11* D. l . t . data •• t . tr,.. prior run 11*----------------------------------------------------------------* IIDELETE EXEC PGN-IDCAMS IISYSPRINT DD SJSOUTW* IISYSIN DD * DELBTE OIJ:'l'BR . SLOG302
PURGK
11*----------------------------------------------------------------* 11* Cr.at. SLOG r.port by U.in9 SYSADS I Maint.nanoe ---* 11*----------------------------------------------------------------* IIRPLSTAT1 J:XEC PGM-NATBATCH, Rll:GIQN-OM, 11 PAP;Moo' PAP;MooSJPROD ,SJS_STRSY7 ,AUTOooON, IMooD , STACItoo (LOGON SYSADS ;MENU) , IlsTEPLIB 00 OIS_SHR,OSN-ADABAS . ALIAS , SIPROD , LOADLIB ADABAS 11 OD OIS_SHR,OSNooADABAS . ALIAS.SJPROD.PGMLIB NATURAL 11 00 OISP-SHR,OSN-ADABAS . ALIAS. SYPROD . PlUIMLIB NATPARM IIDOCAPD OD OIS_SHR,OSN-.r.DABAS .CONTROL. CARD (TESTY) IICMPRINT 00 DSN-DIJ:TER. SLOG302, 11 OIS_( ,CATLG} ,SPACJ:-(TJUt, (10, 10) ,RLSB) ~plication
IICMSYMIN 0,302
00'
,
x
B
,-
, ,I'IN
11* eh. -------------------------------------------------------------11* cl< SLOG tor uq>ty (Rc-O) Or not uq>ty (Rc-12) 11* -------------------------------------------------------------IISLOGREP1 BXBC NATBT ,DBPT-ST ,Da-DEVL, SYSOU-r-*, TIME_100, 11 _ ,:r-o ,MADIo-O ,MAXCt.-O ,MTwO ,LT-999999 ,AUTOooQN, Ou-AaBND ' IISYSOUT
DD SJsou-r-*
IICMIMI'01 IICMPRT01
00 OIS_SHR,OSN-DIE'l'BR . SLOG302
DD SJsou-r-* I/srSIN 00 * LOGON DIBTBR
". 11
Figure 161:
SLOG Check on Reptor OCL)
The Natural parse program DWSLOGCK is located in the appendix, chapter 9.5.4.
7.2 Self-Written
133
The foJlowing shows the Replicator Statistics to be parsed: 17:00:01 R.plicator 312
...._.
R.p1icated tran.
Total trn . hndinq .. Tot ....
••••• A D A B A S
BASIC
2011-02-24
SERVICES . . . . .
Replicator Stati.tic. / . . . .a9 •• / byt•• 43,607
6,400
Recai"ed
PRPTSID
~rom
input qu.u ••
" ••a9.' ayte . Coaait •
'11' •.
aackout.
ayt •••• nt to all de.tination. Tot byt •• .
".'.'11'.'
'" 17,639
o.loqqad . I.oq9aod ••• On ~il • . .
Elyte • ......
Coaait.
aackout• . . .
17,639
Raplay dbid/tok. n cnt o..tination . loq cnt .. rp1--H.1p
rp3--bit
Figure 162:
rp4----Re~ra.h
rps-------OEllD/Tok.n
PP6--------
o•• t. SLOG
rp7---
rp8--+
rp12----"nu
SLOG Check on Reptor (Input)
The following shows the output of the program DWSLOGCK: 17:00:01 R.plicator 312
...._.
Total Un. hndin9
..... A D A B A S
BASIC
SERVICES . . .
Rep1icator Stati.tic. -
43,607 6,400
*.
2011-02-24 PRPTSID
" •• a9· · By te. Coaait •
aackout.
Tot ....9. Byte• • • nt to all cte.tin.tion. Tot byt••.
'"
17,639
. .• • aq •• Elyte • . . . Coaait.
aackout.
17,639
Raplay dbid/tok. n cnt o..tination . 1oq cnt .. SLOG i . not _ t l ' - open th. cte.tination .
Figure 163:
SLOG Check on Reptor (Output)
Mor.: pr ••• rpa
134
7 Monitors
7.2.3
Compare two SlOGs and Open Destination
Similar to the prior chapter 7.2.2, this job compares two Replicator Statistics and open destinations if necessary.
See detailed description of the job - see JCL comments: t/STSLOGCT JOB (ST345T , ST01,ST) ,DBA,NSGCLASS_l,
11
NOTlPT_ 'SYSUfD, TDmwNOL:lKIT
tl*»QIN
, TYPRUNw-SCAN H01JlooNO , SYSTEN-SI5, CLASS_PIO ,USER-DIETI!R
I/ · FORMAT
PR,DDNlIME_ , FORMS_ 41 , FCB-A8 ,CIlAIlS-G125
11*--------------------------------------------------- --------------* 1/ * Replic:ator ne a tination Che ck - DIErER . CNTL(RPLSLOG2) /1* 11 * /I 1/ * 1/* 11 * /I 1/* 1/* /I/I/I/I/I /I/I/I/I/I /I/I /I/I t/*
Job .,i11 be daily atarted by ZSP on 515: DIZTER.SLOGCHECIt-T At thi . time: DB03~ I DB)02 I DB251
Che ck
Step N _
I'1,J.nction
-----------
RPLCHECIt
----
S.t CC 0 i t ct..tin.. tion and DB ..". Oll: Se t CC 12 i t not O!t U' rplche ck.n rc: - 12 the n
ZMlULl
ce
12
Send .-. . i1 and .top job
---- U' rplche ck.n "c - 0 the n Rl'LSTAT1 Cr_ t . SLOGREPI by uainq AOS SLOGREPl Che ck SLOGREPl wh e the ", SLOG S. t cc o i t SLOG ia _ t l ' S. t CC 12 i t SLOG i . not _ t l ' ---- i t al09r~1 n rC _ 0 th.n EtQJ:L.2 S. nd . - ... U . ".. rythinq i . Olt and . top job ---- i t . 109r~1 n.rC _ 12 the n Rl'LOPEN Open ct..tination by uainq AOS tIlUT Wait tor 1 minute Rl'LSTAT2 C",. ate SLOGREP2 by u.inq AOS SLOGREP2 Compare date. e t . SLOGREP1 .. nd SLOGREP2 s.t CC 0 i t SLOG i a _ t l ' s.t CC 12 i t 8LOG i . not _ t l ' ---- ir a loqrep2 n . rc: _ 0 th.n EMPTr S. nt . ..... i1 th .. t SLOG i . _ t l ' ..nd . top :lob 1/* ---- H ' al09r~2 rc: • 12 tben NOTEKP'l'r S.nt ......11 that ct..tin ~ned bu.t /I . ndit
11* 11* /I-
11* D.. te 11* ---------- -------- -------------------------------------------11* 2009-01-27 D. torr copiad trOll Rl'LSLOG1 and aoditiad tor Tl:ST 11* 2009-12-23 D. to"" updatad tor .. n . w te . t with COEMS PROD /I-
11*--------------------------------------------------- --------------* 11* D.I.te dat... . t. trooa prior run 11*------------------ -------------------------- ------- --------------* IIDELBTI: BßC PGHooIDCIoHS IISrSPRINT DD srsour-* IlsrSIN DD • DELETI: DIETER . MSG6 DELETI: DIET~ . MSG7 DELETI: DIETER . MSG8 DELBTI: DIETBR . SLOGREPl DELBTI: DIETl:R . SLOGREP4
11*--------------------------------------------------- --------------* 11* Ch. ck whath.r N. t-Work i . open ..nd DB 191 i . a"...ilabl. (Re14B) 11* A.....i1abl.: Re _ 0; ....... v.ilab1. : Re 12 ; oth.r .rro",.: Re 16 11*------------------ ---- ----------- --------------------------------. IIRPLCIiECJt. EXEC NATaT ,DEPT-ST ,Ds-DEVT, srsour-* ,Tna:_ 100, 11 PRM- ' IM-!) , MJlDIo-O ,1QXCI,a0 ,)1'1'>00 , LT-999999 ,Auro-oN, Du-ABEND ' IlsrBOUT IICMPRINT
11
DD Brsour- * DD DISP-(,CATLG) ,DSN-OIETER.HSG6, RBC~rB,~120,&LItSIZE_0,UNIT_M%SCDA,
7.2 Self-Written
135
11
SPACE_(TRK, (lO,50) ,RLSE) IIc:wsmIN 00 * LOGON DIETltR OWSROUR 2S1
... 11
11' RPLCHECJt.N Re_12 THI!:N
11** ---------------------------------------------------------------11** E-mail N.two"k .nd OB . " . down 11** ---------------------------------------------------------------IIEIQ,ILI EXEC PGM-IIUIlFTOI ,RBGION_40~6K,Onu.MllBR_SO IISYSTSIN 00 * SMl'PNOTZ TO ([email protected]) SUIIJEC'r (Rn: DESTINATION DATABASE 191 OR HE'l'WORK IS DOiIN) BATCH OATASET( 'DIETBR.MSG6') IISYSPRI)C 00 OSN_ SIS2 .CLlST, D1SP-SIIlt IISYSTSPRT 00 SYSOUT-* ENDIF /I 11' RPLCHI!:CJt . N . Re_16 THI!:N /I
11** ---------------------------- ----------- ------------------------11** B-mail N. two"k p"obl....a - Re 224 11** - ------------------ ----------- ----------- ----------- --------- --IIBHAILl EXEC PGM-lIUIlFTOl,RBGION_40~6K,Onu.MllBR_SO IISYSTSIN 00 * SMl'PNOTZ TO (OSTORR@STOiUtCONSULTING .COM) SUBJECT (NETWORJI:: a..pT ...... lonq." than &Irin"" RBPLYTIM) BATCH DATASBT( ' OIETBR.MSG6 ' ) IISY SPROC OOOSN_SlS2.CLlST,OISP-SIIlt IISYSTSPRT DD SlSOUT-* 11 ENDIP 11 Ir RPLCHJ:CJt . N .Rc-O TIIEN n.two.,k open
11*---- -------------------------- ----------------------------------- . 11* Cr.at. SLOG reJ>Ort by " a inq SYSAOS I R40plication Maint.nanc. ---* 11*------------------------------ -----------------------------------. IIRPLSTATI EXBC i'QI-HATBATCR, RBQION-OM, P_'P_SlPROO,SYS-STRSYS,AIJ'l'O-ON,lM-O,STACJtoo(LOGON SYSAOS ; MENUj' IISTBPLIB 00 OISP-SHR,D~ . ALIAS.SIPROtl.LOADL:IB ADABAS 11 OOOISI'-SHR , OSNooAOABAS . ALIAS.SIPROtl.PGKLIB NATURAL 11 00 OISP-SHR,D~ . ALIAS.SIPROtl.PARMLIB NATPARM IloDCARO 00 OISI'-SHR , O~ . CONTROL.CAPl)(PRODN) IICMPRINT 00 OSN-DIETBR.SLOGREP3, 11 OISI'- (, CATLG) , SPACE_ (TRK , (l0, 10) ,RLSB) IIc:wsmIN 0,302
11
,,
"
.
B , ,rIN
/.
11* -------------------------------------------------------------11* Ch.ck SLOG ro" .-pt.y (RC-O) 0., not. .-pty (Rc-12) 11* -------------------------------------------------------------IISLOGRBPI BXEC NATBT,OEPT-ST,OB-PRST,Srsour-*,TIME_IOO, 11 _ ' IM-O ,MlUIID-O ,MAXCL-O ,MT-O ,LT-~99~99 ,AIJ'l'O-ON, Ou-ABEND ' IISYSOUT
00 SYSOUT-* DD DISP-SHJl,OSN-DIET&Jl .SLOGREP3 IICMPRTOI 000SN-DIETBR.MSG1, 11 D:IS P- (,CATLG) ,SPACE- (TRK, (10,10) ,RLSE) IISYSIN 00 * LOGON PDS'l'UTIL OWSLOGCK 11~1
... 11 11
BNOll' Ir SLOGREPl. N Re _
° TREN
11** ---------------------------------------------------------------11** E-mail N. two .. k . ndOB . . . . .vailabl. 11** ---------------------------------------------------------------IIEIQ,IL2 EXEC PGM-llUllPTOl ,RBGION_40~61t, Onu.MllBR_SO IISYSTSIN 00 *
136
7 Monitors
SMTPNOTE TO(O$'1'[email protected] , e<::H)
SUBJECT(RPL: D•• tination 08
l~l
-
and Hat- Work 1 • • • •ilabla ) BATeN -
lJATASBT (' DIJ:TBR . MSG7')
tlSYSPROC DD DSN_SfS2 . CLIST,DISP-SKR IISYSTSPRT DD srsOUT-*
/1
ENDI!'
,," /I
11' SLOGREPI H . Re _ 12 THEN
1/ '* ---------------------------------------------------------------1/" OPEN tha deatination - SLOG .... not u.pty
----------------------------------------------------------------
11"
/IRPLOPEN ItXEC PGH-NATBATCH,REGION_OH,
11
p~' P~SrPlWD,$Y$ - $'l'R$Y5,Aln'O_ON,I_D,STACho(LOQON
I/STEPLIB
DD DISP-SHR,DSN-.ADABAS.ALIl\.S.SIPROD.LOADLIB DD DI$P-$HR, DSN-M>ABA$ .ALIAS . $YFROO . PQMLIB DD DISP-SHR,DSNw.ADABAS.Al.IAS.SJi'ROD.PARHLIB
IID~
OD
IICHPRINT I fCMSYNIN 0,302
DD SISOUT- " 00
/1 11
$YSAOS;MENU) ,
ADABAS NA'l'OIUU. tlATPlUIM
DI$P-SHR,DSH~ . ~L.CARD(PRODH)
X
•
It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It, It ,
,0251006 ,0251007 ,0251008 ,0251009 ,0251010 ,0251011 ,0251012 ,0251013 ,0251014 ,0251015 ,0251016 ,0251017 ,0251018 ,0251019 ,0251020 ,0251021 ,0251022 ,0251023 ,0251024 ,0251025 ,0251026 ,0251027 ,0251028 ,0251029 ,0251030 ,0251030 ,0251032 ,0251033 ,0251034 ,0251035 ,0251036 ,0251037 ,0251038 ,0251039 ,0251040 ,0251041 ,0251042 ,0251043 ,0251044 ,0251045 ,0251046 ,0251047
, ,!'lN
,"
/,*-----------------------------------------------------------------*
137
7.2 Self-W ritten
11* W.it 1 minut. befor. cr.atinq th. SLOG report '2 11* -----------------------------------------------------------------. I/WA:1T EZEC IISTZPLIB on IIDDPRIN'T DD IlsySUDUMP DD IIAlmNDAID DD
PGM-SLBJ!P,P~'OO:Ol:OO.OO '
(HH:_:SS:TR)
OISP-SHR,OSN-OIETI!R.ASM.LOJIOLIB SISO!J'r- * OUlfi!' SISOUT-*
11·------------------------------ -----------------------------------. 11* Cr.at. SLOG report '2 u.inq SYSAOS I R40plication Mooint.nanc. ---* 11· -- - - ---- ---------- - -- -------- - -- - ------- - -- - ------- - -- - -------- --. IIRl'LSTAT2 EXEC P<öM-HATBA'l'CR, R&(öION-OM,
11
PARH-'PARH-SIPROO,SYS-STRSY5,AU'l'o-oN,IM-D,ST~(LOGON
IISTZPLIB
11 11
IIDDCARD IICMPRIN'T II IIc:wsmIIl
,, •
DD DIS_SHR,DSIf-ADAllIU> . ALIA$.$IPROD.LOJIOLIB DD OIS_SHR,D~ABAS.ALIAS.SIPROD.PGKLIB DD DIS_SHR,D~ . ALIA$.$IPROD.PARMLIB OD OIS_SHR,D~ . CON'1'ROL.CAJUl(PRODIl) DD DSIl-DIETER.$LOGREP4, OIS_ (, CATLG) ,SPACK- (TM, (10,10) ,RLSB) DD *
SYSAOS;MImU)' ADABAS NA'l'URAL
RATPARM
0,302
, ,TIN
/.
11* ------------------------------------------------------------------11* Ch.ck SLOG for ..opty (RC-O) or not ..opty (Re_12) 11* S ...... SLOG report 1 and SLOG report 2 empty (Rc-O) SLOG empty 11* S"'" SLOG report 1 _ ' , .nd rep 2 EQ (Rc-O) ..opti-.l. 11* S"", SLOG report 1 GT ....... SLOG r.port 2 (Rc-O) empty in proq 11* S"'" SLOG r.port 1 EQ ....... SLOG raport 2 ( Rc-12) open <Mo.tin 11* open did not work 11* ----------------------------- ----------- ------------ --------------IISLCGREP2 EXEC NATST,DEPT-ST,DB-DEVT,SYSO!J'r- · ,TlME_lOO,
II
nc-o ,MADIo-O ,M1oXCL-O , _ 0 , LT-999999 ,AU'l'o-oN ,DU_ND ' $YSOUT-· DIS_SRR,OSllaOIBTER SLOGREP3 DISP-SHR,DSN-DIETI!R SLQGRI:P4 OSN-OIB'l'ER.MSG8, 01SP- (,CATLG) ,SPACE- ('l'R:K, (10,10) ,RLSE) OD * PRM- '
IISYSCNT //CMIftI.POl
IICMIftI.P02
//CMPRTOI
II
IlsYSIN
DD OD DD 00
OWS:LOGC2 ".
/I /I
Ir SLOGREP2 !l.Re _ 0 THEN
IIEMPTY
BXBC PGM-IKJZPTOl,REGION_4096X,O~50
SLOG .... -..pty
11* · ---------------------------------------------------------------11** EMAIL SLOG EMP!'I 11* · ---------------------------------------------------------------IISYSTSIN
OD .
SlftPNOTll TO ([email protected]) SUBJECT(Replicator: SLOG D8302 i . _ t y )
BATCR OJ.TASBT ('OIBTI!R.MSGS' ) SlftPNO'l'l: TO(LrRAZIN@CALSTRS , COM) SUB.JBCT(Replic.tor: SLOG 08302 i • ..opty) BATCR DATASET ('DIBTEit,MSG8') SlftPNO'l'l: TO ([email protected]) SUBJECT(Replicator: SLOG D8302 i . empty) BA'l'CH OJ.TASBT ('OIBTI!R.MSGS') IISYSPitOC DD DSN_ $IS2.CLIST,D1SP-SKR IISYSTSPRT 00 SISouor-* 11 ENDI" /I Ir SLOGREP2 . N Re _ 12 THEN
11*· ---------------------------- ----------- ------------------------I I **
EMAIL SLOG NOT BMPTY
11* · - - -------------------------- ----------- ------------------------IINO'l'BMP'l'I BXBC PGM-IKJZrrOl, REGION-4096X,DYN1oMNBita50 IISYSTSIN
DD.
7 Monitors
138
SM'l'PNO'l'II: TO(DSTORR@STORRCONSI1LTING . COM)
SU8JZCT(Roopl DB312 , SLOG 1. not. ampt.y DAT~T(
-
Open da. tin. raU..:!) BATe" -
'OJ:BTER . MSG8')
SMTPNOTI! TC) ([email protected]) s=cr(Repl OB312: SLOG i . not _ t l ' - Open eIe.tin . f:-.iled) BATeH
OATASIIT ('DIETIIR.MSGB·) SM'l'PNO'l'II: TO (ADABASSERVERADKIN:lSTRATQilS @CALSTRS . COM) SUBJECT(Rapl DB312 : SLOG ia not alpty - Open
I/SYSPROC 00 OSN-SIS2 . CLIST,OISP-SHR I/SYST$PRT 00 srsOUT-.
/1 11
BNDII'
Figure 164:
Compare two SLOCs Open Destination OCL)
Appendix, chapter 9.5.5 shows the Natural compare program and chapter 9.8.1
displays the assembler program Sieep/Wait. Appendix chapter 9.8.2 shows an assembler program to determine the dataset name via the DDNAME as part of the JCL. The routine can be called from a Natural program or as part of a job
stream.
7.2.4
SLOG Check tor Logged Files
It is important to know in case of pending file changes what files are still in the
SLOG before you update fields in the global format buHer (GFB) and the target database. In some versions and SM-levels of SYSAOS, the replicator statistics show that
files are on the SLOG but hitting the PF6-key shows nothing. This function worked in prior replicator and AOS versions . 17:00:01 Replic:.tor 312
. . . . . A D A B 11. S
Replic:.ted tr.n.
/ me ••• g • • / byte .
BASIC
43 , 607
Tot.l tm. 6,400
hndJ.ng . . Me • •• g •• Tot • • g.
SERVICES •••••
2011-02-24 PRPTS10
- Replic:ator st.ti.tic:. Reoaivad
~rom
input queu ••
Me • • • g •• Byte • . . Co.ait.
B."kout.
Byt•••• nt to .11 öa.tin. tion. Tot byt • • . Na ••• g • • . . .
o.1oqgad Logg.d ••. On h1• . .
'"
17,639 17 , 63$1
Repl.y dbid!tok.n c:nt . o. . tin.tion . 109 c::nt ..
'"
Byte • . . . . . . Co.ait.
B.cl
Mor. : pr.. . PFS
PF1---
PF3---
PF 4-----
P FS--------
PF6--------
H.1p
Exit
Re~r •
OBIO/Tok.n
O• • t. SLOG
Figure 165:
•h
SLOC Check for Logged Files
PF7---
PFB---
PF12-----
+
Menu
139
7.2 Self-Written
Another function 'Destination Statistics' shows 'Total pending trans' but it is not dear whether these pending transactions are located in the replication buffer or in SLQG.
_._. _.
15:35 : 20 hpli"ator 302
*u** A 0 A B A S BASIC ~ICBS ***** - O•• ti"atio" Stati. tic. -
o. . t. N. . .
Total raplicatad tran . action.
--------
0251018 0251035 0251035 0251035 0251035 (.nip)
,.",.
Figure 166:
,
2010-10-14 PRPTS04
Total pendinq t.r.n.
556 3,0$11 5,164
2,098 18 19
5,954
Manual File Change Procedure - SLOG Check
Based on this problem, I wrote a Natural program as a workaround unti! Software AG can fix the bug. It reads the SLOG file and displays the long name of files. See the Natural program READF3QP at appendix, chapter 9.5.12. Output of program READF30P in SYSPRINT:
,
12/15/10
10:38:33
NO record. f'o"nd in SLOG f'i1. 30 in DB 312
Figure 167:
7.2.5
Monitor Program: SLOG Check for Logged Files - READF30P
SLOG Space and Number 01 Records Check
The subscription log (SLOG) is an Adabas file and used as an overflow area for the RPL buffer of the Reptor. To make sure that the SLOG does not overflow, the space and the number of records must be manually checked based on the Adabas report. File 30 is in this example the SLOG file (see Figure 168) and I wrote a Natural program to parse the Adabas report and display the space and the number of records. The program can set a condition code if the size reaches a special threshold and an additional job step can send out an e-mail to the DBA group. The Natural monitor program is located in appendix, chapter 9.5.11.
7 Monitors
140
I/STRPOJOP JOB (STJfST,STOl ,ST) ,DBA,MSQCLASS-l,
/1
I "HAIN
1/*roRH1oT
NOTIFI_'SrSUID, TIHE-NOLDlIT H01JlaNO, SYSTEN-S17 ,CLASS_PIO ,USERaSTADBA PR,DDNlUII:_, FORHS_41, ~ ,CKARS-Gl:l5
/,*-----------------------------------------------------------------* Thi . job cr.atea an online report of tile 30 and para •• i t tor
1/*
11*
_ r of r eco rcU
11 ,,11* ,,11* 11* ----- ------ -------- - ------------ ----------- ------- ----------,,11*--------------------------------------------------- --------------* * - I'ree apace
tlIETBR.CN'l'L(RPL30REP)
1i *
tla te
Name
Chanqed
15 tJec 2010
DS'I'ORR
created
11* tlelete date.eta tr .... prior run 11*--------------------------------------------------- --------------* IltlELETE EXEC PGM-IOCAMS IISYSPkINT DD SYSOOT-* IlsISIN tltl •
DELETE DIE'l'ER. iUpr30 . DB312
l'URCE
DE.LBTI: DIJ:TBR.RPFI'30 .D8312
PURGB l'URGE
DELET!: DIETER.RINP30 .DB312
1/*-----------------------------------------------------------------* 1/* er.at. Hiqh WaU.r Mark. 08312 u.ing- 1005 / PROD .Ou ""'. 515 1/*-----------------------------------------------------------------0 I fRPlJlWM EDC PGMooNATBATCH. REGION_OM, I/
PARH-'PARH-SIPROD,SIS.STRS15,~,I~D,ST~(LOGON SlSAOS;~)'
I/STEPLIB
CD DISP-SHR,DSN-ADABAS . ALIAS.Sll'ROtl.LOADLIB
11 11 //OJX:ARl)
00 OIS-SHR ,tI~ • .u.:IAS,srPllOD.VGMLIEJ 00 DISP-SHR, DSN-ADABAS • ALIAS. SYPROD . PARNLIB
IICMPRINT
11**
"
IICMSYMIN R ,312 1',30,312
1111 tlIS_SHR ,I1S~.CONY'RDL.CARIl (PRODN) 1111 DSN-DIETER.REPI'30.I1B312, RJ:CPMooraA ,LRJ:CL-133,ßLlUII ZZ-0, UNIT-MISCDA, DISP- (,CATLG) ,SPACE_ (TRIt, (10,10) ,RLSE)
JIIIABAS
by ADS
00 -
, ,rIN
--------------* "11*--------------------------------------------------11' Check the SLOG r.port tor number or r .cord.
and u.ed .pace
11*--------------------------------------------------- --------------*
IISLOGHEClI> EXEC NATBT ,tlEPT-ST ,tls-tJEVT , SYSOOT-', TINS_100 , _ ' r-D ,MIUIIo-O ,Ml\XCL-O ,Ml'-O ,LT-9999gg ,AlJ'l'O-ON, DU-ABEHD' IICMNIU'Ol tltl DISP-SHR,tlSN-tJIETER.RBPF30.tlB312 input 11C'IIIKU02 00 DSN-DIETER.RPRJO.I1BJ12, output ADS report 11 RECrM-FB ,LRJ:CLoo79 ,BLltS IU_O, UNIT-MlSCDA , 11 DISP-(,CATLG) ,SPACE-(TRIt,(10,10) ,RLSE) 11C'IIIKU03 tltl DSN-oIBTER. kINFJO. tlB312 , output ot RPLJOREP 11 RECPMooFB,LRJ:CL-080,BLKSIZE_0,UNIT-MISCDA, 11 DISP-(,CATLG) ,SPACE_(TRIt,( 10 , 10) ,RLSB) IICMPRlNT 00 SISOUT-* IICMSYNIN 110' LOQON STIlBJWTI RPL30REP
11
". 11
I1IBTBR.RJ:pr30.DB312 output of 8ISAOS report tlIETER.RPFP30.DB312 "el.vant linea, input tor RPL30REP I1IJ:TBR.RINr30.I1B312 output of proqr_ RPL30REP
Figure 168:
SLOG Number of Records and Space Check OCL)
7.2 Self-W ritten
141
0IETER.RlNr30.0B312 •• • • •• •• •• ••• • • ••• • •• •• •• •• •• • •• • Top ot Oat. • •• • ••• •• •• •• •• •• • •• •• • ••• •• • • ••• • 2010-12-16 - 17:55:03.7 - Raport ot SLOG Vi1. 30 OB312 - RPL30REP Ra"ord. 10adad 0 Ul . pa<:• • 11ooae.d (b1k): 135000 UI . paca unu . ad (b1k): 134 999 NI .pa"a a1100ated (b1k): 1080000 NI . paca unu.ad (blk): 1080000 os . pa<: • • 11ooated (b1k): 2250000 OS . paca unu . ad (b1k): 2250000 ••• ••• •••••••••• •••••• • ** •• •• ••• lIottOllll ot Oat. •• • •• *••• *•• • *••• *••• *•• *• • • *•• *
Figure 169:
7.2.6
SLOG Number of Records and Space Check (Output)
Check Messages on DDPRINT
Under z/OS, it is normally not possible to check the output queue of an active job. To check messages of DDPRINT, the rBM utility EJESLNK can locate the job name and 00 name and save the content to a dataset. A Natural program parses the dataset for error messages, wamings and response codes and saves it to another dataset. 000010 IIEJZSLm: EXI!:C PGM-EJESLm: 000011 11 · EJESEXT 00 SYSOUT-. 000012 IIEJZSEXT 00 DSNooADJIBAS.I!:XTRACT . DDPIUNT, 00001311 DISP-(NEW,CATLG,DELETE) ,VO~(",20), 000014 11 UNITo«ISCDA,auFNOoo20 ,RI!C~FB,LI\J!:CLoo240, 00001511 SPACE_ (2tO, (100,50) ,RLSE),AVGREC-~,RE~PD-30 000016 IIEJZSOUT DD SIsotJT>o* ,RI!:cns-vB, LRBCI.-2tO 000017 IIEJZSl:N DD· 000018 ST REP'noIPH 000019 rum RETMi'M 000020 :S 000021 rl:ND DOPRINT 000022 : 1: 000023 11
Figure 170:
Read Output Queue of Active Job - EjESLNK QCL)
See the parse program at the appendix, chapter 9.5.2.
7 Monitors
142
The report of the parse program: <.nip> 017528
-.........
,,. '" -" '" -" '" ,,. '" -" '" -" '" -" '" '" -" '" '" '" -" ••••••••••••••••••••••••••••••••••••••••••••••••••••• '" J:T cmd to DSID Al cmd to DBID J:T cmd to DSID
017529 017530 011531
tT cmd to DSID
017532
Al cmd to DBID IU cmd to DSID B1 cmd to DBID
011533
017534 017534
A6
~
~,
~
18 RSP
~
~, ~,
18 RSP 14 RSP 14 RSP
-POOL
.W>oodo . W>oodo .W>oodo .W>oodo • W>oodo .~
.~
, ,,• u. , ".
.
". "
m
'"
237158
237186
••••••••••••••••••••••••••••••••••••••••••••••••••••• ••••••••••••••••••••••••••••••••••••••••••••••••••••• 011534 RPL - POOL LRPL- 157286400 149875480 ( 95 ' ) ••••••••••••••••••••••••••••••••••••••••••••••••••••• PNR/RSP/CNT: PNR/R$i'/CN'l':
PNR/RSP/CNT: PNR!RSP/CNT:
PNR/RSP/CNT: PNR!RSP/CNT:
PNR/RSP/CNT:
Figure 171:
, "" '" '" "" '" n '" "" '" "• 254 4
113 4
254 4
Output of Natural Parse Program
EJESLNK and the parse program can be used to check DDPRINT of the source database and the Replicator Engine.
7.2.7
Target Check - Ping
The following job is scheduled to run every hour to check whether the target database, Adabas on Windows, is reachable and the files are available. A Natural program reads one record of one file on the target database and set based on the Adabas response codes a condition code for the batch job. See Natural program in appendix chapter 9.5.1, ring Target Database.
7.2 Self-Written
IlpINQ JOB I I *!GIN
143
(ST345T, ST01, ST) ,DBA,MSGCLASS-l, TIMI!:_NOLIMJ:T Now-NO, SISTEM-SI5, CLASS-plO ,USl!:R-DIB'l'ZR PR,DONAMZa,FORM.Sa41, 1'CBaA8 ,CIIARS-G125
I/*!'ORNAT 11** --------------------------------------------------------------- **
I/u SCHEDULEtI I'OR OAILY EVl!RY HOUR -- DI!;TI!R.PJLSRVCIU!Ck (TEMP 0"')"
11**
I/u CHZCX WlU!TIU!R TAlUZT OB IS UP
AN!)
.*
RUNNING - SEND EMAIL
Ilu
I/u ,An
Ilu I/u 2010/12/06 /lH 2010/11109
I/u 2010/11/02
Ilu 2009/12/01 /lu
OSTORR DSTORR OSTORR DSTORR
PREPAREl) I'OR SY5 II:l.IMlNATED SRP EMAILl WITN ROooO CIU!CIt DATJlBASB AN!) MESSAGE DATAS1!T, EI' l!!VEN'l' CRKA'l'BD
11** -------------------------------------------------------------IIPJLCHECIt I!!XI!!C NA'l'BT , DEPT-ST ,Da-DEVL, PRM- ' IM-!) ,AUTOooON' IISYSOUT DD SISOUT-*
IICMPRINT II /I
OD DISP-(,CATLG) ,DSNaDIE'l'ZR.DB251CH!t, UCnc-FB, LRl:CL-120 ,BLll.SIZE_ O, UNIT-KISCOA, SPACB_('l'PJt, (10 ,50) ,RLSB) IICMSININ DD * LOGON DIETBR DWSRDUR 251 ".
1/** ------------------- - --------- - ---
II
11' ROooO TIU!N
1/*** --------------------------------Ill!:HII.ILl I!!XI!!C PGHooIlW1:rr01,RBGIotl_40961t,D~50 I/SYSTSIN
OD *
SM'l'PNO'l'II: TO([email protected])
SUBJEC'l'(PJL: OESTINATION DATAAIlSE 251 DATASET (' DIB'l'J!P.. DB251CHll') I/SYSPROC OD DSN_SIS2.CLIST,DISP-SHR IISTSTSPRT DD SISOUT-* I/ ENOII'
-
AN!)
NETWORlt IS UP)
BATeH -
11** --------------------------------11 11' RC GT 11 THEN 11** --------------------------------III!:HII.IL2 I!!XI!!C PGHooIIUIl"01,RBGlotl.4096K,0~50 IlsISTSIN
DD * SM'l'PNO'1'I!! TO(DSTORR@STORRCONSULTING COM)
DBSTINATION DATABASB 251 Oll. NETWOJUI< IS DOWN) BAT(:H DATAS1!T ('DIBTBR.DB251CHIt ' ) IISISP!I.OC DD DSN_ SIS2.CLIST,DISP-SHR IlsYSTSPRT DD SISOUT-* 11 ENDII' s=cr(RPL:
11* * ---------------------------------
I/DELI!TI!! EUC PGHoolEFBR14 /lDDl DD DISP-(OLD , DELI!TI!!) , DSN-DIETBR DB251CH!t
/I
Figure 172:
WCP, Network and Target OB Check - PING - OCl)
..•••• ..•• •• ..••••
144
7.2.8
7 Monitors
Destination Report
The following job submits SYSAOS in batch and creates areport, which will be parsed by a Natural program. 000001 I/STDBSl02 JOB (STl4ST,STOl,ST) ,DBA,HSGCLASS_l, 000002 11 000003 //*HI'oIN 000004 I'*I'ORNAT
NOT l n_,SISUID, TINZooNOLDaT , TlPRUN_SCJIN KOLD-NO,SrSTDPSl7 ,~S.i'10,USBR-DIBTER PR,DD~.I'ORMS •• l,1'CBaA8,CHARS-C125
1/*-----------------------------------------------------------------0
000005 000006 // * a.p11cator Subacript10n Check - DIBTER.CNTL(DBST302 ) 000007 //* ADA9 1 3
//*-----------------------------------------------------------------* //*-----------------------------------------------------------------* /IIlBLBT:E EXEC PGMoo I DCAMS
000008 000009 //* !)elat. dat ••• t. t.,0111 prior r»n 0000 1 0 000011 0000 1 2 000013 000014 000015 0000 1 6 0000 1 7 000018 0000 1 9 000020 000021 000022 000023 000024 000025 000026 000027 000028 000029 000030 000031 000032 000033 000034 000035 000036 000037 000038 000039 000040 000041 000042 000043 000044 000045 000046
//SISPRINT
DD SfSOUT-* DD * DELBTZ DIETZP. . DEST302
Ils!Sl:N
PURGIl
--------------* --------------*
11*--------------------------------------------------11* Cr.at. SUBS report by uaing SfSAOS 1 Rap1ication Maint.nanc. ---. 11*--------------------------------------------------IIRPLSTATl EXEC PGMooNATBATCH ,R&GION_OM,
11
PARM-'PARM-SfPROD,SfS _ STR$f7,~N,~,ST~(LOQON
IISTIIPLIB
11 11 II DDCARD IICHPR I NT 11 IICMSYNIN 0,302 X ,. D
DD DD DD DD DD
DISP-SHR,DSN-ADABAS.ALIl\.S. SIPROD. LOADLIB Dl:$P-SHR,DSN-JWABA$ . ALIA.$.SIPROD.PQa.IB DISP-SHR,DSN-ADABAS.ALIl\.S.SfPROD.PARMLIB DISP-SHR,DSN-JWABA$ . CON'l'ROL . CARD(TESTf) DSN-oIETZP..DEST302, DISP- (, Cl\.T!.G) ,SPACK- (TlUt, (10,10) ,RLSE)
Sf$AOS;MENU)' ADABAS NA'rURAL NATPAPll!
DD
,, "IN
11
Figure 173:
SYSAOS Batch - Display Reptor Statistics - Destinations aCL)
7.2 Self-Written
15:35:20 Raplicator o..tN.....
--------
D251018 D251035 D251035 D251035 D251035 D251144 D251158 D251167 D251168 D2512451 D251227 D251228 D2512251 D251230 D251231 D251232 D2512451
Figure 174:
_._._. _._._. . _._._ _. -. -. '"
"..
145
••••• A D A B A S
2010-10-14 PRPTS04
SERVICES . . . . .
Total raplicatad tran.action.
,
.b. .
Total pandinq trana
'"
2,098
""
3,0511 5,764 5,954 4,000
,, ,,
2,000 2,000 2,000 2,000 2,000 2,000
,
.b. .
SYSAOS Batch - Display Reptor Statistics - Destinations - Output
U:53:06 Rap1icator 302
..... A D A B A S
BASIC
SERVICES' . . . .
- Sa 1a"t.d o.U:ination Stati. ti" . -
D251035 Sa1act.d Da.t Type AcIaba. Total rap1icatad tran.a"tion. Total pandin'1 tran.action. Total me •• aga. .ant Total comm.it • . , •.. Sloq loqgad count Sloq deloqqed count Itema tor de.tination on .1og . :Itema to delata tram .1og Byt.• •a nt to dea tin.tion Pandinq byta. tor de. tination Pa nding me •• aga. Numl:>ar ot BT ' . . ........ . . NUlllbar ot BT ' .
Figure 175:
BASIC
- Da.tination Statiatic. -
2010-10-U PRPTS04
T~ tran comm.ittad 1,062 2010/10/14 14 : 51:16 1,592
,
,,, ,, ,,,
o T~ Of la . t ET 1,062 2010/10/14 15:03:251
SYSAOS Batch - Select one Destination - Output
7 Monitors
146
7.2.9
Subscription Report
The following job submits SYSAOS in batch and creates areport, which will be parsed by a Natural program. 000001 I/STSUBl02 JOB (STl4ST,STOl,ST) ,DBA,HSGCLASS_l, 000002 11 000003 //*HI'oIN 000004 I'*I'ORNAT
NOTln_,SISUID, TINZooNOLDaT , TlPRUN_SCJIN KOLD-NO,SrSTDPSl7 ,~S.i'10,USI!:R-STADBA PR,DD~.I'ORMS •• l,1'CBaA8,CHARS-C125
1/*-----------------------------------------------------------------0
000005 000006 //* bp11c:ator Sub.""ipt1on Check - DIETER.CNTL(SUBS302) 000007 //* ADA9 1 3
//*-----------------------------------------------------------------* //*-----------------------------------------------------------------* /IIlELBT:E EXEC PGMoo I DCAMS
000008 000009 //* !)elat. dat ••• t. t"0111 prior r»n 0000 1 0 000011 0000 1 2 //SISPRINT
DD SfSOUT-* DD * DELBTZ DIETZP. . S08S302
000013 Ils!Sl:N 000014
PURGIl
--------------* --------------*
000015 11*--------------------------------------------------0000 16 11* Cr.ate S08S report by uaing SfSAOS 1 Rap1ication Maintenanc. ---. 0000 17 11*--------------------------------------------------000018 IIRPLSTATl EXEC PGMooNATBATCH , R&GION_OM ,
0000 19 11
PARM-'PARM-SfPROD ,SfS_ STR$f7,~N,~,ST~(LOQON
000020 IISTIIPLIB
000021 11 000022 11 000023 II DDCARD
000024 IICMPRI NT
000025 11 000026 000027 000028 000029 000030 000031 000032 000033 000034 000035 000036 000037 000038 000039 000040 000041 000042 000043 000044 000045
IICMSYNIN 0,302 X ,.
DD DD DD DD DD
OISP-SHR,DSN-ADABAS.ALIl\.S. SIPROD. LOADLIB Ol:$P-SHR,DSN-JWABA$ . ALIA.$.SIPROD.PQa.IB OISP-SHR,DSN-ADABAS.ALIl\.S.SfPROD.PARMLIB DISP-SHR,DSN-JWABA$ . CON'l'ROL . CARD(TESTf) OSN-tlIETZP.. S08S302, DISP- (, Cl\.T!.G) ,SPACK- (TlUt, (10,10) ,RLSE)
Sf$AOS;KENU)' l\DABAS NA'rURAL NATPAPll!
DD
Po
,, "IN
000046 11
Figure 176:
SYSAOS Batch - Display Reptor Statistics- Subscriptions QCL)
7.2 Self-Written
1<1:15:38 R.plicator 302 Hark
147
••••• A
Subscription
D A B A S BASIC SERVICES . . . . . Sub.cription Stati.tic.
2010-11-08 PRPTS04
Total noplicatad transaction.
N_
S0391<14 S039145 S039146 S039147 S039148 S039149 S039150 S039151 S039152 S039153 S039158 S039159 S039160 S039162
Figure 177:
2,126
S.l..,t detail intormation by . .rkin~ with 'S'
SYSAOS Satch - Display Reptor Statistics - Subscriptions - Output
1<1:15:38 R.plicator 302
A S BASIC SZRVI(:ES . . . . . S.l.cted Subscription Statistics -
2010-11-08
..... A D A B
PRPTSO
S.l.cted Subscription N_ : S039144 Total replicatad transactions Total CS data . . . . . . . . . . . . Initial-.tat. cooopl.ted . . . . . . . . . . . . . In i t ial- s ta t . data Us.r transactions U1'I f'unetion .. Lost data count DBID . ..
ril.
Numbar Number Nuabar Number
Pr. s .
,, ,
2,126
"
,,
2,126
HO
of' of' of' of'
delatas initial state in •• rts updat ••
200,000
'Enter' to continu.
Figure 178:
,,
SYSAOS Satch - Selecl one Subscription - Output
'"
148
7 Monitors
7.2.10 RPL Flag Check in ADAREP It is very awkward to scan manually an Adabas report with 200 files and check
for the value of the RPL flags and whether before images are collected. The fo llowing job submits an Adabas Report in batch with NOFDT and NOSTD to get the inactive and active RPL fl ags per file. The Natural program DWSRPLRP parses the output and send a compressed report the Adabas DBA group. See the parse program DWSRPLRP at the appendix, chapter 9.5.8. 000001 IIsTREP039 JOB (ST345P , ST01, STLXF, 6230T) ,229-4945, 000002 I I M$GCLA.SS_ 2,NOTZn:_ -'$TSUID, 000003 /1 ** RBSTART-RPLRBP . N 000004 I I RESTART-DELETEl 000005 II*HI'oIN SlSTDPSl7, CLASs-l'10, USU-STADBA, LIMBS_9999 000006 II *PORNAT PR ,DDNANZ_,D E S~2.RT185,roRMS_S5 11 ,CARR~_LDS 000007 II *PORNAT PR ,DDNAME_,CRARS_ST15 OOOOOS 11* ---------- - --- - ------ - --------------------- - -----------------000009 11* DBLETB 1 000010 11* ---------- - ---------- - --------------------- - -----------------000011 IIDELETEI EZEC PGM-ZBrBR14 000012 / lDDl DD DSN-DIETZR.ADAREP311, 000013 II DISPw(MOP,DELETE) , 000014 /I SPACE-(TRJt, (1 ,1) ,RLSE)
11* -------------------------------------------------------------/1 * ADABA.S RllPOlI.T VB - DIETBR.CNTL(ADARBPV8) 11* -------------------------------------------------------------IIRBP039 EXEC ADAUS RM ,DB-STST9 , UTILITTooJIDAREP ,~, VER-VSl 00001Sl II DDTBMPRl DD DlJltiY 000020 IIDDSORTRl DD DU)I('! 000015 000016 000017 000018
000021 IlsTl . DDPRINT DD DlJltiY
000022 /lST1 .DDDRUCIt DD DISP- (,CATLG) , SPACE_ (TRJt , (1 00, 10) ,RLSE ) , 000023 II DSN_DIBTZR.ADARBP311 000024 IlsTSIN DD * 000025
ADARBi' REi'ORT
000026 ADAREP NOfDT,NOSTD 000027 11* -------------------------------------------------------------00002S 11* DELETB 0000211 11* ---------- - -------------- - ------ - ---------- - -----------------000030 IIDELETE2 EXEC PGM-ZErBR14 000031 /lDDl DD DSN-DIETZR.RPLRZP, 000032 II DZSP-(MOP,DELKTE) , 000033 /I SPACEa(TRJt, (1 , 1) ,RLSE)
000034 11* -------------------------------------------------------------000035 11* CHECX DB I'OR lNACTIVI! AND ACTIVI! RPL rLAGS PER rIIJ! 000036 11* -------------------------------------------------------------000037 IIRPLRBP EXEC KATBT ,DEPT-ST ,DB-oEVL, SlSQUT_*, TlME_ l00 , 000039 II PRM- '~,MADIo_O ,MAXC ~0 , MT-0,LTWSl9S1S199 , ~N ' 0000311 II$YSOUT DD SlSQUToo* 00004011**CMWltFOl DD DISPwSHR,DSNw* . RBi'03S1,ST1 . DDDRUCK 000041 IICMWltFOl DD DISP-SHR ,DSN-DIBTER.ADARBU9 000042 IICMWltF02 DD SISOUT-* 000043 /lCMPRTOl DD DISP- {, CATLG ) ,DSN-D IETER . RPLRBP , 000044 II RBCnl-FBA,LRECL-OS1,BLKSIZE_0,UNI~SCDA, 000045 /I SPACE_(TRJt, (l 0, 5 0) ,RLSB) 000046 IlsTSIN
DD *
000047 LOGON DIETER 000048 DWSRi'LRP FIN
000049 000050 00005 1 000052 000053
11** -------------------------------------------------/1 ** ADD TIlZ DATE TO TIß! DATASETS AND PTP - ' I OF 2 11* * --------- - ---------- - ---------- - -----------------II I r Re _ 0 THEN
7.2 Self-W ritten
000054 000055 000056 000057 000058 0000 5 9 000060 000061 000062 00006)
000064
000065 000066 000067
000068 000069 000070 000071 000072
149
IiDATEUPP1 EXBC NATaT,OKPTWST,Oa-OEVL,SYSOUTW1,TINK_100,
I!
' IN-O, MIIOIo-O ,HJ\XCL-O ,M'J'aO , LT-999999 ,Al1'rQooON' SYSOI.IT-* 01) SYSOI.IT-* 00 DI8P-SHR,OSN-DIKT&R , CNTL(FTPLOG08) FOT STMT _
IlsySOUT
I/CMPRINT
110IIfItF(l1
01)
IISYSIN 00' LOGON DIKTER COWPI0DT DIBTIIR.J\DAlU!P)9 ADJlRBP J\DAlU!P)9_FILB_RPL_ DATE I':IN IIrTP1 BXBC PGlPrTP,RBGION-4M,PARM-' (TIICBOUT 100 TRACI! BX:IT' Ii000PUT 01) SYSOI.IT-* IISYSPRINT 00 SYSOI.IT-* IISYS'l'Cl'O 01) DISP-SHR,OSN_SYSl. TCPIP. PARMLIB ('l'Cl'OATA) IISYSFTl'O 00 DISP-SHR,OSN-SYSl . TCPIP. PARMLIB (CFTPDATA) IIINPUT DO DIS P-SHR,OSN-DIKT&R.CNTL(rrpLOG
1111 .* -------------------------------------------------11 -* ADD TBB DATE TO TU DATASBTS AN1l FTP - '2 01' 2 1/ .* --------------------- - ------ - --- - --- - -- - --- - --- - --
000073 IiDATIIUl'02 BXBC NATaT, OBPTWST ,Oa-DEVL, SYSOUTWl, TINK_I00, _ ' IMooD,MIIOIo-O ,HAXCI.-O ,M'J'a0, LT-999n9 ,AU'J'OooON' 00 SYSOI.IT-* 000076 I/CMPRINT DO SYSOI.IT-* 000077 110IIfItF(l1 DD DI SP-SHR,OSN-DIBT&R , CN'I'L(FTPLOG09) FOT S'l'M'l'S 00007S I/SYSIN DO * 000079 LOGON DlETIIR 000080 COWPI0DT DIBTER.RPLlU!P J\DAlU!P RPLRBP)9_FILB_ DATE 000091 I':IN 000092 IIrTP2 BXBC PGlPrTP , RBGION_4M,PARM-' (TlMl!:OUT 100 TRACI! BXlT' 000093 Ii000PUT 00 SYSOI.IT-* 000094 IISYSPRINT DO SYSOI.IT-* 000095 IISYS'l'Cl'O 00 DlS P-SHR,OSN_ SYS1 . TCPIP , PARMLIB('l'Cl'OATA) 000096 IISYSrTl'O DO DISP-SHR , OSN-SYSl . TCPlP. PARMLIB (CrTPDATA) 000097 IIINPUT DO DlSP-SHR,OSN-DIBT&R.CNTL(rrpLOG09)
000074 I/ 000075 IISYSOUT
000099 000099 000090 000091
11 * ------------ - ---------- - -------- - - - ---------- - -------- - - - ---11. BMAlL THB RPL STATUS REPORT *. 11* ------------------------------------------------------------IISUCCBS$ &EEC PGM-I~rrOl,REG:ION_ 4096~,0~50
000092 IISYSTS IN DO * 000093 SHrPNOTE TO(DSTOlUt@S'r(IRRCONSULTlNG . CCK) 000094 SUBJBCT(Osn : RPL STATUS REPORT) BAYeR 000095 OATASBT ( ' DlBTER . RPLRBP') 000096 SM'l'PNOTE TO(LFPAZ IN@CALSTRS . COM) 000097 SUBJBCT(OB39 : RPL S TATUS REPORT ) BAYeR 000099 OATASET ( ' DI ETBR . RPLRBP') 000099 I/SYSPRQC CD DSN_SYS2. CLIST ,DISP-SHR 000100 IISYSTSPRT 01) SYSOI.IT-* 000101 I/ END:II'
000 102 11 00010) I/DELI
000104 IIDEL2 000105 11
Figure 179:
CD DISP-(OLD , DELBTE) , DSN-DIETER . J\DAlU!P)9 00 DI SP-(OLD,DELBTII) ,DSN-DIKTIIR . RPLRBP
Check RPl Flag QCl)
7 Monitors
150
Output of ADAREP DDDRUCK - NOFDT,NOSTD output: of ADARZP DDDRUCJt - NOPDT. NOSTO ( . nip)
••••••••• ** ••••••••• ** •••••••••••
• • .................................• ,
(ST-ADA-CALC-EIlAT)
m
TOP-l:!,N
.,
MlU[-ISN Expect..:i ~"orc:b
1,2'1
m
Lo . . . .
MIN-ISN N~r
MIU[
ol!
Upda ~ .
,, ,
COMP RZC LEN
-~
BLlt/ADD
-~,
""' '" ., '"
5 , 060
~
ADAM I'il, CipMr""" 1'11. ISN Reu •• q .
Spa"'" Rau.ag'" Couplad Fil • • I!xp .... d..:1 1'11. USBJUSN NOACEXTENSION MIZDSDEV PGHRIIFRlSH
M\llti Clia nt: r i l.
Privilega d U"g' Orüina INVERT
Index Ca.pr••• ..:i Spanna d Re" $upp Toto Byte HU/lI!:
High •• t lnd40x t..-... 1 Paddin9 F • .,tor ASSO Paddinq r.ctor DATA Le"9th 01' eHent NR ISNSltl!:
... ......
,o.U o.u
,'-
,
"., '",
2()O1-10-20
~
12 : 11:32
of' l • • t
. _U
ol! l.at . _U
...• ••
Non.
No No No No No No No None
...
Fila 1a r~li". t. d : Replicator tarqat 10 Col l • .,t boto". image. of updat. .
13:5i : 15
~
No No
NO No LOB fU . NO Contain LOB ti. leb No RPLUPDATI!ONL! No
Figure 180:
2010-03-0~
...'"
Adabas Report RPL Flag Check - (Output)
lOIO-Ol-09
12:03:48
7.2 Self-W ritten
151
Output of parse program DWSRPLRP with RPL f1ag and OSBI status 2010-03 - 09 14,15,36 DWSRPLRP ~., A 0 All .. I' ~ ilPL &TAt'US
~ ~
... ,• ", ."U ."ti ... '" m • ."u ... '" HO
• "
", ."U... m a"ti. ...
u
m
U U
."U...
HO HO a.,U ...
a"ti. ...
U HO (anip)
m
'" '" '" '" m m m
m
."U... a"ti_
."ti...
HO HO .cti ....
m
a"ti_
00 00 00
00 00 00 00 (ani.p)
u. 'U u,
01. 01. 01. 01. 01. 01. 01.
Figure 181:
'" '" '"'" '" '"'" '" '" '" '"
D8U> a 00039 0881
sU>rt4od
~ ~ ~
~ ~ ~ ~ ~ ~ ~
~ ~ ~
RPL Flag Check Report - (Output))
7.2.11 Analyze WCP Log The program RDWCPLOC (ReaD wcr Log) counts the number of Adabas commands per second in the Entire Net-Work log of the dient side.
._. ~.
,
.•.- ...
C&1h
.."" ... .."""" .." .." ......"" " , " '" '" m '" '" '" '"on '" '"
~u,
1022 1100 1179 12S. 1322 137. US. 1531 1615
~
n n
"
Figure 182:
15:53 ,09. 15 , 53, U. m ,11 .005 U ,12. U u 53, U. 00' ,14 .OOS U ,15. 00' U U 53, 00' ,n .OOS U ,18. 005 u 1$ ' 53' 00' 15,S3 ,20. 15 , 53 ,21 .005 15 ' 53 ,22 .005 15 :S3 ,23. 15 , 53 ,24 .005 IS :S3 ,2S . 00. 15 :53 ,26. 00' 15 , 53 ,21 .005 IS :S3 ,28 . OOS 15 :53 ,29. 00' 15 , 5), 00'
." ." ."' ." ." ." ". ."
". ."'
."
".
ba1660 ba1560 ba1SI0 ba1160 'b5abO 'bSabO 'b58bO 'b59bO ba1160 ba1560 ba1560 ba1160 ba1560 ba1560 4l>!i8bO 'b59bO 4bSabO ba1560 'b5abO 'bSabO ba1560 'b58bO
~. ~.
~. ~. ~.
~. ~. ~.
~. ~. ~. ~. ~. ~. ~. ~.
.
~. ~. ~. ~
~. ~.
Analyze WCP Log
,n, -,n, ,n, -,n, ,n, -,n, ,n, -,n, ,n, -,n, ,n, -,n, ,n, ,n, ,n, -,n, ,n, -,n, ,n, ,n, ,n, ,n, -
......... ...... ...... ...... ............ ......... ......... '" '"
10-09-13
~
~
--_u _u _u _u _u -_u _u _u _u _u _u
_U
~
_u _u
~
_U
~
~ ~
~ ~ ~
~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~
~
_U _U _U _U _U
_U
_ U
...... ...... ...... ...... ...... ......... ......... '" '" '" '" '"
'"
~
~ ~ ~
~ ~ ~
~ ~ ~
~ ~
n,23,U
"all
".11 .,.11 "all ".11 "all "all _U "all "all _U "all
~
".11 _U
~
"all
~
~ ~ ~ ~ ~ ~
~
".11 ".11
"all
".11 ".11
"all
".11
----------------
7 Monitors
152
Using a self-written Natural program, you can parse through the wer log and count the Adabas calls per second. YOll can also use a text editor for Windows with search capabilities, such as display number of lines with ' New ADABAS call New ADABAS call ='. A selection function by columns (from/ta) is beneficiary to search a command log size of 200 MB and more.
7.2.12 De1ermine Highesl ISN Currenl ly Used The program ISNHIGH reads fiJes of a database and reports the highest ISN currently used. The Natural program is described at chapter 4.3, Compare Files of Source and Target OB, and is located at appendix, chapter 9.5.10.
7.2.13 Compare File Componenls After Replicalion The following job creates an Adabas report on the mainframe with NOFDT and NOSTD and FTP it to a Windows server. The Adabas on Windows report is created and saved directly to the Windows server to be compared. IIsTREP039 JOB .
11 MSGCLASS_2 ,NOTlrr_'SYSUIO, TIMII_1UO 11* . 11* -------------------------------------------------------------11* OELETE 1 11* -------------------------------------------------------------IIDEUTEl !:XI!C PGIoPIEI'BR14
/1001
/I /I
OD
OSN-ST.AOAOBA.AOAREP39, OISP-(HOO,DELETE), SPACE-(TiUt, (1,1) ,RLSE)
11* -------------------------------------------------------------/1*
ADABAS REPORT VB - DIETER.CNTL(AOARI'039)
11* ------ ----------- ----------------------- ---------------------IIRZP039
BXZC AOAUSRM,0S-STST9 , UTILITY~P , QUAL-MPM, VBR-v81 II00TBHPRl OD omea II00sORTRl 00 omea /lSTl . DOPltINT 00 omea IIST1 . ODOR!}(:!\. DO OIS P- (,CATLG) ,SPACE- (TJt:K, (1000,10) ,RLSE) , 11 OSN-DIBTER.AOAREP39 IISYSIN 00 * ADAP.&P RZPORY AOAREP NOftlT, NOSTD
11* -------------------------------------------------------------/1 * rrp TO THE Z-ORIVlI:
11* -------------------------------------------------------------/lnPl
!:XI!C PCMooI'TP,RZGI0Na4N,PARM-' (TINEOUT 100 TRACB EXIT' 00 SYSOUT-* IISYSPRINT 00 SYSOUr-* IISYSTCPD 00 OIS_SHR,OSN_ SYS1. TCPIP . PARNLIS (TCPDATA) IlsysrrPD 00 OIS_SHR,0SN-SYS1. TCPIP . PARNLIS (crrPDATA) IlrrPINl 00 OIS_SHR,OSN-oIETER.AOARI!.P39 IIINPUT 00 OISP-SHR,OSN-OIETBR.CCAROS (I'TPLOOON) /I 00 *
II000PUT
.scii
~~,
pgt /loo:rrPINl
ADAP.&P39_FILE_RPL . 20110127 txt
~" "0" 11
Figure 183:
Create and FTPanAdabas Reporttoa Windows Server
7.3 Optimize for Infrastructure (041)
153
The program RPL-P002 reads both Adabas reports and creates a list with TOPISN, Records Loaded, and MAXISN of both source (DB039) and target (DB251) databases. See the Natural program at appendix, chapter 9.5.13. FILa-NR
000006 000007 000008 000009 000010 000011 000012 000013 000014 000015 000016
TOPISN 039 TOPISN 251 RBCLOD 039 RBCLOD 251
~ISN
039
~ISN
251
---------- ---------- ---------- ---------- ------------------1 ,271 1,279
'"
.
195,637 1 ,098,767
,"
'"
195,637 1,098 ,767
"."
25,665,942 25,665,942 250,289 250,289
,
6,004,159 2,439,377 3,887
Figure 184:
,
6,004,159 2,439,377 3,887
'" ,"
.
195,635 1,098,767
'"
.
95,635 1,098,767
1,000,427 196 ,095 1,251,011 1,114,879 1,271 2,047 3,815 25,191,478 25,191,478 30,000,119 25,673,727 249,229 249,229 1,000,427 257,279 8,191 6,003,833 6,003,833 8,000,243 6,004,735 2,439,314 2,439,314 6,000,023 2,4 41,215 3,673 3,672 5,087 8,191
,
,"
,
'"
'"
Create Adabas Report and FTPtoa Windows Server
The report shows differences in highest ISN (TOPISN), records loaded (RECLOD) and the maximum set ISNs (MAXISN). One record of fil e 16 received RSP 113 and was therefore not replicated, as pointed out in Reptor's log dataset DDPRINT.
7.3
Optimize tor Intrastructure (041)
7.3.1
General
Currently, companies have to write or purchase several monitor programs to gather statistical data to evaluate the performance of Software AG products. They use this data to improve their processes. To make this more effident, Software AG and other vendors offer single monitor software on the mainframe such as Review, Adabas Statistic Fadlity, Adabas Online System, Adabas Event Replicator Subsystem, Apas/Insight, System Management Hub, and Trim. Some customers find it very awkward to get performance data f,om a green screen on the mainframe and then switch over to the PC for additional information on Windows-based Software AG products. For example, if you monitor Event Replication for Adabas on the mainframe, you must dose the Adabas Event Replicator Subsystem screen and open the Adabas Online System screen to get additional information for the same product.
154
7 Monitors
Ln 2009 Software AG introduced their ' new tool' Optimize for Infrastructure: the Mainframe Edition. For many years, webMethods u sed their Business Activity Monitoring (BAM) tool, which includes Optimize for Process, Optimize for SAP, and Optimize for 828. After the merge, Software AG updated and improved the existing Optimize product for monitoring their enterprise products in real time. This tool is UNIX or Windows-hased and collects data from Software AG's produets such as Adabas, EntireX, Event Replicator for Adabas, Adahas Delta Save, Natural, Entire Net-Work and A dabas Fastpath. The benefit of this solution enables yOll to observe yOUf performance data from a single weh-hased dashboard using YOUf favorite Web browser.
The Software AG products Adabas, Event Replicator for Adabas, Com-plete, Entire Net-Work, Natural, Entire System Server, ApplinX and EntireX are already equipped with ' hooks' to get performance data if the latest versions are installed. Ln some cases, small system modifications (ZAPs) are necessary. One or more special Natural RPC servers on the mainframe are necessary to get the data horn the above-mentioned products through EntireX Broker (webMethods server) to a JMS Queue and on to the Analytic Engine for interpretation and application for KPI rules. The Analytic Engine stores the data into a relational database. For example, a batch Natural RPC server monitors all global Natural components: a CICS Natural RPC server monitors all global Natural components: a CICS Natu ral RPC server monitors in general only local environment-specific Natural components. If EntireX Broker is not available on one of the rnonitored platforms, the EntireX Broker stubs (EntireX Mini Runtirne) must be installed.
Figure 185:
Analyze wer Log (Sourre: SAG)
7.3 Optimize for Infrastructure (041)
155
Optimize for lnfrastructure comes with over 600 predefined Key Performance Indicators (KPIs), which can be selected and activated to collect the data you want to monitor and analyze. You can also create rules, send predefined alerts or start activities by using Web services. ln addition to the data collection, Optimize implementation performs other main functions such as data communication, data processing and analysis, data storage and data presentation . Optimize for lnfrastructure uses the following parameters to monitor Adabas Event Replicator: Dimensions, KPls and Built-in Rules.
7.3.2
Dimensions
AdminIstratIon Name
Olsplayed Value
Host
The name of the host.
Product
The product component name "Adabas Event Replicator".
AdabasEventRep
The 10 and name of the Event Replicator server.
7.3.3
KPls 01 Event Map AdabasEventRep
AdminIstratIon Name
KPI Name
Umt
Type
DescnptlOn
RepBytesSentTotal
Bytes Sent Total
count
delta
The total number of bytes sent in the messages.
RepFreeSl OGAssoSpace SlOG - ASSO Free Blocks
percent last vatue
Free space on ASSO for SlOG entries.
RepFreeSl OGDataSpace SlOG - OATA Free Blocks
percent last vatue
Free space on OATA for SlOG entries.
RepHWMRepPool
percent last High-Water Mari
The high-water mar1< of the Replication Pool (RPl).
RepMessagesTotal
Replicated Messages Total
count
delta
The number of replicated messages.
RepPendTransactionsTotal
Pending Transactions Total
count
last value
The number of pending transactioos.
RepSlOGEnlriesTotal
SlOG - Number of Entries
count
last value
The total number of enlries in the SLOG file.
RepState
Replicator - State
state
state
The state of the Event Replicator (oolineloffiine). This KPI is automatically monitored .
RepTransactionsTotal
Replicated Transactions Total
count
delta
The number of repl icated transactions.
156
7.3.4
7 Monitors
Built-In Rules
Administration Name
Expression
Adabas Event Replicator Not Active
Adabas.RepState
Adabas Event Replicator Sl OG ASSO Full
Ada2 - High bas.RepFreeSLOGAssoSpace < 10
Less than 10% of the SLOG ASSO space is free.
Adabas Event Replicator Sl OG DATA Full
Adabas.RepFreeSLOGDataSpace < 10
Less than 10% of the SLOG DATA space is free.
7,3,5
=0
Seventy
Descrlptlon
2 - High
The Event Replicator is not active.
2 - High
Dimensions - Destination
Administration Name
Dlsplayed Value
Host
The name of the host.
Product
The product component name "Adabas Event Replicator" .
AdabasEventRep
The 10 and name of the Event Replicator server.
AdabasEventRepDest
The Event Replicator destination.
7.3.6
KPls 01 Event Map AdabasEventRepDest
Administration Name
KPI Name
Unlt
Type
Descnptlon
RepDestBytesSent
Bytes Sent
count
delta
The number of bytes sanI.
RepDestCommands Committed
Commands Committed
count
delta
The number of commands committed.
RepDestCommands Pending
Commands Pending
count
last value
The number of commands pending.
RepDestLatency
Latency Time of Last Transaction
last value
Latency time of last transaction. This value is only avail able for Adabas destinations.
RepDestMessagesSent
Messages Sent
count
delta
The number of messages sent.
RepDestPendingTransaclions
Pending Transactions
count
last value
The number of pending transactions.
RepDestReplicated Transactions
Repl icated Transactions
count
delta
The number of replicated transactions.
RepDestSlogDelog
SLOG - Oelogged Count
count
delta
SLOG delogged count.
RepDestSlogEntries
SLOG - Number of count Entries
last value
Number of SLOG entries for this destination.
m,
7.3 Optimize fo r Infrastructure (041)
157
AdminIstratIon Name
KPI Name
Umt
Type
Oescnptlon
RepOestSlogLog
Sl OG - Logged Count
count
delta
Sl OG logged count.
RepOestState
State of the Event ReplicatOf Oestination
state
state
State of the Event Replicator destination (active or not). This KPI is automatically monitored.
7.3.7
Built·ln Rules - Destination
7.3.8
Dimensions -Input Queue
AdministratIon Name
Dlsplayed Value
Host
The name of the host.
Product
The product component name "Adabas Event Replicator".
AdabasEventRep
The 10 and name of the Event Replicator server.
AdabasEventReplnQueue
The Event Replicator input queue name.
7.3.9
KPls 01 Event Map AdabasEventReplnQueue
AdminIstratIon Name
KPI Name
Umt
Type
Descrlptlon
ReplnQBackouts
Number of Backouts
count
delta
The number of backouts.
ReplnQBytes
Number of Bytes Received
count
delta
The number of bytes received.
ReplnQCommits
Number of Commits count
delta
The number of commits.
ReplnQMessages
Number of Messages
count
delta
The number of messages.
ReplnQPendingBytes
Number of Pending count Bytes
last value
The number of pending bytes.
ReplnQPendingMessages
Number of Pending count Messages
last value
The number of pending messages.
ReplnQState
State of the Event Replicator Input Queue
state
The state of the Event Replicator input queue. This KPI is automatically monitored.
state
7 Monitors
158
7.3.10 Buill-In Rules
7.3.11 Dimensions - Subscription AdministratIOn Name
Displayed Value
Hest
The name of the hest.
ProdUCI
The product component name "Adabas Evenl ReplicaIOf" .
AdabasEventRep
The 10 and name of the Even! Replicator server.
AdabasEventRepSubscr
The Evan! Replicator subscription name.
7.3.12 KPls 01 Event Map AdabasEventRepSubscr Um!
Type
Descnptlon
count
delta
The number of initial-state
Lost Oata Count
count
delta
The number of lost dala.
Replicaled Trans-
count
delta
The number of replicated
Rep5ubRepUlilityFunclions
Utility functions
count
delta
The number of replicated utility functions.
RepSubState
State of the Event Replicator Subscription
state
state
The state of the Event Replicator subscription (active or not). This KPI is automatically monitored.
RepSubUserTransactions
User Transactions
count
delta
The number of replicated user transactions.
Administration Name
KPI Name
RepSublnilialSlaleCompleted Initial-Slate Transactions Completed Rep5ubLOSIOata
RepSubRepTransactions
actions
transactions completed.
transactions.
7.3.13 Built-In Rules
is not active.
7.3 Optimize for Infrastructure (041)
159
7.3.14 How to Monitor a Component After you run the discovery process to ascertain the products running in your environment, select product-instances and KPIs you want to see, you can monitor the KPIs and display details. Figure 186 shows Analytics Overview oE the Adabas Event Replicator and some KPIs of destinations, subscriptions, input queue, etc.
._. __ .. _""'P_. --, .-- .•
•
__ •
__
0-
<;
••
•
-
, Figure 186:
.'-,,, .......... ... ...'-,,' _", ........
.
~,-",
....
.'-",...... .'-,,'
..... _", .....
'-", ..........
~,-",
__._-
..0-
~
Optimize for Infrastructure (041) - Analytics Overview
_.--,--.....
._........ _"""_0-,
.-- .- .
__
,,- .-
.-
e il
SM . . . .
....... ,-_., .......................--~ ......... _ . _-,_.~-,
Figure 187:
:• ••o ~ •o •• •• •~ • •• ••• •
.,-~_
-
Optimize fOT Infrastructure (041) - KPI Subscription User Transaction
160
7 Monitors
._.--, _._.-....
- . ......
--~_.-'
. -- . - . --.._. -_.-
. .. .........,,_............
, ,
'-"
_---_. ...,,_ .-.
• ...._-"...
-_._. --_._. Figure 188:
Optimize for lnfrastructure (041) - Krl Destination Replicated Transactions
I ~"'-""--
_._,-- ......
' _ __0. _'-'00_0-.
. -- . -
....."M._ .. _ .,.."....... ,.....__.__ ..__ ....... ,-.<_.... , -
-
,
!i
-_.- --_.Figure 189:
Optimize for lnfrastructure (041) - Destination Adabas Calls Committed
7.3 Optimize fo r Infrastructure (041)
161
I ~·~"'----~ '-------------------------------------------------------------------'
-
•
..~_. _.
Figure 190:
--_.-
Optimize for Infrastructure (041) - Total Replicated Transactions
.....
8
Security
Databases are designed to provide open and flexible access to data. But this open access makes them vulnerable to malicious activities. Adabas databases on enterprise servers (mainframes) are in general very safe and
has not been reported (as far as I know) that hackers successfully accessed or manipulated this data. However, as database data is available in 10eal or wide area networks (WAN, LAN) and on Web sites, security becomes increasingly impor-
tant. The System Authorization Fadlity (SAF) is used by z/OS and compatible sites to provide rigorous contral of the resources available to a user or group of users. Security packages such as RACF, CA-ACF2, and CA-Top Seeret allow the system administrator to maintain user identification credentials such as User rD and password. SAF establish also profiles determining the datasets, storage volumes, transactions, and reports available to a user. Software AG offers several security products to enhance the effectiveness of the SAF central security repository. Using the SAF repository, the following Software AG products can be secured: Adabas SAF Security protects Adabas Adabas SQL Server SAF Security protects Adabas SQL Server (ESQ) Entire Net-Work SAF Security protects Entire Net-Work version 5.6 and above EntireX Security protects EntireX, Entire Broker, Broker Services - also Natural RPC using Entire Broker. It protects Entire Broker (pre-EntireX) operating in z/OS, UNIX, and Windows environments (the security built into webMethods EntireX now protects EntireX Broker and Broker Services as weil) • Natural SAF Security protects Natural
• • • •
The Entire Security SAF Gateway protects dient/server, peer-to-peer, and standard application systems. The following chapters will show how data from the source to the replicated target can be protected.
8.1
Source Database Adabas
8.1.1
Adabas SAF Security (ADASAF)
Adabas SAF Security (ADASAF) enhances the scope of SAG-based security packages by integrating Adabas resources into the central security repository. D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_8, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
164
8 Serurity
ADASAF enables a single contral and audit system for all resources and industry-standard protection of Adabas data. See also description to SAF in chapter 8, Security introduction.
......
-- -
EnYll'llnment
Figure 191:
8.1.2
Adabas SAF Security (ADASAF) - Source: SAG
Adabas Securi1y (ADASCR)
Adabas Security and the related security utility ADASCR is part of Adahas without additional costs and provides selective user access and update protection at a file, field, and field value level. The documentation is only available on special request at Software AG. The feature 'Value Level Protection' or 'Security by Value' can be an overhead in the system, as tests from customers have proved.
8.1.3
Adabas Da!a Encryption (Ciphering)
Data encryption is an integral feature of Adabas and requires no options or extra modules. It encrypts at this time only the DATA component of Adabas but not the ASSO. An Adabas user exit is available to control the cipher code and protects the file from corruption if data is added with the wrang cipher code.
8.2 Entire Net-Work (wep) Mainframe V6.2.1
8.1.4
165
Adabas Multi·client Files
The feature 'Multi-dient Files' is part of Adabas without additional costs and controls access to records in a file. The owner ID is assigned to a user lD. A user ID can have only one owner ID, but an owner ID can belong to more than one user. Each user can access only the subset of records that is associated with the user's owner ID.
Physical File
Multiple Logical Files
Figure 192:
Adabas Multi-dient File
8.2
Replicator Adabas
8.2.1
Adabas SAF Security (ADASAF)
The Replicator is basically an Adabas nucleus and Adabas SAF Security (ADASAF) is available to protect its resources, as described in chapter 8.1.1. Adabas Security (ADASCR) and data encryption for Reptor's system files inclusively SLOG and TLOG does not make sense and may slow down the replication process.
8.3
Entire Net-Work (WCP) Mainframe V6.2.1
8.3.1
Entire Net·Work SAF Security (NETSAF)
Entire Net-Work SAF Security is aseparate, optional product for z/OS environments and protects EnHre Net-Work (WCP) version 5.6 and above. It allows Entire Net-Work clients to access SAF-secured data sources (targets): for example Adabas, EntireX Communicator, and Entire System Server. See also the descripHon to SAF in chapter 8, Security, introduction and chapter 8.1.1, Adabas SAF Se-
curity (ADASAF) .
166
8.3.2
8 Serurity
Encryption V1 .1.2
Encryption is a Software AG product option that provides support for the Secure Socket Layer (SSL) management that is provided for and installed on both mainframe and open systems.
Oien!
+.
SOL
....
. _...
---
.
~
., •
......
_ _ _ _ 1
CerWIeate • . - - - • - :
Figure 193:
: - - - - • ·1Ioi CertIIkaIII
wep Encryption - Source SAG
8.4
EntireX Broker
8.4.1
EntireX Security
EntireX Security protects EntireX, Entire Broker and Broker Services. See also chapter 8, Security (SAF). lt is available for z/05, UNIX and Windows and installations must be done for the broker kernel and the broker stubs. For more infor· mation see Software AG's documentation webMethods EntireX, Security Solutions in EntireX.
8.5
Network
To secure the network between the host and the dient, the network folks in your organization must be involved. Some organizations use Internet Protocol Security (IPsec) to encrypt safely. It operates in the upper layers of the TCP/IP model and applications do not need to be specifically designed to use IPsec. It is fast because it encrypts on hardware and not on software level. Other security options are Secure Sockets Layer (SSL), Transport Layer Security (TLS) and Secure Shell (SSH). The use of TLS/SSL must be designed into an application to protect the application protocols.
8.6 Natural Security
8.6
Entire Net-Work (WCP) LUW V7.3.4
8.6.1
Encryption V1.1.2
167
Encryption is a Software AG product option that provides support for the Secure Socket Layer (SSL) management that is provided for and installed on both mainframe and Linux, UNIX, Windows (LUW). See Figure 193: wcr Encryption SourceSAG
8.7
Entire Net-Work (WCL) Client V1.3.3
Entire Net·Work 7 also supports communications using Secure Sockets Layer (SSL). This support is provided using SSL protocol target entries in the Software AG Directory Server. The SSL Toolkit is not included on the installation CD and must be separately requested at Software AG.
8.8
Event Replicator Target Adapter
The Event Replicator Target Adapter is used to transform Adabas data to the relational database management system (RDBMS). For security reasons, you must include the company's security group to make sure that sensitive da ta received from EntireX Broker in message queues, for example, is protected.
8.9
Adabas ADASCR on Linux, Unix, Windows
Similar to the mainframe, Adabas Security and the related security utility ADASCR is part of Adabas without additional costs and provides selective user access and update protection at a file, field, and fjeld value level. Performance problems with the featu re 'Security by Value' are not known on the open system Adabas is also using the UNIX group concept and Adabas access can be restricted to only assigned groups ..
168
8 Serurity
8.1 0 NaturalSecurity 8.10.1 NSC Natural Security is available on mainframes, UNIX, OpenVMS and Windows platforms. A full version is normally installed to protect the following Natural components: • • • • • • • •
Users Libraries Links Between Users and Libraries DDMs/Files Utilities Applications Other Object Types Profile Parameters
On those Windows platforms which are not suited to the stand-alone operation of Natural, NSC is instalIed as a runtime-only version.
8.10.2 Natural SAF Security Natural SAF Security is used in conjunction with Natural Security (NSC) and with an SAF-compliant external security system - see introduction to chapter 8. • • • •
Add-on to NSC SAF-compliant (RACF, CA-ACF2, CA Top Secret) SYSSAFOS (d efined in NSC) SAF interfaces: NSFNPAS, NSFNPASZ, NSFNPAX
Using Natural SAF Security, there is no need to define users in Natural Security and in the external security system.
8.11
Non-Adabas on Linux, Unix, Windows
Each relational database management system has its own security. Please contact the relevant database or security administration group in your company for more information.
9
Appendix
9.1
Subscription OB - AOARUN parameters
The user of the followmg parameters has 57 subscriptions spread across 4 LPARs running on 8 separate Replication STes. See also Appendix 9.2, Reptor - ADARUN parameters. ADARUN DBID-205 , DBVICS_3390,SVC-224 ADARUN LP-300000 ADARUN L~2 _ 15000 LBNGTH
• • JlDARUN DSr-n:S • ... PARl'oMBTKRS •
or
W01Ut PlUlT2
. . . . . DELTA SAVZ PARAMETERS
FOR AIlAßAS REPLlCATlON SBRVtCES
~-
LRPl.-200M REPlolCATIONaHS
~~~
RPLSORT_LAST RPWARNI:NCREMEN'l'-5
~
~~~ ~~•
RPWARNINTZRVlU.oo30 P.l'WARNNESSAGELIMlT-1O Rl"iIARNPERCENT-70
LBP-65 OH LDEUQP-5000 L I'J:O_ 60M
ADlUWN NUa2500
ADARUN NB_ lOOOOO
• • •
I«IDIF IC!l.TION
ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN
~~~~~~~~ ~
or
~
LQ-350000 LS_ 61000 LtJ-200000 ~,-
INTNAS_900
ADARUN CTa900
ADARUN T'J'00900 ADARUN 'l'NAA-1800 ADARUN TNAJ:_1800 ADARUN TNAX_I00000 ADARUN NAB-400 ADARUN LCP-2000 ADARUN NSISK-IOl ADARUN PMXIO-6
• • • • •
P'OLLOW
*.*
SORT ALL UPDTES BETWN ETS BI FILE/15N/TRAN SHOW NEIf WARNmG MJ:$SAGE EVERY AT " INCR SEes tIlUUfING WILL BE SUPPRESSBD WIIEN PERSISTENT OWR!'LOW - MAl[ _INGS " 01' RPL Ta START :ISSU:lNG WARlUNGS LZNGTH OF BUFFBP. POOL WJ.S !150M 5 /19/07 LENGTM 01' UNlQUE DZSCRlP'l'OR POOL LKNGTH 01' ASYNC . BUFFER FLUSH POOL - 1oI1lS SOM 5/19/07 ~ 01' USERS WAS 1725 08/18/2007 NUMaJI!R 0 .. HQJ:'S tI7lS 25K 6/2"106
THE J\BO'ß PARMS REQUIRE$
PROGRAM-ADANUC PLOQRQ-YJ:8 OPENRQ-NO UTIONLY-OO NC>SOO N'J'a90 LPP-IM LWP-7000000 LI_ SOOOO
(RBP'lOR)
REPLICl\.TION POOL rCIR NUCLEUS PJ!:PLlCATION SBT Ta TBS POR 'MIIS DATABASB
cr
CACHE $IZE CHANGE
--> --> -->
PLOG8 JUUI: REQUIRED NO OPEN REQUIRED NOT A UTILITI ONLI SBSSION ~ or CQJ:'S WAS 300 8/23/03 ~ OF TRRBADS WAS 105 08/23/03 L1!NGTH OP PI POOL !'ROM 800000 6/21/03 LKNGTH or W01Ul POOL WAS SM 11/22/08 L1!NGTH OF TBI POOL WAS 30'" 11/03/07 NT-WOU DATABASB Ll!NGTH or TBLI!S POOL WAS 260'" - 6/4/05 L1!NGTH OF SORT ARM lOB LBNGTH (MIU) Jlu.D ONLT NUCl.oZUS ISSUZ CltPT ZVBRT 5 MlN .ACS 9/06/03
TIHJ:OU'1' INTZRVlU. TRANSACTION TIMZOUT INTZRVlU. WAS 600 lNAC'l'XVITT TIHJ:OU'1' IN'l'J:RVAL WAS 900 INAC'l'XVITT T:tMBOUT INTJ:RVAL (BTaT) lNAC'l'XV1TI TINBOUT INTZRVlU. (BXUU) AT'I'ACIIED Burn:RS WAS 250 8/23/03 ---> SBCURITT POOL SIZB ISNS PER TBI BLBMZNT PlUUI.LLI!:L 1/0 OPERATIONS WAS 30 8/22/03
COMMNI1)
--->
NUCLEUS POOLS
DATABASB/USBR L~TS
ADARUN NQCID-80 ADARUN NISNHQ-5000
--->
--->MIU HBLD/USER«
MIU N\JHBBR CIDS/USER 2 5 \ NH)WAS 35 00 6/24/06
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1_9, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
9 Appendix
170
--->TIM!!
ADARUN TLSCMD-300
LDCIT I'OR SX
~
• PRO'1'ECTION LOGGING
ADARUN PLOG!IEV- 83ii3 ADARUN NPI.OGoo4
ADARUN PLOGSIZZ-30000 • caeo.ND LOGGING
_w
_W _W _W _W
_w
_W _W _W
LOGGING-YBS
"" ~" ~" "" ~" "" "" ~" ~" "" ~" "" "" ~"
~m
""~W
""_W
~m
"""",""m
LOGXB-OO LOGIo-nS
""
"""","m
• USER UITS
ADARUN UEJ:4-DBALGRIS ADARUN UEJ:S-t1EXIT08
~
=o~
~
-~
~~ ~~
~ ~~ ~~
UB EXTENSION
•
~
•
'/0
•• nn -~ • ,. -~ w -~ • • ,. -~ -~
~,
ADARUN UEl[12_Ul!XI:T12
USER Ul'rS USER ZZ:I'U 2
ADARUN DSFZXl-tlSFZXIT
DBLTA SAVE USER UIT TO SUBlCIT
• DTNAMlC CI'
ADARUN CSTQlIAGEaVIRTUAL" ADARUN CASSOMAXSa20ON
ADARUN CSTORAGE-VIR'l'UAL'4 ADARUN CDATAMlIJtS_200H ADARUN CDENaND-O
ADARUN CFIL&-( 77",V)
ADARUN CFILB-(151",V) ADARUN CDISPSTAT-NO ADARUN ~C8P8 - 1 ADARUN
CRBTRI_~OO
ADARUN ct.OGLAY0UT-5
• • • NEW V7.1.3 PARAMETERS - ADDBD-07!06!2002 • • •
.. 110 .. ADARUN ASTTVS_HS
ASYNC,PER VOL-NO
W'l'O ON ZACH AOS/DBS CQoI
ADARUN AOSLOQ-HS ADARUN l'GFXX-n:S
MIUIllGZR •• LEN OF "TH ARBA
~rn,
•• Fl\.STPATH • •
ADARUN FASTPATs_n:s .. .
V:ISTA PARMS
ADARUN
AI'P UIT PART 01' NUCLZUS . ..
VIST~YES
PAAALLI!:L
SBRVI~S
FARMS I'OLLOW
DBIO+IllSTMlCl:
ADARUN NUClDaO
ADARUN
ADARUN CLULOCKSIZB- SSM
ASN CACHI! STRUCTURI! (PRQN ADACOM) ASN CACHJ: STRUCTUR& (nlCM l'oDACQM)
ADARUN UlDP-O
LBNGTfI OF
ADARUN OIRRATIo-9S1
DIR&C'1'ORI RATIO BLEMENT RATIO w.x CCH>IUNlCATION TDa: BBTllBBN NUCS NUCLI!I WILL WAn' f'OR CANCEL CONJ'IRM AUTQMATICALLI MKRGZ CLOG AT CLCOPI?
ADARUN ADARUN ADARUN ADARUN
~HZSIZZ-446000K
ELIDIII:N'l'RATIo-IOO MXMSG00300 MXCANCELa600 CIoOGMRG-NO
ADARUN RPLCONNZCTcotJlIT-60 ADARUN Rl'LCONNEC'rIN'l'ERVAL-60
Figure 194:
--> -->
PJW()
POOL
TRI RECONNZCT 60 TIMI!:S TRI RECONNZCT Arl'ER 60 $J:C<)ND$
ADARUN Parameters Subscription Database
9.2 Reptor - ADARUN parameters
9.2
171
Reptor - ADARUN parameters
The user of the following parameters has 57 subscriptions spread across 4 LPARs running on 8 separate Replication STCs. They TUn 8 STCs to balance the workload and because MQ is LPAR4Specific they are forced to stay on certain LPARs. They publish approximately 80 million total messages a week. They have no backlog of Reptor messages (never SLOG) but that may be due to the speed of the MQ QMgr's which consume the messages. In the event an MQ queue was to go down, they made all their SLOGs 65,000 cylinders. They calcu 4 lated this would hold 4 hours of Uve repUcation against their biggest subscription (their worst case scenario). If MQ was down longer than 4 hours they would then need to TUn the Replay function. ADARUN DBro-931,D~CE _ 8393,SVC-22f ADARUN LP>o65000 ADARUN L~2 _ 10000 LENGTH OP W01Ut PAJlT2 ADDED 9/6/03
• • •
Rl:PLICI\.TION
ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN
•
LRPl.-600M RPLPARKS_FILJ: RPWARNPERC!:NT-70 P.P'IIlI.PNMBSSAGELIMIT_l0 RPWARNrNTERVlU.-20 RPWARNINCIIl!:MZNT-5
SHOW NEW tIlI.P.NING HESSAGI!: BVERY AT "
INCRI:
ADARUN PP.OGRAN-ADANUC
ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN
•
VI8TA-NO OSr-OO PLOGRgooSEL OPENRQ-OO UTIONLY-OO RI!ADONLYooNO INTNAS_900 I.OCAIo-NO FASTPATHooNO
4_> NO DBl.TA SAVE REQUIRI:D 4_> PLOO Rl:QUlRED 4_> NO OPEN Rl:QUlRED 4_ > NOT A UTILITI ONLI SESSION RBAD OIlLI NUCloBUS
ISSUE sms 60 C1tPT 15 MIN .ACS 9/06/0] --> MODIPIED 8Y JNA, PRJ:V-~YBS
--,
• NUCIJruS POOLS
•
ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN ADARUN
• • • •
NC>200 NH_ 20000 NT-18 NU-750 LBP>o100000000 LFIOr-25000000 TFLUSa-O LPP>o600000 Lwr-fOOOOOO LS_ 60000 LI_lOOOO LQ-l00000 LU-200000 NAB-820 LCP>o2000 NSISN-51 LDEUQr-250000
TIM!! LIMITS
OP CQE' S OP HQB' S OP THREADS OP USERS LIINGTH OF BUPFI!:R POOL LIINGTH CP UrNC BUPPE FLuSN POOL BUF FLUSH DURATION - 0 WHIm LPIOP IS USBD LENGTH OP PI POOL LIINGTH OF W01Ut POOL LIINGTH OP SORT AREA LENGTH OF TBI POOL LIINGTH OP TBLI!S POOL 108 LKNGTH (MlUI:) NUMBER OP ATTACHED Bt1!'PERS ---> SECURITl POOL SIZE ---> ISNS PER TBl ELEMENT USED BY SLOGGrNG TO • LIUlZL' MSG COMPONBN'l'S WAS lOOK 08/18/2007 NUMBER NUMBER NUMBER NUMBER
i .... .
.....
s:
Vl
.g
~
~
....
<>
I
...
~
t;
'"
!i
Oe
"
~
8
~ ~
[; i,
H
;~ ~ ~ ~! 8
~~
~i
1a"O<3
~~ ....t<~
VV
::!. EO
<>
;;;. • •
~
;;;l"
....
2
H
=
~ O~
~0 i
·
•
N
::;
1<1
:
\I>
d
d
1
~
'I ~
~ ,.
..
Q
i
3:
....
-i"
- a::
................
•
.. · 1 <
-tIIO~O~.. 000..
o;j
H ~N
1-1
Z"
n
00
"
!:!!:!til~IHli3J:
+ + + + + + + +
mum n
mmu
;:j .......
~
N
<>
•
o o
~
N
~
~
10..,.,
..0 <>
02 ~ w
mE mE :::ll'nnnnnn:
00
mm§§
00
~
t;')
V ~
... '"
.. ..,
....
0 . '() <>
H
t"
•
>i
•......
liW
l~~L
m~!
0
<>
0
~
;;\
-' .~=,
" nu~ I m
.. .
;~n
i! ! i ~i
• v.
,, ,, ,, , ,,
<>
00
00
i~ .... U'U':'i'g'Umm'~'uummm"'m';'m"'um ~ · ~ ........ ~ ............. ! ... i ••• ~ 8~11!5 ~ 5 ~ ~9~lgglgg~ §gg§§§§ I ~~~~§ §~~ ~;~ ~ i~i~& ? ~ SN. ni~ ~ ,i p ~ ? riri~ '.~~H S .~ ~ • 20 , d . ~i •. ,. ~ ~~ ~ ~ ;~~ 2 ~~ 8 ~~~ ~ ~~~ ~ ~1~~ § ~fN § ~ ~~ a g~ggg
x'
0-
f
~
->J
9.3 Definitions Target DB - Windows
9.3
Definitions Target OB - Windows
9.3.1
Parameters - db251.ini
• •
• C:\Pr09ramOata\So~tware AG\Adabaa\\db251\DB251.INI • La. t Update : Tu. NO" 30 10:26:23 2010 [CONTAINER] ASSOl ASS02 DATAl
d:\aag\contaiDar.\ASS01,251 d:\aag\container.\ASS02.251 . : \a ag\containera\DATA1.251 ~D : \SAG\Ada.ba. \db251 \NUCCLG"
m=.G ~~
~D:\SAG\Ada.baa\db251\NUCPLG"
SORTl SORT2
• d • •
-, -,
[CONTAINER-END]
\SAG\contain.ra\SORT1.251 \SAG\contaiDar.\SORT2,251 \SAG\containera\TEMP1. 251 \ a ag\containera \WORK1.25 1
[OB PAR»II!:TER) [~ION DBA) [ACTION: DBA-END) [ADANUC STARTED)
ACTI -
_ HS
ACTION JIOUT l NE
ad._nata
[ADANUC_STARTED-END) [ADANUC TERNINATED)
ACTIoN ACTION JIOUTINB
[ADANUC_ TERKtHATED-EIIII)
[DELBTE CHECIU'QINTS) ACTIoN ACTION JIOUTINB MINIMUM [DELETE_CHECIU'QINTS-END] [1NCREA$E_ASSOl ~,~
ACTION_JIOUTINB RATE MESSAGE MINIMUM [INCREASE_ASSO-END) J:X'l'EIIII
[INCREASE DATAI ACTION ACTION JIOUTINE EXTEND-RATE MESSAGi MINIMUM [INCREASE_DATA-END) [INCREASZ LBPI ACTION ACTION JIOUTINB MESSAGi [INCREASE_ LBP-ENDI [INCREASE LS) ACTION ACTION JIOUTINE MESSAGE [INCREASZ_ LS-I!ND) [INCREASE LWP) ACTION ACTION JIOUTINl! MESSAGi [INCREASZ_LWP-ZND)
(I_40,W-20,Z-10,r-S)
"
NO
,,"
ada idat (I_40,W-20,Z-10,r-S)
NO
ada inuc (Z_I01)
NO
ada in\1C (I_50, W-80 ,Z-101)
173
9 Appendix
174
[INCREASJ: NB]
ACTION -
_cl. inuc (1_50,_80,B_I01)
ACTION ROUTnnr: HBSSAGE
[INCREASE_NB - ENDl [INCRD.SE NT]
ACTION -
ACTION ROUTINE MESSAGE
[INCREASE_NT -ENDl [INCR&ASZ NU] ACTION ACTION ROUTINE
.da inue (I_SO,waIDl)
MESSAGE [IN~_NU-END ]
[OmINE CllECJtPOINTSj MESSAGE _ (1 _ 50,w-20,Z_ 5,r-2) [OIPTLINII:_ CHEC1U'OINT$-END)
[RECOV'ER LOST Bl.CICJlSl AC:TIONACTION ROUTINE
_ YES - ad._rl.t
[RECOVER:LOST_BLOCKS-ENDj [REORDER FILE]
ACTIOHACTION ROUTnnr:
~
MESSAGE
[REOROER_FlLE-BNO] lUVE OB]
AC'l''iON ACTION ROU'l':INE
[SAVIl_DEI':"ENDj
[T&RMJ:NA'H_ ADANUCI
A!IORT CANCBL
12 12
0
,~
(T&RMJ:NATJ: IoDANUC-BNDl IDB_PAMKBm-ENDJ I ZNVlROmCBNT) ( BNVlROmCImT-END) [HUCPAPJoIS) AR CONPLICT
BPIO PARALLEL LIKtT
CLOGBMu CLOCLA!OUT
-
,
4096
16771216 20971520 104857600
LOGGING
3145728
,~
""
""
NOL
90000
N:ISNHQ
~,
~.,"" ~
~
OPTIONS PARALLEL_LIKtTS 'l'HAA-
REAl)
TNAB TNAX
"'" 3000 3000 3000
TT
900
USElUtltITS WlUTE LIMIT IHUCPAPMs-END]
Figure 196:
Adabas for Windows Parameters db25Uni
9.3 Definitions Target DB - Windows
9.3.2
175
High Water Marks
\ ADADPR- I-STARTED, 24 - PEB - 2011 14 : 47:40, V.r.1on 6.2 . 1.01 (W1ndov.) D.t.b. •• 251, . tart~p . t 15-rEB-2011 13:22:53 lUIANUC V.r.1on 6 . 2 . 1 . 01, PID 4688
Oat.b. •• Ar • • /Zntq-
----------
'"
V•• r Qu. u . CommatId Qu.ua Hold Qu. u . C1i.nt ou-u. HQ U•• r Limit Thr.ada Workpool ISN Sort Compl. x S. areh AttaCh.d Bu~~.r .~
Pool ProUeUon Ar • • Ac:thr. Ar • • Group COfIIIII.it Tr.n.aetion Tu..
Figure 197:
" "
786, 448
0
0 0
36,864
36 , 864
0
0
"
15-rEB-2011
•, , ,
,
"
---------
17-FEB-2011 15-nB-2011 15-rEB-2011 17-nB-2011 0 15-rEB-2011 17-nB-2011 15-nB-2011
0 15-rEB-2011
"
'00
"
""" "
23: 14:21: 14:21 16:20 14:21:05 16:24 : 15 13:22 : 54
0 0 0 24-nB-2011 08:50:U 0
419.430.400 415.856,640 418,732,032 332.790 g9.837
" "
2 2 : 54
00
15- nB- 2011 13:48 24-rEB-2011 14:45:
"" "
Adabas for Windows High Water Marks
Oat.b. •• 251
1/0 Aet1vity
,
2,068 , 217
:auf~ar
~.,
Wr1 t . PLOG Wr11:
NUCSRT
.. ,=,
'" ------------~
Buf!'. r Format pool
Figure 198:
.
357,02g
WiORll
~
lUIANUC V.r.ion 6 2.1.01 Ac:Uvity
Total.
-----------,=,
,=,
"
•
, , ", ", " ""
,
gO.OOO 3,145.728 3g3,216 3n,216 16,777,216
----------,
Activities
9.3.3
-
,, ,,
'00
(~)
:auf~.r
lUIANUC V. r a 1on 6.2.1.01 on 24-rBB-2011 14:47:35 Hiqh Wat.r Mark. Si,.. In V•• H1qh W.t.r D.t./T1me
0
on 25-rzB-2011 08:01 : 15
Throwbaek.
---------W.itinq
'0. UO c:ont...t
Wa1tinq <0.
••
Total.
,,"0
0 0 0 0
'"
OWP OV.r!'low
0
Total 93.7\
'"
In1:
---------Spae. W.it
~
Adabas for Windows ADANUC Activities
Curr.nt
Total
0
0
176
9.3.4
9 Appendix
Buffer Pool Statistics ~
Oat.ala•• 251
B~~L. r
V.".1on 6.2 . 1.01 Pool Statia tica
on 25-rEB-2011 08:01:15
419 , 430,400
Pool A11ocation
CUrrant
412,060,6'2
10 ,713
Hi'ihw.. t .r
418,732 ,032
15,112
Interna1
19 , 037,184
Workpc:ool
2,453,504
o o
o Sulft." Flush • •
Loqical Re.da
16,794,"0
Phya ical bad. Pool Ni tRat.
1,049,708
Phy.1<:.l Wrlte ..
1 ,018,509
Figure 199:
..,
Total To
1',,_
o
Spac:.
93 . " Writa t.im.it
5\ ) :
20,971,500
Nod.1t'iad
4\) :
19,899,392
Adabas for Windows Buffer Pool Statistics
9.4 Test Results
9.4
177
Test Results
8
]100 mbps IIne /L-
SLOG
REPTOR &.1.J/3.2.1
-
RPLB ...... '
<;;«;II;t
D.
TARGET
r-r(;..!....
WCP
6.1.8.0J
!!,..) .
CSTZOO1
2
,
• ":3iI:26-'U':J.l
'.iJe1_
F ,u,.n2M' I:
;l$t.12_>
'$;'05;2J.'~2'l'"
Figure 200:
Replication Process - Number of Commands per Second (cps)
178
Figure 201:
9 Appendix
Replication Process - Number of Commands per Second -Spreadsheet 1
9.4 Test Results
Figure 202:
Replication Process - Number of Commands per 5econd - Spreadsheet 2
179
180
9 Appendix
9.5
Natural Monitor Programs
9.5.1
Ping Target Database
0010 DEPlNE DATA LOCAL 0020 1 FJ:Lll:U VIEW 01' $T-RZ-CN'l'R!I-LlNE
0030 0040
2 LOG-COUNTER
0050 , '0. , '0' 0070 , 0060
0080 0090 0100 0110 0120 0130
•
2 ENTITY (Al) (NS) .~ (14)
INIT (' S'> IN:lT <251>
'*
t'or UDB USRI040N
S_ •• t G-gat
'" f'or UDB
JmI)-DEFlNE
••• ------------------INPUT 'DB ••• ------------------ON ERROR
0140 0150 0160 0170 0180 0190 0200
Ir *ERlIDR-NR • 3148 WlUTJ: (0) NOTITloE ' BP.P.OR: Oataba •• ' 'OB ' or Nat-Worlt i . down ' TERNINA'l'E 12 &LSE WR.ITE (0) NOTITLZ 'Otb
0220 •• ---------------------0230 CALLNAT 'USRI040N' toP loa IRe
0240 •• -------------.--- . ---0250 Ri . READ (1) FILE44 BI I5N 0260 • DISPLAY LOG-COUNTER BNTITJ: *ISN (RI . ) 0270 WRITJ: (0) NOTJ:TLE 'OB' 'OB ' .nd Hat-Work 02BO JmI)-RBJ\D
Are
up .nd runninq'
0290 I r .COUNTER (RI.) _ 0
0300 WRITI! (0) NOTITLE 0310 'OB' 'OB ' i . up and runnin'i - but t i l. 0320 JmI)-IF 0330 END
Figure 203:
44 i .
"'"Pty'
Monitor - Natural Program Ping Target Database
9.5 Natural Monitor Programs
9.5.2
*. ••
181
Check Messages on DDPRINT
---------------------------------------------------------------------
BVENT REPL1CATOR Per~ormanc . Proj . ct •• RPL- P001: Read th. nu"1. . . . . tat1.t1". an
•• •• •• •• •• •• ••
-HWM>'5 ' rNR(1:999) - RSP and CNT (1:255)
Array :
.. Adab.. ..*. ---------------------------------------------------------------------•• Date
----------
•• 2009-02-18 •• 2009-04-13
••
DSTORP. OSTOPR
Cop1ad ~rom p.r~ormanc. proj.ct PER-POOl ODPRlNT haB no lon!i.r an l\.SA chara"t.r
OEFINE DATA LOCAL Inp1.lt Work ril. 1 'ADALOG-LINE (11.133) 1 REJ;lErINB 'ADALOG-L1NB • 2 'ADALOG- LINE-ASA (11.001) 2 'ADALOG-L1NE-TBrr (Al33)
••
1 'DUTPUT-L1NB (Al20) 1 REJ;lEFINE 'DUTPUT-LlNE 2 'BEQ (N6)
..-
2'~
(1.2)
2 'TEXT
(All2)
2 'RaP
(N3/1:255) (N6 / 1 :255)
,•• ,, """ tu ,, '" "
"" "" "••
rNR _ OrJl'SET IN TABLB
(N4) /. rNR INDEX / . RaP/CNT (N4) (L) INIT (L)INIT
.~
••
/.
(0 : 9GG)
'ASTZRISK
.~
lI - rNR-ALP 'I-nlR-Nt/H lI - RaP-ALP 'I-RSP-Nt/H
(11.120) (N6) (11.3) (N3) (11.3) (N3)
,==
1*
lin. count
J!ND-DEFINB
••
11' .MACH1NB-(:LASB NE
'MlUNI'RAME'
OEPlNE WOU FILE 1 DBl'lNE WORft 1'1LB 2 J!ND-IP
'Z:\Repl1cator\rp1tmpa2 .tat 20090413.txt' 'Z :\Rep1ic. tor\RPL-PlOO=.ta t=r. p_200990.13_n. .. . txt·
••
~-,
t BRROR-TA :_ 'PJ:R-PJ:RR'
.. ----------------------------------------
~--••
.. ---------------------------------------•• -- In1tia 1i.ation
••
'LC :_ 0
'ASTERISK : .
' •••••••••••••••••••••••••••••••••••••••••••••••••••••• '
FOR 'U _ 0 TO 999 I'OR U2 •
1 TO 255
1*
~i11 r •• p
code. 1-255
182
9 Appendix
'RSP(tn,'U)
:_ ' U
--~ J:ND-FOR ••
.. ---------------------------------------.. ---------------------------------------•• -- Ra&d .ta ti . tic. and Eill arr.y
~ ,
."
, . r.oad on. ADALOG RBAD WOlUt 1 'ADALOG-LINB •• -Cheek J:rror Line . 'Start 15 , --------I r SUBSTRING('ADALOG-LINB-~T,01,17) _ 'AB -POOL AND SUBSTRING('ADALOG-LlNE-TEXT,42,02) GT '75' ADO 1 TO 'LC 'ADALOG- LlNE - TEXT _In: WOlUt FrLl: 2 'ASTJ:RISIt WRITE WOlUt PILI: 2 'OUTPUT - LINJ: _In: WOlUt "ILI: 2 'ASTJ:RISIt
"" "" "" "
'Re :.
..
'TEXT :.
..
'HWM :_ TRUl!:
END-I:r Ir
SUBSTRI:NG ('ADALOG-LINJ:-TErr, 01,17) _
'RPL -POOL '75'
AND SUBSTRING('ADALOG-LINB-TEXT , 42 ,0 2 ) GT
..
ADD 1 'TEXT WRITJ: WRlTE WRITJ:
TO 'LC : . 'ADALOG-LINB-TEXT WOlUt FILI: 2 'ASTUUSIt WOlUt FrLl: 2 'OUTPUT-LINJ: WOlUt FILI: 2 'ASTUUSIt
'HWM :_ TRUl!:
END-Ir
.. -------POR '11 •
POR 'U
Print r.oapon . e eode err a y ----- - --------
0 TO 999 1 TO 255
9.5 Natural Monitor Programs
IF 'CN'l'('U,'12) GT 0 ~SS 'PNR/RSP/CN'l" INTO 'OUTPUT-LINB
*"
183
'11 'RSP('11,'12)
'CN'l'('11,'12)
'SE<;! ,. 0 WRlTE WOR:K FILII: 2 'OUTPUT-LINB END-IP
~-"'"
END-POR
••
IP 'IIWM • TRUB WRlTE WORK FILE 'OUTPUT-LINB , . WRlTE WORK FILE WRlTE WORK FI LZ END-IF
2 'ASTERlSII: 'Pl.as. ch.ck th. hiIJh-..ater ....... rk s!' 2 'OUTPUT-LINB 2 'ASTERlSII:
Ir IRe • TRUB WRlTE WORK FILZ 'OUTPUT-LINB : . WRlTE WORK PILZ WRlTE WORK PILZ END-IF
2 'ASTERlSII: 'Pl. a a. ch. ck th. 2 'OUTPUT-LI NB 2 'ASHRlSII:
••
ADABAS r •• pon • •
code s !'
••
Ir IIIWM • TRUB OR IRe • TRUB IP .to.CIIlNE - CLASS EQ 'HlUNPR»CI!' TERMINATE 12 END-I P :ELSZ WRlTE WORK PILZ 2 'ASTBRISII: Ct»G'RBSS ' PROGRAM ': no . rror. f:ound in OOPRJ:NT ! ' INTO 'OUTPUT-LlNE LIlAVING NO SPACK WRlTE WOR:K FILII: 2 'OUTPUT-LINB WRlTE WORK PILZ 2 'ASTBRISII: END-IF
••
Figure204:
9.5.3
Monitor - Natural Program Check OOPRINT Messages
RPL and NAB Buffer Overflow
0010 •• ------------------------------------------------------------------0020 • • DWSLOGBW : Check High Water Mark of: Raplic.tor Engin. Thi. proqram r.ada the 700S high-.. ater _rk. 0040 •• check. f:or Rooplic.tion (RPL) 0050 .. Input: OtIIllPOl RBI'oD WOR:K 1 -- 700S High Wat. r Mark. 0060 •• OUput: 0MItF02 - WRlTE WORK 2 -- 700S IIWM
0030 ..
0070 .. 0080 • •
.-
LJ:B: PDSTUTIL (prod) ; DIETER (davl)
0090 •• Oa t .
0100 •• ---------0110 • • 2009-01-26 0120 •• 2009-02-25 0130 •• 2009-02-26 0140 •• 2009-03-19 0 1 50 ••
STDWS
STONS STDWS
STONS
CRBATBD chanqed to .. rite werk fil . 2 ASA not r .ad on _inf:r ..... but on Windo ... IIWM ch.ck from 50\ to 6 5 \
0160 •• --------------------------------------------------------------------0 1 70 OZrINB DATA LOCAL
(lU33) 0190 1 RlCDzrJ:NB 'ADARBP-LINB 2 'ADARBP-LINB-ASA (AD01) 0200 0210 2 'ADARBP-LlNE-TI!:XT (lU32)
0180 1 'ADARBP-LJ:NB
0220 •• 0230 1 'ARRA1'
0240 1 'START
(11.79/1:50) (L) INIT
184
9 Appendix
0250 1
'r
(U)
(A79) INIT <'NAß 01: RPL
0260 1 'IIWM-NSG
0270 _.
r.ach~
65 \ '>
02BO ENI)-DEPINZ 0290 ••
0300 . . 0310 11' *MACl!INJ:-CLASS NE
'MIUNFitAME'
DIU' IN!!: WORP; PILil 1 'Z:\Replicator\D8134 IIWM 20090226 tat' DBI':INE WQR:K 1'11.& 2 • Z: \~lic.tor\d.d09hw .db134_11MM_ 20090226. txt'
0320
0330 0340 JmI)-IP 0350 ••
0360 •• --------------------------------0370 •• -- bad
r~rt. • • nd
fill _trix
0380 •• --------------------------------0390 11 , _ 1
0400 RIf. RU.ll
WQR:K
1 'lUlAP.EP-LINB
0410 •• 0420 DISPLAY 'ADARBP-LINZ (AL-a) 0430 Ir SUBSTRING('ADARBP-LINl!-TI!X'l',l,6) •
OHO
'DATA S'
'START :. TRUI:
0450
ESCAPE TOP
,.
(RW.)
0460
EJIt)-IP
0470
11' SUBSTRmG('ADARBP-LlNE - TEXT,l,ll)
0490
'DATA"
DUO
,"IN '
ESCAPE DOT'rOM (RW.)
0500
&ND-lI'
0510 ••
0520 0530
:II' 'START. TRUI:
0540
ADD 1 '1'0 ,X END-lI'
IARRAYltI) :. 'ADARBP-LINB-TEXT
0550 0560 • 0570 ENI)-WOlUt
0580 •• 0590 1'1. I'OJI. 11 • 1 TO 30 0600 :IF 'ARRAY(U) _ ' , OR 0610 SUBSTRING('ARRIU('I) , 1 ,13 ) _ 0620 E$CAi'E BO'l'TOM (Pl.) 0630 END-IF 0640 WRITE WOIUI: FILE 2 'ARRAY ('J:) 0650 END-FOlI. /* rL 0660 ** 0670 ' F2 . FOlI. '1 _ 1 TO 30 0680 SUBST'RlNG('ARRAr (U) , 1,20) 0690 SUBSTRING('ARRAr('J:) , 1 ,20 ) SUBST'RlNG('ARRAr('I) ,1,20) 0700 0710 SUBSTRJ:NG('ARRAY('J:) ,1,20) SUBSTRING('ARRAr('I) , 1,20) 0720 0730 SUBSTRJ:NG ('ARRAY ('J:) ,1,20) SUBSTRING('ARRAr('I) ,1,20) 0740 0750 SUBSTRJ:NG ('ARRAY ('J:) ,1,20) SUBSTRING('ARRAY('I) ,1,20) 0760 SUBSTRJ:NG('ARRAY('J:) ,1,20) 0770 SUBSTRING('ARRAY('I) ,1,20) 0780 SUBSTRJ:NG ('ARRAY ('J:) ,1,20) 0790 SUBST'RlNG('ARRAY('I) ,1,20) 0800 SUBSTRJ:NG('ARRAY('J:),l,20) 0810 SUBSTRING('ARRAY('I) ,51,02) 0820 WRITE WOlUt. rILE 2 ' IIWM-MSG 0830 TERMINATE 0840 0850 END-Ir 0860 END-Ir 0870 END-FOlI. /* (F2.) 08BO ** -0890 END . . . . . End o~ li at u***
• • • • • • • • • • •
' Pl'l----- PF2'
--
"
•
"
Figure 205:
"
'Attach~ B,,~~.r(NAB) , ~ (RPL) , 'bpl ication 'Coa.and Qua". (NC) 0. (LFP) , 0' , Format Pool ' Hold Q\Mou. ~ 'ISN-Li at Tabla (LJ:) 0' 'S.q . ~. Tabl.(LQ) 0. ,~, ' U.ar Qua". ~ 'uniqu. DE Pool (DUQ) , 0. (LCP) , 0' 'Sac..,.:ity Pool (UQP) , 0. 'UQ Pila L1at (:nD) , 0' 'ATM Tran., (LWP) , 0. 'Worlt Pool 'Rado Pool (LRDP' 0' ' 65'
'W,
'0.
"
Monitor - Natural Program RPL and NAß Overflow
9.5 Natural Monitor Programs
9.5.4
185
SLOG Check on Reptor
0010 0020 0030 0040 0050 0060 0010 0080 0090 0 1 00 0 1 10 0 1 20 0 1 30 0 1 40 0150
•• --------------------------------------------------------------------• • DWSLO!iCK : Che ck SLOQ oL Replicator Enqine •• Tbia pr09ram read. tbe AOS/Rep1ieator St&ti.tie. •• check. Lor queued. "al"e. and .end _ • • a!Je to ..... . •• Input : CMNIU'Ol - READ WORlI: 1 - - AOS/Rep1ieator St&ti.tie. • • Ouput: CMPR.T01 - WRITE (2) •• roRMAT(2) LS_80 PS_40
0160 0110 0180 0190 0200 0210 0220 0230 0240 0250 0260 0210 0280 0290 0300 0310 0320 0330 0340 0350 0360 0370
• • ------ - ----- - - - - -- ----- - - - - -- ----- - - - - - ------ - - - - - ------ - - - ------- - -DBI'INB DATA LOCJU. 1 UDARBP-LINB (Al21) 1 RBDBI'INB 'ADARBP-LI NB 2 'ADARBP- LINB - ASA (AOOl) 2 'JU>ARBP-LINB-TEXT (Al20) •• (A19/1: 30) 1 'J\RRAY 1 'START (1.) INIT (14) / • • rray counter 1 •• END-DEI':lNE •• •• 11' ' MACHINB-CLASS NB 'MAINI'RAMB' DEI'INJ: WORlI: FILE 1 'Z: \JU>ARBP\adaba. _ . loqrep . tat' BND-II' •• DBI'INB PRINTER (l) OUTPUT ' CMPR.T01 ' I' needa to .uppre• • DEI'INB PRINTER (2) OUTPUT 'CCONTROL' 1* tobe ASA . iqn FOPlOoT(2) LS_SO PS_40 ••
•• •• •• •• •• •• ••
Date ---------2009-01-05 2010-03- 1 0
N_
Rea.on Lor ehanqe.
STDNS STDNS
ereeted. u~ted. Lor A08813 - diLLe r e nt di . play .... : De.tination .109 ent now : On Lile
':1
0380 •• --------------------------------0390 •• -- Raad r e port. and Lill matrix 0400 0410 0420 0430 OUO 0450 0460 0410 0480 0490 0500 0 5 10 0520 0530 0540 0 5 50 0560 0510 0580 0590 0600 0610 0620 0630 0640 0650 0660 0610
'1 :_
•• --------------------------------1 RW. REAl) WORlI: 1 'JU>ARBP-L:lNB •• Ir SUBSTRING('ADARBP-LINB-TBXT,1 , 6) • 'START , _ TRUB ESCAPE TOP /* (Rlf.) END - lI' •• 11' fS TART _ TRUB 'J\RRAY('I) : . 'ADAREP-LINB-TEXT ADD 1 TO II END-lI' 11' SUBSTRING('ADAREP-LINB-TEXT,2,23) ·o..tination .109 ent ESCAPE BOT'l'OM (1Of.) END-Ir BND-WOU •• 1'1. roR 1 TO I r 'J\RRAY('I) • BSCAPB BOTTOH tl'l.) END-lI' WRITB (2) 'J\RRAY('I) BND-roR I ' (1'1.) ••
'1 •
"
'DATA B'
186
06eo
9 Appendix
'v2 .
Ir
0690
0700
WQR ' I •
1 TQ 30
SUBSTRING('~I{'I) , 2.11)
Ir
0710 0720
•
SUBSTRlNG('ARRAI('I),12 , 1~)
WRITI! (2) NOTITLI! 1/ '·'(20) I 'SLOG i a -.pty '
0130 0140 0750 0760
ELSE
I
WRITJ:
' •• (20)
(2)
NOTITLB
1/ ' . ' ' . ' (38) ' . ' I ' _1 (11) (AL-25) I 'SLOG i . not _ t y I '.' '.' (38) ' . '
0770 0780
0190 0800
open th. destination'
0810
TBRMINATE 12 1DItJ-IF BJIl)-IP 0830 0840 END-roR /* (.-:2 . )
0820
0850
'On fil e • '
.. --
'*
tor ce checl<
0860 END
. . . . . End of li s t . . . . .
Figure 206:
9.5.5
Monitor - Natural Program SLOG Check Re ptor
Compare !wo SLOGs
0010 •• -------------.---.------.------. ---------------------------------- . -Compa"a two 8LOGe of Jteplic.tor Eng-ina Thi a p"og" .... " . ade tha AOS/Repli"ator Statisti". cha cks tor qu. "ed, ...1"•• and ••nd _ •••'1. to ..... .
•• •• •• •• •• ••
ouput:
LU"
c:MWUOl CMilKF02 CMlIRTOl FORMAT (2)
~
WORl<; 1
REAtI WOlUt. 2 WR1TE (2)
AOS/Replic:ator Statisti<:. old AOS/Replica tor St.aU. tic. n e ..
L$-80 PS_ 40
PDSTU'l'IL (prod) - DIETER ("vl)
D a t. •
eopied t'rOlll DWSLOGCIt and ch .. ~d to ",e .. d .. nd compa,.. two SLOG "'~"'t . ehanq"" c~nt . : 8LOG i . ~ inq dr .. in .. d 0170 0180 0190 0200 0210 0220 0230 0240 0250 0260 0270 0280 0290 0300 0310 0320 0330 0340 0350 0360 0370 0380 0390 0400
u
•• DEVINE DATA LOCAL 1 'ADAREP - LINE-l (A12l) 1 REDEVINE 'ADAREP-LlNE-l 2 'JlDAREP- L1NE - ASA-l (AOOl) 2 IJlDAREP-LlNE-TEIT-l (A120) u
1 'AD1UUI:P-LlNE-2 (A12l) 1 REDEVINE 'JIDAREP-LINE-2 2 'ADAREP-LlNE-ASA-2 (AOOl) 2 'JlDAREP-L1NE-TEXT-2 (Al20) •• 1 'ARRAY-l (A19/l : 30) 1 'START-l (L) INIT <~SE> (14 ) / . a",ray counte", 1 In •• 1 IARRAI-2 (A79/l : 30) 1 'START-2 (L) INIT <~SE> (14) / . a",ray count.", 1 '12 •• BND-DEVlNE •• u
9.5 Natural Monitor Programs
0.10 0.20 0.30 OUO 0.50 0.60 0.70
ono OUO 0500 0510 0520 0530 0540
0 5 50 0560
187
Xl' 'MACHXNE-CLASS NE 'MAINI'RAMI!:' DEFINE WORlt FXLI: 1 'Z, \AIlAP.J:p\.cial> • • • 109r.p 20090105. tat. ' DJ:rINE WORlt rXLI: 2 'z, \l'oDAJlI!P\.dab • • :::d09rep:::20090116 . tat. ' END-Xl' •• Xl' 'MACHXNE-CLASS BQ 'MAINrRAME' OEFINE PRINTER (1) OUTPUT 'CKPRTOl' /* n.ed. to .uppr••• DEFINE PRINTER (2) OUTPUT 'CCONTROL ' /* th. ASA .1'1" END-Xl' •• Ir 'MACH INE-CLASS BQ 'MAINnuue:' FORMAT(2) LS- SO ps- so J:LSJ: FORH1.T(O) LS_80 ps_so END-XI' ..
0570 •• ------------------------------------0580 . . -- Reed SLOG r-.port. 1 and Lil1 _t.rix 0590 .* ------------------------------------0600 ' U : _ 1 0610 RWl . P.BAIl WOp,p; 1 'AOAJU!P-LXNE-l 0620 . . -0630 I r SUBSTlUNQ(tAOAJU!P-LINE-TJ:XT-1,1,6) _ 0640 'START-I : _ TRI]II: 0650 BSCAPB TOP /* (Rlf1.) 0660 ENll-XF 0610 IP SUBSTJUNQ ('AOAP.J:P-LINE-TJ:XT-l ,2,32 ) 0680 'Por individual repl.y dbid/toke n' 0690 ESCAPE BOT'l'CN (RWl . ) 0700 ENll-xr 0710 . . 0720 IF 'START-I _ TRI]II: 0730 'AJl.RAY-I(tU) , _ 'AOAJU!P-LXNE-TJ:XT-1 0740 AOO 1 TO ' U 0750 ENll-XP 0760 0770 BND-WORK /* (RWl . ) 0780 . . 0790 F1. FOR '11 _ 1 TO 30 0800 IP 'AJl.RAY-1 (tU) _ ' 0810 ESCAPE BOT'l'a( (PI.) 0820 ENll- I r 0830 Ir *MACHINE-CLASS BQ 'MAINFRlIHI: ' 0840 'iIlUTI!: (2) 'ARAAY-l (tU) 0850 ELSE 0860 WRITE (0) 'ARAAY -1 ('U) 0810 ENll-IP 0880 BND-FOll/. (F1.) 0890 . .
'!>AT" B'
0900 .* ------------------------------------0910 . . -- Read SLOG r-.port. 2 end Li11 _t.ri ..
0920
.* -------------------------------------
.. --
0930 fI2 , . 1 0940 JlW2. JlEAO WORlt 2 'AOAJU!p-LXNE-2 0950 IF SUBSTlUNG('ADARBP-LINE-TJ:XT-2 , 1,6) _ 0960 'START-2 :_ TRI]II: 0970 0980 ESCAPE TOP /* (RW2.) 0990 ENll-IP 1000 Ir SUBSTlUNQ('AOAJU!P-LINE-TJ:XT-2,2,32) 1010 'ror individu.l rep1.y dbid/tok.n' 1020 BSCAPB BOT'l'a( (JlW2 . ) 1030 ENll-IF 1040 . . 1 0 5 0 l l ' ISTART-2 _ TRlJl! 1060 'ARAAY-2('X2) , _ 'AOAJU!P-LXNE-TEX'l'-2 1070 ADD 1 TO 1080 ENll-Ir 1090 1100 END-WORK /* (JlW2.)
'1:2
1110 ••
'DATA B'
188
9 Appendix
1120 r2 . nlR 'U • 1 TO 30 1130 Ir 'ARRAI-2 (U2) • ' 1140
ESCAPE BOTTOM (1'2 . )
1150 1160 1170
END-Ir :Ir *MACHINB-CLASS EQ 'MAUlFRAME' WlUTB (2) '1ülRAI-2(':I2)
1180
E.LSE
1190
WlUTB
1200
1210 1220 1230 1240 1250
(0)
'ARRAY-211I2)
END - Ir
END-raR /* (1'2 . ) •• ------------------------------------•• Compare both ar".y. •• ------------------------------------1'3 . l'OlI. 111 • 1 TO 30
1260 •• 1270 11' SUBSTRrNG('ARRAT-l(tIl) ,2,17) • 'Itama on 1'11. 1280 •• U· suaSTJUNG('ARRAI-l (lU) ,20,45) 1290
SUBSTRING('ARRAY-2('Il) ,20,45)
1300 1310
Ir *MACNINB-CLA$S EQ ' Ml\.INFRAHZ' WRlTE (2) NOTI'l'LZ 11 .• ' (13) I 'SLOQ i , .-pty'
1320 1330 1340
1350 1360 1370 1380 1390 1400 1410 1420
1430 1440 •• USO 1460 1470 1480
I
WlUTB (0) NOTITLZ /1 •• ' (13) I 'SLOG i , ampty' I ' . ' (13) END-Ir BSCAPB IIOTTOK (1'3.
BNI)-II' 11'
1490 1500 1510
1520 1530
BLSE WlUTE
1700
Ir
(0) NOT:ITLI: .mpti~'
SUBSTR%NG('ARRAY-1(111) ,20,45) GT ' SUBSTRING{'ARRAY-1{'I1) ,20 , 4 5 ) GT SUBSTR:ING{'ARRAY-2{'I1) ,20,45) Ir 'MACHINE-CLASS EQ 'MArNFRAMB' WlUTB (2) NOTITLB
11 ' .' (46) 1 ' SLOG i . bein<;! drainad' 1 '.' (46) ELSE WlU'l'E
(0) NO'l'ITLZ
11 ' .' (4.6) I ' Sl.OG i , bei"", dra ine d' I , .' (,,)
1720 1730
1820
.mpti~'
END - Ir BSCAPE BOTTOM (r3. END-I r
1710
1740 1750 1760 1770 •• 1780 1790 1800 1810
'SLOG haa baan aucca •• ~u11y '.' (34)
11 ' .' (34) 1 ' SLOG haa baan aucca • • ~ully 1 '.' (34)
1660 1670 1680 1690
SUBSTlUNG l'ARJaY-l ('11) ,20,45) NI! SUBSTR%NQ('ARRAY-2('Y1) ,20,45) EQ Ir 'MACHINE-CLASS EQ 'MAINFRAMII:' WlUTB (2) NOTITLI: 11 , . , (34)
1 1
1540 1550 1560 1570 1580 1590 1600 u 1610 1620 1630 1640 1650
'.' (13)
Itl.SE
END-IP ESCAPI!! BOTTOM (P3. END-IP Ir
SUBSTR%NG('AP.RAY-1('Il) ,20,45) NE SUBSTRING('AP.RAY-2('I1) ,20,45) EQ Ir "MACHINE-CLASS EQ ' MAINi'RAHI!! ' WRITI!! (2) NOTITLI!! 11 '.' (34)
,
AN!)
9.5 Natural Monitor Programs
1830 1840 1850 1860 1810 1880 1890 1900 1910 1920 1930 1940 1950 1960 1910 1980 1990 2000 2010 2020 2030 2040 2050 2060 2010 2080 2090 2100 2110 2 12 0 2130
I
'SLOe ha. t..an .uc:ca•• tully .mpt1ad'
I
'.'
(3<1)
ELSE
WRI'l'E (0) NO'l'l'l'LB 11 '*' (3<1)
/ /
'SLOe ha. '*' (3<1)
END - lI' ESCAPI!: END-fr
~
(1'3,
.. fl'
SUBSTRlNG('ARRAY-l(fIl) ,20,45) NIl SUBSTRlNG('ARRAY - l('Il) ,20,45) ZQ SUBSTRlNG('ARRAY-2('Il) ,20,45) fl' *MACHnnr:-CLASS ZQ 'MlUNnllIME ' WRI'l'E (2) NO'l'l'l'LB 11 '*' (3<1)
/ /
.-
'SLOe 1. not .mpty - opan th
ELSE WRI'l'E (0) NOTI'l'LB 11 '.'(3<1) 'SLOG i . not empty - opan tha ä.tination manually' / '*' (3<1) / END - lI' 'l'ERMINA'l'E 12 END-Ir J:Nl;I-II'
END-FOR
. . -END
Figure207:
9.5.6
189
/*
(1'3. )
Monitor - Natural Program Compare 2 SLOGs
Analyze WCP Log
The program RDWCPLOC (ReaD WCP Log) counts the number of Adabas commands per second in Entire Net-Work log of the dient side.
'-_. ..,
, " m '" m ,'" '"
~u,
.
on
'" '" on '"
1022 1100 117g 1258 1322 1378 U58 1531 1615
10-0i-13
C&lh ~
, ". "" " ." ". '" "" "" ." n. '" ." '" " " ." "" "" n. '" ." '" " " ." "" " n. '" '" """ "" '" '" " '" "" "" ". '" '"
..
Figure 208:
15:53 :Og. 15 : 53: :11 .005 : 12. 53, :14 .005 :15. 53, : 11 . 005 : 18. 005 1$ ' 53: 15: 5 3 :20. 15 : 53 :21 .005 1$ ' 53 :22 .005 15 :53 :23. 15 : 53 ,24 .005 15 : 53 :25 . 15 :53 :26. 15,53 ,21 ,005 15 : 53 :28 .005 15 :53 :2g. 15,53,
ba1660 ba1560 ba1 5 60 ba1660 'b5abO 'b5 abO 'b58bO 'b5gbO ba1660 ba1560 ba1560 ba1660 ba15 60 ba1560 'b58bO 'bSgbO 'b5 abO ba1 5 60 'b5abO 'b5abO ba1560 'b58bO
~. ~. ~. ~. ~.
~. ~. ~.
~. ~. ~. ~. ~. ~. ~. ~. ~. ~. ~.
~. ~. ~.
,n, -,n, ,n, -,n, ,n, -,n, ,n, -,n, ,n, -,n, ,n, -,n, ,n, ,n, ,n, ,n, ,n, -
-,n, ,n, -,n, ,n, ,n, --
.........". ...... ...... ......... ......... ...... ...... '" '" '"
~ ~
--_u _u _u _u _u -_u _u _u _u _u -_u
_U
~
_u _u
~
_U
~
~ ~
~ ~ ~
~ ~ ~
~ ~ ~ ~ ~
~ ~ ~
~
_U
_U _U _U _U _U _U
Monitor - Natural Program Analyze WCP Log
......... ...... ...... ......... ......... ...... •••
'" '" '" '" '" '"
~ ~ ~ ~
~ ~ ~
~ ~ ~
~ ~ ~
~ ~ ~ ~ ~
~ ~ ~
~
H:23:U
"all call
_u
"all call
_u
"all call "all "all _U "all " a ll "all "all " a ll
_u
"all "all "all "all "all
---------------
190
9.5.7
9 Appendix
Checksum Program
The program CHECKSUM uses Natural's API to compare two Adabas files.
-- ,, -- , -- ,,• -,, =" ,,, ,, ,, ,, ,,,
$ _ 1 . CHECJI;.SUM Provide D810. Provide Eil., n... in 'FILE
provide Provide Provide Provide
ri1. Nuaber in 'rlLE-NBR
Eil., n... in VIEW
• Eull DDM detinition f"o11o.. i"'1 VII:W the LRECL in 'DDM
oE CHl!:CJtSUM •• CHKSMOO6 DEFlNE DATA :LOCAL INI'! <187> 'OBI (N5) INIT <250> 'D82 (N5) U'ILE-NBR (N5) INIT <006> 'FILI! (7.32)
1'11& 6
nUT < ' ST-CALC-BDATB'>
VIElf ST - MC- CALC - EDATZ (5'15 . 0) =-~ ENTITY (A5D)
D~
, ,-,- ««< ««< , , ,-,- ««< ««< , ,-,- ««< • ««< ,
LAST-CHGQ-DATE-TIMK (AIS) LAST-CHGD-USBR (AOS) (11.10) (AOS) (AOS) (ADe) (A250)
CALC-CQDE
!l1'P-DAn: Brl'-DATE-~
BXP-DATE ~,.
,, ,, , 'rum
1 REDZPINZ DDM
2 100M (&365)
'1023
roNC
(Al)
Re (114)
(Tl DATE (0) 2 TS (B8) ,~ (1'19)
, , .,
11040
0360
'''''
2 DB (N5)
0370 2 Re (14) 0380 1 14011 0390 2 I'UNC (14) 0400 2 eTX (Bl56)
DUO
2 TEXT (A) OYNAMl;C
0420
2 HASH
0430 0440 0450 0460 0470 0490 0490 0500 0510 0520 0530 0540 0550 0560 0570 0590 0590 0600 0610
(820)
1 'flASH (a20) 1 'COUNT (Pl0) END-DErnlll: * roRKAT SG-r * DErnlll: SuaRO!JT:lNE flASH-ilTN CALLNAT " USR10tON" '10tO ASS:lGN 14011. FUNC _ 1 CALLNAT " USR4011N" 'tOll ASS:lGN 14011. FUNC 2 ASS:lGN '1023.MS *CPU-TIMZ R. READ HULU-FBTCH ON DOM BI ISN ASSIGN "011. TEXT • 'DOM CALLNAT "USRtO llN " "011 END-READ ASS:lGN '4011.FUNC • 3 CALLNAT " USR4011N" 14011
,. ««<
6
9.5 Natural Monitor Programs
0620 0630 OUO 0650 0660 0610 0680 0690 0700 0710 0720 0730
0740 0750 0760 0710 0780 0790 0800 0810 OB20 0830 OB40 0850 OB60 0870 OB80 0890 0900 0910 0920 0930 0940 0950 0960 0910 0980 0990 1000 1010 1020 1030
ASSIGN 11023 . MS • "CPU-TIMB: - 11023 . MS CALLNAT "USR1023N" 11023 OISPloA1: 'oa1:0' 11040 . 0a 'Roocol:d.' .COUNTER (R.) 'Ch.ck.um' '401l . HASS 'CPU T~' '1023.TrME (EM-HH II:SS.T) END-S!JBROUTnlE AT TOP 01' PAGE WRIT!: "tlAT4U .TrME 'Stal:t.d' .PiIOGlUU(
10X 'Ch.ck.um COIIP4l:i.on' I lOT 'FU . ' 'FILE 1lI: 'Fil. ' : ' 'FlLE-NBR
I
END-TOpPAGE ST. SET TIME ASSIGN '1040.0B • 'DBI PEIU'ORH HASH-P.TN ASSIGN 'HASH • '401l.HASH ASSIGN 'COUNT. "COUNTER (P.. ASSIGN 11040 . 0B PEIU'ORH HASH-P.TN
'DB2
11' .COUNTER (R.) _ 'COUNT TIIJ:N walT!: / T""COUNT!:P. (P.. 'Count.u .... tch' (GRI) ELSE walT!: / T""COUNTER (P.. '»»> Count.u da not match ««< , (REI) END-Ir 11' '4011 HASH _ 'HASH TIIJ:N walT!: / T"'4011.HASH ' Ch.ck.um. match' (Gal) ELSE walT!: / T"'4011 . HASH '»»> Ch.cksuma da not .... tch ««< , (RZI) END-Ir
WRlTl! "DAT4U "TrME 'Endood' I "TIMD (ST . ) (ZH-99: 99: 99' . ' 9) 1050 END
1040
Figure 209:
Monitor - Natural Program Checksum
191
192
9 Appendix
9.5.8 0010 0020 0030 0040 0050 0060 0070 0080 0090 0100 0110 0120 0130 0140 0150 0160 0170
Compare Amount Fjelds ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• • VERIrr I'ILI: 99 Arl'ER ADARES • • 11/19/2004 ~ • 09/23/2008 ~, a.us.d multi-I!.tc:h 100 to the r_d • 09/24/2008 ~, ch. "'1. d ...."ltif:. tch •• inpu.t ....1". • 12/15 /2008 ~, a.us.d di.pl.y I!or .l.p.ed time .nd cpu time • cpu time tor TSO .nd b.tch only • 12/22/2008 ~, corrected. cOlq>utation f:or 'TIM!) (hh : _ : . . . . . ) • 01/05/2009 ~, c:h. n9ed "ith 'COUNTER • a.us.d f:i.lda LOG-COUNTER .nd 'LOG-COUNTER • 01/13/2009 ~ CHANGE REPORTING DATE TO IlAVE l'OUll DIGIT YEAR AND IN • FORHII.T TITT/tKfDD • • DEI'INZ DATA
'CTR
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
LOCI\Jo
OlBO 1 ~IB VIZW 01' ST-RI-CNTRB-LINZ 2 LOG-COUNTER OUO 0200 0210 0220 0230 0240 0250 0260 0270 0280 0290 0300 0310 0320 0330 0340 0350 0360 0370 0380 0390 0400 0410 0420 0430
OHO 0450 0460 0470 0480
OUO
2 POST -TAX- CNTRB-AMI' 2 PRB-TAX-CNTRB-AMT 2 DB- POST-TAX- CNTRB-AMT 2 DB-PRB-TAX-CNTRB-AMT 1 'POS T-TAX-CNTRB-AMT (P12 . 2) 'PRJ:-TAX-CNTRB-AMT (P12 .2) 1 'DB - POST-TAX-CNTRB -AMT (P12 . 2) 1 'DB-PRE-TAZ-CNTRB-AMT (P12 . 2) 1 'LOG-COUNTER (P1 5 ) (N4) 1 'MULTll'ETeH 1 'START-T:tKB (11.10) (11.10) 1 'START-DATE (N7) / . in unit. ol! 10 .... . 1 'CPU-TIME-HS 1 'CPU-TIME-HH (N2) (N2) 1 'CPU-TlME-HM 1 'CPU-TlME-SS (N3 . 2) (11.10) 1 'DATE10 END-DEI'INE • INPUT 'MULTlPETCB • ST . SET TIME • 'START-T IME : . 'TIME 'START-DATE :_ 'OAT4U • AT TOP 01' PAGE MOVZ 'OATU Ta '!lATEI0 I!XAKIHB PULL 'DATE10 '- ' RJ:i'LACB Wl:TH ' / ' WRlTE NOTITLI! NOIIDR 'PAGE: ' 'PAGE- NtlMBER 55T 'OATE10 'TlME (AL-8) END-TOpPAGI!: Rl . RD.D MULTI-FIlTeR IMULTIl"IITCR CONTRIB ADD POST-TAX-CNTRB-AMT TO 'POST-TAX-CNTRB-AMT ADD PRB-TAX-CNTRB-AMT Ta 'PRB- TAX-CNTRB-AMT ADD DB-POST-TAX-CNTRB-AMT TO 'DB-POST-TAZ-CNTRB-AMT ADD DB-PRB-TAX-CNTRB-AMI' Ta 'DB-PRB-TAX-CNTRB-AMI' ADD LOG-COUNTER TO 'LOG-COUNTER
,
0500 0510 0520 0530 0540 0550 0560 0570 0580 • 0590 WRITE ' CONTRIBUTION I'ILI: CHECIt SuteO.RI ' 0600 WlUTE 0610 2X ' POST-TAX-CNTRB-AHT ' 0620 25T 'POST-TAX-CNTRB-AMT (EM-ZZZ , ZZZ,ZZZ,ZZ9.99) / 2:.: ' PRIl:-TAX-CNTRB-AHT ' 0630
~--
193
9.5 Natural Monitor Programs
0640 0650 0660 0670 0680 0690 0700 0710 0720 0730 0740 0750 0760 0770 0780 0790 0800 0810 0820 0830 0840 0850 0860 0870 0880 0890 0900 0910 0920 0930 0940 0950 0960 0970 0980 0990 1000 1010 1020 1030 1040 1050 1060 1070 1080
25T 'PRE-TAZ-~-~ (EM-ZZZ,ZZZ,ZZZ,ZZ9 . 99) / 2X ' DB - POST -TAX -~ -ANT' 25T 'DB-POST-TAZ-~-~ (EM-ZZZ,ZZZ,ZZZ,ZZ9 . 99) / 2X ' DB - PRE -TAX- ~- ANT' 25T 'DB-PRE-TAZ-~-ANT (EM-ZZZ,ZZZ,ZZZ,ZZ9,99) / 2X ' LOG-COUNTER' 2<1T 'LOG-COUNTER (EM-ZZZ, ZZZ, ZZZ, ZZZ, ZZ9) // " * OlT 'Record. Read: 16T 'CTR (EM-ZZZ,ZZZ,ZZZ,ZZ9) 01T 'Reco~ Re.d: 16T *COUNTER (Rl.) (EM-ZZZ, ZZZ, ZZZ, ZZ9) J5T 'Wiloh Mu.ltif'a t<::h _ , 54T tMuLTIFB'rCH (EK-Z,ZZ9) / 'CPU-TlMB-MS :_ * Utcl (ST.) ** 'CPU-TlME-MS : _ 189830
""""'"
'CPU-UME-SS
,~,
'CPU-UME-~
,~
'CPU-UME-HH
,~ ,~,
,~
~m
I I I I 11 11
'CPU-uME-MS 'CPU-UME-MS 'CPU-UME-MS
• • •
,0> ,,, '" ,0>
"
I I 3600
'CPU-TIME-~
'CPU-TlMB-~
('CPU-TlMB-HH
'CPU-TlMB-SS 'CPU- TIME - MS
'CPU- TlMB-SS 'CPU- TlMB - MS
('CPU- TlMB- SS
01T 01T 01T 01T 01T 01T
'Tima. ------------'Start Tima . . : 'END TDIZ . . , . : ' 'El.p•• d Time:'
('CPU-TIHE-~
'" '" '"
", ,---------- , '" '*foD/nyy' ---------- TlMB '" 'START- DATE '" fSTART '" *DAT
'" '"
*TIMD(ST. )
'"
(EM-99:99:99'. '9)
--------------------------------------------
01T 'CPU time in 27T 'CPU-TlME-MS / 0 1 T 'CPU : ' 06T 'CPU-TIHE-HH 09T 'hour. ' 15T 'CPU-TlMB-~ 18T '.un' 22T 'CPU-TlMB-SS 28T' •• c' /
m.illi •• c:onda :' (EM-Z,ZZZ,ZZ9)
(EM-99) (EM-99) (EM-99 . 99) /* onl)' t . o .nd bat<::h
rE'rCH Rl!'1'URN 'USR4004P' END
Figure 210:
Monitor - Natural Program Compare Amount Fields
9 Appendix
194
9.5.9
Parse Adabas Report for RPL Flag
.. --------------------------------------------------------------------.... , .... •• .... '"'" •• DWSRPLRP : Check. Adabaa report Eor .cti.... end in.cU .... rap11c:ation . nd c no. t •• th. f:ollowinq H.a t:
••
FNR
RPL
STATUS
TDB
DSSI
0/.
acti .... in.cei ....
Input :
~,
. . OUput :
U
CMPRTOl
-- Adabaa noport NO!'DT,NOSTD
READ WORlt 1 WRITI!: (1)
.. ---------.... --------------------------------------------------------------------.. o.t•
•• 2010/02/11
DIBTER
•• 2010/11/15
er•• t..:! updat"" tor DSBI (log
DISTER
'U
DBF lNE DATA ~ (1.121) 1 'ADAP.J:P-LINB 1 REDBFINB 'ADAREP-LINE
2 'ADARBP-LINB-ASA
(MOl)
2 'ADJUU:P-LlNE-'l'EXT
(Al20)
1 'FIR$T-LINE
,,
(ABO)
'WI!'2-LXNE
(11.080)
RZD!:PlNE fWF2-LINl! 2 twr2-nm (11.04) 2 1WP2-SPACEl (11.02)
,,, ,,, ..,
twr2-RPL
1WP2-SPACB2 twr2-AC'l'-INAC'l' IWF2-SPACl!3
(11.03) (11.02) (AOS) (11.02)
1WF2-TDB
1M3)
IWF2-SPACE4 ,,"2-0SB1:
(11.02) (11.03)
,,.. ,, ,, Im. ,.. on
1 IWV3-OU'l'ro'I'
(A080)
~or
work
(A04/1 : 999) (Aa3/1 : 999) (A08/1 : 999) (A03/l : 999) (A04/1 : 999) (14)
'I'J:LJ: I~
'J.CT-J:NACT IOS81
.... .. ..
/.
END-DBFJ:NB
3
/. a rra y count.r
'"
'NBW-I'J:LJ:
~il .
Ir '-CHJ:NE-CLASS NB 'MAINIP'RAMI!:' DBrINB WOlUt rJ:LJ: 1 'H : \AOAREP\ADAREP39 201002I6 . txt ' DEFINE WOlUt I'J:LJ: 2 'H : \ADAREP\ad.ba. -~laotiv.-r~-20100211.txt' END-J:r J:F '-CHlNE-CLASS BQ 'MAINIP'RAMI!:' DEI'J:HE PRJ:NTER (1) OUTro'I' 'CMPRTOI' END-Ir
.... --------------------------------------------------
J:F '-CHINB-CLASS BQ 'MAINIP'RAMI!:' FORMAT (I) LS- 80 ps- so END- Ir
.. -------------------------------------------------"
-- Initialira tabl. - all
FOR'U _ l IFIL!: I~
TO 999
(lU) (lU)
::_
.~.
~il ••
Ar. not
r~licated
9.5 Natural Monitor Programs
'ACT-lNACT ('11) 'OSSI (':I) .ma ('11) J!ND-I"OR (>, 'PILE .~
'ACT- :INACT
.ma
'DSS:I 'PILE
m,
'ACT-:INACT
.ma
'DSBI
••
'"(>, '"(>, '"''l '"'" '"
,-
,,,,-
,. ,,-
195
'n/.' 'OPT'
'-'
'RPL' 'STATUS' 'TOB' 'OSSI'
,- ,----, ,- ,-------- , ,- '--- ' , ,- ,----
** ------------------------------------** -- Re.d lUJAREP report a nd J!'ill _t.rix ** ------------------------------------':Il :_ 2 RWl.. RBAD WOlUt 1 'ADAREP-LINB
** --
Ii' SUBSTRING I 'ADAREP-LlNE-TBXT, 1 , 15) _ '11. DAR E P 'rIRST-L:IHE : _ SUBSTRINQ('ADAREP-L:IHE-TEIT,1,80) ESCAPE TOP / * (RWl. ) END-Ir
V'
••11'
• •
•
8UBS~NQ('ADAREP-Lmz-'1'EX'1', 1,7) • '* pu. ' 'NBW-PILE ; . TRUE ADD I TO '11 HOVE SUBSTRING('ADAREP-LINB-TItXT, 10 , 3) TO 'i'ILE ('11 ) ESCAPE TOP /* (RWl.) END-Ir
Ir SUBS~NG('ADJUUI:P-LlNE-TItXT. 1 ,20) _ 'RPL ('11) , . 'HS' J:SCAPB TOP /* (RWl . ) END-IP
'ril. i .
r.plic:at..d :
Ir SUBSTRING('ADAREP - LINZ- TEXT,1,41) Replic:at.ion i . inact.i". J!'or thi. J!'il. ' 'ACT- lNACT ('11) , . 'inacti. . ' J:SCAPB TOP /* (RWl . ) END- lI' 11'
8UBS~NG('ADAREP-LINZ-TEXT,1,23)
Raplicat.or tarqat. ID ' 'TOB ('11) ; . SUBSTRINQ('ADAREP-LINZ-TI!XT,tl,4) ESCAPE TOP /* (RWl.)
•
•
END-lI'
Ir
SUBS~NQ('ADAREP-LINE-TEXT,1,44)
Ir
SUBS~NG('ADJUUI:P-LINE-TItXT.1,4")
Coll.ct bel!or. imeqe. ol! updete. 'OSSI ('11) :_ ' On' ESCAPE TOP /* (lun.) END-Ir
Coll. ct bal!or. imeqe. ol! updete. 'D8B:I (':Il) :_ 'OJ!'J!" ESCAPE TOP /* (RWl.) END-Ir END - WOR1t /* (RWl . )
_ r •• '
_ No
••
* * ------------------------------------------** -- Writ.. raport. out. oJ!' _trix
** ••
-------------------------------------------
1 1' *MACBINZ-CLASS EQ 'MAINJ'RAME' WlUTE (1) NO'l'ITLE NOHDR OlT ' - ' (78)
/
OlT *DATN (EM-9999-99-99) *TIME (AL-8) 30T ' Adaba. Replicator Report' 68T ' Paqe ' *PAQ!I:-NUMBJ:R (1)
/
'
196
9 Appendix
OlT *l'ROGRAM
68T *LIBRARI-ID
I
OlT ' . ' (78)
I
.U.
OlT ,rIRST - LINZ (AL-79)
'WI'2-LINE : .
,-------------------------------------------------------------------
tflUTZ WOU FILl! 2 twr2-LINl!
OlT *DATN (EN-9999·9g·gg) .TIME (AL-8) 30T 'Adab •• Replicator Report' S8T
.PAGE-NUMBER (0)
'P.~·
I
OIT *PROORAM
'" I
seT *LIBRARI-ID OIT '·'(78)
I
'WI'2-LlNE : _ 'FIRST-LlNE WRI'l'B wau FILE 2 fWP2-LlNE 'WF2-LUlE : _
,------------------------------------------------------------------fWP2-L:INE
tflUTE WORit !'noB 2
'WF2-LlNE : . '
,
END-Ir
••
PI. pop. In • 1 TO 51l1l1 U' 'rIU('U) • ' , ESCAPI! BO'l'TOM (PI.)
Ir *NACHINZ-CLASS EI;l 'IO.INFRANI!:' WRI'1'B
(1)
OIT 'FILZI'Il)
OST '1U'l.('Il)
lOT 'ACT-lNACT (tU) lOT 'TDB (tU) 2ST 'OSBI (,n)
BLSS U'ILI!(1l1)
....,-~
twF2-SPACl:l
IWF2-RPL
twF2-SPACB2
1wr2-AC'l'-INAC'l'
fWF2-SPACB3
IWr2-TDB
1WP2-SPACE4
,
twF2-DSBI
.... ....
BN!;I-IF
END-raR , .
'" '" '" ,. ,. ,. ,.
'R1'LI,n) 'ACT-J:NAC'r ('U)
'=81'11) 'DSBI('U) ItIF2-LlNE
(rl,
Wri t. Work Pil. 3 with ADADBS comman~ ADADBS RBPLlCATION PILB-006,ON,TARGET-302,DSBI-on
r2. FOR '11 • 1 TO 999 IP 'RPL('Il) _ 'lES' AND 'ACT-INACT('Il) • 'inaetiva' COMl'RESS 'ADADBS REPLICATION PIL&-' 'nLJ:('U)
, ,ON, TARGI:T- '
'mB('U)
.
, ,DSBI-oPP' INTO twF3-0UTl'UT LEAVING NO SPACE
WRITE
1fC)RJI;
END-Ir END-FOR ,. P2 .
PILJ: 3 'WI'3-0UTl'UT
~
Figure 211:
Monitor - Natural Program Parse ADAREP for RPL Flag
9.5 Natural Monitor Programs
197
9.5.10 De!ermine Highes! ISN Curren!ly Used
· ---------------------------------------------------------------------• rSNHICH • Thi. i • • eommon module whieh tind. the hiqha.t rSII currantly • u .ad in tile .
• • • ---------• E.rly an • 20ll/01/28 • 20ll/03/25 • • • • • • • • • • O .~
Lewi. Pritch.rd N•• Module Die tar Storr adaptad tor a e1ient !.arry F r ."in moditied tc look tor . 11 tile. in a .paeitiad databa.e raqu •• tad by INPUT 8tet. . .nt. ooe. a direct call LF to dater.in. ti1e . xi.ta , and i t &xi.t. tollow. with • 2nd direct call Ll with '8' in CB-OOP2 tc q . t tha t i r . t unu •• d lSN, .ubtr.et 1 tram th. r •• ult. , and th. ra . u1t. i . th. 1 •• t u.ad 18N. Nota: i . not n ae •••• ri1y the hiqha . t lSN " . cord load..:!.
· --------------------------------------------------------------
OEPlNE DATA LOCAL 1 'H:IGHEST-:ISN (P10)
/
...................................................................... .
/. /. /.
/
ooPl11:1;1 FRCM USRl04lP LlaRARY SYSBrY Thi . proqr ... . erve • • • e xampl e how to da.iqtl a u .e r - datinad proqr... tc c.l1 ' USRl04lN' .
...................................................................... .
'-"'AL 1 CONTROL-BLOClt (ASO) 1 REIlEFnnr: CONTROL-BLOC!\. 2 CB-RESERVED (B02) 2 REDEFINE CB-Rl:8ERVED 1 FIRST-BYTE (BOl) 2 CB-(:MD (A02) (A04) 2 CB-CID 2 CB-FJ:I.J: (802) 2 REDEPINE CB-PILE 3 CB-DBID (BOl) (BOl) 1 CB-1"tIlI. 2 CB-R8P (B02) 2 REDEPINE CB-RSP 3 CB- DBID - ALT(B02) 2 CB-ISN (B04) 2 CB - lSL (B0 4) (S04) 2 ClI-ISO 2 ClI - PBL (B02) 2 ClI-RBL (B02) 2 ClI - SBL (B02) 2 CS-VBL (802) 2 ClI-IBL (B02) 2 CS-001'1 (A01) 2 ClI-OOP2 (AOl) 2 CS-AIlDl (AOS) 2 ClI-AIlD2 (A04) 2 REDE F INE CS-AIl02 3 CS-J\DD2-2X (A02) 3 CS-SUB-OODE(B02) 2 ClI-AIlD3 (AOS) 2 CB-J\DD4 (A08) 2 ClI-AIlD5 (AOB) 2 CB-CT (A04) (A04) 2 ClI-UA
,.
/. /" /. /"
H ' 30 ' tor 2 byte t i le. C - . . d eoda CODDand ID 2 byta t i le numbar
/" D. te b •• e 10 /. Pil . numba" /" Ra.pan.a eoda /
2 byta DBI0
/" /. /" /. /. /. /. /" /. /" /. /" /.
D.te b •• e 10 (altern.ta) ISII ISN lowar lim.1t rSH quant.1ty Po.,..t butte r l e nqth Racord butte " 1 e nqth Se.reh bu tte r lenqth Va1ue butte r 1enqth ISII butEe " 1 e nqth Command option 1 CODDand option 2 Addition. 1 Addition . 2
/" /. /" /. /" /.
8ub Coda r e.ult. Addition . 3 Addition , 4 Addition . 5 Command U U.e" ."e.
198
9 Appendix
1 I'QRMI\.T-lIU~ (AlOOD) 1 REDEPlNE PORMAT - BUFnR
,,,,,-
2 IQRMAT-ADOR
(7.01)
I Rll:CORD-B~ (ASOOO) 1 REDEPlNE RECORD-SU!'FBR 2 _CORD-ADDR
(A01)
I SKARCH-BUPTER (JUOOO) 1 REDBPINB SEARCH-SUl'FBR 2
SEARCH-ADDR
(A01)
I VALVE-BUIPTER (JUODO) 1 REDEFINE VALUB-BUFFER 2 VALUlhlUlDR (ADl) I ISN-BurnR (JUOOO) 1 REDEFINE ISN-BUFFBR 2 ISN-ADIlR (ADl)
I RESPONSE
(lOt)
'FlLE- NR
(N05) (A02) (N05) (NOS) (NOt)
,,, Ix ,,
IDDID
'l'tRST-I'ILE 'NO- OP- PIlZS
END-PBI'INE INPU'l'
'&nter DBID:' 'DBID 'St&rting PNR :' 'FIRST-PILE 'No . ot Lil •• : ' 'NO-OF-FILES
11' 'DBID _ 0 RIIIMPUT 'DBID 1 .
0, pI • • •• a ntar • non-,..ro v.lu.'
END-l I'
11' 'FIRST-PILE _ 0 'FIRST-PILE :_ 1 WRlTE 'Pir a t fil a . a . END-lI'
not
pro~i~d,
••• ~ a tart with fil a I'
11' 'NO-OF-PILES _ 0 'NO-OP-FILES : _ 10 WRlTE 'No. of fil • • •a. not provided, • • au.. naxt 1 0 fil •• fram l.t ' 'file will
~ ~ . pl.yed'
END-lI' MOVI! ALL K'OO'
1'0 CONTROL - BLOCK H ' 30' 1'0 J'lRST-EjYTl!: 'OP' 1'0 CB- CMD MOVI! 5000 TO ClI-QL MOVZ 1000 TO ClI-ISL ClI-FBL ClI-SBL ClI-VBL ClI-IBL MOVZ 'ACe- .' TO _CORD-SurFER. RESET CB-ADDI CB-ADD2 ClI-ADD3 ClI-ADD4 ClI-ADD5 PERFORM CALL-ADABAS
<------------------------
.tart h . r .
WRITZ 'OP CMD Re: ' RESPONSE
roR 'FILZ-NR noN 'FIRST-FILZ TO 'NO-OF-FILES ClI-FILE : . 'FILZ-NR , _ 'Lr' ClI-COP2 : . ' s'
CB-CMD
PZRFORM CALL-ADABAS Ir RESPONSE . 17 OR • ESCAPZ TOP END-Ir
200
199
9.5 Natural Monitor Prog rams
R . R&PEAT CB- QG) , . 'Ll' CB-CQP2, . 'F' l'BRPOIUf CALL- ADABAS DECIDE roR F:IRST CQtm:IT:ION WHEN RESPONSB • 17 OR • 113 Oll. • ESCAPE BOTT(H (R , ) WHEN RESPONSB • 0
200
''''''~
W~_
•
WlUTE , _ , _SPON$I!: 'rNR,' ' F II.J:-NR END-DECIDE
'HIGHBST-ISN , . CB-ISN 'HIGKEST-ISN , _ 'HIGKEST-ISN - 1 WlUTB ' OBIO, ' 'OBIO 'rNR,' 'FlLE-NR 'HIGHBST ISN,' 'HIGHBST-ISN ESCAPE BOTT(H BND-REPEAT END-roR
·•• -----------------------------------------------------------
DBrINB SUBROUTINB CALL-ADABAS MOVE 'OBIO TC CB-OBIO-ALT
•
CALLNAT ' USRl043N' CONTROL- BLOCII: ro::lRMAT-ADDR RECORD-ADDR SDRCH-ADDR VALUB-ADOR :ISN-ADOR RESPONSB
•
DBCIDB FOR FIRST CONDITION WIIEN Rl:SPON$I!: _ 17 WRITB ' THIS FILE DOBSN" T BlUST " 'nLE-NR WIIEN Rl:SPON$I!: _ 113 WRITB ' THIS ISN DOBSN"T BltIST , , 'nLE-NR WIIEN Rl:SPON$I!: _ 200 WlUTB ' No acc. •• to thi. fil. , , 'FlLE-NR WHEN Rl:SPONSB NB 0 WlUTB ' ADABAS ~.pona. Coda ,' RESPONSB ' . ' CB-QG) ' rNR ,' ' F lLE-NR I 'ae : ' CB-SUB-CODB
-,-
IGNORl: J!ND-OECIOE END - SUBROUTINB
· -------------------------------------------------------------
Figure 212:
Monitor - Natural Program (SNHIGH - Check Highest (SN
200
9 Appendix
9.5.11 RPL30REP - SLOG Check
.. --------------------------------------------------------------------.. .... .." .... .... .... .... .. ---------..'. --------------------------------------------------------------------EVlI:NT REPLJ:CA'l'OR. Per:formanc. Proj . ct •• RPL30RII:F : Read th. Adabaa r.port o:f :fil. 30, OB312 , "r.oat.d by SYSAOS in ba t"h •• Input : CMNKFOl - REAl) WORK 1 SYSAOS r~rt o:f :fi1. 30 (SLOG) Main :fr . . . , ST.AOAOBA.Rll:PP30.0B312 Wiru:lowa: Z: \Repli"ator\xxx. txt output: CMNKF02 - WRITB WORX 2 Main:fr. . . : DIEH:R . Ri'1P'J'30.0B312 Wiru:lowa : Z: \a.pli"ator\a n . txt Pro.,. •• : Cha"k th. Adaba . SLOG ADAREP r~rt :for : - Hi9h r."ord uaa98 - Hi9h . pa". u a a9a Re1."ant Adaba a R. port lin •• : REPlolNES (1: 99) ""ray : Reaaon tor chanqea
~'"
•• 2010-12-16
DSTORR
cr.at.d
OEPlNE OATA ~ ' . -- Input Work r i l . 1 IINPUT (Al33) 1 REDEI'INl!: 'J:NPUT ,~ (A01) 2 'ADALOG-LJ:Nl!: (Al32) 1 IINI'O-LlNE (AOSO) •• -- OUtput Work r i l . (Al33/1:500) 1 'REPLINES 1 IFOUNDl (N2) (N2) 1 '1'OUND2 (N2) 1 'FOUND3 (N2) 1 'l'OUNDf (N2) 1 'FOUNDS (N2) 1 '1'OUND6 (N2) 1 'FOUND7 (Fl0) 1 'START-Rll:F 1"
,
."
..
END-OEPINE 11' .NACHINE- CLASS NE 'MAINPRAMI!!' DEFlNE WORK FILS 1 'Z:\R.plicator\." DZPINE WORK PILS 2 'Z:\Rap1i"ator\ •• ' END-Ir
1.0 :for t.ata on a pe
.. .... ---------------------------------------.. ---------------------------------------.... --
~~
.ERROR-TA : . 'PER-PERR' END-ERRl)R
•• -- P.aad at.tiati"a and :fi11 array
'START-REP : .
rALSE
~
READ WORK 1 'ADALOG-LINl!:
11' 'START-REF • rALSE EX10MlNE 'IoOALOG-LlNE VOR " •••• A D A B A S GIVJ:NG 'POUNDl
BASIC
SBRVICBS ••••• '
9.5 Natural Monitor Prog rams
201
IF 'FOI.INl:Il G'l' 0 'S'l'AR'l'- REP , . 'l'RUE
'1 ,. 1
•
•
• ••
'RI!PLlNES(tl) 1000 1 TO '1 ESCAPE TOP , END-IF END-IP
,.
'ADALOG- LINE
(RII'l . )
IP 'START-REP _ TRU!!: EXAMlNII: 'ADALOG-LINE rClR GIVING 'rouND2 I F 'FOI.INl:I2 GT 0 'START-REP , . TRUE 'R&PLINII:S(tl) , _ 'ADALOG-LINE 1000 1 TO '1
EXAMlNII: '1oOlU.OG-LlNE roR 'OATAl ' GIVING 'rotJNDJ IF 'rouNDJ GT 0 'START- REP , . PALSE 'R&PLlNES('I) , . '1oOlU.OG-Ll NE ESCAPE BOTTOM , - (R1.) END-IF 'R&PLlNES('I) 1000 1 TO tl END-lI'
, _ 'loOlU.OG-LlNE
FORt. FOR U
_ 1 'l'O 500 11' 'REPLINES I 'I) • ' ICSCAPE BOT'1'Cti
END-l I' ~R WORK F ILE 2 'REPLINES (tI) END-rClR , - (FOR1.)
••
_. ------------------------------------------------_. ------------------------------------------------•• • • -- Ch."k a",,,ay to", ",. "ord. loa dad an
~"
*DA'l'41 ' - ' .TIME '- Roopo",t: ot S1.OO Fil. nrro 'INI'O-LINE WRITl! WORJt PILE J UNI'O- LINE
JO OBJ12 -
••
FOR2 . roR tl • 1 TO 500 11' 'REPLINlCS('I) • ' ESCAPE BOTTOM
••
••
u . a~
END-l I' lCZAMlNE 'R&PLlNES(tI) FOR ' Racord. l "..dad ' GlVING 'FOI.INl:I4 1 1' .romm4 !i'l' 0 'INI'O- LINE ,_ SUBSTRING('REPLINESI'I ) , 4 , J2) WRITI! WORJt I'lLl: J ' INI'O-LlNE END-lI' BVoMlNE 'REPLINES (tU FOR ' ASSOI JJ90 Ull ' GlVING ' FOI.INl:I5
'
. PROQRAN
202
9 Appendix
U' 'lI'OUND5 GT 0 CONPRESS
'ur .pace a Uoe.tad (blk):' SUBSTRING ('PJ!PLlNES (U) ,11.08) '111: .pac. un" •• d (blk):' SUBSTRING l,gPLINES (U) ,63,08)
INTO
'INFO-LrKE
WRITI! WORlI: PILZ 3 fINFO-LINB
••
IDIII-II'
EXAKINJ: 'REPL:lNII:$(fI)
raR 'ASSOl 3no RlI'
GIVING 'FOUND6 I r 'FOUND6 GT 0 COMPRBSS
'NI . pace a llocat.d (blk):' SUBSTRING('REPLlNES('I) , 17,08) 'NX . pace "nu•• cl (blk):'
..
SUBSTRING('REPLlNES('I) , 63,08) INTO 'INWO-LINZ WRITI!: 1fORII> FILZ 3 'INFO-101NB ENIl-II' EXANINl! 'UPLlNES(fI) I'OR 'OATAI 3390 DS1' GIV1NG '1'OUND7 11' 'rot1ND7 GT 0 COMPRESS
'OS . pac.
alloe.tael (blk):'
SUlJSTRZNG ('REPLINB8 ('1:) ,17.08) 'OS .pac. unu •• d (blk):'
SUBSTRJ:NG('REPLlNES('J:) ,63,08) INTO 'INPO-LlNE WRITB 110_ ru.J: 3 'nO'O-L:INE
.. '* BND-II'
END-roll
Figure 213:
(1'OR2.)
Monitor - Natural Program RPL30REP - SUX:; Space Check
203
9.5 Natural Monitor Programs
9.5.12 READF30P - Read SLOG Content 0010 •• - - ----------------------------------------------------------------0020 •• READF30P : READ SLOQ, Li1. 30 oL ~ptor OB 312 0030 •• Writun by 1>1. t . r Starr - 14 O . . , _ r 2010 0040 0050 0060 0010 0080 0090 0 1 00 0110 0 1 20 0130 0140 0150 0160 0110 0180 0190 0200 0210 0220 0230 0240 0250 0260 0210 0280 0290 0300 0310 0320 0330 0340 0350
• • ------------------------------------------------------------------DEPlNE DATA LOCAL , . DB312 Hx 1 ST-SLOQ VIZW OF ST-SLOQ-312 2 AA-PIEUl AB-FIELD AC-FIEUl AD-FIEUl g-FIEUl Ar-FIEUl AG-FIEUl AB-FIEUl C·AN-FIBLD lW-I'IEUl (1: 10) AO-FU:Ul C·JIR-I'IBLD AR-I'IBUl (1 : 1 0) DA- I'IEUl C·SS-I'IBLD SS - I'IEUl (1 : 10) /" A2S0
,,, ,, ,, ,, ,, ,, ,,
, ,,, .ro ,, ,, ,,
(1'10) (N4) (N4) ~ (11.16) ~-"" 'I'ILE-COUNT (N4) 'READ-COUNT (N10) (ASO) 'STRING (NOS) (12) INIT 'DELAI
.".,.
END-DEFlNE •• 0360 AT TOP 01' PAGE 0310 WRITJ:
0380
/
0390
/
<>,
1'11. N _
, --------------------
I$N SLOQ'
--------
0400 BND-TOPPAGE 0410 ••
0420 R1. READ 0430
0440 0450 0460 0410 0480
ST-SLOG BI ISN STARTING FROH 1 EJt»aNE SS- I'"IBLD (2) I'OR ' ST - ' GIVING POSITION IN 'PO 11' 'PO GT 0 THIW MOVl! SUBSTRING(BB - I'IEUl(2) ,'PO) TO SS-QUT WRITE SS-QU'l' " ISN END - lI' ADD 1 TO 'READ-CQUNT
•••
0600 END-READ
0610 11'" "COUNTER (Ri . ) _ 0 0620
WRITE (0)
'No r . corcb Lound in SLOG Li1. 30 in DB 312'
0630 BLSIl 0640
WRITE (0)
'Nulab.r oL tran •• ction. in SLOQ:' 'READ-COUNT
0650 BND-II'" 0660 END
Figure 214:
Monitor - Natural Program READF30P - Read SLOC Content
204
9 Appendix
9.5.13 RPL·P002 - Compare File Component. 0010 •• 0020 • • EIIEN'l' REPLlCATOR ~ rfo~n .,. Proj a clo RPL- P{)02 , a.ad tha Adabaa a.port from tha ..... infr.... 0030
0040 0050 0060
0070 0080 0090 0100
OllO 0120
0130 0140
0150 0160
0170 0180
OUO 0200
0210
•• •• •• •• •• •• •• •• •• •• •• •• •• •• •• •• •• •• u
R40ad th. Ad.aba a a.port from tha •• rve"
Input :
c:MWU'Ol - R&AD WORJ; 1 (HBF02 - REAl) Jf()Rl!; 2
REPLlCATOR r . port • Hainf".... : ST . OBI!. . TI)(: . RPLI'MPMB , DDPRl:NT . nB0109 . OUTLIST CMilKF03 -
WlU'l'E WOR:K 3 -
EXCl!:L
fo~t:
GIlt tha valu •• tor DBJ:D
or
Datat> • ••
Fila ~C
lo.~
TOP I Sß o r Top I SN HAXISN or Mo.,,~ ISN a xpooet"" lu:ray:
OBID(1:999) - FNR (1 : 999)
Dat. •
N_
RIo •• on for chanq ••
DSTORP.
er• • t..:!.
----------
0220 •• 2011 - 01 - 26
0230
Z : \R
Winde... :
Ouput: Pro.,. •• :
u
0240 0250 0260 0270
•• --------------------------------------------------------------------DZFlNE DATA LOCAL •• -- I nput Work Pil. 1 'ADAREP-LlNE (A133) 02BO . . 0290 1 'OU'l'PUT-LINII: (AI20) 0300 0310 (A03) '08101 (&03) 0320 '08102 0330 'JU:CLOD-OBl (A12/1: 999) 0340 'JU:CLOD-Oa2 (A12/1: 999 ) ''1'OpISN-OBl (A1 2/1: 999) 0350 0360 ''1'OPI SN-Oa2 (A12/1: 999 ) 0370 'MAl[J:SN-OBl (A12/1: 999) (A12/1 : 999) 0380 'MAl[J:SN-Oa2 0390 0400 'I-FNR-ALP
,,•• ,, ,, ,,
••
0410
0420 0430
"" "••• "
U-FNR-NtlM
"." (N3) (N6)
..
OHO 0450 JmI)- OEPINE 0460 0 4 70 IP *to.CIIIN!! - CLASS N!! ' HAINPRAMI!:' 0480 OJ:P IN!! WQRK PILI! 1 ' Z: \AIlARJ:P\AIlARJ:P39 FILI! RPt. 20110127 . txt ' /. 08039 0 4 90 OErIN!! WORK PILI! 2 ' Z:\ADAREp\CSTOOB 08 251-ADARzP 20110127.txt' /- 08251 0500 oJ:rnnr: WQRK PILI! 3 'Z: \AIlARJ:p\08039_08251_etHPAR..ISON_20110127 . txt ' / . O\lt 0510 JmI)-Il' 0520 - 0530 ON EMOR · J:RRQR-TA : _ 'P&R-_ ' 0540 0550 JmI)-EAAOR 0560 - 0570 - - ---------------------------------------0580 - - -- ~ad Adar~ _infr_ and fill a rray 0590 -- ---------------------------------------0600 - -
0610 RIfl . 0620 REIUI WQRK 1 'lUIAREp-LJ:NJ: 0630 - - -0640
0650 0660
0670
IP
SUBSTRlNG('lUIAJU:P-LINE,02,32) . ' A 0 A RE P 'OBIOI :_ SUBSTRING('ADAREP-LINE,37 , 3) ESCAPE TOP END-Ir
va . l
SN3
OBIO . '
205
9.5 Natural Monitor Programs
0680 0690 0700 0710 0720 0730 0740 0750 0760 0710 0780 0790 0800 0810 0820 0830 0840 0850 0860 0870 0880 0890 0900 0910 0920 0930 0940 0950 0960 0970 0980 0990 1000 1010 1020 1030 1040 1050 1060 1070 1080 lOgO 1100 1110 1120 1130 1140 1150 1160 1170 1180 1190 1200 1210 1220 1230 1240 1250 1260 1270 1280 1290 1300 1310 1320 1330 1340 1350 1360 1370
U'
SUlISTRIIiG ('JU:lAREP-LIIlE, 02,09) _ ' . I'il. U - FllR- ALP , . SUlISTRIIiG ('I.DAlU!P- LllIE, 11,3) 'I-FllR-1IUM , . VAL(lI-FllR-ALP) END - lI' Ir SUlISTRIIIG('AIUUtEP-LIIlE,02,20) _ 'TOP-ISII . ' 'TOPISII-DBl ('I-FllR-IlUM) : . SUlIS'l'P.I1IG ('JU:lJlREP-LINII ,24,12) END-lI' 11' SUlISTRING('JU:lJlREP-LINII,02,20) • 'MJIX-ISII z.xp.et.d . ' tMAxl:SII-DBl ('I-FllR-IlUM) : _ SUlIS'l'P.IIIG (lADAREP-LIIIE, 24,12) END-lI' Ir SUlISTRING ('JU:lAREP-LIIlE, 02,20) • 'beorct. Lcac:lotd . ' 'RZCLOtl-DBl (lI-FllR-IlUM) : . SUlIS'l'P.I1IG (lJU:lJlREP-LINII ,24,12) END-lI' END-WOU .. •• ---------------- 2nd r . port RW2. /. noad on. JU:lJlREP •• rv.r RBJU;I WOlIlt 2 'JU:lAREP-LINII
.* --
SUlISTRIIIG (lJU:lAREP-LINII, 01,24) • '%I.DAlU!P-I-DBON, databa • • ' 'DBID2 : . SUBSTRIIIG('I.DAlU!P-LINII,26,3) ESCAPZ TOP END - lI' 11' SUlISTRIIIG(lJU:lAREP-LIIlE,13,07) • " I'il. ' U - FllR- ALP , . SUlISTRIIIG('I.DAlU!P- LINII,22,3) 'I-FNR-IIUM : . VAL('I-FNR-ALP) ESCAPE TOP END-lI' 11' SUlISTRING(lJU:lAREP-LINII,01,09) • 'Top ISN: ' 'TOPl:SII-DB2 (lI-FNR-IlUM) : _ SUlIS'l'P.ING ('ADAREP-LIIIE ,20,12) END-lI' Ir SUlISTRING('AIUUtEP-L:IIIE,37,21) _ 'Max~ ISN _ e t . d : ' IMJIXISII-DB2 ('I-FllR-IlUM) : . SUBS'l'P.I1IG ('JU:lJlREP-LINII, 68,12) END-lI' 11' SUBSTRING ('JU:lAREP-LINII, 01,15) • 'beord. loac:lotd: ' 'RZCLOtl-DB2 (II-FNR-IlUM) : _ SUBS'l'P.ING (lADAREP-LIIIE ,20,12) END-lI' Ir
END-WOU .. COHPRESS FULL 'PILZ-mt' TOPISII ' 'DBIDl TOPISII' 'DB:ID2 RZCLOtl' 'DBIDl RZCLOtl' 'DB:ID2 MP.XISII' 'DBIDl MJlXISII' 'DBID2 INTO 'OU'l'PUT-LIIIE WRITI! WORJI: 3 'otJTPl1'r - L:INII .. COMPRESS FULL ------- ----------
----------
INTO 'OU'l'PUT-LIIIE WRITI! WORP; 3 'otJTPl1'r-LINII u 1'1. roll 11 _ 1 TO 999 11' 'TOPISII-DBl ('I) 'TOPISN-DB2 (11) 'IlBCLOD-DBl ('I) 'IlECLOD-DB2 ('I) 'MlUI:ISN-DBl ('I) 'MlUI:ISII-DB2 ('I) ESCAPE TOP END-:IP COKPRESS FULL 11 'TOPISII-DBl ('1)
AND AND AND AND AND
----------
----------
----------
----------
206
9 Appendix
1380 lTOPISN-D1I2 (lI) 1390 IUCLOD - D1I1 (11) 1400 IUCLOD-D1I2 (lI) 1410 hOJ[ISN- D1I1 (11) 14 20 lMAXISN-D1I2 (lI) 14 30 INTO lDU'l'PUT-LINIl 1440 WRITJ: W01Ul 3 lDU'l'PUT-LINE 14 50 JmI)-1'OR 1460 ZN!)
Figure 215:
9.6
Monitor - Natural Program RPL-POO2 -Compare File Components
WCP Log Windows
15:53,08.6301>&1560 LIflt : (0.) _ N&1560 LIflt: (I"IRST) thr.acl block 0081:2 400 15:53:0.8.630. bo.1560 LIflt : Set 10 - th.,..d 0.081:2100. 15:53:08.630. bo.1 5 6o. LIflt : B.t 10 10010.10 T t.n'1th-U/Ox 18 Buf'f'..... o.x 140f_4 000.0: 02001800 CODC420C CODCUOO C6UB2A8 .... i.Ö1I.i.iiB.aZ· .... ( ... ( ... 1" .. '1 0010.: 1:50C8I06 0~C5D103 /o..t.vj..6 V.f' UPL 15:53:08.630. bo.1560 LIflt : S.t 10 - lUD dOa> 15:53:08.630. 1>&1560. LIflt: (SU) lUD len 3 MAlt 64 15 :53:0.8. 630. bo.1560 LIflt: (SU) UIO-&1560 LIflt: (AC) Alloc cn (00BBA1EB-004a.Br?4) 15,53 ,08 . 630. bo.1560 LIflt' (AC) Alloc cn (00BBAU8-0D481JfT41251 - 251) 15:53:0.8.630. bo.1560 LIflt: (AC) CTX-&1560 LIflt: (&A) - TIIREAD con"'nt " ith Butt.r Addr ••••• Loon'1th-11484/0 ,,2cdc Butf e".o._2 'dO 000.0: 680.0000.0 00.0000.00. ECBI'4BOO B85181:00 k ...... . iL"' .• 0'0 . 0010, C052BEo.O 1'B000o.OO 0.2001800 CODC420o. 0. ..•...• i.iiB. ( ........... (. 00.20: CODCUOD cnr.a2All E5OC8606 01K:50103 AiiB . .a!' '/0.. t. vj.. 6 ( ... I' .. yV.f' REPL OOlO: 000.000.0.0 0.0.000.0.00. 0.00.00.000. 0000.0000. LINZS 0040-2880 SNIZ AS LINZ 00.30 2BIIO: 00000000. 0000000.0 A868BJ:00 I'868BI:OO ....... ''1'' .B. 2BAO: Cl6BBEOO 00000000. 000.00000 00000000 0 .. 2BBO, 00000000 00000000 00000000. 000.0000.0 2BCO: 00000000. 0000000.0 00.0000.00 0.0000.000 2800: 000.00000 00000000. 000.00000 C85381:00 ....... . .... BS". 2B80, 040000.00 00000.000 00000000. 000.0000.0 2BI'O : 00000000. 0000000.0 00.0000.00 0.0000.000 LINZS 2co.O-2CBO SAMZ AS LINZ 2Il1"0 2CCo.: 0.0000.0.00 0.000.0.00.0 0000.000.0. 3621:3121: . . . . . . . . . . . . 6.1 . 8.0.3. 2CDO: 38283033 0000000.0 00.0000.01' 15:53:08.630. 1>&1560 LCL: _ Surt LCL 0&11 Surt LCL call 15 :53:0.8.630 bo.156D LCL: p711b 00BE240o. 15:53:08.630. bo.1 5 6D LCL: (CVT-I NI 8BCDIC -) ASCII conveuion required 15:53,08.6301>&1560. LCL: (CVT-III) BYTE OIIDER conveuion nquired 15 :53:08. 630 bo.1560 LCL: (CVT-I N) ca in t.n'1th-80/0x5o. Buf'f.r-0_6Ba8 0.00.0: lD4oo51"2 UCC6UO 0.0110.0.0114 00.030._ OQÖODÜ· . . . . . . 11 . N2 . . . . •. 0010., 00.0000.0.00.0.000.0.00 o.2CBo.333 000.0000.0. ......... i!.3. 00.20: 0000.4040. 40404040 '0.40'0.40. 40404040 .. 11118118811181
.u....
.•.
9.6
wep Log Windows
207
0030: 40404040 40404040 40404040 40404040 nUU8UUUU8 0040: 00000000 00000000 00000000 00000000 15 : 53:08.630 b007S60 LCL: (CVT-Ilf) CB out x..ngtb-80!0"SO Buff.r-O_68a8 0000: 30'04&32 6066CCU ~OOO~'OO 01:0~0300 0 8H2 · tiO .. ~. D. .. . . . . . • . 0010: 0000000000000000 CB023303 00000000 ... i.3. 0020: 00002020 20202020 20202020 20202020 0030: 20202020 20202020 20202020 20202020 0040: 00000000 00000000 00000000 00000000 15:53:08 . 630 b007S~0 LCL: pCI> OOBU8A8 15:53:08.630 b007560 LCL: CB (IH) l.oM>gth_ BO!0,,50 Butt.raO_na8 +.- .....•. 0000: 30'OU32 ~066CCU ~OOOUOO 01:0~0300 0@H2·fiD .. ~.P. 0010: 00000000 00000000 ClI023303 00000000 • •1.3. 0020: 00002020 20202020 20202020 20202020 0030: 20202020 20202020 20202020 20202020 00'0: 00000000 00000000 00000000 00000000 15:53:08.630 b007560 LCL: .... ada 1d don. t.o CE TRUJ: lS:53:08.~30 b007560 LCL: DBID 251 DBltll"O.t ooiESr8C 15'53:08.630 b007S60 LCL' DBIO 251 toun 03 00 15:53:08.~30 b0015~0 LCL: _dfy: butt . . . . . .k 0003 15:53:08. 630 b007S60 LCL, ~"' d typt> 2 15:53:08.630 b007560 LCL, "ri~.r: DBID 2!1l lS:53:08.~30 b007S60 LCL: (1) : . . ;10" _ ~ • • inol: _ 1. _1 _ 8. p1 _ 3 15,53,08. 630 b007S60 LCL, opton" ... , DBID 251 valid v.ra "' 1 15,53,08.630 b007560 LCL, Input PB x..n'1th_7H/0"2~ Bu1'1'..... O_68fB 0000, CIC16Or8 68076BCl C26OI'SI'O 6BC16BCl W.k~~iliA Mo.8.P .AB.50 ."," 0010: C3~Bnrs 6BCl6BCl CU8f"\1~8 Cl6BCIC5 AIti'oo!i~iliJ.i C.15.".AD.e,".JI.& 0020, 6B1'16BCl 6BCICUB FUBCUB D4C16BI'l lu'Ilti.kAD./lili6AJm .1 ,",M, 1.",Mi\ , 1 0030, 6BC16804 C2~BI'lI'O 6BC16BCl CHaFll'O iliOi.kMki.k.ükM .",MB.I0 ,"."1.10 0040: 6BCl6BCl D16BI'll'O 6BC16BC1 0268'168 ~oki.ltJ.Oltnlt . ",,",,.10,"._. 1, 0050, C16BCID3 6U'l6BCl 6BCID'6B FUBCUa i.kA6~/lili ".AL.l ,",NItA .8r, 10 , ",8~, 13 , " 01CO, 6BC3C16B I'16BC16B C3C26Br6 6BCUBC3 l
.","1'
".BQ.
208
9 Appendix
15 ' 53:08.6301:>0.1560 LCL ' HO" eh. OI< RB/IB 15 : 53:08.6301:>0.1560 LCL : Input RB :t..nqtb_ 81g/0,,333 Bul!l!.r-0_6b.=3 0000, 00000000 0000005r OgC9nre r 9r3,.,r6 ... . ... _~o+ ö
. .. .. ... RI289316
0320, oooooon 1"il1"il1"31"il 1"~1"il1"11"2 1"il1"01"31"0 ... o,,-"'li0656a ... 20030~0120030 0330, r9l"3ro UOtI 930 1553,08 . 6301:>0.1560 LCL , lToUl .. 1619 , cb_ott..t .. 180, ""'_ b_lnq .. 1619 15 :53:08.6301:>0.1 5 60 LCL : AllAßA8 u •• r-qu. ue handl. _ 15 :53:08.6301:>0.1 5 60 LCL : vio .. rit.uu: DBID 2 5 1 15 , 53,08 . 6301:>0.1560 LCL , ... iow .. it.uu , . tU ch..:! butt... h • • 0.1 5 60 LCL : ... iowrit.uu, procoo . .inll ACB ro.qu ... t on OBIO 251 conv .. rtinq t.o ACH 15 :53,08.6301:>0.1 5 60 LCL : NP USRIPC walTE X (2 5 1-00BZ6010- 5 -0140n:60-0(-I609486212(124612U) 15 ' 53 : 08.6301:>0.1560 LCL ' v .. it.u.r, ti ..... l ... _ _ • • 0 15 :53,08.6301:>0.1 5 60 LCL : ... actu.r, OBID 251 15 : 53,08.6301:>0.1560 LCL : vior.aduu : DBIO 251 iIOYCnt 2 15 ' 53 : 08.6301:>0.1560 LCL , vior.actu ... , . tUch..:! butt. .. _0.1 5 60 LCL : ... ior.aduu : procoo. . ;'nq ACSX ro.qu ... t on OBID 2 5 1 conv .. rtinq I:>o.cJc t.o ACB 15 : 53,08.6301:>0.1560 LCL : NP lISRIPC RU.D X (251-00BE6010-2-0140rc90-0 I Ull24?6360) 15 : 53:08.6301:>0.1 5 60 LCL : vior.adu ... : ""Pr bul!l!. r 1:>o.c:1< tor an ACB/ACSX ro.quo. ... on WIlD 251 15 :53,08.6301:>0.1 5 60 LCL : con .... rt t.o aob : DBIO 25 1 15 : 53,08.630 1:>0.1560 LCL : l . n u ••;.bd- 8 15 :53,08.6301:>0.1 5 60 LCL : pdat pointinq t.o ti ... t AB butt. r addro. . . 02urllCB 15 :53,08.6301:>0.1 5 60 LCL : ca (IH) Lenlltb_ 80/0,,5 0 autt ..... O_68a8 0000, 30tOn32 6066CCU 90009tOO 08060300 O@H2 · tio . . . P. + .- .... .• . 0010, 0000000000000000 CB023303 00000000 ....... . i.3 . 0020, 00002020 20202020 20202020 20202020 0030, 20202020 20202020 20202020 20202020 OOtO, 00000000 00000000 00000000 00000000 15 : 53,08.6301:>0.1560 LCL : aob" to.tor. ""PY' ... po. 0 15 , 53,08 . 630 1:>0.1560 LCL , . eh . t ..... copy' . cI> ... poo 0 15 : 53,08.6301:>0.1 5 60 LCL : ....,.ivinq au' pac:Jcag. roopr ..... tinq an aeh acbl< c:on_raion r~ ... 15 : 53,08.630 ba1560 LCL : ACBX c.d c:oa. (H2) 15 ' 53 : 08.6301:>0.1560 LCL ' paIxI (02i9"68) 15 : 53,08.6301:>0.1 5 60 LCL : n_ rb (1) - n_ fb (1) 15 : 53,08.6301:>0.1560 LCL : abdi d (r) 15 ' 53:08.6301:>0.1560 LCL ' ABO dUIiIP :t..nqtb_U/Ox30 Butt. ... Ox2Utg68 0000, 30004732 4600UOO 00000000 00000000 0.021".1 . . 0010, ca020000 00000000 CB020000 00000000 t .. . ... . t. 0020, 00000000 00000000 00000000 F868BBOO ....... . ... . .,h" . • ... • ... • ... B . 15 : 53,08.6301:>0.1 5 60 LCL : 1"8 (out) :t..nqtb_ U/Ox40 Butl!.... Ox2UUc:8 0000, t1412C38 2C502Ctl 422C3530 2CU2CU ...... ,8 , P ,AB, SO , "','" . .. .. 1. 0010, U2C313 5 2C412C41 U2C382C 412C4U5 C,1 5 ,"',AD,B,"',ll.lI: ... . .. ( . 0020, 2C312C41 2C4U62C 312CU2C 40U2C31 ,1,"',111 , 1 ,"' , HA,l (. . 0030, 2C412C40 '22C3130 2C412C41 492C3130 ,"' , MB,10 , "',"'I,10 15 : 53,08.6301:>0.1 5 60 LCL : AllAßA8(rcv) UQ-handl . (0) 15 :53,08.6301:>0.1 5 60 LCL : ca (OUT) :t..nqtb_ 80/0x50 Bu tt.... Oxbo.6h& 0000 , 0040n32 6066CCU 90940000 0 8 060300 .@ H2 · tio .~ .. D. • +. • .a. 0010, 0000000000000000 CB023303 00000000 ....... . 1.3 . 0020, 0000202020202020 20202020 41010000 .... 0030: 20202020 20202020 20202020 20202020 0040, 00000000 00000000 00000000 00000000 ....... . . 15 : 53,08.630 ba1560 LCL : final rc: 0 ca 15 ' 53 : 08.6301:>0.1560 LCL ' (~-OUT) blCD1C -> AIlcn oon_ r d on ro.quir..:! 15 :53,08.6301:>0.1 5 60 LCL : (~-OUT) B1:TIC 0iID8R con ........ ion ro.qui.-.d 15 : 53 , 08.6301:>0.1560 LCL : (~-OUT) ca i n Length-80!0"SO Butf.r-O_68a8 0000, 0040n32 10UCCU 90940000 0 8 060300 . 8H2 ' tio. ~ .. D. + . . . .a. 0010, 0000000000000000 CB023303 00000000 ....... . i.3 . . 0020, 0000202020202020 20202020 41010000 .... 0030, 20202020 20202020 20202020 20202020 0040, 00000000 00000000 00000000 00000000 1553,08 . 630 1:>0.1560 LCL , (~-OUT) ca Out :t..nqtb_80!0.. 50 Bufh ... Oxbo.6h8 0000, 0040D51"2 UCC6UO 94900000 00030601: . 8UDit · N • • • • • • D H2 . .. -. . 0010, 0000000000000000 02ca0333 00000000 ....... . . i.3. 0020 , 0000404040404040 40404040 01410000 .... @U . . U@ . ... . 0030, 4040404040404040 40404040 40404040 8UU8UUUUU 0040, 00000000 00000000 00000000 00000000 15 ' 53:08.6301:>0.1560 LCL ' _ LCL oa11 tin h h..:! _ LCL oa11 tin h _ _ 15 : 53,08.630 1:>0.1 5 60 ~ : (D) - u.cB """ten .. Lenllth_ n/oxu Bul!t .. r-OxUOt .. c:O 0000, 01011"80004180001 CB023303 00000000 .. '; .... . E.3 . • .. .• . . . . • h o . 0010: 00003303 00000000 OOOOB\lSC 00000000 .. 3 .... . ... \. 0020, 60ll:AOOOO 02001800 CODC4200 CODC4200 . e . . ... . MiB .iiiB. ··1 · ··1 · 0030, C68m2.U 1:50C8606 09C501D3 00000000 u · -l.f .öA>6. r . . yV.t RBPL. 0040: 00000000 15 : ~3,08.630 1:>0.1 5 60 ~ : (D) Call DBID 2~1 - Loc:al Coapl . .... 15 : 53,08.6301:>0.1560 ~ : (D) _ bturni"9 tMD(ZBCDIC) , O ,,' dSt2'b~n • • : 0 ; Re , 0 _ 15 : 53,08.6301:>0.1 5 60 ca1linll Al. local _t.and..:l_oodaba . DB10-2 5 1 r c:-O
°
• 0'
-
'"
.
°
9.6
wep Log Windows
209
1$ ' 53:08.630 ~7560 t.oc.l~ . t <:!On , I>\>IrIp o~ .,..,ly ACB block 0000, 0040D5 1"2 UCCU60 OOgOOOOO 00030_ . II ÖODi:f · ....... ~. 0010, 0000000000000000 02CB0333 00000000 •......... 1.3 .... • 0020: 000040'0 '040'0'0 '040'040 01410000 ' .. 8U UUU @.A .. • 0030, 40404040 40404040 40 404040 40404040 ' aIllUIIIUII9UIII@ ' 0040, 00000000 00000000 00000000 00000000 •........... . ....• 1$, 5 3,08 . 630 ~7!l60 t.oc.l~n <:!On : I>\>IrIp o~ r.ply &AB block 0000, 0101n100 OUBOOO l CB023303 00000000 ' .. ,; ..... E.3 ..... • 0010, 0000330300000000 0000885C 00000000 • .. 3 .....•.. \ .... • 0020, 60u.oOOO 02001800 COOCUOO CODCt200 . ... . . .ÄfiB.ÄfiB. 0030, C6BU2A8 ~50C8606 ogCSD7D3 00000000 'Ai ' ·• . t.Ui.6 .... • 0040, 00000000 1$, 5 3,08.630 boI1 5 60 t.oc.l~ . t otrr : Ro.turned Rbl _ IU Ibl _ O 15,53,OB.630 boI7560 t.oc.U.• qu• • t otrr, Reply RB i . 0000: 00000000 00000051" D9C 9r2" I"U3nr6 • ....... O&c.uo-;.ö' 0010, 1"01"31"240 40404040 '0404040 4040 4040 ' ''ooe lllliIlIllIlU '
.
0320, 0000001"2 1'01"01'31"0 1"91"01'11"2 1"01"01'31'0 ' ... ~,,"~ • ,~ 0330, 1'"91'31"0 15, 53 ,08.630 boI1 5 60 _ _ _ _ _'.IORK UNU' DB10002 5 1 RJ:I'LY CLASSI'C_ _ _ __ 15 , 53,08.630 boi7560 Prooeu Cl u d eRep pQNE-O_9tfB 1$, 5 3,08 . 630 boI75 60 5EIIDIQ Mll:5SAGZ MsgRef.""noe-l)o.bcdc5lc Leru;lth- I44------------
------------RDA
15 , 53,08.630 boi7560 Buff • ....o 0000, 005100001 91"011:0000 •.... Y. 15,53,08.630 boI7560 Buff ..... l 0000, 4400000000000004 3158CBOO C6Bt:94B' ·0 ...... . 1[t . d~ . · 0010, 4B5A3030 31202020 UUUU 31 5 32020 ' KZ001 ADAN"IS 0020, 00000000 00000000 00000000 00000040 • ............... @' 0030, 033300000000009000000000 00000000 . 3 . . ..... • 1$, 5 3,08.630 boI1560 Buff ..... 2 0000, 0040D51"2 UCCU60 00900000 000306DI: . @ÖODit · . ...... p· 0010: 0000000000000000 02CB0333 00000000 • ....... .. 1..3 .... • 0020, 0000404040 404040 '0404040 01410000 ' .. UIIUIIU .A .. • 0030, 40'0'0'0 '040'040 40404040 40404040 ' ffUUUUUUU ' 0040: 00000000 00000000 00000000 00000000 • ................ • 15, 5 3,08.630 boI1560 OIUhndKoo. .aqeByll.t> Ro.f.rence-0xbcd<:9c Th ....dP.ef_ O"O Buff • ....ox140t. 5" t.ength-S ryp.-O 1$ , 5 3, 08 . 630 boI7560 MsoRo.t. r.nc_ 0>tbcdc5lc ryp.-Poou h tent kept for r . u . ao. 15, 5 3,08.630 boI1560 I:nter Coadlock _ Oxbd0254 " - " ' u_ 2 l"roa,Choo<:kBlo"kEntry 15 , 53,08.630 boi7560 OIUsendKoo" .o-ByRt> TiOrg. tIf_ NIlTWOl\ll ADAN"IS T. r gootId-O,,1. 000003 Mf.r."c_ Oxbcd<:5Ic RoutI~O"O Ms<;JNo-O Length_1 5 2 Interval_ O.. 15,53,08.630 boI7560 PS. nd S.rvoo...mTll'ORlt_ADAII1S TarvootI~0,,7.000003 Con1~1 7 Payload-152 Tiaoo1$, 5 3,08.630 boI1 5 60 SEND Con1~n Leru;lth_ 1$2{0,,5IB Buf~. .... 0"UQr.it ec...slock-340 t.ength-1686 1$, 5 3,08 . 630 'bB240 RJ:CJ:IVJ: ConI
.,.
z
9 Appendix
210
001.0' 001'0 : 0100 : 0110: 0120 : 0130:
6BCHBCl 6BCIU68 CUa6Bl"l C1681'868 6Brl6BCl I"06BC16B
11'681"668 rl l'06BCl Fi)6BC16B D7611C2C2 fiBel<::46B C2C66Brl
C16BClI.S 6BelE16B CIE96Br2 681'11'06:8 n6BD76B 6BC16BC2
6BI"26BCl
0140:
6BC16BC2 CB6BrUB Cl6SC2Ci 6BrUBJ:4 6BC2D16B 1"768»768 C2D2681"4 6BE4fiBel
6BC16BC2 C16BC2C3
A1t.kx~ki.k1i.
<::2<::5681"1 C16Bl'11'O
0150: 0160:
D36Bt'768 D76BCSCl 681"46BJ:' 6seS':::468
0180 : DUO:
D76Belle, 6H"H' 6BCSCBI>B r'l6BD76B C5C96m" 6811:4&8(:5 Ol61!P"lU 076BC2N
ono:
kAltWöki.kUkW
I<1..kMJt.UA,.UI
FUBelEl.
1'76111)768 C5C56BF4 6BU6BC5 C66BF76B
uJtAItAi.Jr. +k' ltihil
"l<.U.Mkil~1III I
+kxltihllJ
itkllkiil
OlAO:
tiBfttiBCl 6BC2D56B 1'1I6SC16B C2DUBI'S
~Jti.kAök.Jti.kAök.
0180: Olea:
6BC16BC2 D7681"568 Cl6BC2DB 6BI"56BCl
ki.ki'kll~
0100:
alBO: 011'(1 :
0200: 0210: 0220:
0230: 0240: 025 0:
0260: 0210: 0280: 02~O:
Ou.Q: 021.0:
02eo: 0200: 02lE0:
021'0: 0300: 0310 :
0320: 0330: 0340 : 0350: 0360:
6BC2tl968 F\lfi&C16S CU:UBI'l 68(:168(;2 K26SrS6B J:UBC2J:3 6srUBU 6se4CHS 1"26BC16B CSC26BFl 6BC16BC2 ZURU8
C168C2I:1 6BC2UÖ8 C3C26B.rÖ 6B.rlF068 rHBC168 C16BC3C~
6BC3D268 0468r468 0668r868 6B.rl6BCl r06BCl68 0768C21C5 CJlC36B.r4 6B.r46B1!:4 6N46BC4 6BC4ICUB B56BFlFO 6Br86BC1 6BC14B30 0306DFOO 00000000 40404040 40404000 00000000
6BFU8Cl r1r3öBC1 6BC16BC3 Cl6BC3C5 C3C7Ö81"1 6BFl1"{168 r86BC168 1C46BC305 C16BC301 68C30968 C1C?681't 6BF46l11C4 6l11CUlIIC9 6BC4C(68 046Br'768 r'76BD76B 6BCUBC3 68C31i868 4005 r244 00000000 00404040 40404040 00000000 00000000
68C21:86B öBC3CHB C36Br268 68Fl6BCl öBC16BC3 Cl6BC3l>l C30368Fl 68r1rsro 68r1l'568 1"16BC16B 68E4 6BCl 68C21C668 Cl6BJ"'76B r'76BD168 016BC409 C3ICUBFl E66Br868 F86BC16B CCU6000 0000000 2 40404040 40404040 00000000 0000sm9
1"1 1"{1 68Cl r16BC168 E46BC3C( 68C3CUB C8681"168 68r86BCl 68C168C3 6BCl6BC3 CUBC3l>8 C31C268Fl C86Br168 r'76BD168 0768C4C3 C4C?6Br4 6Br46811:4 6BC16BC3 C?6BC3IC? C3IC9681"8 9000ROO CB033300 40404040 40404040 00000000 C9F21'8r9
kA\Ik~ilki.Iti..
iJelikaWköUkÄAJr. ~ilk1.J.hI.ilk
~~kil.(lJti
I
Wöl<1.lt.UJ.ou.1<M l
iIl
I
ÖJ<6kiU
Öl<.ki.kix I
Ü:1lll1
~kCkA4k.l
,A,AO,6,A,AV ,2 ,A ,All, 10 ,A,AX,1 ,A, Ar ,10 , A,AS, 2 ,A,8 A, 8,P,BB, 10 ,A,BC ,1,A,BD, 7,P,81C,l 0 , A,8r ,l,A,BO,10 ,A,8JI,4 ,A , BI,4, U ,BJ,1 ,P,8I';, 4,U,8 {' , 7,P , BC,4,U,W, 1 ,P,o., 4,U,ICI" , 7, P ,ICG,4, U,ICH,? ,P, U, ' ,U,ICJ, 7 ,P ,Ilt'l ,S ,A,BN, B,A,BO, B
, A ,BP , 5 ,A,BQ,5 ,A ,BR,S,A,DU, l , A,B S,5 ,U,BT, 6, U,DA, 2,A,U,1.A,BU,1, A,Bl< , l,A,8r ,10,A ,BZ, 13,A,CA,1 ,A, CB, 6,A,CC,2 ,U ,CD ,10,A,CJ:, l,A,cr, 1 ,A,CG,l,A,CB, I, A , CI, 10 ,A,CJ,8 ,A ,CJt,8,A,C{', l , A,C K,4,U,CN,180,A,C O, e ,A,CP ,15,A,CQ ,1,A,CA,l,A,CS,l O,A,AG, 4,U,AII,? , P , 8V ,4, U,BIf, 7,P, CT, 4,U, ZA, 7, P,DC ,4 ,U,OO, 7,P,00,4 ,U,DK,7 ,P ,Oft,4, U ,0I,1,P,CU,l,A,C V,10,A,CII',a,G,a ,8 ,G,cr, 8,A,Cr., 8 , A.
N2 . • . - . • .
.. · ··UUUU8U
IIU II UUUUU @n.
.......... _oto.u
........... ftI2S9
0680: lCOOOOOO 0000r2FO ror3ror9 ro r lr2r<1 ...... 0/I4O/Iu"MII ...... 2003090120 0690, rOr3rOr9 r 3r<1 4O/IUO/I 030930 15 :!IJ :OS. 630 4bSUO Procoou 8u:r:r.r OrvB1oc:k-SUO RJ:ClCIVIC EVlCIIT S."""'r-NIC'!'IfOlUt_ADAII7S Ta ...... Ud-0><7.00000J b:r.r.nce-O>
0680: lCOOOOOO 0000r21'O I'Or31'Or9 I'OFlF21'O ' . .0000000u/lilO/l· ono: r8UO FIND MOI:->GOr IT 15,53,08.630 .b82'0 >>>>>>>>>>>>>>>> llDA 0'UD-251 flBQUJl:ST «<<<<<<<<<<<<<< lS :!IJ :OB.630 4bBUO ADABAS "*lU •• t frca ehute n~S OB10-2S1 T1o-.a!' -.i.tPID-OllCS07D3 15 :53:08.630 4b8240 Alloc:ateCAJWOxt>e6B30 15,53,08.630 .b82'0 o.,..o"toRdaAdab.....q ",. . t, ou-p ot ACB 0000: 30 4OO5r2 uee6UO OOgOOOn 00030601" · o I OOoi1" ... 0. ... 11 " 0010: 0000000000000000 02CB0333 00000000 •......... i.3 .... ' 0020: 0000404040.040.040404040 .040.040 • .. u u u u u n u · 0030: 4040404040.0404040404040 4040.040 ' IIUII U IIUII U ' 0040: 00000000 00000000 00000000 00000000 •.............. .. • 15 : 53:08.63041:>8240 Abl.U9 11:>1.715 $bl.0 Vbl-<1 IbhO lS :53:08.630 4b8UO DImp 01' n 0000, C1el6Br8 6BD16BCl e2681!'5ra 6BC16BC1 ·MJ..k_kAAJ.MkAJti" 0010: C3681'11"5 6BCUBCl CUBI'86:8 Cl6BCIC5 • AIt;o;.:;I
9.6
wep Log Windows 0060: 0070: 0080: OOPO: 001.0: OOBO: OOCO: OODO: 0011'0: OOJ'Q: 0100: 0110: 0120: 0130: DUO:
C1056BFII 6BC16BC1 06681"268 681"46BCl 6BC10768 1"1 J'QöBC1 "16BC16B C1D~6Bl"~ 6BC16BC1 6BCl6BC1 1l36B1"3J'Q 6BC16BC1 C16BC11:5 6U26BC1 öBClJ:66B 6BC18768 "16BC16B C1886Br1 C11:96lW'2 6BC16BC2 Cl6BFII6B 6B"1J'QoB C16BC2C3 oBI"16BC1 1"768076B C2C56M'1 1"068C16B 6BC16BC2 C76BI'1J'Q 6BC16BC2 C16BC2C9 6Brt6B!:4 oBC2D16B C2D26B1"4 6U4~2 D36BI"76B 6BI"UU4 6BC5CUB rJ68076B oBEUBC5 C66BI"76B D76BC5C7 68C5C868 1"76B0768 C5CP6Br4 ono: D16BI"76B 076BC204 6BI'86BC1 0160: 1'86BC16B C2Dö6Bn 6BC16BC2 0170: C16BC208 6Br56BCl 6BC20P68 0180: CUUBl"l öBC1öBC2 1:26BI"568 öB1"66B!:4 öBCtC16B 1"2öBC16B 0190: oao: 6BC16BC2 &4681"168 Cl6BC21:7 6BC2BSöB l'1J'QöBC1 öBC21:968 OlBO: 01CO: 6BC3C16B I"16BC16B C3C26Br6 01DO: C36B1'26B &46BC3C4 6B1"1J'Q68 öBI"16BCl öBC3C66B I"16BC168 011:0: 01J'Q: 6BC1öBC3 C86BI"l6B C16BC3C9 0200: C16BC301 6BP86BCl 6BC3D268 0210: C3D3öB1"1 öBC1öBC3 046BI"468 0220: 6B1"11"8J'Q ~16BC3 066B1"86B 6BI"lr56B C16BC3D8 6B"16BC1 0230: 0240: I"16BC16B ClB26Brl J'QöBC16B 0250: 6BE46BCl C86BI"76B D7 68C2B5 6BC21:66B J'76B076B C31:36Br4 0260: 0270: C16Br76B D76BC4C3 6B"46"4 OUO: 1"76BD768 C4C76Bl"4 681:46BC4 0290: D76BC409 6Br46U4 6BCUU8 02AO: c:n:46B1"1 öBC1öBC3 1:56B1"1J'Q 02BO: U 6BP868 C76BC3J:7 681"86BC7 02CO: r8öBC16B C31:PöBn öBCttB 15:53:08.63041>8240 DuIop ot RB 0000: 00000000 00000051" 09C5II'21'8
211
C16BCU6 öBC10868 li:268rJl'O 1:468r66B 1"11"06BC1 1"06BC168 D76BC2C2 6BC2C468 C2C66B" 1 C86lW'46B rJ68D16B D16BC5C3 C5C56BI"4 öBI"4öBE4 6B1l46BC5 6BC2D56B D768r568 1"86BC16B 1:4öBC2U C5C26BI"l 681"16BC1 1"11"36BC1 6BC16BC3 Cl6BC3C5 C3C7681"l 6BI"lJ'Q68 1"86BC16B B4öBC3D5 Cl6BC3D7 6BC3DP6B CIC7681"4 6BJ"46B1l4 6BU6B1lP 6BC4C468 046Br76B 1"76B1176B 6BC16BC3 6BC3J:86B
· i.öuki.ki.ök"l
· kMlti.lti.bilWW · ·+k.kllJ<M~iI' · l
· .I
' ~ki\kA'
· l
·ki.k.ükAl
'klkiik+k_l<.U.k6l
1"511'31'81'1 • ....... _iI:to,ouo.iI ·
0320: 0000001"2 1"0J'Q1"31"O 1"9J'Q1"11'2 J'QJ'Q1"31"0 ' ... 000&OIIullilO/l&Oll · 0330: "1"3J'Q 'i>O/I 15:53:08.63041>5abO Al WOlUtING 0810-251 RJ:Q LOCAL_ _ _ __ 15:5l:08.630 41>8240 R.ooadSyncRouti"" DrvBlock_0l5abO Locd!loOqU... t IR: Ouap ot !lAll block 0000: 0101noo 04180001 CB02J303 00000000 ' .. u ..... 11:.3 ..... • 0010: 00000000 00000000 0000885C 00000000 •....... .... \ . ...• 0020: 601lAQ000 02001800 CODC4200 CODC4200 ......... iUlB.iflB. 0030: CÖSI:82A11 1l50CUOO D9C5D7D3 00000000 ' d ' -... t.Ui.6 .... • 0040: 00000000 '. 15' 53' 08. 630 4b8HO TcpRoooooiv. $ock.t.-340 Loo<>9th_81P2 . _itte5abO LocalP.equlO.t IN: Dwop of ACB 0000: 3040D51"2 44CC6660 OogOOon 00030601" ·o@öooit · • .. o ... S· 0010: 0000000000000000 02CB0333 00000000 • ......... 11:.3 .... • 0020: 000040404040404040404040 4040 4040 ' .. I U III U II U III I · 0030: 40404040 40404040 40404040 40404040 ' ~n@ @@ u @@u@@ u ' 0040: 00000000 00000000 00000000 00000000 • . . . . . . . . . . . . . . . . • 15:5l:08.630 41>5abO Loca1P.equ1O.t: !!b1_SU .,,1_715 Sb1_0 V1>1-ll 11>1_0 15:53:08.630 4b5abO Locd!loOqU•• t IR: Ouap ot n 0000: C1Cl6Bn 6BD76BCl C26B1"5J'Q 6BC16BC1 · J.J.Jt"kxkAhOllkAkA· 0010: Cl6Brll"5 öBC1öBC1 C46Br8ö8 Cl6BC1C5 'Al<Mi~iliü' ~1
0310: 1'2 1"11'231: rDI"Al61P 360041"U 401COOOO · Oilo>ji>. .. 6.00H ... • 0320: 000000r2 I"OJ"OI"3J'Q r9J'Qr11'2 J"OJ'Q1"31"0 ' ... 00000000u"ilO/IIIOII · Ol30: "l"lJ"O .... 6-' 15'53'08.646 4b5abO L>II< , (I"IR$'f) thr . .4 block 00BD5168 15:53:08.ö46 41>5abO L>II<: {J:AI ADALNJO[ V.nion: 6 . 2.1.23 Buil4Ir 0 an5abO L>II<: ADALmOI co.pila Uon Dat.: OCt 2008 Tl..IO: 15:18:31 15'53'08.646 4b5abO L>D<, (J:A) _ w." ArIJULU <:all _ _ ArIJULU call 15:53:08.610 41>5abO L>II<: {J:AI - ACB cont.nt Loo~th_80/0"50 Buff"....0_öSa8 0000: 30401>51"2 44CC6660 oo~ooon 00030601" o@öooit' . • . o ... S N2 . 0010: 0000000000000000 02CB0333 00000000 ......... 11:.3. 0020: OOOOt040 40404040 40t04040 40404040 .. I@U I@ @@ I@ U U
212
9 Appendix
~. ~.
15:53 :OS .6U 15:53 :08 .646
~. ~.
15,53 ,08 .646
~.
'U, (SU) ,~,
'W ,~,
0000:
(u_O_S168 0000: UOOOOOO 00000000 ZCSr4 UOO "D88C00 0010:
OOOOUCOO rBOOOOOO 02001800 CODC t 200
0020: 0030:
CODC4 2 00 C6SD2A8 E5OC8606 D~5D?D3 00000000 00000000 00000000 00000000
1,,1<._ .
. t".d ....... i.iiB. "ÜB. ai , - ... t .Ui. 6
.8Q •
1 ... r
······1·
.. yV.t
RZPL
LIIIZS 0040-28 80 2 B~O:
,-~ U g 0030 00000000 00000000 .... 6811Z00 "UnDa
1< • • • •
2BAQ: 2880:
C368B1l00 00000000 00000000 00000000 00000000 00000000 00000000 00000000
2BCO: 2800:
00000000 00000000 0 4 000000 00000000
2BII:0:
00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000
00000000 28208000
00000000 00000000
ZBro: U g ,~ LIIIZB 2COO-2CBO -~00000000 362J:3121: zeCD: 00000000 00000000 2CDO: 3821:3033 00000000 00000001"
15 : 53 :oa . 646 'b!labO
15 :53 :08 .646 4b5abO 1 5 :53 :08 • 6 46 at>5abO H : 53 :08 .646 4 b S abO
= . -".~ =. = . =. =.
Start LC:L call
008»5168
CCIIT-IN ) t:BCDIC 4>
(CIIT-IN)
.,R
'"
ASen
........ - h ....h ...
""
. . . . . . . . y . . .8 .
0, .
. . . . . . . . . . . . (-'t.
....... . .
....... . . .. . 6. L
-
8.03.
Start
~,
".11
con ".u!on r.quir-.l
ORDJ:P. con_ui.on r.qui.r..:I.
. .. ,
(CV'r-I II) ~ 15 :53 :08 .646 4b5abO t..rlo;th-SO/Ox 50 Butt..... O_Ua8 0000: 30400Sn U CC6660 OO~OOO 94 0003061>,. O@Ö6l>tr tI:! ••
0010:
Figure 216:
0000000000000000 02CB0333 00000000
Monitor -
wep Log Windows
. . . . . . . . . 1.3.
. , .•...
9.7 ADARPL Replay SOC4 Dump
9.7
213
ADARPL Replay SOC4 Dump
A DAR P L
\'8 . 1
SM!
DBID _ 00134
2010-12-23
Start~
lUlJUlPL RJ:PLAY TQJtENa15825 ADAlU'L RPLTARGZTIDa312 lUlJUlPL LRP~600000~
Yniti. 1i,..tion lancbh.ka Lor Reptor 312 . ~oo e •• Lu1, toke n bplay Type • 5ynchroni,.ad Tokan ora. t~: 2010-12-23 14:4~:20 . 5~ 2010-12-20 02:00:00 ADAlU'L t'rOlll. data/time 2010-12-23 14:4~:22 . 01 J\IIAJlPL to data/t~ 5uba"ription(a) invo1v~: 8134006 8134007 8134008 813400~ 5134010 5134011 5134012 5134013 8 134014 8134015 8134016 8134017 8134019 5134020 8134021 8134018 8 134022 8134023 8134024 8134025 8134026 8134027 5134028 813402~ 8134030 8134031 8134032 8134033 5134034 8134035 5134036 8134037 8134038 81340n 8134040 8134041 8134042 8134043 5134044 8134045 5134046 5134047 5134048 5134049 5134050 8134051 5134052 8134053 5134054 5134055 5134056 5134057 8134058 5134060 8134061 813405~ 5134062 5134063 5134064 5134065 8134066 8134067 8134068 813406~ 5134070 5134071 5134072 5134073 8134074 8134075 5134076 8134077 5134078 51340n 5134080 5134081 8134082 8134083 5134084 8134085 5134086 5134087 5134088 5134089 8134090 8134091 5134092 8134093 5134094 5134095 5134096 5134097 8 134098 51340~~ 8134103 5134104 5134105 5134106 5134107 5134108 8134109 5134110 8134111 8134112 5134113 5134116 5134118 5134119 8 134120 8134121 8134122 8134125 5134130 8134131 8134132 8134133 8134135 8134137 5134138 51341n 5134140 8134141 8134142 8134145 5134146 5134147 5134148 51341U 5134150 8134151 8134152 8134153 5134154 5134158 5134159 5134160 5134162 8134163 8134164 8134165 5134166 5134167 5134168 5134170 8134173 5134175 8134176 8134171 5134177 5134180 5134181 5134182 8134183 8134184 5134185 8134186 5134195 51341~6 5134197 51341~8 8134200 8134207 8134210 8134211 5134212 5134214 5134216 5134221 8134223 8134224 8134226 8134241 5134242 5134243 51342U 5134260 8134270 8134271 8134280 8134326 5134327 5134344 5134401
"
15825
14 : 51:27
21.
9 Appendix
lJ • • tin. tion
D251006 lJ251010 D251014 D251018
D251022 D251026
D251030 D251034
D251038 D251042 D251046 D251050
D251054 D251058
D251062 D251066 D251070 D251074
D251078 D251082
D2510B6 D25101l0 D251094 D2510118 D251105 D2511011 D251113 D251120 D251130 D251135 D251140 D251146 D251150 D251154 D251162 D251166 D251171 D251177 D251183 D251195 D251200 D251212 0251223 D251242 0251270 D251327
(.) in ... olved, : D251007 0251008 D251011 0251012 D251015 0251016 D251019 D251020 D251023 0251024 D251027 D251028 D251031 0251032 D251035 D251036 D2510351 0251040 D251043 D251044 D251047 0251048 D251051 D251052 D251055 D251056 D2510S9 D251060 D251063 D251064 D251067
D251068
D251071 D251075 D251079 D251083 D251087
D251072 D251076 D251080
D2510Sll D251095 D2510119 D251106 D251110 D251116 D251121 D251131 D251137 D251141 D251147 D251151 D251158 D251163 D251167 D251173 D2 5 1180 D251184 D251U6 0251207 D2512U D251224 D251243 D251271 D251344 PU . ( . ) 1n... o1 ... -.d'
, """ ""'" "" """
,
D251084
D251088 D2510112 D251096 D251103 D251107 D251111 D251118 D251122 D251132 D251138 D251142 D251148 D251152 D251159 D251164 D251168 D251175 D251181 D251185 D251197 0251210 D251216 0251226 D251249 0251280 D25U01
• "" "" " " .,"" "" "" """ """ ""'" '" "" "" " " "
. . . .
, """ .,"" "" " """ "" "
D251009
D251013 D251011 D251021 D2 5 1025 D251029
D251033 D251037 D2 5 1041 D251045 D251049 D251053 D251057 D251061 D251065 D251069 D251073 D251011 D251081 D251085 D251089 D2510113 D2510n D251104 D251108 D251112 D2511U D2 5 1125 D251133 D2 5 1139 D251145 D251149 D251153 D2 5 1160 D251165 D251170 D251176 D251182 D251186 D251198 0251211 D251221 0251241 D251260 0251326
"" "" """ """ "" " "" "" " "n "" "" " "" '" ".
. .
U
9.7 ADARPL Replay SOC4 Dump
m '" '" '"
'" '" ".
'" '" '" '"
'" '" '" '" '" '" '"'" '" '" m '" '"
'" '" '" '"". '" 1f:51:28 14:51 : 29 1f:51:29 14: 51 : 29 1f:51:29 14:51 : 29 14:51 : 29 14:51:29 14:51 : 29 14:51:30 14:51 : 33 14:51:5f 14 : 51 : 5f 14:51:54 14 : 51 : 5f ( . nip) 14 : 51 : 57 1f:51:57 14 : 51 : 57 1f:51:57 14 : 51 : 57 1f:51 : 57 14 : 51 : 57 1f:51:57 14:51 : 57 1f:51:57 14:51 : 57 1f:51:57 14:51 : 57 1f:51:57 14: 51 : 57 14 : 51 : 57 14:51 : 57 14 : 51 : 57
Figure 217:
'" '" '" '" '" '" '" '" '" '" '"m '" '" '" '"
HO
215
no
'"
'" '" '" '" '" m '" '" '" '" '" '"'" '"'" '"no '" '" '" '" '" '" '" '" '" '" '" '" '" '" '" '" '" '" '" '" HO
IEr403t $TREPLAA - $TARTED - TLME-1f . 51 . 28 +lUIONL-2B: REPOII.T HEM8ltR CREATION FAILED, P.C _ 0000015C, DSN _ STSD. +ABONL-18 : NO DATABASE I'ILES ELIGIBLI! 1'011. SELl!:CTION +lUIONL-10 : ABEND-AID WILL USE ABENDl\.ID DD INSTEAD +JlB401 _ ABEND-AID _ P.BPOP.T WP.IT'l'BN TO : JIBZ.NtlAID.JOB-STP.BPLM. S'l'EP-STl ABEND CODE-SOC4 ACCESS TOUR ABEND-JUD P.EPOII.TS III I!lXBCU'l'ING STSTKM cc:t.o.ND nun rRON AN'!WHI!:Rl!: IN lSPP . lAT1600 ~. STREPLAA (JOB4B202) LINES ZXCEEDED IAT1600 ~ STREPLAA (3OlI48202) 16,000 =mm lAT1600 ~ STREPLAA (JOB4B202) LIDS 32,000 IAT1600 ~ STREPLAA (JOBtB202) fS , OOO lAT1600 ~ STREPLAA (JOB48202) EXCu:IlED 64,000 IAT1600 ~ STREPLAA (JOBtB202) 80 , 000 ,~,
,~, ,~, ,~,
.,.,.,.,
==" === === .,
STSTEM COMPLETION CODE-OC4 REASON CODE_00000010 Tno:_ U. 51. 28 SEQ-OU50 CPU-OOOO ASID-01DS PSW AT TIME OP ERROlI. 078DOOOO 80041'P5 4 lLC 4 INTC 10 ADDP.ESS_ 000f9COO Orr$ET-00006354 ACTIVII: LOAD J«)DULE -~,
DATA AT P$W 0004rrn: S2165Sro A9!1C501'0 30001 871' 1 : 00000000_00000290 GI'. 0 : 00000000_0000007A 2: 00000000 800 4 rr50 3: 00000000 61'50589C 4: 00000000=00000000 5 : 00000000=0004D1'C4 6: 00000000 00000012 7: 00000000 6Pf92ADO 8: 00000000=00052D96 9 : 00000000=0004FEFO A: 00000000 80049COO S: 00000000 000 4ACOO C: 00000000=0004BCOO D : 00000000=0004DCOO E: 00000000_ 4AAOA008 1': 00000001_ 6pf92830 EIID or SYMPTOM DUMP IEp4501 STREPLAA ST1 Rl!:PLAY - ABEND-SOC4 UOOOO REASON-00000010 T1ME_14 . 51 . 57 IEp40fl STREPLAA - EllDED - TIME_14.51.57
RPL SOC4 Dump
216
9 Appendix
9.8
Assembler Programs
9.8.1
SleepIWai!
DIETER.ASM. SOURCB ( SLEEP)
....... *** . ................. ** ...
Top of' o.ta
** .... ****u . . . . . .. . . u.*u . . . . . u
TNIS PROGRlIM PB~RMS A TDIED WlUT . J:TS PURPOU 1:5 'l'O HALT EZECU'l':ION !'OR A GIVIIN PIIRIOD 01' TIME. THB P1!RIOD 01' orDal IS CODZD ON THIl EXZC $TA'l'EMENT 1:N HH:_:$S . TH FORMAT
(WHERE H K 18 HOURS,
HK IS MINUTES, 55 IS SBCONDS, T IS TZNTKS OF A SBCOND, H IS HUNDR&THES 01' A SECONI!.
EXIIMPLE:
//SL&EPOI
BXEC PGH-SL&EP , PARH-'OO;10 :00.00·
TRIS Wl:LL CAUSB A WlUT 01' 10 MINUTBS IN TRI: JOB . I r TBIS PROGPAM NlBNDS WJ:TK A U0999 ABENtl CODE, IT _ S TIlAT TfIE TIME VALUE WAS NOT SUPPLIED IN A VALID !'ORMAT (KH:_:SS:TH) .
•••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
SUEP
START 0
5TH
14 , 12,12(13)
BALR
12,0
USING • ,12 LR 10, 1 3 LA 13,SAV1!
sr sr
13,8(10)
10,<1(13) L 5,0(1) U5:ING PARM,S CLC REQLEN, PARKLBN ~
COMPARIl PARMLEN W/REQUIRIID LBNGTH
LOCATE,C'l'
SN!: NOTe!'; CLC PJ\RMYl\L+2 (1) ,COLON
Ir NOT EQUAL , BRANCH Ta NOT Olt t.OOlt rClR COLON Bll:TNEEN HR' MIN
MVI LOCATE,C'2 ' BNZ N01'OIl CLC pARMVlU.+5(l) ,COLON
Ir NOT EQUAL, BRANCH Ta NOT Olt t.OOlt roR COLON BETNEIm MIN , SEC
~
LOCATE,C'3'
sm: NOTO'" CLC MV! SNZ MVC
PJlRNYl.L+8 (1) ,PI!RlOD :LOCATE, C ' 4 ' NOroIt INTRVlU.(2) , P1.PMVlU. HVC IN'l'RVAL+2 (2) , P1.PMVlU.+3 HVC I N'l'RVAL+' (2) ,P1.PMVlU.+6 HVC INTRVlU.+6 (2) ,P1.PMVlU.+9
11' NOT EQUAL, BRANCH Ta NOT Olt t.OOlt I'OR DECDIAL POIN'l' AP'l'I!R SEC Ir NOT EQUAL, BRANCH Ta NOT Olt
P!UN'l' PARM INPO
"'"
MVC MVC MVC OPEN PUT CLOSE
TEZT, -CL80'
,
TEXT (11) ,P1.PMVlU. TEZT+ 12 (1 ?) , -C ' _ PARAMETER VALUE' (PRIN'l' ,OUTPUT) PRIN'l' • TEXT (PRIN'l')
. ...
~.
ABEND X '3E?' , DUMP ,STEP $TIMER tIlUT, DIH'l'VL-INTRVlU.
L 1 3,4(13) LH 14,12,12(13)
LA 15,0
SR 14
9.8 Assembler Programs
217
- ------------------- -----------------, -
DEPINITIONS
m~
" =
• • •
DDNAME_ DDPRJ:NT , ~~ , BLK$7ZE _ SOO,LRE~SO,
DSORGool'S
n~ ~,~ ,~
~""'-'9 OO~
PERIOD .~
'~N ._~
"" "oe oe oe oe oe
m 0'
,,=
ZLS , 00050000 , XL2'B ' X'OO' C ': ' C'. '
"",ND =OLU
//STSLEEP
/I_
/ / / / -MI\.lN
// -
,"'''
"
~
JOB (ST345T,ST01,ST) ,'DIETER' ,TDKE-1440, RESTJ\RT-GO, MSGCLASS_2 ,NOTIPY_'SISUID, LINESa9999 CLASS- PlO ,U_DIETER
---------------------------------------------
,TIPRUNooSCAN
//ASMIICL EXEC ASMIICL,l'RINT-/ /C. SISIN DD DISP-SHR,DSN_DlIlTER . ASM. SOURCE (SLEBl') //L.S1SLMOD DD DISP-$HR,DSN-D7ETER.A$M.LCADLIB //L.SISIN DDNAME SLEEP2(R)
,.
//QO EXEC PGM-SLEEP2,P~'OO : OO 30.00' //STEPLIB DD DISP-SHR , DSN-DIETBR . ASH . LOADLIB / /DDPRIN'l' DD SI$01.1'1'-//SISUDUHP 00 DUHHY /1AB%NDAl:D DD SIS~/I
Figure 218:
Assembler Program Sieep/Wait
21 8
9 Appendix
9.8.2
Get Dataset Name
t/STGETDSII JOB (ST345T , STOl,ST) ,'STDWS' , TXME_1 44 0,
1/ * 11
RESTlUtT-GO) ,
1/ " MAUi
CLASS- PIO ,USZ_STADBA
MSGCLASSs2 ,NOTln_'SYSUID. LlNES_9!J99
,TYPRtJNaSCAN
// * - - - -- - - - - - ------ - - - -------- - - - -------- - - - ---/!ASMHCL /tc SYSIN
EXEC ASMIICL,PRJ:NT- * DD DISP-SHR , DSN-DIE'l'ZR.ASM.SOURCI!(GETDSN)
IIL . SYSLMOD /IL.SrSIII
,-
DD DISP-SHR ,DSN_DIETER , A$M, LOADLIB
DD '
NAME GETDSN(R)
I/GO
EXEC
/ISTZi'LIB
IIl'DFOUT
i'QIoo
DD
DISP-SHR , DSNaDIE'l'ZR .ASM . LOADLIB
DD
DI$P-$HR , D$N-*. S'l'II:PLIB
IISYSPRINT DD
SJsour-*
DD
SfSOtJ'1'a*
11~1'U'l'
,-IIGO
w.HE GETDSII (R) EXBC PGH-GBTDSN,PARH- ' POl'OUT
t/STZPLIB
IIi'DFOUT
DD
DISP-SRR,DSN-DIETER . ASM . LOADLIB
00
tlISP-SHR , DSNw* . STBPlolll
tlSISPRINT OD
SI sour-*
PD tlSYSUDUNP OD IIAaENDAl:D 1)1;1
SYSOUT-* DUIOß' SYSOUT-*
II00000PUT
11
.-
GETD$N (u . in<;l RDJY'CB) Obtain tha DDNAHZ - can t.. u a ed in • Natural prO<Jr ..... CALL ' GETDSN ' tbi a •••.-bl. r routine ddname o~ tha f'il e .,,,nuo1 b1oc:k (11.176 ) f'ir . t f f byt •• i . th. data •• t n ....
......"'" ., ...'" ......"'""'" ., ., ......"'""'" R' ........."'" ... . .. RO .,
R'
." RU ."
RU RU
."
~'"
..
,, ,, ,,,• , • " "" "
(A) CALL Tl" (A) DBID (A) ADABAS KSG/OPERCOH (A) CACHE RELEASE COUNT NUMBBR 01' ,~U BNTRIES (11.) PRINT LINE
,~
U
U
------------------------------------------------------------------Ml\.IN CONTROL S&CTION ------------------------------------------------------------------- -
Gl!:TDSN
CSEC'l'
Gl!:TDSN GBTDSN
RHODB 24
AKXIE 24
9.8 Assembler Programs
•
219
R14,R12,U(R13) R1.2,R1S OSING G.l!TDSN,R1.2 R1.l, SAVZAREA+f U R1 S, SAVBJIREA R1.S,8(R13) ~ R13,R1S
srou CALLZR' S REGS LOAD MY I!:N'l'RY JU;lDR ZN RJ:G12 OSE REG12 AS MY BASE UG STQRII: CALLZR' 5 SAVlI: AR&A JU;lDR GET MY SAVlI: ARD. ADDRESS S'rORII: I'!' IN CALLBR' 5 SAVlI: ARKA LOAD MY SAVE AR&A JU;lDR IN REG13
OSING JPCB,1I10 1H R2,Rf,O(Rl) MVC INDCBHO(8),2(R2) LA Rf ,JFCIIl\R&A ST Rf ,OCBBXLST MV:I DCBEXLST ,:I:' 87' JlDJPCB (INDCB,INPUT) m R1.S,R1S
OSE REG10 POil DSEeT ~ GE'!' PARK ADJ)RJ:S8E$ MOtlZ" DeB (DD_) 1e"'1th
,~
~
• • • • • •
IlAVEDSN
" "
~,
~w
" •D'
"
• • • • •
'RU ..
REI\D JOB FILE
~L~
TEX'l'(08),2(R2)
~
TEX'l'+lO(lO),-C~lO'DSN
~
I'OUND! '
D'~
"
TEX'l'(08),2(R2)
~
TEXT+10(lf),-C~lf'DSN
~
•
NOT lI'QUND! '
·•• -----------------------------------· -----------------------------------• D'~
PR.INT PARK INFO
D'~
'QU ~
.. "
D'~
"" ~
•
.. .= D'
L
~ ~
TEX'l'+ 30 (44) ,JFCIIl\R&A (PRINT,OUTPUT) PRINT,TEXT (PRINT)
R1.3 , SAVBJIREA+4 R1.4 ,1112,12 (R1.3) R1.S, R1.S
n.
JU;lRESSE SAVE-AERBA CALLBR->REG13 RJ:$TQRII: CALLBR VALUE$ ~m
..• ------------------------------------------------------------------.. ------------------------------------------------------------------" U"
DBI"ZNITZONS, WORIt NID SAVE AAI!:AS
D
SAVBJIREA DS
""
'" ''"'
""Da "Da ""' " ~"' • , ,,,
STANDARD REGISTER SAVE ARD.
,.,~
D DDNAMlh.OO'l'PUT ,~PM, UlEct.-80 ,DSORG_PS D
,~
DSORG_PS,~R,EXLS~'!',DDNAME_ '.'.'.,.
..
Da~'
.jl!<:b
•
:I:' 87' ,ALl (JFCIIl\R&A) 176]['00'
J!'CBI)S_ DArASEr N»CZ 44 BYTES
IEFJFCBN END GETDSN
•••••••••••••••••••••••••••••••• Botto. ol! Data •••••••••••••••• ••• •••••••• •••••
Figure 219:
RPL SOC4 Dump
220
9 Appendix
9.9
EntireX V8.0.1 Parameters
These parameters are used for Natural RPC Servers and not for replication .
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• • EntireX Broker Attribute Pile '0'8.0.1 • • •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
.. .... ..•••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••.. .... .... .... , .... .. ,.= . "" .... .... """'" ,., ., -, ,'"= " " .. .........•..........•...•...•....•.....•...••...•.....•........•......... .. """'" . . DEVLJ:TBH EXB Attribute Pile
Chang•• --Date-- U•• rID
-
----------Deacription---------------------------. ~ ACCOUN'l'ING-VI!RSION
07!Og/lO ~" ~ " eco rcb '215 0./20/10 Increa •• ''OB 0./07/10
00 tb.re:fo" • 73280 00 146560.
EntireX 8.0.1
&TlI237
DBI!'lUJl.TS • aROUR aROUR-ID ACCOUNTING ACCOUNTING-VERl;ION
-~ DYNAMIC-MEM)Rr-MIWAGEMZNT
ETB237
,'" '" m
lCU-CONVBRSION
~
MAX-MEM)Rr
~'"
MAX-HESSAGE-LIINGTH
10000000
NUM-LONG-BurnR NUM-SHORT-BUFFBR
75000 I . num-lonq/ a hort a hould not 05000 1* needed o-.,.u •• o~ dyn .... ., ......
PSTORJ: PSTORJ:-Tyn
row
--..,....
PUBLISH-~-SUBSCRlBE
SECURl:TY ,ro~
SUBSCRIBER-STORE 'l'RAC1l-lZVEL TRANSPORT
DIlPlWLTS DB:rD ~
"
~
'" m
~,,,
Nl!T - TCP
,
DIl!'JWLTS • DIV D:IV • " Dllr:rHE STORE IlTBSTORE DDNAHIl STOREOl DATASPACIl NlUIJ: STORll:01 DATASPAC!: PAGIlS 6000 ATTRIBU'l'J: OLL COUNT 1500 KASH M:lDULUS 13 CELL COUNT 15 POOL NAHE CPBLOB01 S:rZE 256 4000 OLL POOL CPBLOB02 S:rZIl 40!U CPBLOB03 S:rZE 16384 COUNT 1 00" =~,
'"
DEi'1oULTS • Nl!T
~ ZXTI!NDIW-ACB-SUPPORT ~ ,~
~
'" ns
* •
lI.daba....8 end abov. dafeult i . NO 10005000 rES
~
9.9 EntireX V8.0.1 Parameters
-,
146560
" '" m
""" Noo.
..
RBSTART RETRY-LIMIT RBTRY-TDa:
"
~'M ~
'"
DEFAULTS _ SEC!JRITY • CHBCK-IP-ADDRBSS ERRTZT-N:lDULI: • IGNORB-STOnN
NO ~.o
n,
NO
• INC!.UDE-CLASS • INC!.UDE-NAMB • INC!.UDE-SERVICE SAI"-CLASS • SBCURITf-LBVEL • TRACE-LBVEL TRUSTCD-USBRID • UNIVERSAL • _-HODE l'ASSWORD - TO-UPPI!R- CASE USERID-TO-UPPER-CASE DEI"AULTS • SSL CONNECTION-NONACT ~,
...... , m
m
• PROPAGATB-TRUSTBD-USERID
• • • • • •
221
NO
• ct.:tault 1. fBS
AUTHORIZATION YBS • ct.:t.ult 1. YBS
NO NO
m m
"22223
NO
VERII'J-CLIBNT JUl:f-LABEL TRUST-STORB
.~,
[USBR-ID/[RING-NAMB
DBFAULTS _ Tel'
_ lS237
~,
DEFAULTS _ SERVICE
'"
CONV-OONACT
YBS • ct.:t.ult 1 .
• DEIP'J:RRED SBRVER-NONACT TRANSLATION
NO
>ON ~
!!'utor1al, SERV:ICI!
CvUn1tOEWork
CHBSS,
~L
• TRANSLATION . , DBFBRRBD
.,
.,
.....
STRS RPC S."...1",••
DEFAULTS _ S&RVICE CONV-NQNACT
• DErERR&II MAX-MBSSAGB-LBNGTH SERVEJl-NONAC'l' TRANSLATION ,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
,~,
~,
....-..,,,,SBRVER SBRVER SBRVER
,,,,SBRVER SBRVER
'" "
HS • ct.:t.ult 1. NO 10000000 ~~
RPCR01, RPCR02, RPCR03, RPCR04, RPCR05, RPCOO1, RPC002, RPCOOJ, RPC004, RPC005, RPC006, RPCOO7,
SBRV:ICE SERV:ICE SBRVlCE SERV:ICE SBRVlCE SERV:ICE SBRVlCE SBRV:ICE SBRVlCE SBRV:ICE SBRVlCE SBRV:ICE
~,
~, ~,
~, ~,
~, ~, ~, ~, ~, ~, ~,
222
9 Appendix
RPCOO8.
,~,
~.
SERVER
,~,
~.
SERVER
,~,
~.
SERVER
RPC01O,
,~,
~.
SERVER
,~,
~.
SERVER
,~,
~.
,~,
RPCOO9,
SBRVtCE
~.
SERVICE
~.
SBRVJ:CI!
~.
SERVICE
~.
SBRVJ:CE
~.
SERVER
RPCOll, RPC012 , RPC013,
~.
SERVER
RPCOU,
SBRVJ:CE
~.
,~,
~.
SBRVER
RPC015,
SERVICE
~.
,~,
~.
SERVER
RPC016,
SBRVJ:CE
~.
,~,
~.
SBRVER
RPC017,
SERVICE
~.
,~,
~.
SERVER
RP<;:018 ,
SBRVJ:CE
~.
,~,
~.
SERVER
RPCOlll,
SERVICE
~.
,~,
~.
SERVER
RPC020,
SBRVJ:CE
~.
,~,
~.
RPC021,
SBRVICE
~.
,~,
~.
SERVER SERVl:R
RPC022 ,
SBRVICE
~.
,~,
~.
RPC023 ,
SBRVlCE
~.
,~,
~.
RP<;:02<1,
SBRVJ:CE
~.
,~,
~.
SUWR SERVER SDVBR
RPC025 ,
SBRVICE
~.
DIU'1.ULTS • TOi'IC ALLQW-DtIRABU PUBlolCATION-LlnT:tME TRANSLATION TOPIC
SERVICE
~.
n,
"~-
••••••••• ** ••••••••• END ••••••••••••••••••••••••••••••••••••••••••••••
Figure 220:
EntireX V8.01 Parameters
Bibliography Adams, Mike and others (2010), EMC Techbooks V1.5, EMC SRDF/A and SRDF/ A Multi-Session Consistency on zlOS http://www-03.ibm.com/systems/storage/disk/ess/ IBM, Enterprise Storage Server Family
http://documentation.softwareag.com/adabas/ada823mfr/adamf/overview.htm Software AG (2011), Adabas 8.2.3 for Mainframes Software AG (2010), Adabas 6.2 SP) for Open Systems Software AG (2011), Entire Net-Work 6.2.2 for Mainframes Software AG (2010), Entire Net-Work .3.4 for Open Systems Software AG (2010), Entire Net-Work Client 1.3.3 Software AG (2010), Adabas SAF Security KerneI8.1 .2 Software AG (2010), Adabas SAF Security 8.1 .2 Software AG (2011), Event Replicator for Adabas on Mainframes 3.3.2 http://documentation.softwareag.com!natural!nat427mf!overview.htm Software AG (2011), Natural 4.2.7 for Mainframes Software AG (2011), Natural Security 4.2.7 for Mainframes Software AG (2011), Natural SAF Security 4.2.7 for Mainframes http://documentation.softwareag.com!webmethods/wmsuites!wmsuite82_fcs/EntireX/8-2_EntireX/overview.htm Software AG (2011), webMethods EntireX 8.2 for different platforms http://storrconsulting.com/sc200.html Storr, Dieter W. (1995), Effizienter OB-Einsatz von ADABAS, (Efficient Database Usage of Adabas), Second Edition (German) Storr, Dieter W. (2009), Experiences with Event Replicator for Adabas, Artic1e in TECHniques, Issue 3, 2009, Software AG Storr, Dieter W. (2010), Optimize for lnfrastructure, Artic1e in TECHniques, Issue 2,2010, Software AG Sybase (2001), Disaster Recovery with Sybase Replication Server, High Availability through Warm Standby - A Sybase White Paper
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
Index A
C
ACF2
CCSID 96 CHECKSUM 59, 190 Ciphering 61,93, 164 circuit 9 circuits 10 command log 14,46,90 f., 108, 120, 123 H., 129 Command Log 129 Communication 43,100 Compu te r Management 98 H. Connectivity 98 f. CPU 23,25,29,59,68,72,74 ff., 96, 104 f., 178, 190 H., 215 CPU time V, 10 CQECKSUM 113 CT 28,41,76,113,169,172, 207,210 CTCA 42
- CA-ACF2 163, 168 Adabas Event Replicator Subsystem 29 f., 63, 68, 153 Adabas Multi-dient File 165 ADABAS_TIMEOUT 45,92 ADADBS V, 10, 24, 77, 79, 80, 84, 96, 196 ADADIR folder 46 ADAEND 79,97,101,104 ADAFRI 103 ADAFRK 79,104 Ada ln kx.dll 91 f. Adamplnkdll 91 f. ADANC6 74 ADANC8 74 ADARPD 26,29,39 ADARPL 63,65,67, 11 2 H., 213, 215 ADARUN parameters 19,23 f" 27 ff., 41,169,171 ADASAV 1 ADASCR 164 f" 167 amount fields 58 f. Apas/lnsigh t 20,119,153 AP! 43,59, 190 asynch ronous I/Os 46, 102 ASYTVS 19,23,27 ff" 76 f" 89, 101, 120, 170, 172 attached buffers - NAß 10 B bandwidth 9 f" 20 f" 126 f. BFIO 47,102,174, 179 b roker 9 f" 15 buffer fl ush 46 f" 76, 102, 109 buffer pool 7,13, 19,27,46,74 H., 95, 101 L, 109, 120, 122 buffer pool statistics 46
D data warehouse 1, 8 DATABASE - ID 29 DB2 8, 18,23,25,59, 190 f. DBCONNECT 29 DBID 20,26 H., 33, 36, 40 L, 49, 59, 64 L, 67 f., 71, 76, 81, 86, 89 ff., 100, 104 ff., 11 2 H., 121 f., 128 H., 133, 138, 142, 147, 151, 169 H., 191, 206 H., 218, 220 DOCARD 40 ff., 123, 125, 130, 132, 135 H., 144, 146 DDKARTE 29 f., 43, 123 DDPRINT 11,40 f., 57, 78 f., 90 H., 103 H., 109, 123, 125, 137, 141 L, 148, 181, 183, 217 Destination 30 f., 35, 36, 39, 64, 66, 81 L, 85 f.,97, 100, 114, 116f., 122, 124, 133 f., 136, 138 f., 144 f., 156 f., 160, 185,214 DESTINATION - DTYPE 29 destination database 15,17 f. Destination Definitions 30 f. Destination parameters 39
D. W. Storr, Efficient Usage of Adabas Replication, DOI 10.1007/978-3-8348-8214-1, © Vieweg+Teubner Verlag | Springer Fachmedien Wiesbaden GmbH 2011
226 DEUQP 106 disaste r and recovery - DIR V, 1, 8
diska rrays 10,46,101,106 DRIVER 42 f.
DSBI 24,77,151,194,196 DSBI=üFF 24, 77, 196 - before image 10 DSBI:ON 77 duplex circuit 20
Index
G GFB V, 13 H., 18, 30 H., 40, 84, 105 GFORMAT 29 G lobal Format Buffer 30 ff., 84 global formats 13 f., 16, 18, 26, 30, 38, 40 Global Formats 40 GLOBALS 29 GOPEN 30 GQFULLDELA y 30
H
E EBCDIC 96,206,208,212 EJESLNK 141 f. Encryption 164,166 f. Entire Net-Work 10, 15 H., 29, 41 H.,63, 90 f., % H., 11 9 L, 124 f" 128, 151, 154, 163,165,167,189 - wer 9f., 15 EntireX 9 f" 15, 18, 21, 29, 35, 48, 52, 78, 154,163,165 H., 220, 222 EntireX Broker 18,29,35,48,78, 154,
220 ERROR-139 112 ERROR-140 11 3 f. ERROR-148 114 f. ETBBROKERID 29 ETBBROKERNAME 29 EXCPs 72
HALT 67,101, 104,216 hard drive C - C-drive 101 hig h-water mark - HWM, high water mark 88,155
1/0 buffer 46, 76 1/0 pool see LFIOP initialization parameters 29 initial-state V, 10 L, 3D, 38, 58, 93, 107 L, 158 Initial-state 68, 147 INITIALSTATE 29 Ini tial-State Definitions 30 f. IPSec 20 IPSec VPN tunnel - Windows network 9
IQUEUE 30
F FBVALIDATION 29 file changes V, 11,80,84,105 FILTER 29 Filter Format Buffers 37,39 firewall 9 Firewall 127 FMXIO 19,23,27 H., 76 f" 89,101, 120, 169,172 format buffer 15 f" 21, 30 H., 34, 105 format buffers 9 f., 37, 39 format buHers (FB) 9 FTP 5,38,82,102, 148 L
IRMSGITERVAL 30 IRMSGLIMIT 30 ISN REUSAGE 93 ISNREUSE 83,93
J Java 5
K KERNEL 44,104 Key Performance Indicators - KPI 155 KPI 154 ff.
Index L
LBP 13,19,23,27 H., 46, 75 H., 89, 95, 101, 109 H., 120, 122, 169, 171, 173 f. - buffer pool 75 LDEUPQ 106 LDEUQP 28 f., 76, 89,169, 171 LFIOP 13, 19,23,27 H., 75 H., 89, 95, 101,109,120,169,171 f., see 1/0 Pool line speed 9 LINK 42,43 Linux 1,6 H., 15 H., 41, 43, 48, 91 LOGINPUTIRANSACf 19 LOGINPUTIRANSAcnON 29, 104, 121 LP 28 f., 76, 89, 169, 171 LRPL 13,19,23,26 H., 67, 71 f., 77, 87 f., 101, 11 2 H., 120 f., 129, 142, 169, 171, 182, 213 LU 19,27 H., 41 f.,76, 101, 169, 171 LUW 7,15 H., 43, 48 M MAXISN 83, 94, 107 f. MAXOUTPUTSIZE 30 MAXRECORDSIZE 30 MAXV ARRECORDSIZE 30 Mbps 9 f. message-oriented middleware - MOM 8 f. middleware 1,9 Mirroring 3, 4, 7 monitor routines 11 MQ 18,29,35, 171 MQQMGRNAME 30 MQSeries 8 f. MS SQL Server 8 Multi-dient Files 165
MySQL 8 MySQL Server 18 N NAß 10, 19,23,27 ff., 41 f., 71, 76, 86 H., 101,113, 121 f., 129, 131, 142, 169, 171, 182 H.
227
NAT3148 97 Natural RPC 9,48, 154,220 Natural Security 168 NC 19,27 H., 42, 71, 76, 87 r, 121 f.,131, 169, 171, 184 .NET 5,48 NETPFILl 125 f. NETPFIL2 125 f. network 9 Network 4, 15 f., 97, 101,119, 126 f., 135,143,166 NH 28 f., 71, 76, 87 f., 89, 121 f., 131, 169, 171 H., 184 NISNHQ 28 f., 76, 89, 110, 169, 172,174 Node 100, 125 NODE 42 f., 49, 90, 221 NOFDT 148,150, 194 NOSTD 148,150,194 NPADACALLS 30 NSC 168 NT 27f., 76, 11 0, 169, 171, 174 NU 27 f., 71, 76, 83, 87 f., 110, 121 f., 131, 169,171,174,184
o
041 153, 159 H. OC), circuit 9 OC3, circuit 9 O ptimize for Infrastructu re 153 H., 159 H. O rad e 5, 8, 18 overflow 10, 13,15 f., 18 f., 23, 26 f., 71, 87,89,95,101,109,1 12,1 20 f., 129 p persistent store 9,15 Ping 142, 180 PLCOPY 65 Predict 30 H., 40, 82 H., 105 PRQG=NETWRK 19,42 program migration 11
228
R RACF 163,168 raid technology - raid·1, rairl-S 7, 10 - raid-5 46,101, 106 RBL 20 f" 114 RDBMS 1,8 record (RB)
- record buffer 9 RECORDPLOGINFO 30,65 Recovery 63, 76 REPLA Y 11, 63, 67, 93, 112 ff., 121 , 213,215 replication buffers 10 replication engine 13,25,77 f. Replication Eogine 15,17, 19,27,40 f" 57,71,74 H., 86 H., 90, 101, 104, 108, 120 f" 124, 129, 178, 183, 185 f. Replication system file 13 H., 18 REPLICA TION=NO 19,27 H. REPLICATION=YES 19,23, 169 Replicator Engine 14,16,18,25,79, 104,130 Reptor 13 H., 18 f" 23 H., 40 f" 47, 67, 75 H., 84 H., 94 H., 101 H., 115 f., 120 fl., 132 .,144 H., 169, 171 L, 185 f" 213 RESENDBUFFER 30 Res ponse 131 114,117 response codes 46,57,63,94,105,114, 141 f., 183 RETRYCOUNT 30 RETRYINTERVAL 30 REUSEISN 107 f. router 9 RPL buffer 19,23,26,29,74 f., 77, 84, 87,89,105, 112, 120 RPL Flag 148 H., 194 RPLPARMS 27 f., 78, 97,171 RPLSORT 23, 169 RPWARNINCREMENT 23, 27 f., 169,171 RPWARNINTERVAL 23,27,169,171 RPWARNMESSAGELIMIT 24, 28 f., 169,171
Index RPWARNPERCENT 23 f., 27 H., 169,171 RSP 113 92 f., 106 H. RSP 131 113 f. RSP 148 97,100 f. RSP 153 43, 45,90,92,108 f. RSP 162 95,109 f. RSP1 76 106 RSP 224 100 RSP 254 87,113 RSP 52 105 RSP 98 94, 106f.
S SOC4 115 H., 213, 215, 219 SAF 104,163 H., 168, 221 SAN 19,46,101, 11 9 Secure Socket Layer 166 f. Security 50, 71,76,121 f., 127, 131, 163 ff., 184 Service.config 43, 45 SFFILTERGFBAI - after image 10, 37, 39 SFFILTERGFBBI - before image 10, 37, 39 60 files limit 112 SLOG V, 10, 11, 13, 15 H., 23, 26 H., 36,39,64,67,71,75,77 ff., 87, 89, 96 f., 101 H., 120 f., 132 H., 155 H., 171, 179, 185 H. slow - replication too slow 43, 101 H. Special characte rs 95 SQL Database 53 H. SSH 166 SSL 49,166 f., 221 Stress 104 Strobe 74 subscription V, 13 H., 26, 30, 32, 36, 38, 57 f., 63, 75, 77, 80, 82, 89, 93, 105, 11 9 ff., 129, 146, 158, 171 Subscription 13,22,30 f., 36, 37, 39, 64, 66,71,79,86,96,104,114, 116f., 122, 124,144 ff., 158 f., 169 f., 21 3
229
Index subscription database 14 H., 32, 36, 38, 57 f., 63, 77, 80, 82, 105, 120 f. Subseription Definitions 30 f. subscription log 15 H., 26, 75 Subscription parameters 39 SUBTASKS 30 SUBTASKWAIT 30 SVC 28,40 H., 49, 74, 76, 123, 169, 171 SYAOS 79 Sybase 8,18 Sybase ASE 8 SYSAOS 27,80 H., 96, 119, 121 f., 129 H., 135 ff., 144 H. SYSDlC 82 SYSDICBE 82 SYSRPTR 19,26 f.,38 ff., 122 System Autho rization Facility 163 System Management Hub 44 f., 98 H., 125,153
T target adapter 48 Target Adapter 38,48,52 f., 64, 69 target database 15 H., 20 f., 29, 35, 38, 41,43,47 f., 58, 60, 63, 75, 77 f., 80, 82, 84,86,89 H., 94 H., 100 H., 105 H., 112, 119 f., 125 L, 129, 142 Target Database 71,105,142,179 f. TARGETIO 19, 42 TCPl 42 TCPX 42 Teradata 8,18 TLOG 14,30, 3S f., 78, 119, 122 H. TLS 166 Token 64,67,81,1 14 H., 133, 138, 213 TOKEN 93,113 H., 213 Top Seeret - CA-Top Seeret 163,168 transaction-suspend 4 TRANSLAT 42 TI 28,45,76,92,1 10,169,172,174
U UBCKSUM 113 Unix 5 UNIX 1,5 H., 15 H., 41 H.,48, 91,154 unload 27, 30, 38 URBLTOOO 35 USR4011N 59,190 UTILONLY 78 UTILONL Y·YES 78
V VERIFYMOOE 30 VPN tunnel 20 VTAM 41 f. W WCL 16 f., 44 H., 92, 109 WCP 15 H., 29, 41 H.,97, 100, 109, 119 L, 124 H., 143, 151, 154, 179, 189, 206, 212, see Entire Net-Work wcr log 152 WebSphere MQ 18,30,35 Win2003 server 43, 46 Win2008 server 43 H. Windows 1, 5 H., 15 H., 41, 43 H., 58, 76, 80,82,90 f., 94,96, 98 H., 119, 122, 126, 128 L, 142, 153 L, 173 H., 179, 181, 183, 206,212 WLM 23,25 workload 7 Workload Manager 23,25 WRlTE_LlMlT 46,95, 102, 109 H., 174 wrong FOT 105 Wrong Replicated File 96
X Xts.eonfig 44 f. xtsurLdg 46
