Vous êtes sur la page 1sur 29

GENERAL INFORMATION

High Availability
for IBM iTM

21, Rue Rollin - 75005 Paris– France


Tél. : +33 (0)1 53 10 27 50 - Fax : +33 (0)1 43 26 26 42 - www.quick-software-line.com
Table of contents

1. GENERAL ORGANIZATION OF REPLICATION ......................... 5


1.1. General Diagram .................................................................................. 6
1.2. Software Components ......................................................................... 7
1.3. Prerequisites ........................................................................................ 7
1.4. OS/400 restrictions .............................................................................. 7

2. DIFFERENT MODES OF QUICK-EDD/HA................................... 8


2.1. « HIGH AVAILABILITY » mode ............................................................ 8
2.2. « DATA » mode .................................................................................... 8
2.3. « LOCAL » mode .................................................................................. 8
2.4. « VERIFY MODE » only ........................................................................ 9
2.5. “SRS” mode: Smart Remote Staging ................................................. 9
2.5.1. Reminder .............................................................................................9
2.5.2. How it works ........................................................................................9
2.5.3. How to set it up ....................................................................................9
2.6. Display depending on the mode ....................................................... 10
2.7. Counters ............................................................................................. 12

3. PREREQUISITE RULES ............................................................ 13


3.1. Objects auditing ................................................................................. 13
3.2. Journaling .......................................................................................... 13
3.3. Journal performances ....................................................................... 13
3.4. Receivers management ..................................................................... 14

4. STARTING WITH QUICK-EDD/HA ............................................ 15


4.1. Concepts ............................................................................................ 15
4.2. Glossary ............................................................................................. 18
4.3. Access to the menus ......................................................................... 20
4.4. Function Key General Rules ............................................................. 21
4.5. Global menu « EDH »......................................................................... 22

5. PMEDH* - LIST OF COMMANDS BY ALPHABETICAL ORDER


24

6. DATABASE FILES ..................................................................... 25


6.1. Capacity Limits (Record Length) ...................................................... 25

Quick-EDD/HA, Copyright © TRADER’S 2014 2


6.2. Full file management ......................................................................... 25

7. AUTOMATIC MANAGEMENT WITH JOURNAL ENTRIES ....... 26


7.1. Commands processing ..................................................................... 26
7.2. SNDJRNE *CMR, Processes on target system ................................ 27
7.2.1. Samples: daily backups made on target instead of source ................27
7.3. Continuous protection of the data during batch processes .......... 29

3 26/09/2014
Note: Quick-EDD/HA is meant to be used only by technicians and so, to be user
friendly, it is possible to access all the product functionalities thanks to any
entry point.
The product is built around a unique screen displaying the overview of the
replication properties and allowing the necessary access to the setup and
supervision.

Warning : RIGHT AFTER THE INSTALLATION, please send to your partner or


to Trader’s the PMEDH/PMSYSCOD screen shot, in order to get the product
KEYS.
Any temporary key request must be sent to support@traders.fr
Any permanent key request must be sent to keys@traders.fr

Quick-EDD/HA is a software made to provide security and continuity for the IBM i
environment. The product allows you to replicate easily and safely all events from a source
production system to a remote target system using a communication link.
Based on the continuous monitoring of the journals, Quick-EDD/HA replicates, on a remote
site, all the modifications made on the objects and data of the users’ libraries and the
configuration and security components; IFS or Spools are also managed by Quick-EDD/HA.

Quick-EDD/HA, Copyright © TRADER’S 2014 4


1. GENERAL ORGANIZATION OF
REPLICATION
Quick-EDD/HA consists of four steps:

 Event detection
The first step is a function to monitor all journals corresponding to the environment
parameters for any kind of transaction (i.e. creation, modification, deletion) related to any
defined object (i.e. data, PGM, user profiles, configuration, spools, IFS …)

 Communication
The second step is replication in real time of any detected modification on the source system.
The speed of the exchange is determined by the type of object and event: I/O transaction,
object transfer or data synchronization.

 Processing
On the target system, the detected event from the source system is processed immediately
in the same way. Depending on the type of event, Quick-EDD/HA has to manage one or
several data updates, perform an object restoration, or run a command in order to replicate
the modification (i.e. change of a password, system value…).

 Acknowledgement
To ensure a complete process and a perfect completion of transactions, every transaction
will be acknowledged in real time. The acknowledgement validates the whole process and
allows you to retrieve information for history and statistics.

Note: ALL OF THESE FUNCTIONS ARE EXECUTED IN A SYNCHRONOUS


MANNER BY Quick-EDD/HA.

5 26/09/2014
1.1. General Diagram

Data
OBJ
IFS

System SPOOL Event detection
PARAMETRAGE step
DB
AUDIT Journal DB Journal
Journal DB Journal
Journal
Management

SUPERVISION

TCP/IP 
Communications Communication
towards target
system

OBJ
SYS
SPOOL

Event integration
step
IFS
DATA I/O, RSTxxx,
command …

TARGET SYSTEM
Destination Libraries, IFS,
Spools …


Acknowledgement from
target to source

Quick-EDD/HA, Copyright © TRADER’S 2014 6


1.2. Software Components
Quick-EDD/HA consists of three main libraries:

 Library PMEDH contains all functionalities and processes. PMEDH, which is


approximately 6 MB in size, must be installed on both Production and Recovery
servers.
The name of this library can differ from PMEDH; but it must be the same on both
source and target systems.
 Library PMEDHUSR contains the Quick-EDD/HA objects that can be customized
(subsystem, job description …), the objects containing the settings for replication
(environments) and the switch scenarios.

The name of this library can’t be changed.


Library PMEDHUSR must be in the replication scope, because it contains all
information for the switchover / fail-over

A third library, PMEDHTOOLS, name which shouldn’t be changed, contains tools to


integrate replication functions into your general processes and specific tools for controls and
switch functions. This library can also include the source files of those tools, allowing you to
modify the tools to meet your unique needs.

1.3. Prerequisites
Quick-EDD/HA does not require either a specific feature of the IBM i nor specific model, but
needs TCP/IP communication features for connection between the systems.
Quick-EDD/HA uses the communication line configured on your system; it does not
automatically create, and does not manage, this configuration.

1.4. OS/400 restrictions


Quick-EDD/HA runs with all OS/400 releases from level V5R2M0 to V7R2M0.

Note: Please check with your reseller on the compatibility of the Quick-EDD/HA
with the OS/400 of the two systems.

Quick-EDD/HA allows you to have a maximum difference of TWO levels of


release between the operating systems of your source and target servers,
following the limitations of IBM SAV/RST functions.

Note: in case the source system runs on V5R3 or V5R4 and the target system runs
a V6Rx or V7Rx, the systems in V5R3 or V5R4 must have the appropriate
PTFs to accept V6Rx or V7Rx objects.
Each OS release has specific PTFs for that purpose.
If those PTFs are installed, switch is not an issue at all.

7 26/09/2014
2. DIFFERENT MODES OF QUICK-
EDD/HA
Quick-EDD/HA can be used in 5 different ways:
 « HIGH AVAILABILITY » mode allows 100% of the functionality
 « DATA » mode limits the replication to a subset of object types
 « LOCAL » mode replicates inside the same system (same partition)
 « VERIFY MODE » only compares the two systems and reports back on differences
 « SRS » mode allows replication to be active and keep sending the journal entries to
the target system, but the apply process of those journal entries is paused; for example
in order to perform daily backup on target system instead of source system

2.1. « HIGH AVAILABILITY » mode


HIGH AVAILABILITY is the focus of the product and allows all the functionality of replication
between a Production server and a Recovery server.

2.2. « DATA » mode


The “DATA” mode is a restricted use of Quick-EDD/HA used to replicate DATA only.
Only the following objects will be selected:
 Database files (PF LF)
 Data queues (*DTAQ)
 Data areas (*DTAARA)
 User profiles (*USRPRF) to keep ownership and authorities of the replicated objects

The “DATA” mode must be activated at “General parameters” level, in order to correspond
with the license key:
DATA replication mode 1

Note: The license key will automatically check for selection of objects

2.3. « LOCAL » mode


The “LOCAL” mode is a special usage of the product, when you want to replicate inside the
same server (same partition). In this case, restrictions are given by the system:
 It is not possible to replicate configuration objects located in QSYS such as user
profiles, or configuration objects
 Objects must be replicated into a DIFFERENT library
 IFS files must be replicated into a different root
 Spool files must be replicated into a different output queue
 System values cannot be replicated

Note: Replication in “LOCAL” mode can be done in both HA and DATA modes

Quick-EDD/HA, Copyright © TRADER’S 2014 8


2.4. « VERIFY MODE » only
The “verify” mode allows using a Quick-EDD/HA environment in order to compare two
systems. No change will be done either to the source objects nor to target objects. In this
specific case:
 the settings are the same as for a standard replication
 the audit is not activated on the objects
 journaling is not activated
 the process stops automatically right after the last object is checked

The “verify” mode has to be activated at the general parameters level:


Synchro servers - Mini 1 Synchro servers - Maxi 1
Verify mode only 1

Start the environment in Normal mode:


 Quick-EDD will create the list of elements to be controlled and then run the control into
the unique synchronization job.
 When the control is finished, the environment stops, the result is available in the
EDH_xx_S01 spool; xx being the name of the environment; produced by the
synchronization source job.
 The details of the performed control correspond to the IOA function, see
documentation EDD_HA_Supervision_EN.pdf.

2.5. “SRS” mode: Smart Remote Staging


2.5.1. Reminder
The SRS function inside Quick-EDD/HA allows you to keep sending the journal entries to the
target system and deactivate their apply process.
The objective is to give more availability for the target database, allowing customers to access
data on objects for backups, extraction of data, tests, etc. without stopping the high availability
process.

2.5.2. How it works


Usually Quick-EDD/HA is using an internal synchronous loop to read journal entries from the
source system, send and apply them on the target system, and then return an
acknowledgement back to the source system.
When you activate the SRS, you deactivate the apply process, and in this case journal entries
are stored on the target system in temporary user spaces. They will be applied later when you
reactivate the usual Quick-EDD/HA process.

2.5.3. How to set it up


- Stop the environment if it’s active
- In the second screen of the general parameters, choose the “Maxi storage SRS Mb” and/or
the “Maximum entries” that Quick-EDD/HA will use/store on the target system. This allows you
to adapt to the available target disk space.
- Before release V13_1212 of Quick-EDD/HA, outside the environment, use the tool
command EDHSRSOPT with option *ON

9 26/09/2014
Note: If you don’t use EDHSRSOPT, by default, the SRS process is limited to store
261k journal entries on the target system.

- From release V13_1212 of Quick-EDD/HA, command EDHSRSOPT is no longer needed


for new environments; any new environment will use the “Maxi storage SRS Mb” and/or the
“Maximum entries” settings, without the limit of 261k journal entries.

One command can be used to manage the SRS:


PMEDH/PMEDHMOD

On the target system, 2 options are available for SRS:


*NOIO: Deactivate the Apply process
*IO: Activate the Apply process (apply stored journal entries and restart synchronous
replication)

On the source system, 2 options are available for SRS:


*NOJRN: Deactivate the Read process
*JRN: Reactivate the Read process

Used in a CLP, from release V13_1212 of Quick-EDD/HA, command PMEDHMOD


must be submitted.

From V13_1212 of Quick-EDD/HA, 2 messages with severity 10 appear every 15 minutes


when *NOJRN or *NOIO mode is used:
EDH1771: !! *NOJRN mode on SOURCE from n mn
EDH1772: !! *NOIO mode on TARGET from n mn

2.6. Display depending on the mode


Here is the main screen of the environment. Each parameter line is displayed with dashes to
the left of the line:

EDH EN_SND Work Environment QSLFRA1 20/03/09


19:18:08

1=Insert 2=Modify 4=Delete 5=Display 8=Explore 9=Activity


M=Messages J=Journal S=Start E=End ?=Others

h ---- Synchro ---- - Wait - nbr


Type Descript. * Wait Ac ok nok hld rep obj
_ EN_snd Environment ---- -- ---- ---- ---- ----
_ General parameters
_ Target site -> QSLFRA2 PMSOFTICF
_ Journals +..5
_ Jobs
_ ----- Library parameters +..1
_ Libraries ---- -- ---- ---- ---- ---- +..1
_ ----- SYS object parms
_ ----- IFS parameters
_ ----- Spool parameters

F5=Refresh F10=View> F11=View< F12=Cancel F17=Top F18=Bottom F8=Select


F20=Job

Quick-EDD/HA, Copyright © TRADER’S 2014 10


Depending on the mode, the display of the screen and colour of the dashes can be different:

 For “DATA” mode, settings lines for IFS, SPOOLS and SYSVAL will disappear
 For “DATA” or “LOCAL” mode, dashes can be displayed in RED if some settings don’t
match the mode

Generally speaking, three colours are used for dashes:


 GREEN Settings level is available, and there is no group definition yet
 WHITE Settings level is available and some groups are defined
 RED Some group definitions don’t match the current mode. The corresponding
selections will be ignored.

« SRS » mode, when *NOIO is activated; that is to say when the apply process of journal
entries on the target system is paused:

EDH US_SND ---s Work Environment QSLTST1 8/07/13


noIO 14:26:35

1=Insert 2=Modify 4=Delete 5=Display 8=Explore 9=Activity


M=Messages J=Journal S=Start E=End ?=Others

h ---- Synchro ---- - Wait - nbr


Type Descript. * Wait Ac ok nok hld rep obj
_ US snd ENGLISH DOC ---s ---- ---- ---- ---- 1
_ General parameters
_ Target site -> QSLTST2 PMSOFTICF
_ Journals -> QAUDJRN +..1
_ Jobs +..2
_ ----- Library parameters
_ ----- SYS object parms
_ ----- IFS parameters
_ ----- Spool parameters
_ ----- SYSVAL parameters
End
F5=Refresh F10=View> F11=View< F12=Cancel F17=Top F18=Bottom
F8=Select F20=Job

Edh US_RCV ---s Work Environment QSLTST2 8/07/13


noIO 14:26:32

1=Insert 2=Modify 4=Delete 5=Display 8=Explore 9=Activity


M=Messages J=Journal S=Start E=End ?=Others

h ---- Synchro ---- - Wait - nbr


Type Descript. * Wait Ac ok nok hld rep obj
_ US rcv ENGLISH DOC ---s ---- ---- ---- ---- ----
_ General parameters
_ Target site -> QSLTST2 PMSOFTICF
_ Journals -> QAUDJRN +..1
_ Jobs +..2
_ ----- Library parameters
_ ----- SYS object parms
_ ----- IFS parameters
_ ----- Spool parameters
_ ----- SYSVAL parameters

11 26/09/2014
2.7. Counters
---- Synchro ----
 Wait => Number of objects waiting for synchronization
 Ac => Number of objects currently being synchronized
 ok => Number of synchronized objects
 nok => Number of objects in synchronization error

Note: « nok » objects indicate a « fatal » error which occurred during


synchronization.
Every 5 minutes, Quick-EDD/HA will retry to synchronize these objects.
In certain cases, a manual control is mandatory, to solve the error and trigger again
a synchronization (see EDD_HA_Daily_Checklist.pdf)
When the error is solved and the synchronization is done the « nok » counter is
decremented.

Wait
 hld => Journal entries that are held by Quick-EDD/HA.
When, for example, a synchronization is running, all the new journal entries of the object are
held, in order to be applied at the end of the synchronization (last step of the
synchronization).
 rep => Journal entries sent to the target and not acknowledged yet

Nbr obj
 nbr obj => Number of elements inside the sub menu

Quick-EDD/HA, Copyright © TRADER’S 2014 12


3. PREREQUISITE RULES
3.1. Objects auditing
Quick-EDD/HA activates auditing on all the objects included in the replication (*CHANGE).
Notice that after auditing activation, some functions will be automatically audited.
If auditing is not currently in use on the system, Quick-EDD/HA will automatically create the
necessary elements (receiver QGPL/AUDRCV0001 and journal QSYS/QAUDJRN) and
activate the minimum needed system values, as a result of the installation. No existing
value will be modified automatically: neither QAUDLVL or QAUDCTL, nor the auditing
value within already audited objects.
The values on your systems will have to be checked.

The audit journal can receive a large amount of entries. Therefore, its management
has to be defined with care.
When the replication is started for the first time, auditing is activated on every object;
this action may impact your backup if you are using a SAVCHGOBJ command (all
objects may be modified, so they will be saved).

3.2. Journaling
Quick-EDD/HA will dynamically start journaling on files and other special objects (DTAQs,
IFS …) depending on the defined settings (see EDD_HA_Settings.pdf).
Because of the large number of objects, it may be judicious to split the different applications
and environments into different journals. This will avoid reaching system limits, and makes
the system easier to maintain and manage.
It is also possible to process files without journaling in specific cases:
 Files which are never updated and kept sometimes for historical purposes, such as EDI
files
 Archives
For those special cases, use specific management functions, which allow you to manage
files like non-database objects (See Non journaled files in EDD_HA_Settings.pdf).

3.3. Journal performances


Journal activation undoubtedly has an effect on server performance, and moreover, the
transmission of entries will have repercussions on the network.
It is therefore imperative to understand the process in its whole so that this activation doesn’t
provoke dysfunction on the production system.
The implementation of Quick-EDD/HA should take advantage of available functions:
 Automatic management of the receivers
 Performances – Journal options

13 26/09/2014
3.4. Receivers management
The HA process is fully based on journaling. Quick-EDD/HA allows you to manage journals
and journal receivers, their detachment, and their deletion, depending upon the settings you
choose.

We have to confirm that journals and journal receivers are not used by some other
function in the system or by another software application. If existing journals are
used for an application, you do not want Quick-EDD/HA to delete the receivers
before the other application has completed their processing.
Depending on the needs and the configurations (OS/400 release level), you will
have to setup carefully the receivers management, see EDD_HA_Journaling.pdf

Quick-EDD/HA, Copyright © TRADER’S 2014 14


4. STARTING WITH QUICK-EDD/HA
4.1. Concepts
Quick-EDD/HA has been designed for simplicity for the system administrator and for high
performance to ensure smooth and accurate replication.
We defined these rules to achieve those goals:

 Independence between settings and processing

o Settings are defined in environments and groups, depending on application or software


used.
o The process reads the journals, runs updates and database I/Os in sequence to
replicate operations on the target system, without taking into account the group from
which the event is issued.

 Minimize active jobs in the system. Quick-EDD/HA dynamically controls the number of
jobs depending on activity.

o Only one master job ensures the follow-up of all journals and the real-time replication
o Server jobs, dynamically managed, are charged with synchronization. The minimum
and maximum numbers of server jobs are defined in the settings.

15 26/09/2014
APPLICATIONS
APPLICATIONS
IFS DTAQs ???
APPLICATIONS
APPLICATIONS

 DB JOURNAL
DB JOURNAL
DB JOURNAL D IFS Journal DTAQs Journal Vx.Rx Journal
DB JOURNAL

SETTINGS

QAUDJRN Quick-EDD/HA


PROCESSING
AUDIT Journal SUPERVISOR

Données (EDD) SAV/RST


COMMANDS SPOOLS SYSVAL JOBS


Données (EDD) SAV/RST
DATA (I/Os) SAV/RST
The previous schema shows the general organization of Quick-EDD/HA:

  The settings part depends on your applications and your journals (currently used or
to be created during the implementation of Quick-EDD/HA).
 Groups are defined by the customer or the assigned software engineer, depending
on replication rules defined previously for the system.
 They are used to make parameters easy to follow, understand and maintain.
 The journal list is automatically built by Quick-EDD/HA directly from file descriptions,
and depending on the groups settings linked with automatic journaling activation.

 


The supervisor reads all the journals AT THE SAME TIME, including the audit journal
QAUDJRN.
This functionality allows the processing of all required system events, in the correct
sequence, on the target system.

 


The supervisor dispatches the different transactions, depending on the type of
function to process.
DATABASE replication – processing of input/output transactions on records
(CRT/UPD/DLT) and some commands on members (INZPFM, CLRPFM …)
 Commands SAV/RST for new objects or important modifications that need to
recreate the object(s) on the target system
 Commands that will reproduce a modification (change password, object modification
…) on the target system
 Manage system values
 Send/delete spool files
 Send information from jobs running on the source system

17 26/09/2014
4.2. Glossary
The documentation of Quick-EDD/HA respects the terms usually used in IBM i
environments.
The list below details the vocabulary specific to Quick-EDD/HA.

Environment
The environment, in Quick-EDD/HA context, corresponds to a setup table, gathering all the
settings to replicate to an IBM i server or partition.
Environment objects have been created to make it possible to differentiate between
different applications, and/or different distribution areas (application environments, multiple
remote sites …). This distinction makes the management easier and more logical, and
expands the maintenance capability.
Environment configuration is stored in an IBM i object, of type *USRIDX, which will be
created in the library PMEDHUSR. The object name is xx_SND on the source system (xx
represents the environment name), and xx_RCV on the target system.
Note: depending on the amount of set information, the *USRIDX may be
followed by *USRSPC, named xx_SNDnnn on the source and xx_RCVnnn on
the target; nnn ranges from 001 to 255. In that case, all objects xx_S* (or xx_R*) are
the environment.
*USRIDX xx_SND and xx_RCV are exactly identical on the source and target system.
So are *USRSPC XX_SNDnnn and XX_RCVnnn.

All other XX* objects of PMEDHUSR are linked to the activity with:
- Pointers on current positions
- Storage of journal entries to manage different functions:
 Running entries if a commit cycle is opened
 Storing new journal entries during a synchronization
 SRS: Smart Remote Staging

Each time the environment is started all RCV objects are recreated during the "Send
parameters" step. So, if you accidentally delete the objects on the target, it is not an issue.
Any missing object will be recreated when the replication is started, including the object
XX_MSG containing the replication messages.

Warning: if there are stored journal entries on the target - objects xx_RCO* - and if
you delete those objects, it won’t be possible to restart the environment by
processing the residual journal entries; see EDD_HA_Supervision for more details

Target or Recovery System


Basically, HA needs a target system for switching while the production system is down for
any reason. That term will be used often. The source system is often named « production
system ».

Site
For Quick-EDD/HA a site is a target system.
Usually, a site corresponds to a network node name or a TCP/IP address. Quick-EDD/HA
uses the site to establish communication between source and target systems.

Quick-EDD/HA, Copyright © TRADER’S 2014 18


Group
A group allows you to manage a unique entity or a coherent set of objects following the
same replication rules. There are five different types of domains involved in managing the
different parts of IBM i. Each domain will have one or several groups:
 Objects – All types of objects which can be created in a user library (database or
not).
 Configuration – The objects created in QSYS library (security and configuration).
 IFS – The objects corresponding to an organization by directory
 Spools – The spool files on the source system are replicated to the target.
 System values – Most system values can be replicated.

The group is also very important to organize your replication. Logically organized groups
make your installation easier to maintain and modify in the future.

19 26/09/2014
4.3. Access to the menus
The standard command to enter Quick-EDD/HA is "PMEDH". This command, without
parameters, displays the main menu. Note: The menu may differ from this document
depending upon the release level of the software.

QSLFRA2 Q U I C K - E D H 13/03/10
GODEC PMsoft Inside 15:44:43
_____________________________________________________________________________
High Availability www.pmsoft.net V100205
www.quick-software-line.com
_____________________________________________________________________________
Select one of the following options:

Sender site Remote site


1. Parameter
2. Start
3. Control 3. Control
4. Stop

7. Commands
8. Messages
9. Object

Option, or command

===>_________________________________________________________________________
F3=Exit F4=Prompt F9=Recall F12=Cancel F13=PMsoft system

The menu has 3 kinds of options:

Functions for the Sender site


 Access to settings
 Start of the replication
 Control of the replication
 Stop of the replication

Function for the Target site


 Control of replication

Other functions
 List of Quick-EDD/HA commands
 Messages for the replication
 Management of the objects linked to replication

Quick-EDD/HA, Copyright © TRADER’S 2014 20


Function keys:
 F3=Exit Exit from job
 F4=Prompt Prompt of command
PMEDH* commands list if the command line is blank
 F9=Recall Retrieve previous command
 F12=Cancel Return to previous screen

4.4. Function Key General Rules


Quick-EDD/HA sticks to IBM standard Function Keys rules for OS/400:

F3=Exit End of process – Exit menu


F4=Prompt List for commands
Also, list of PMEDH* commands if command line is blank
F5=Refresh Refresh data on screen
F6=Create Create a new element
F9=Retrieve Retrieve previous processed commands
F10/F11=View Display more line information on a sub file
F12=Cancel Cancel – Back to previous screen
F14=Children Used when deleting a setup element
deletion
F16=Deletion Used when deleting a setup element
of everything
F17=Top Display from the top of the list (sub file)
F18=Bottom Display the end of the list (sub file)
F19=Left Move on to the left (display longer than 80 characters)
F20=Right Move on to the right (display longer than 80 characters)

21 26/09/2014
4.5. Global menu « EDH »
A global menu « EDH » allows you to manage all options from the two menus « PMEDH »
and «EDHTools » (tools of Quick-EDD/HA).
This is now the main menu of the product.

Note: The menu may differ from this document depending upon the release level of the
software.
Check that you have PMEDH and PMEDHTOOLS in your library list; then run command
EDH. The following menu is displayed:

QSLFRA2 65117EA Quick-EDD/HA - Tools V13_0416 23/04/13


GODEC PRODUCTION 16:09:54
____________________________________________________________________________
EDH - HIGH AVAILABILITY Quick-EDD/HA : V130318
____________________________________________________________________________
Select one of the following options:

Parameters Activity
1. Work with environments 6. Manage replications
2. Manage specific objects
3. Supervision parameters 7. Start supervision process
4. Monitoring options 8. Start msg monitoring
5. Monitoring filtering

Switch Others
11. Work with switch scenarios 21. Display EDH messages
12. Run switch scenario 22. Work with objects (PMEDHUSR)
23. Tools menu - EDHTools
Option, or command
===>______________________________________________________________________
__________________________________________________________________________
F3=Exit F4=Prompt F9=Repeat F12=Cancel

This menu introduces the different available options with one focus: to perform, in
sequence, all operations from the definition of settings (options 1 - 5), and then execution
of environments (options 6 – 8) to implementation of the additional tools (options 21 - 23).

Four categories are available on this menu:


SETTINGS
 1 – Setup the replication environments
 2 - Setup the management of specific objects
 3 – Setup the supervision
 4 – Setup the monitoring options (MSGQ, E-mail, SNMP)
 5 – Setup monitoring filtering options (MSGQ, E-mail, SNMP)

ACTIVITY
 6 – Manage replications
 7 – Start supervision process
 8 – Start monitoring

Quick-EDD/HA, Copyright © TRADER’S 2014 22


SWITCH
 11 – Setup the switch scenarios
 12 – Run switch scenarios
ADDITIONAL TOOLS
 21 – Display Quick-EDD/HA messages
 22 – Manage objects (PMEDHUSR)
 23 – Access to the tools menu

Note: Libraries PMEDH and PMEDHTOOLS must be in the library list of your job
before running EDH command.

Release numbers
Two release numbers are displayed on the main menu:
In the title, version is corresponding to the tools library (PMEDHTOOLS
library).
On the right, « Quick-EDD/HA: Vnnnnnn » is the release corresponding
with the product itself (PMEDH library).

Function keys:
 F3=Exit Exit from job
 F4=Prompt Prompt of command
 F9=Recall Retrieve previous command
 F12=Cancel Return to previous screen

The main menu includes a control of the license key. If the key is expired or if the
key will expire in the next 2 days a red message will be displayed on the top of the
screen: QSL/PMsoft software 13 not available since the 27/04/10 07:47:22

23 26/09/2014
5. PMEDH* - LIST OF COMMANDS BY
ALPHABETICAL ORDER
Some Quick-EDD/HA functions might be used externally in users ‘programs through
commands in the software library. Those commands will be detailed in appropriate
chapters of the documentation.

 PMEDHCHK Check environment activity


 PMEDHCOPXR Reorganize the environment: to be used by the support team
 PMEDHCOPXX Copy the environment: to be used by the support team
 PMEDHCTL Environment management function: deprecated
 PMEDHEND Stop an environment
 PMEDHGEN Generation and start of audit and journaling per the configuration
 PMEDHINSG Insert a setting line
 PMEDHJRCHK Check journal receiver status
 PMEDHJRNPO Specific journal position
 PMEDHMOD SRS, Execution mode for the environment
 PMEDHOPENV Various actions on the environment: Hold, Release, Stop…
 PMEDHOPXCF Options for configuration objects
 PMEDHOPXIF Options for IFS
 PMEDHOPXJO Options for Jobs
 PMEDHOPXOB Options for libraries and objects
 PMEDHOPXSP Options for spools
 PMEDHOPXSV Options for system values
 PMEDHPARUN Access performance settings: to be used by support team
 PMEDHPURGE Purge of the deleted elements
 PMEDHRCI SRS and failover : Apply stored journal entries on target before
switching
 PMEDHRCO Failover : Commit management
 PMEDHSBMJ Failover : Jobs Follow Up
 PMEDHSBMP Failover : Jobs Follow Up
 PMEDHSTR Start options for the environments
 PMEDHSWI Switch of the environments
 PMEDHWAT Internal supervision management
 PMEDHWRK Access to the environments

Quick-EDD/HA, Copyright © TRADER’S 2014 24


6. DATABASE FILES
6.1. Capacity Limits (Record Length)
The OS/400 system allows you to create physical files with a maximum length of record of
32,766.
This value can be reduced in case the function “allow null” is used at the field level; in this
case, the maximum length is reduced by as many bytes as the number of fields using this
functionality (one field ”allow null” = one byte less).
Besides, the OS/400 requires 11 complementary bytes for “reading by blocks” function.
The limits of Quick-EDD/HA are therefore identical to those of the system;
that means 32,755 bytes (32.766 - 11), less the possible number of bytes
bound by the function “allow null.”

6.2. Full file management


When a PF gets to its critical size, message CPA5305 is sent by the system to the console.
The answer ‘I’ allows to add an increment and to continue processing.
For the same reasons, message CPA3138 is sent after a command INZPFM. That second
message must be managed the same way.
Unfortunately, that transaction does not change the object and logically is not present in the
System Audit Journal, so Quick-EDD/HA is not able to detect that modification and
replicate it to the target system.

Solution:
ON THE TARGET SYSTEM
 Add messages CPA5305 and CPA3138 to the system reply list
ADDRPYLE SEQNBR(1000) MSGID(CPA5305) RPY('9999')
ADDRPYLE SEQNBR(1001) MSGID(CPA3138) RPY('I')
(Change sequence number if needed)

 Change PMEDH job description to use the system reply list


CHGJOBD JOBD(PMEDHUSR/PMEDH) INQMSGRPY(*SYSRPYL)

Note: System reply list is unique; however, only jobs with description (JOBD)
using the value INQMSGRPY(*SYSRPYL) will be affected by the
modification.

25 26/09/2014
7. AUTOMATIC MANAGEMENT WITH
JOURNAL ENTRIES
Some Quick-EDD/HA functions can be managed with journal entries.
 Hold an object  *HLD
 Release an object  *RLS
 Synchronize an object  *SYN
 Job follow-up  *JOB
 Stop the replication  *END
 Local command  *CMD
 Remote command  *CMR
 General control (I.O.A.)  *CTG / *VFY // *VFN (Previously ignored objects)
 SRS  *IOE
 SRS  *IOS
 SRS  *JRE

Those functions could be automated by sending a journal entry in the audit journal this
way:
SNDJRNE JRN(QAUDJRN) TYPE('EH')
ENTDTA('*ACT**&OBJNAM&LOBJNAM&OBJTYPFORCE(*YES)')

Message syntax is the following:

 Type Entry « EH »
 ACTION Position 1 – Length 4 value (*HLD/*RLS/*SYN…)
 Env. Code Position 5 – Length 2 (**=All)
 OBJECT Position 7 – Length 10
 LIB. Position 17 – Length 10
 TYPE Position 27 – Length 8
 FORCE Position 35 – Length 11 value ‘FORCE(*YES)’

If using *SYN function, as in EDHOBJREP, all elements in hold will be released

7.1. Commands processing


The options *CMD and *CMR allow you to submit, thanks to Quick-EDD/HA, commands
which will be processed either on the source system (*CMD) or on the target system
(*CMR).
The IBM i already provides standard functions, such as RUNRMTCMD, to process this kind
of job. This said, if you use Quick-EDD/HA to process a command, the latter will be
processed respecting the sequence: the command will be processed at a specific
moment of the operations.

Quick-EDD/HA, Copyright © TRADER’S 2014 26


7.2. SNDJRNE *CMR, Processes on target
system
By using this special type of journal entry, SRS will be automatically used, for example, to
manage backups on the target system instead of the source system.

Here are the details:

7.2.1. Samples: daily backups made on target instead of source

Performing your backup on the target system is now really simple thanks to SRS.
You just have to write the CLP that will launch the backup; Quick-EDD/HA will handle the
rest of the process.

Sample 1
Your standard CLP that does backups on the source system is written as follows:
PGM
….
SAVLIB SAVLIB(XXXXX) DEV ...
SAVDLO ...
SAVCFG ...
….
ENDPGM

You already have tested this program. It must be present on target system.
All you have to do now is submit it using the remote command function from Quick-
EDD/HA.
For that you will only have to send a journal entry in the audit journal using a SNDJRNE.

This journal entry, using the special code *CMR (remote command) and containing the
CALL command will be sent on the target system and the program will be executed by a
Xnn server job of the environment.

SNDJRNE JRN(QAUDJRN) TYPE('EH') ENTDTA('*CMRXXCALL YYYYYY')


 *CMR
 Replace XX with the name of the environment
 CALL YYYYYY: the name of your CLP, which must be in a library present in the library
list of the Xnn jobs

When a *CMR command is processed, Quick-EDD/HA will automatically do the following:


- Apply and acknowledge all previous entries
- Close all opened files
- TURN the target environment to *NOIO: apply process is stopped
- Run the command defined in the journal entry  YOUR BACKUP
- When the program is finished the environment is turned back to *IO: apply process
restarts

Using such a scenario you can very easily make a backup from your target system
with only a standard CLP.

In case there are several environments, for example E1, E2 and E3, the target
CLP will be called by the command SNDJRNE JRN(QAUDJRN) TYPE('EH')
ENTDTA('*CMRE1CALL YYYYYY') and must contain :

27 26/09/2014
PGM
SBMJOB (PMEDHMOD ENV(E2) ENT(*RCV) MOD(*NOIO)…)
SBMJOB (PMEDHMOD ENV(E3) ENT(*RCV) MOD(*NOIO…)
….
SAVLIB SAVLIB(XXXXX) DEV ...
SAVDLO ...
SBMJOB (PMEDHMOD ENV(E2) ENT(*RCV) MOD(*IO)…)
SBMJOB (PMEDHMOD ENV(E3) ENT(*RCV) MOD(*IO)…)
ENDPGM

Sample 2
Depending on companies it is sometimes required to validate the backups, and if the
backup failed IT IS MANDATORY to run the backup again AT THE SAME POSITION.
Using sample one it is not possible to do that. When the CLP is finished – even if it failed -
the environment is turned back to *IO automatically.
If a customer wants to validate backups as described, the CLP will have to be more
sophisticated to manage separately the SRS and the backup itself:
The backup can be submitted either by the source or the target system
The main CLP program will use the PMEDHMOD command to turn the environment to
*NOIO
The backup will be executed – May be a CALL or independent SBMJOB
Option 1 – The backup CLP is well monitored and if it finishes normally the
PMEDHMOD command is used to turn back the environment to *IO
Option 2 – If the CLP fails for any reason, the environment stays in *NOIO and
the operator can take the decision to run a new backup or to manually turn the
environment back to *IO.
In this case the most important is that the PMEDHMOD is not managed automatically
by the *CMR function but as an independent function. The decision to reactivate the
*IO process will require a program or a manual operation done by the operator.

Quick-EDD/HA, Copyright © TRADER’S 2014 28


7.3. Continuous protection of the data during
batch processes
If you wish to suspend the apply process of the journal entries on the target system while
your batch jobs are running on the source system; and restart the apply only if those batch
jobs ended properly, 2 types of journal entries can be sent to the audit journal:
SNDJRNE JRN(QAUDJRN) TYPE('EH') ENTDTA('*IOEXX'), XX has to be replaced by the
name of the environment; *NOIO mode starts immediately.
Then, you can launch the batch jobs.
If they ended as expected:
SNDJRNE JRN(QAUDJRN) TYPE('EH') ENTDTA('*IOSXX'), XX has to be replaced by the
name of the environment; *IO mode starts immediately to apply the corresponding journal
entries on the target.

If the batch jobs failed and you don’t want to apply their result on the target system, you
only have to stop the environment and delete the objects PMEDHUSR/XX_RCO*. Then,
you can skip the journal entries related to the batch jobs, and restart replication.

Note: A third type of journal entry,*JRE, allows you to stop the reading of the journals
on the source system. In such a case, the PMEDHMOD command, used with option
*JRN, allows you to restart reading the journals.

Attention: journal entries *JRE, *IOE and *IOS are processed by the SND job.
Therefore, if you send a *IOE entry when there is latency; *IOS entry might be sent
too soon: the environment will remain in *NOIO until someone notices it.

29 26/09/2014