Documentation Quick
Transcription
Documentation Quick
TOOLS High Availability for IBM Power 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. TOOLS – GENERAL INFORMATION .............................................6 1.1. EDH – Main Menu .......................................................................................... 6 1.2. EDHTOOLS – Menu....................................................................................... 7 2. OPTION 2 OF EDH MENU – MANAGE SPECIFIC OBJECTS .....9 2.1.1. 2.1.2. 2.1.3. 2.1.4. EDHSAVDTA - Backup parameters .......................................................9 Run of system backup ..........................................................................11 Restore system data: switch on backup system - EDHSAVSWI .........11 Restore initial attributes (switch back) – EDHSAVSWR ......................12 3. MONITORING AND AUTOMATIC RESTART ............................. 13 3.1. Monitoring ..................................................................................................... 13 3.1.1. 3.1.2. 3.1.3. 3.1.4. Monitoring filtering.................................................................................14 Start Monitoring, Command EDHMONMSG ........................................15 Automatic alerts: tool EDH_STATUS ...................................................15 Stop monitoring .....................................................................................16 3.2. Automatic restart of the replication after an incident – EDHCTL... 17 3.2.1. Parameters............................................................................................17 3.2.2. EDHCTL – Start supervision.................................................................18 4. JOURNALING ................................................................................ 20 4.1. Option 1-5 – Audit ....................................................................................... 20 4.2. Option 6 – Journal manager ..................................................................... 20 4.2.1. 4.2.2. 4.2.3. 4.2.4. 4.2.5. 4.2.6. 4.2.7. 4.2.8. Option 31 – Work with Journal management rules ..............................20 Option 32 – Search / Insert journals .....................................................23 Option 33 – Start Journal Manager ......................................................24 Option 34 – End Journal Manager........................................................25 Option 35 - Replace journal receiver / delay ........................................25 Option 36 - Delete old journal receivers ...............................................25 Option 37 – Start of file journaling ........................................................26 Option 38 – End of journaling ...............................................................26 4.3. DTAARA QDFTJRN – EDH_DFTJRN ...................................................... 26 4.4. Change journal management rules – EDHCHGJA (if no Journal Manager)................................................................................................................... 26 4.5. Journaling rules on source and target – EDHJRNOPT, EDHJRNOPL............................................................................................................ 27 4.5.1. EDHJRNOPT ........................................................................................27 4.5.2. EDHJRNOPL ........................................................................................28 4.6. EDHJRNRLS ................................................................................................. 28 4.7. EDHCLRJRN ................................................................................................. 28 5. ANALYSIS...................................................................................... 29 2 12/07/2013 3.1. Option 11 to 14 – Database analysis......................................................... 29 3.1.1 Options 11 and 12 – Interactive analysis ................................................29 3.1.2 Option 13 - Full analysis (batch) – EDHANZL.........................................30 3.1.3 Option 14 - SQL - Analyze Identity fields ................................................31 3.4. Option 15 - Analyze constraints - EDHCSTANZ..................................... 32 3.5. Option 16 - Analyze triggers – EDHTRGANZ.......................................... 33 5.1. Options 16 and 17 - Analysis of the bandwidth – EDH_ANZDBA and EDH_ANZDBL ................................................................................................. 33 5.2. Option 19 – EDHIFSANZ ............................................................................ 34 5.3. Analyze journals – EDHANZJ................................................................... 35 6. CONTROLS.................................................................................... 36 6.1. Option 21 – User Profiles management ................................................ 36 6.2. Option 22 - User Profiles Activation - EDHUSRENA.......................... 36 6.3. Option 23 – Disable User Profiles - EDHUSRDIS ................................ 37 6.4. Option 24 – Check the Libraries - EDHCHKLIB................................... 37 6.4.1. Use on the source system ....................................................................37 6.4.2. Use on the target system ......................................................................37 6.5. Option 25 – Interactive Check of the Libraries - EDHCTLLIB.......... 37 6.6. Option 26 - Objects control (target) - EDHCHKOBJ........................... 39 6.7. Option 27 – Periodic control of replications – EDHEXAM................ 40 6.8. Option 28 – Supervise replication activity - PMEDHWAT ................ 40 6.9. Option 29 - Run Verify function – EDHIOAEXC................................... 41 7. OTHER COMMANDS .................................................................... 42 7.1. Options 41 à 45 – PMEDHOPX* ............................................................... 42 7.2. Option 45 - Statistics per Objects – EDH_STATS............................... 44 7.3. Option 46 - Statistics per Jobs – EDH_STATJ .................................... 45 7.4. Option 47 - Collect performance data – EDH_PERF .......................... 45 7.5. Option 51-Migration Kit - EDH_MIGKIT .............................. 46 8. REMOTE PROCESS AND BACKUP ........................................... 47 8.1. S.R.S. (Smart Remote Staging) - Storage of the journals entries .. 47 8.1.1. Independent management of I/Os ........................................................47 8.2. TRP – « Total Remote Process » / Remote control ............................ 48 8.2.1. List of functionalities..............................................................................48 8.3. CDP - Continuous Data Protection ......................................................... 48 8.3.1. Backup request - EDHCDPRQS ..........................................................49 8.3.2. Run backup request - EDHCDPEXC ...................................................49 8.4. Remote backup - EDHSAVRMT ............................................................... 50 3 12/07/2013 8.4.1. 8.4.2. 8.4.3. 8.4.4. Remote backup – How it works ............................................................50 Submit the remote backup - EDHSAVRMT..........................................50 Adaptation of the program EDHSAVRMT2 ..........................................51 Usage a group code..............................................................................51 7.5. Remote backup using BRMS - EDHBRMSRMT...................................... 52 7.5.1. BRMS/Quick-EDD/HA – How it works ....................................................52 7.5.2. Submit the remote backup - EDHBRMSRMT ........................................52 7.6. Remote backup and S.R.S ........................................................................... 52 9. SWITCH.......................................................................................... 53 9.1. Command EDHCVTSEL ............................................................................. 53 9.2. Commands EDHDB2SAV and EDHDB2RST ........................................ 53 10.3. Command EDHJRNU .................................................................................. 53 9.3. Command EDHMQSYNC ........................................................................... 54 9.4. EDHSAVSWI / EDHSAVSWR .................................................................... 54 9.5. EDH_NWSUSR ............................................................................................. 54 9.6. EDH_ROLE .................................................................................................... 54 9.7. Option 11 of EDH menu - Switch Scenarios ........................................ 55 9.8. Run a switch scenario – EDHSWIRUN .................................................. 58 10.5.1. Step by step mode ................................................................................58 10.5.2. Interactive mode....................................................................................59 10.5.3. Batch mode ...........................................................................................59 10.5.4. Spools allowing to track the scenarios processing...............................59 10. MISCELLANEOUS COMMANDS................................................. 61 10.1. EDHOBJERR................................................................................................. 61 10.2. Adapt synchronization servers – EDHSVRA ....................................... 61 10.3. EDHSTART Command: start of environments and tools ................. 61 10.4. EDHSTOP Command: stop of environments and tools .................... 62 10.5. Replication of ACG application – EDH_ACGINS ................................ 62 10.6. Synchronize a library - EDHOBJREP ..................................................... 62 10.7. Data Extraction - EDHRTVINF .................................................................. 63 11.4. Data Extraction - EDHRTVINX .................................................................. 63 4 12/07/2013 Note: This document is dedicated to the tools of Quick-EDD/HA. Those tools are delivered with their sources, in order to be adapted to any system. Tools and their sources are available here http://www.quick-software-line.com/UK/quick-eddha-download.html Those tools can be described as well in other parts of the documentation, when it’s accurate 5 12/07/2013 1. TOOLS – GENERAL INFORMATION 1.1. EDH – Main Menu The Tools library provides a general menu to access to the product, allowing you to manage both the Quick-EDD/HA product and associated tools. Verify that you have PMEDH and PMEDHTOOLS libraries in your library list. Type the command EDH and press enter. The main menu is displayed: QSLTST1 06DE8ER Quick-EDD/HA - Tools V13_0705 10/07/13 GODEC PRODUCTION 16:07:50 _________________________________________________________________________ EDH - HIGH AVAILABILITY Quick-EDD/HA : V130627 _________________________________________________________________________ Select one of the following options: Parameters 1. Work with environments 2. Manage specific objects 3. Supervision parameters 4. Monitoring options 5. Monitoring filtering Activity 6. Manage replications Switch 11. Work with switch scenarios 12. Run switch scenario Others 21. Display EDH messages 22. Work with objects (PMEDHUSR) 23. Tools menu - EDHTools 7. Start supervision process 8. Start msg monitoring Option, or command ===> F3=Exit F4=Prompt F9=Repeat F12=Cancel Menu gives access to any needed option: Parameters Work with environments Manage specific objects Supervision parameters Monitoring options Monitoring filtering Activity Manage replications Start supervision process Start msg monitoring Switch Work with switch scenarios Run switch scenario Others Display EDH messages Work with objects Tools menu 6 See Quick-EDD/HA documentation Save of specific objects EDHCTL command Monitoring setup Depending on monitoring setup See Quick-EDD/HA documentation EDHCTL command Monitoring start Fill in the scripts EDHSWIRUN command DSPMSG PMEDHUSR/PMEDH WRKOBJ PMEDHUSR/*ALL *ALL EDHTOOLS 12/07/2013 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 1.2. EDHTOOLS – Menu Command EDHTOOLS, and option 23 of EDH menu, give access to the tools main menu. This menu displays the most used tools grouped by domain. It also gives you access to system audit control function. Note: This command needs that PMEDHTOOLS and PMEDH libraries are in your work environment (*LIBL) QSLFRA2 Q U I C K - E D H 6/01/12 GODEC 14:16:28 ____________________________________________________________________________ TOOLS - Other tools V12_0103 ____________________________________________________________________________ Select one of the following options: Audit options 1. Audit status 2. Audit System Values 3. QAUDJRN journal attributes 4. Display QAUDJRN entries 5. Display QAUDJRN journal Journaling 6. Journal Manager More Option, or command ===>_______________________________________________________________________ ___________________________________________________________________________ F3=Exit F4=Prompt F9=Repeat F12=Cancel (c) PMsoft 1996 - 2011 AUDIT Options 1. Audit status 2. Audit-related system values 3. Attributes of audit journal QAUDJRN 4. Display QAUDJRN entries 5. Display journal QAUDJRN Journaling 6. Journal Manager 7 12/07/2013 DATA BASE analysis 11. Global analysis 12. Analyze per library 13. Analyze all system (batch) 14. Analyze Identity fields (SQL) (EDHSQLIDTF) 15. Analyze Constraints (EDHCSTANZ) 16. Analyze Triggers (EDHTRGANZ) 17. Analyze Database activity (EDH_ANZDBA) 18. Print Database activity (EDH_ANZDBL) 19. Analyze IFS directories (EDHIFANZ) Check 21. 22. 23. 24. 25. 26. 27. 28. 29. Manage user profiles Enable user profiles (EDH_USRENA) Disable user profiles (EDH_USRDIS) Control Libraries (EDHCHKLIB) Control on Libraries (EDHCTLLIB) Control Objects (EDHCHKOBJ) Periodic control of replications (EDH_EXAM) Supervise replication activity (PMEDHWAT) Run Verify function (EDHIOAEXC) Other commands 41. Force synchro on Objects (PMEDHOPXOB) 42. Force synchro on System Objects (PMEDHOPXCF) 43. Force synchro on IFS files (PMEDHOPXIF) 44. Force synchro on spools (PMEDHOPXSP) 45. Statistics per Objects (EDH_STATS) 46. Statistics per Jobs (EDH_STATJ) 47. Collect performance data (EDH_PERF) 51. Migration Kit (EDH_MIGKIT) 99. List of commands 8 12/07/2013 2. OPTION 2 OF EDH MENU – MANAGE SPECIFIC OBJECTS Some internal information cannot be managed in real time, mainly for three reasons: Data cannot be journalized, and standard replication process is not able to detect modifications Data cannot be saved using standard function of the operating system Modification cannot be applied directly on the remote system Considering those limitations, the tools of Quick-EDD/HA offer a menu allowing the management of these data, with a process adapted to each particular case. Attention: If source and target systems don’t have the same OS/400 releases, you won’t be able to use neither SAVSECDTA nor SAVCFG or SYSINF. Generally speaking, you’ll have to customize SAVOBJ commands in the source files of the tools, in order to take into account the correct *TGTRLS. 2.1.1. EDHSAVDTA - Backup parameters The option 2 of EDH menu displays the following screen: GODEC QSLFRA2 QUICK-EDD/HA SAVE SYSTEM DATA 4/01/12 15:27:26 "X" to select data to process : System Security (SAVSECDTA) . . . . Save STATUS of user profiles Scheduled jobs (JOBSCDE) . . System data (SYSINF) . . . . Exit points (*EXITRG) . . . . : : : : : X X X X X Network TCP/IP data . . . . . . . . . : X Directory entries (WRKDIRE) . : X SNADS DSTQ definition . . . . : X Distribution list (DSTL) . . : X Storage library F3=Exit F11=Command line Configuration (SAVCFG) . . . . . : X Message reply list entries . . . : X RDB entries (WRKRDBDIRE) . . . . : X Environment variables . . . . . . : X NetServer definition . . . . . . : X Configuration lists . . . . . . . : X Network job entries (NETJOBE) . . : X Source : PMEDHUSR F12=Cancel Target : PMEDHUSRBK F13=Schedule EDH_SAVDTA Select each element you want to be processed, using an « X ». Security (SAVSECDTA) Use of system command SAVSECDTA, which includes all the security information of the system, including the *USRPRF, the *AUTL and the authority holders. Save is done in file EDH_SAVSEC. 9 12/07/2013 Configuration (SAVCFG) Use of system command SAVCFG which saves all the configuration objects: *DEVD, *CTLD, *LIND, *SRMSPC, *RZHRIPD, *COSD, *NTBD and *MODD of the source system in the object EDH_SAVCFG. Save STATUS of user profiles In the object EDH_USERS. Allows to keep deactivated the same *USRPRF on the target system as on the source system. Scheduled jobs (JOBSCDE) Saves the internal job scheduler in the object EDH_JOBSCD. Message reply list entries Saves the system reply list System data (SYSINF) Use of RTVSYSINF which saves: - QSIZAEDTD, objects *EDTD - QSIZASRVA, object QAEDSPI - QIZANETA, table of the names *NETA - QIZASYSVAL, system values - QIZAVRM, OS/400 release - QIZARLESP, reply list entries QIZASRVASP, list of the ASPs RDB entries (WRKRDBDIRE) Exit points (*EXITRG) Save of system exit points (WRKREGINF) in the file EDH_EXITRG Environment variables Save of environment variables (WRKENVVAR) in the file EDH_ENVVAR created in the directory /home of the IFS. TCP/IP data QATOCHOST: Hosts table QATOCIFC: IP interfaces QATOCRTE: Routes description QATOCSTART: Auto start options of TCP servers NetServer definition Save of the IFS files from /QIBM/UserData/OS400/NetServer in the object EDH_NETSVR. Directory entries (WRKDIRE) Save of the directory entry in the file EDH_DIRE and save of the following files: 10 12/07/2013 QAOKP9XA: Contains user defined data for the user QAOSAY07: Library of documents QATMSMTPA: SMTP systems alias Configuration lists (*CFGL) DSTQ Network job entries (SNA) (NETJOBE) Distribution list (DSTL) Note: If DSTL are selected, the directory entry (WRKDIRE) is automatically selected as well Storage library - source This library will contain all saved data on the production system This library MUST BE INCLUDED in the replication process to make data available on the target system. You must set the Library Group parameters to allow objects beginning with a "Q" and also owned by user QSYS (objects coming from RTVSYSINF command) Storage library on target system In case of switch, the recovery system will be modified to receive the production system attributes. Prior to this change, all the usual attributes of the recovery system will be automatically saved in this second library. This is done thanks to EDHSAVSWI command, which will use this library. This library ONLY exists on the RECOVERY SYSTEM and MUST NOT be replicated. It will be created by EDHSAVSWI command if it doesn’t exist. 2.1.2. Run of system backup Command EDHSAVDTA saves system data, as defined in the previous screen. This command must be periodically run, in order to save selected elements. This definition can be automatically done using function key F13 which is available on the screen. See tools and switch documentations to manage the switch and switch back of the s pecific objects 2.1.3. Restore system data: switch on backup system - EDHSAVSWI This command will restore the specified attributes of the Production system on the recovery system. EDHSAVSWI command must be included in the switch scenario steps. 11 12/07/2013 Restore System & Network data (EDHSAVSWI) Type choices, press Enter. Data to be restored Note: . . . . . . __________ *USRPRF, *CFGL, *SYSRPYL... The command begins by performing a backup of current system data (inside the “Storage library on target system”), before replacing all system attributes With the latest release of the tools (starting from April 2010), you don’t need to be in restricted mode of the system to switch RDB entries. 2.1.4. Restore initial attributes (switch back) – EDHSAVSWR This command will restore the initial attributes of the recovery system. This data was saved during the switch process by command EDHSAVSWI, and stored in the “storage library on target system”. Restore Recovery system attr. (EDHSAVSWR) Type choices, press Enter Data to restore . . . . . . *ALL, *CFG, *CFGL, *DIRE... Note: Each special object can be restored separately, or *ALL can be chosen to restore all elements. 12 12/07/2013 3. MONITORING RESTART 3.1. AND AUTOMATIC Monitoring To complement the OS/400 messages management used by Quick-EDD/HA, it’s possible to activate a monitoring, which selects any message from message queue PMEDHUSR/PMEDH with a severity level equal to 40, and sends it by e-mail and/or SNMP and/or in a secondary MSGQ. This function needs that you setup some properties, then that you start the monitor. Processing option 4 of EDH menu displays the following window: MESSAGE MONITORING Route to MSGQ : 0 Filtering ..... : 0 (1=Yes) Route as email .. : 1 Filtering ..... : 0 Route as SNMP ... : 0 Filtering ..... : 0 F3=Exit F12=Cancel First, select which monitoring options you need, MSGQ, and/or e-mail, and/or SNMP. Then, for each one, select if you will use Filtering or not. Any activation of the filtering requires to use option 5 of EDH menu « Monitoring filtering» in order to customize which alerts will be sent, and which way. Depending on the selected options, you’ll have to fill in the following windows: MSGQ: Indicate the name of the second MSGQ (in PMEDHUSR/PMEDH) in which the messages will be sent addition SEND MESSAGE TO ANOTHER MSGQ Message queue : PMEDHTEST Library .... : QUSRSYS F12=Cancel 13 12/07/2013 to E-mail Send message as email SMTP Server 1.1.1.1 : Message sender .... : [email protected] Message sent to .......... : [email protected] ________________ ________________ ________________ F3=Exit F13=Send a test Fill in the following settings: SMTP server: Indicate the DNS name or the IP address of your SMTP server (no matter its OS, but the Power i must have access to it) Message sender: Name of the send which will appear in the email. Some SMTP servers require that this address exists for real. Message sent to: 1 to 4 e-mail addresses Please test the email sending with F13 function before starting the monitoring. If it doesn’t work, please contact support SNMP Fill in the following settings: Send messages as SNMP trap SNMP Server : __________________________________________ Port ...... : _____ F12=Cancel You will also need the following JAVA and MIB available here: http://www.quick-software-line.com/UK/quick-toolbox.html 3.1.1. Monitoring filtering It’s option 5 of EDH menu. We deliver a pre-set filters list, which you can customize: Messages which will send an alert If alert: MSGQ and/or E-mail and/or SNMP If SNMP: Critical, Warning or Info 14 12/07/2013 When you change those filters, stop then restart monitoring job. 3.1.2. Start Monitoring, Command EDHMONMSG Run option 8 of EDH menu to submit the monitor job: Monitor Message Queue (e-mail) (EDDMONMSG) Type choices, press Enter. Message queue name . . . . . Library . . . . . . . . . Job queue name . . . . . . . Library . . . . . . . . . Job name . . . . . . . . . . User to run job . . . . . . Clear message queue . . . . Time to clear message queue . . . . . . . . . . . . . . . . PMEDH PMEDHUSR QSYSNOMAX *LIBL EDHMONITOR PMSOFTICF *YES 120000 Name Name, *LIBL Name Name, *LIBL Name Name *NO, *YES Time Enter the following parameters: Message Queue Name of queue to check; normally PMEDUSR/PMEDH Submit Job Queue Default: QSYSNOMAX; job will run in subsystem QSYSWRK Submit Job Name By default EDHMONITOR Profile User profile for which the job is submitted Clear MSGQ Capability to periodically clear the message queue. If YES, a time can be entered. Time to clear message queue Time of day at which the message queue PMEDHUSR/PMEDH will be cleared. 3.1.3. Automatic alerts: tool EDH_STATUS The EDH_STATUS command is used to control the status of the replication process, in a punctual or periodic way. It must be integrated to a CLP program, which will eventually assume what to undertake regarding received messages. The command prompt displays the following parameters: EDH - Status of replication (EDH_STATUS) Type choices, press Enter Environment . . . . . . . . . Environment type . . . . . . Delay before alert . . . . . . . 15 __ *SND 60 Nam *SND, *RCV 10-3600 12/07/2013 The environment code is required: Running the command, different controls will be done: Check activity of the environment Check the delay reading journals Check number of objects out of sync Depending on different cases met, different messages are produced: INACTIVE replication EDH0038 – Environment &1 is NOT ACTIVE This message is directly sent to the caller program, as an “Escape” mode with severity 40. The caller program can decide to restart immediately the process, using the command PMEDHSTR. Delay greater than 60 seconds EDH0040 – CAUTION : DELAY on environment &1 => &2 seconds This message is sent to message queue PMEDHUSR/PMEDH, as a « Diagnostic » message, with severity 40 At least 1 object out of sync – 2 messages: EDH0041 – CAUTION : There are &2 objects WAITING FOR SYNCHRONIZATION on environment &1 EDH0117 - CAUTION - There are &é objects OUT OF SYNC for environment &1 Those messages are sent to message queue PMEDHUSR/PMEDH, as « Diagnostic » messages, with severity 40 Note: The 4 messages of obvious problems are deliberately sent to the message queue PMEDHUSR/PMEDH. Therefore, the tool included in PMEDHTOOLS, or any other messages monitoring tool can easily intercept the messages and act consequently. Furthermore, a *DTAARA is updated with this information. The DTAARA is named EDH_xx in PMEDHUSR (xx= environment code) So you can build a CLP, as an example to stop the replication only if there is no delay. Run the command EDH_STATUS Read the DTAARA – Position 257 to 265 on 9 positions If greater than 0 – do a DLYJOB and loop on EDH_STATUS If equal to 0 – Do a PMEDHEND_xx and end of program From December 2011 releases, EDH_STATUS also produces a report spool file. 3.1.4. Stop monitoring ENDJOB, option *IMMED of job EDHMONITOR in subsystem QSYSWRK. 16 12/07/2013 3.2. Automatic restart of the replication after an incident – EDHCTL The function of supervision is an optional task which will monitor to ensure that replication is active. 3.2.1. Parameters Supervision requires a prior definition of parameters, using menu EDH - option 3 Use F6 to create the settings for the environment you want to supervise. Enter the environment code on 2 digits. The following window is displayed: EDH Quick-EDD/HA - Automated process General parameters Environment managed by Environment code EDD/HA User Check Frequency of control : : *SRC SG PMSOFTICF : Password 5/12/06 14:14:53 : __________ 10 (5 to 60 seconds) Communications *** SOURCE *** IP address for replication : 192.168.100.8 IP address for control : *SAME *** TARGET *** 192.168.100.10__________ *SAME___________________ Error management MSGQ for alerts : PMEDHUSR/PMEDH PMEDHUSR/PMEDH________ Delay before retry Retry number Delay before switch Program to run on error : 60 (30 to 300 seconds) : 10 (3 à 99) : 300 (30 to 900 seconds) : PMEDHTOOLS/EDHSWI_S PMEDHTOOLS/EDHSWI_T_ F3=Exit F9=Messages CTL F12=Cancel F23=Check TCP/IP Environment code Code of the environment to control User / password User name and password to connect on the target system Frequency of control Frequency in seconds. By default activity check is done every 10 seconds. IP address for replication - Source TCP/IP address of the Production system. This address is used by the Recovery system to check the availability of the Production system IP address for replication - Target 17 12/07/2013 TCP/IP address of the Recovery system. This address is used by the Production system to check the availability of the Recovery system Recovery IP address – Source Not used in the standard process. Would be used as another route to reach the Production system from the Recovery system, to separate a network issue from a system one Recovery IP address – Target Same as above for the target system Message queue for alerts – Source Message queue to receive alert messages on Production system Message queue for alerts – Target Message queue to receive alert messages on Recovery system Error management In case of problem, rules to be applied to restart replication Delay before retry Number of retries Delay before switch If retry failed, Quick-EDD/HA can run an exit program. This program can be limited to alert, or run partially or completely the switch process. By default, the exit program provided in Quick-EDD/HA is limited to a SNDMSG command. Option « F9=Messages CTL » PMEDHUSR/PMEDHCTL allows to display the contents of the MSGQ Option « F23=Check TCP/IP » pings each IP address written in the screen to check connectivity. 3.2.2. EDHCTL – Start supervision Command EDHCTL (option 7 of EDH menu) starts the supervision job, according to defined parameters. Starting this job performs the following steps: Start TCP/IP daemon PMSYSDEMON on the Recovery system Start subsystem PMEDHUSR/PMEDH on the Recovery system Start replication if it’s not active, for defined environment, Start supervision job on the Recovery system Do a permanent loop Check if replication is active Check communication, using « ping » command Supervision job will stay permanently active until OPTION(*END). EDH_XX on source system, in sub-system QSYSWRK running command EDHCTL EDHCTL_XX on target system, in sub-system QSYSWRK Attention: To start remote functions, the CLP program uses RUNRMTCMD command. This command needs to have the TCP/IP server *REXEC active on the Recovery system. Start server as follow: 18 12/07/2013 STRTCPSVR *REXEC You can start automatically the server, using TCP/IP configuration: CFGTCP Option 20 – Configure TCP/IP applications Option 17 – Change REXEC attributes Note: Command EDHCTL includes start of replication. It can replace PMEDHSTR in your start procedure. If you require to end the environment, end EDHCTL before; or use EDHSTOP command 19 12/07/2013 4. JOURNALING 4.1. Option 1-5 – Audit Options 1 to 5 allow you to control audit status, and also allow you to display audit journal entries DSPSECAUD WRKSYSVAL QAUD* WRKJRNA QAUDJRN DSPAUDJRNE DSPJRN Note: Those options are only based on OS/400 standard commands. 4.2. Option 6 – Journal manager This function allows to manage the journals of the system (detachment and deletion of the receivers), and is independent from Quick-EDD/HA. Attention: there is no relation with the environments set in Quick-EDD/HA, except if you specify it when starting the journal manager. Therefore, if the replication is stopped, receivers can be deleted even if they were not replicated, such as with any external procedure which manages the journals. This function relies on a physical file in the library PMEDHUSR: EDH_JRNMPF - The same module can manage an identical cleaning on the sourc e and target systems if the file is replicated - If management rules are different on source and target systems, you have to omit this file from the replication 4.2.1. Option 31 – Work with Journal management rules Option 31 presents the list of journals manage by the Journal Manager. 20 12/07/2013 EDH-Tools JOURNAL MANAGER --------------------------------------------------------------------------Lib: *ALL Jrn: *ALL 2=Change 3=Copy 4=Delete 5=Display Display from J=WRKJRNA C/R=Chg Receiver *Cont/*Reset Lib..: __________ Mngt ChgRCV DltRCV Sav CHGJRN Exit PGM Slt Library Journal RCV Hours Hours Rqs Option Bef Aft _ $$EDHJRN EDHJRN *YES 12 24 *NO _ $$EDHJRN JRN *YES 12 24 *NO _ $$EDHJRN PMJRN *YES 12 24 *NO _ $$JOURNAL JRNCFT *YES 12 24 *NO _ $$JOURNAL JRNROB *YES 12 24 *NO _ $JOURNAL JRN_SUD *YES 12 24 *NO _ $JOURNAL TRADERS *YES 12 24 *NO _ $JRNLIB PMA1R *YES 12 24 *NO _ $JRNLIB PMA2R *YES 12 24 *NO _ $JRNLIB PMA3R *YES 12 24 *NO A suivre... F3=Exit F6=Add Jrn F12=Cancel F8=Select F9=Upd/Selection F11=Command Options: 2=Change: Modify the management rules for the selected journal 3=Copy: Copy the definition of the selected journal for a new journal 4=Delete: Delete the journal definition – the selected journal won’t be managed by the Journal Manager anymore 5=Display: Display the definition of the selected journal J=WRKJRNA: Work with journal attributes (IBM command) for the selected journal C/R=Change the receiver in *CONT (C) or *RESET (R) mode. By default, change is done in *RESET mode; *CONT if *RESET is not possible Function keys: F3=Exit: End of process – Return to the Journal Manager menu F6=Add Jrn: Add a new journal in the Journal Manager F8=Select: Search with generic names F9=Upd/Selection: Multiple update F11=Command: Allows to make a command line appear F12=Cancel: Return to the Journal Manager menu Definition of a journal Using the function key F6, you can add a journal in the Journal Manager and define its management rules. 21 12/07/2013 JOURNAL MANAGEMENT RULES____________ Library ......... : __________ Journal .......... : __________ Journal management Delay for ChgRCV Max. Size ChgRCV Delay for DltRCV SAV required ..... Option CHGJRN .... Exit program . . Library ........ Exit program . . Library ........ : : : : : : : : : : *YES ___12 (*YES, *NO) (in hours) 0 ___24 (in hours) *NO_ (*YES, *NO) *RESET (*RESET, *CONT) __________ __________ __________ __________ Library: Name of the library where the journal is located Journal: Name of the journal Management of the journal: Indicate if you want the Journal Manager to manage receivers Delay for ChgRCV: Indicate in hours the delay before the current receiver will be replaced Max. size ChgRCV: Indicate the amount of journal entries in the current receiver before it gets detached Delay for DltRCV: Indicate the duration in hours the receivers will be kept on the system before the deletion by the Journal Manager SAV required: Indicate if the receiver must be saved before deletion (backup is not managed by the Journal Manager) Option CHGJRN: *RESET (default) or *CONT; you must select this setting depending on the application needs Exit programs: The call of 2 exit programs is possible before and/or after the detachment of a receiver The exit program receives 2 parameters: The name of the receiver which has been detached The library of the receiver When the exit program is called, a message is produced in the log of the job and in the MSGQ PMEDHUSR/PMEDH. The content of the exit program is under the responsibility of its author. A sample exit program, EDH_JRNEX9, is available in the library (it only does a SNDPGMMSG) Select option (F8) The select option allows to search and display a sub-list of the journals, depending on criteria on the journal name and the library name. SELECTION_________ Library .... : EDH*______ Journal .... : TST*______ F12=Cancel 22 12/07/2013 Note: As displayed in this example, you can enter a generic name either for the journal name and/or the library name. Upd/Selection (F9) This global update allows to apply the same management rules on a list of journals. This function must be used in combination with the selection option (F8) GLOBAL UPDATE ON SELECTION____________ Library ......... : EDH* Journal .......... : TST* Journal management Delay for ChgRCV Max. Size ChgRCV Delay for DltRCV SAV required ..... Option CHGJRN .... Exit program . . Library ........ Exit program . . Library ........ F12=Cancel : : : : : : : : : : *SAME (*YES, *NO) *SAME (in hours) *SAME_____ *SAME (in hours) *SAME (*YES, *NO) *SAME (*RESET, *CONT) *SAME_____ *SAME_____ *SAME_____ *SAME_____ Enter the different parameters to be changed and press Enter. All the journals corresponding with the selection criteria will be updated with the selected parameters. 4.2.2. Option 32 – Search / Insert journals Command EDH_JRNINS allows to search journals and insert them in the Journal Manager, with their management rules. Add Journals to JM (EDH_JRNINS) Type your choices, press Enter Journal . . . . . . Library . . . Manage journal . Detach delay (hours) Delete delay (hours) Save required . Include Q* libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . __________ __________ *YES 12 24 *YES *NO_ Name, generic*, *ALL Name, *USRLIBL, *CURLIB *YES, *NO Number Number *YES, *NO *YES, *NO Journal : Indicate the name of the journal and of its library Field « Journal » accepts special value *ALL or a generic name Field « Library » accepts special values *USRLIBL, *CURLIB, *LIBL, and *ALLUSR Note: if you choose *ALLUSR, user libraries Q* won’t be included in Journal Manager unless you select *YES for Include Q* libraries. 23 Manage journal : Indicate if this journal will be managed by the Journal Manager 12/07/2013 Detach delay : Indicate the time slice (in hours) to change the receivers Delete delay : Indicate the time slice (in hours) to delete the receivers Save required : Indicate if the receiver has to be saved before being deleted (Journal Manager doesn’t manage the save) 4.2.3. Option 33 – Start Journal Manager The Journal Manager is a permanent batch job which analyses periodically the status of the journals. For each journal, depending on the settings of the Journal Manager, detachment and deletion of the receivers will be done. Command EDH_JRNCLN – option *STR – allows to submit the batch job. Journal manager (EDH_JRNCLN) Type your choices, press Enter Option . . . . . . . . . . . . . > *STR Run period (minutes) . > 30 Check EDH activity . . . . . . *YES *STR, *END 10-720 *NO, *YES Run period: Indicate the time slice (in minutes) to check the journals and manage their receivers. Note: job EDH_JRNCLN runs in sub-system PMEDH Attention: if you want the receivers to be deleted only when Quick-EDD/HA has processed them, press Enter to display more settings. In that case, specify all the needed environments (up to 25): Journal manager (EDH_JRNCLN) Type your choices, press Enter Option . . . . . . . . . . . . Run period (minutes) Check EDH activity . . . . . Environments to be checked . . + for more values . > *STR . > 30 . *YES . __ __ *STR, *END 10-720 *NO, *YES Alphabetic Additional Parameters Job queue Library 24 . . . . . . . . . . . > PMEDH . . . . . . . . . > PMEDHUSR Nam Name,*LIBL 12/07/2013 4.2.4. Option 34 – End Journal Manager Command EDH_JRNCLN option *END stops the Journal Manager. Journal manager (EDH_JRNCLN) Type your choices, press Enter Option . . . . . . . . . . . . . > *END *STR, *END 2 independent commands allow to handle the receivers : 4.2.5. Option 35 - Replace journal receiver / delay Command EDH_RCVCHG allows to detach a receiver, depending on its attached time. Change Journal Receiver (EDH_RCVCHG) Type your choices, press Enter Journal . . . . . . Library . . . . . Detach delay (hours) Max. size . . Sequence option . Exit program . . Library . . . . . Exit program . . Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . __________ *LIBL_____ _______ __________ *RESET *NONE_____ *LIBL_____ *NONE_____ *LIBL_____ Nam Name, *LIBL, ... Number Number *CONT, *RESET Name, *NON Character, *LIBL, *CURLIB Name, *NON Character, *LIBL, *CURLIB 4.2.6. Option 36 - Delete old journal receivers Command EDH_RCVDLT allows to delete the receivers, considering when they were detached and if they were saved or not. Delete old Journal Receiver (EDH_RCVDLT) Type your choices, press Enter Journal . . . . . . . . Library . . . . . . . Delete delay (hours) Save option . . . . . . Option for message . . + si autres 25 . . . . . . . . . . . . . . . . . . valeurs __________ *LIBL__ ______ *SAVEDONLY *NONE Nam Name, *LIBL, ... Number *SAVEDONLY, *ALL *NONE, *IGNINQMSG... 12/07/2013 4.2.7. Option 37 – Start of file journaling In addition to the IBM command STRJRNPF, command EDHJRNSTR allows you to activate journaling to database files. EDHJRNSTR performs the following functions: Automatic journal and receiver creation, if they do not already exist. File group processing, with generic names, or *ALL for every file of a library. Ignore automatically already journaled file(s). 4.2.8. Option 38 – End of journaling Command EDHJRNEND contains all parts of ENDJRNPF command, and allows file processing using groups to stop journaling the files. Note: End of journaling can be done only when the file is not in use. 4.3. DTAARA QDFTJRN – EDH_DFTJRN The OS/400 allows to automatically activate journalization through a DTAARA QDFTJRN created in the library, and containing the name of the journal to be used. A new command EDH_DFTJRN allows to create this DTAARA from the settings of a QuickEDD/HA environment. 4.4. Change journal management rules EDHCHGJA (if no Journal Manager) – This function allows to change dynamically the rules of journals management inside an environment of Quick-EDD/HA. The focus is to adapt dynamically to special situations like night batches or end of month processing; duration of receiver attachment, of delay and option to delete receivers may be adapted to special request of the system management. Note: Effect of the command is immediate; new parameters will be applied in real time. EDH - Journal parameters (EDHCHGJA) Type choices, press Enter. Environment . . . . . . . . . Duration for attachment . . . . Automatic deletion (0, 1, 2) . Delay for purge . . . . . . . __ ____ _ ____ Nam 0-9999 0-2 0-9999 Environment Indicate the environment code which will be modified Duration for attachment (hours) Indicate the number of hours the receivers will stay attached to the journal 26 12/07/2013 Automatic deletion Select option to delete the journal receivers 0= No deletion 1= Automatic deletion without control of saved status 2= Deletion is done only if the receiver has been saved Delay before deletion (hours) Indicates the number of hours the receivers will be kept on the system before deletion 4.5. Journaling rules on source and target – EDHJRNOPT, EDHJRNOPL 4.5.1. EDHJRNOPT Start journaling / SRC options (EDHJRNOPT) Type choices, press Enter. Option to execute . . . . . Option file . . . . Library . . . . . . . . Libraries to analyze . . . . > *RTV___ . . EDH_JRNOPT . PMEDHUSR . . *ALLUSR___ *RTV, *STRJRN Nam Nam Nam, generic*, *ALLUSR This command has 2 functions: Used with option *RTV on the source system, submitted with a SBMJOB, it analyses the physical files of the selected library (ies), in order to write in a file which options are currently in use (name of the journal, images *AFTER or *BOTH…) The choice of the name of the file or the library is free, but this file must be replicated. Start journaling / SRC options (EDHJRNOPT) Type choices, press Enter. Option to execture . . . . . . Option file . . . . . Library . . . . . . . . . Libraries to process . . . Override the journal . 27 . > *STRJRN . EDH_JRNOPT PMEDHUSR . *ALLFILE . *NO *RTV, *STRJRN Nam Nam Nam, *ALLFILE *NO, *YES After the *RTV analysis and the replication of the option, the option *STRJRN, on the target system, allows to reproduce on that system the journaling options used on the production box, for the files which are not already journaled on the target, unless you indicate *YES for “Override the journal”. 12/07/2013 4.5.2. EDHJRNOPL Print journal options (EDHJRNOPL) Type your choices, press Enter. Option file Library Output form . . . . . . . . . . . . . . . . . . . . . EDH_JRNOPT PMEDHUSR__ *DETAIL_ Nam Nam *DETAIL, *SUMMARY This allows to display the result of the analysis made by the command EDHJRNOPT, option *RTV. 4.6. *DETAIL produces 2 spool files: EDHJRNOP1, the result of the analysis sorted by name of file and EDHJRNOP2, the result of the analysis sorted by journal name. *SUMMARY produces the same spool files, they only show the counters produced by the analysis EDHJRNRLS EDH - Release Journal (EDHJRNRLS) Type your choices, press Enter. Environment . . . . . . . . . Journal . . . . . . . . . . . . Library . . . . . . . . . __ __________ __________ Nam Nam Nam If a journal is placed on hold in the environment within the “Journals” list, this command allows to release it. 4.7. EDHCLRJRN EDH - clean receivers (EDHCLRJRN) Type your choices, press Enter. Journal . . . . . . . . . . . . Library . . . . . . . . . __________ *LIBL_____ Name, generic*, *ALL Name, *LIBL This command does a CHGJRN *GEN for the specified journal and deletes all other receivers WITHOUT ANY CONTROL. 28 12/07/2013 5. ANALYSIS 3.1. Option 11 to 14 – Database analysis It is possible, with the four following options, to analyze libraries and database files. Three options do the same work, in different ways: 11 – Analysis of libraries, in interactive mode 12 – Analysis of a specific library, in interactive mode - EDHANZF 13 – Batch analysis of all libraries – Production of a spool file - EDHANZL Those commands allow you to receive information about: Number of database files in the library Number of journalized files Number of used journals, in library and/or outside the library Number of members Number of triggers Number of constraints Option 14 lists the fields of type Identity. Since the release V11_0219 of Quick-EDD/HA, the switch of Identity fields is done by the switch command PMEDHSWI. No need to use the command EDHSQLIDTF anymore. 3.1.1 Options 11 and 12 – Interactive analysis EDD-TOOLS F=Files S _ _ _ _ _ _ _ _ _ _ J=Journals Library ECRANS EACASA EDH_ANZBDA EDH_JLR EDH_SAVDTA EDHDEMO_EN EDHDEMO_FR EDHDEMO_F1 EDHDEMO_F2 EDHDEMO_IS F3=Exit 29 MANAGE LIBRARIES A=Analyze ---- Files ---- --- JOURNALS --Total Jrn Total Used Out 0 0 0 0 2 0 0 1 1 0 0 0 1 0 0 0 9 0 0 0 19 19 1 1 22 22 1 2 0 0 0 0 22 0 0 0 23 0 0 0 F5=Refresh F8=Analyze ALL Mbr 0 1 0 0 0 1 0 0 0 0 F9=Select 0 148 1 7 9 52 184 0 194 55 Trg Cst 100 5 F12=Cancel Option “A = Analyze” allows you to process analysis in real time, for the selected library. Function key “F8=Analyze All” allows you to analyze all displayed libraries at the same time. Once the analysis is done, option “J=Journals” displays the list of journals regarding the library. Option “W=WRKJRNA” displays the details of each journal Option “F=Files” shows the detail (database) of the selected library: 12/07/2013 __EDD-TOOLS MANAGE FILES___________________________________ 5=DSPFD J=Journaling Library .... : EDHDEMO_FR Slt _ _ _ _ _ _ _ _ _ _ File Att EDH_MSG PF EDHDEMODDM PF EDHSRC01 PF EDHSRC02 PF EDHSRC03 PF EDHSRC04 PF EDHSRC05 PF EDHSRC06 PF EDHTGT01 PF EDHTGT02 PF F3=Exit F5=Refresh Journal EDHDEMO EDHDEMO EDHDEMO EDHDEMO EDHDEMO EDHDEMO EDHDEMO EDHDEMO EDHDEMO EDHDEMO Library EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR EDHDEMO_FR F9=Select Act *ON *ON *OFF *ON *ON *ON *ON *ON *ON *ON Trigg. Cont. MBR 0 0 3 5 3 5 3 1 0 0 A suivre... F12=Cancel Two options are available: “5=DSPFD” This option allows you to display details of the file, using command DSPFD. “J=Journal” This option allows you to start or end journalization for the selected file. Function key F9 allows you to select specific files according to different criteria: SELECTION OPTIONS File ......... : *ALL______ Journalization : * ' '=Never '0'=Disabled '1'=Active '*'=All files Triggers ..... : _ (1=Yes) Constraints .. : _ (1=Yes) 3.1.2 Option 13 - Full analysis (batch) – EDHANZL The option “13” allows you to submit the EDH_ANZDB command in batch mode. DATABASE ANALYZER (EDHANZL) Type choices, press Enter. Print only differences . . . . *NO *NO, *YES The complete analysis command, processed in batch, allows you to select the libraries for which some journalization differences occur. 30 12/07/2013 Note: If the PRTERR parameter is positioned to * YES, then only the libraries of which the number of journalized files is not equal to the total number of physical files are printed. This job is going to produce a spool file comparable to the interactive screen in all points presented above. The: 1/06/2012 à 15:06:35 EDDTOOLS_-_Database_analysis__ Page : 1 ---- Files ------ JOURNALS --Library Total Journal. Total Used Outside TRG CST MBR ********************************************************************************************** * $QUICKDTA 53 0 0 0 0 53 $QUICKDTG 52 0 0 0 0 50 $QUICKPGM 53 0 0 0 0 63 £LIBRARY 1 0 0 0 0 2 £RPGLIB 2 0 0 0 0 9 AA_JAPON 14 13 0 1 1 17 AABLOC1 1 0 0 0 0 1 AACCSID 24 22 1 2 1 5 42 ********************************************************************************************** Total PF files : 11.200 Total PF members : 20.857 Total Journals : 163 Total Triggers : 2.247 Total Constraints : 11.245 At the end, a summary allows you to count the total number of PF files, journals, members, triggers and constraints. 3.1.3 Option 14 - SQL - Analyze Identity fields This tool starts a job named EDH_SQLANZ which produces a spool file named EDHSQLANZ, which looks like the example below: 04/05/10 13:46:06 Library name Table name SQL TESTIDENTI T_GODEC TESTIDENTI ORDERS FILE FILE2 COPF 31 EDHTools - SQL Identity Fields Column name Description CHAMP1 CLE ORDERNO FIELD1 FIELD1 FIELD1 - PAGE 12/07/2013 1 3.4. Option 15 EDHCSTANZ - Analyze constraints - EDH - Analyze constraints (EDHCSTANZ) Type choices, press Enter Libraries . . . . . . . . . Action for constraints . . __________ *PRINT Name, generic*, *ALL, *ENV *ENABLED, *PRINT The analysis can be done by library name (with generic names) or for all libraries of an environment. If the setting *ENV is used, two other settings are displayed to choose the environment and its type, *SND or *RCV. The job batch EDHCSTANZ is submitted: It produces two spool files: A global list, with reference ** LISTCST A synthesis list, with reference **CNTCST Option *PRINT allows to compare the source and target systems, for example; this comparison is valid only if you take into account the omissions done in the settings. If the option *ENABLED is used, constraints are activated. If this operation cannot be done, a third spool, with reference **ERRCST, is produced. The option *ENABLED can only be used on the target system. Quick-EDD/HA deactivates a minimum of constraints during the replication, and reactivates them at the time of the switch. You can also plan to run this command using the option *ENABLED once a week, so that the switch process be as fast as possible 32 12/07/2013 3.5. Option 16 - Analyze triggers – EDHTRGANZ EDH - Analyze triggers (EDHTRGANZ) Type choices, press Enter Libraries . . . . . . . . . Action for triggers . . . . ___________ Name, generic*, *ALL, *ENV *PRINT *PRINT, *CHKPGM, *ENABLED The analysis can be done by library name (with generic names) or for all the libraries of an environment. Using the setting *ENV, two others settings are displayed to choose the environment, either *SND or *RCV. The batch job EDHTRGANZ is submitted: Two spools files are produced: A detailed list, with reference ** LISTTRG A synthesis list, with reference ** LISTTRG Option *PRINT allows to compare the source and target systems, for example; this comparison is valid only if you take into account the omissions done in the settings. The option *CHKPGM allows to check if the programs attached to the triggers are present. Missing programs are located in a third spool, with reference ** ERRCST. In case of missing programs, you will have to synchronize them or use IOA. If the option *ENABLED is used, triggers are activated. When this operation fails, a third spool is produced, with reference ** ERRCST. Options *CHKPGM and *ENABLED are made to be used on target system. Quick-EDD/HA deactivates the triggers (except for system triggers) during the replication and reactivates them at the time of the switch. You can also plan to run this command using the option *ENABLED once a week, so that the switch process be as fast as possible 5.1. Options 16 and 17 - Analysis of the bandwidth – EDH_ANZDBA and EDH_ANZDBL EDH_ANZDBA: Data extraction EDH_ANZDBL: Analysis of extracted data These tools are based on statistical activity database available with DSPFD. 33 12/07/2013 So there is no need to activate journalization for this analysis. A physical file stores the list of files and its members. For each file, we store the record length and 5 groups of counters: The first group stores current counters of the file The 3 others groups store counters that have been picked up during 3 analysis The command EDH_ANZDBA performs 3 analysis (Submission of a batch job by the command): EDH_ANZDBA is used for storing the current value of counters (*INIT) EDH_ANZDBA (YourLibrary) PERIOD(*INIT) We re-use the command at 3 different periods of time: After jobs batchs EDH_ANZDBA (YourLibrary) PERIOD(*PERIOD2) After 24 hours EDH_ANZDBA (YourLibrary) PERIOD(*PERIOD3) After a week EDH_ANZDBA (YourLibrary) PERIOD(*PERIOD4) The second command EDH_ANZDBL allows you to print data into a spool file Compares the selected periods to the initial values EDH_ANZDBL TOPERIOD(*PERIODn) Adds all the entries (Add, Update, Delete) for each file and multiplies them by the record length Note: Only modified files are displayed in the spool You can also compare 2 periods: EDH_ANZDBL FRMPERIOD(*PERIOD2) TOPERIOD(*PERIOD3) 5.2. Option 19 – EDHIFSANZ Analyze IFS (EDHIFSANZ) Type choices, press Enter Path to be analyzed . . . . . . ____________________________________ _______________________________________________________________________ _______________________________________________________________________ _______________________________________________________________________ Output file . . . . . . . . EDH_IFSD Nam, generic*, *ALL Library . . . . . . . . QTEMP Nam, *LIBL, *CURLIB Output member options:: Member to receive output . . . *FIRST Name, *FIRST Replace or add records . . . . *REPLACE *REPLACE, *ADD We advise that you submit this command which, in the chosen output file, and for the filled in path, lists the following properties for all files of the main directory and its sub-directories: Name of the directory, then name of the file *DIR or *STMF attribute Size of the element Owner Date and time of the last modification Date and time of the last usage If the element is journaled: name of the journal 34 12/07/2013 5.3. Analyze journals – EDHANZJ This tool is used to list journals of the requested libraries Analyze of journals (EDHANZJ) Type choices, press Enter. Journals library . . . EDD-TOOLS __________ Name MANAGE JOURNALS 5=Detail W=WRKJRNA Library .... : $$EDHJRN Slt _ _ _ Journal EDHJRN JRN PMJRN F3=Exit Library $$EDHJRN $$EDHJRN $$EDHJRN F5=Refresh F12=Cancel From this screen, two options are available: “5=Details” This option displays the name of the journal and the library “W=WRKJRNA” This option displays the result of the command WRKJRNA 35 12/07/2013 6. CONTROLS 6.1. Option 21 – User Profiles management That option is an additional command to profile management commands, and allows an interactive selection for activating or deactivating profile. The program (CALL EDHUSRMGN) displays the following screen: 6/01/12 16:20:56 E=Enabled S _ _ _ _ _ _ _ _ _ _ _ _ _ _ *ENABLED / *DISABLED user profiles D=Disabled Profile ADMIN ANDREU ARCAD ARCAD_NET ARCAD_PGMR ARCAD1 ARCARD1 AUDIT AVNET BDC BDC_ET CAROLINE COMMERCE CORRE F3=Exit QSLFRA2 GODEC Stat *ENABLED *ENABLED *DISABLED *DISABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED F9=Select S _ _ _ _ _ _ _ _ _ _ _ _ _ _ Profile CRABE CRAM CSISEC DB2XML DELCF DEMO DEMOITA DEMOMX DEMOTEST DEVANDRUL DEVCARIGL DIEGO EDH EDH_OA1 Stat *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED S _ _ _ _ _ _ _ _ _ _ _ _ _ _ Profile EDH_OA2 EDH_PRS EDHDEMO EDHDEMO_EN EDHDEMO_FR EDHDEMO2 EDHGROUP EDHNEW EDHOPER EDHOWNER EDHOWNER2 EDHREPLIC EDHTRAININ EDHUSR1 Stat *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED *ENABLED .. F12=Cancel Options « E » and « D » allow you to activate or deactivate one or several selected profile(s). 6.2. Option 22 - User Profiles Activation EDHUSRENA The target system is often inaccessible to the users. An easy way to get that is to manage parameter STATUS of the user profile: disable all user profiles, except the ones of the IT team and PMSOFTICF. The command EDHUSRENA allows you to change the status of a set of profiles. Selection with name, generic name, *ALL Change parameter STATUS to value *ENABLED Include or not, Q* profiles; include or not the QSYS owners: this allows to modify only the Q* profiles which aren’t system profiles The QSECOFR profile is ALWAYS excluded, regardless of the value of the QINCLUDE parameter. 36 12/07/2013 6.3. Option 23 EDHUSRDIS – Disable User Profiles - Following the same principle, the command EDHUSRDIS allows you to deactivate a set of profiles; it would be useful during the switch return. Selection with name, generic name, *ALL Change parameter STATUS to value *DISABLED Include or not, Q* profiles; include or not the QSYS owners: this allows to modify only the Q* profiles which aren’t system profiles 6.4. Option 24 EDHCHKLIB – Check the Libraries - This tool allows checking the libraries list on the source or on the target system in order to know which libraries are managed or not by Quick-EDD/HA. 6.4.1. Use on the source system EDHCHKLIB ENV(XX_SND) OPTION(*LISTALL) produces a spool file containing the full list of the libraries of the system, divided in 2 categories: Library not managed: library not replicated by Quick-EDD/HA Library OK: library replicated by Quick-EDD/HA EDHCHKLIB ENV(XX_SND) OPTION(*LISTERR) produces a spool file containing the full list of the libraries of the system not managed by Quick-EDD/HA. 6.4.2. Use on the target system EDHCHKLIB ENV(XX_RCV) OPTION(*LISTALL) produces a spool file containing the full list of the libraries of the system, divided in 2 categories: Library not managed : library not replicated by Quick-EDD/HA Library OK: library replicated by Quick-EDD/HA EDHCHKLIB ENV(XX_RCV) OPTION(*LISTERR) produces a spool file containing the full list of the libraries of the system not managed by Quick-EDD/HA. 6.5. Option 25 – Interactive Check of the Libraries - EDHCTLLIB This module allows you to check with an interactive and real-time view the list of the libraries of the production system, and compare the number of contained objects and the number of replicated objects. Then it displays the number of objects with a replication error. Using the command: Control replications (EDHCTLLIB) Type choices, press Enter. Libraries . . . . . . . EDD environments . . . . . Output type . . . . . . . Control CRTLIB date . . . . . . . . . *ALL *ALL *DISPLAY *LASTCTL Name, generic*, *ALL, *REP Name,*ALL *DISPLAY, *PRINT Date, *LASTCTL Libraries 37 12/07/2013 Name: name of the library to analyze Generic: analyses a group of libraries *ALL: analyses all the libraries of the system in the environment chosen below *REP: analyses only the replicated libraries of the system in the environment chosen below EDD environments Name : Chose the XX environment to be analyzed *ALL : Analyses all the environments Output type *DISPLAY: the analysis results are displayed on the screen *PRINT : the analysis results are a spool file named EDHCTLPR Control date / CTRLIB It shows all the new libraries created on the system since the date of the last processing of EDHCTLLIB (*LASTCTL) or the Date you specify. If you choose *DISPLAY, you obtain the following screen: EDD-TOOLS CONTROL OF REPLICATIONS - Libraries 1=Open EDH O=EDH objects W=WRKOBJ C=EDHCHKOBJ Env. Date of Slt Libraries EDH creation _ T_BDC2 2007/11/15 _ T_CEDRIC 2008/04/01 _ T_CLUSTER 2007/11/15 _ T_CONST 2010/03/11 _ T_DIEGO 2007/11/15 _ T_FACTARCH 2007/11/15 _ T_GODEC Z6 2007/11/15 _ T_GODECPR 2010/03/09 _ T_GODECTE 2010/03/09 _ T_GODEC2 2007/11/15 F3=Exit F5=Refresh F8=Analyze ALL --- OBJECTS -Total EDH 203 13 94 5 34 2 235 0 0 59 F9=Select Errors 0 0 0 0 0 0 3 0 0 0 0 0 0 0 0 0 1 0 0 0 A suivre... F12=Cancel Library analysis allows you to display the following information: White (bold here): libraries managed by the replication The environment in which the library is managed The date of creation of the library, in yellow if it’s new The number of objects contained in the library The number of objects replicated by Quick-EDD/HA The 2 numbers above are displayed in red if there is a difference The number of objects with a replication error Available options 1 = Open Open directly the environment in Quick-EDD/HA O = Objects List of the replicated objects of the library W = WRKOBJ List of the objects of the library 38 12/07/2013 C = EDHCHKOBJ Produces a spool named EDHCHKOB1 which contains the list of objects that are not managed by Quick-EDD/HA Selection function F9 PF KEY allows you to display a selection screen 6.6. Option 26 - Objects control (target) EDHCHKOBJ This module allows you to control target system libraries objects list comparing it to information listed in Quick-EDD/HA. The focus is to list any non-essential object(s) in those libraries. The command allows you to edit a list or prepare to delete by moving the objects into a temporary library. EDH - Check Objects (EDHCHKOBJ) Type choices, press Enter. Environment . . . . . . Libraries to analyse . Control option . . . . Storage library . . . . . . . . . . _________ . *ALLENV . > *DELETE . *$$LIB Name Name, generic*, *ALL... *LISTALL, *LISTERR, *DELETE Name,*$$LIB Environment Enter environment name: xx_RCV Libraries to Analyze Library name to check Generic name, for a set of libraries *ALL – Every library *ALLENV – Every library described in one environment Check Option *LISTALL – Every object is listed; a text describes checked-object status *LISTERR – Only “non-essential” objects listed *DELETE – Library objects not replicated by Quick-EDD/HA are moved into a temporary library. In this case, RCLLIB parameter has to be defined. Note: This option is dedicated to the TARGET system (env. xx_RCV). Storage Library Library where « non-essential » objects will be stored Special value *$$LIB allows to dynamically create job library with name beginning with « $$ » Note: If library name has eight or fewer characters, the new name will be prefixed « $$ »; otherwise, the two first characters will be replaced. Detail of messages generated using the command: 39 12/07/2013 EDHCHKOBJ ENV(P1_RCV) LIB(PMEDHTEST*) OPTION(*DELETE) EDHTOOLS - Library PMEDHTEST => 0000000 errors occured. EDHTOOLS - Library PMEDHTESTR => 0000009 errors occured. EDHTOOLS - Library PMEDHTEST1 => 0000008 errors occured. EDHTOOLS - Library PMEDHTEST2 => 0000000 errors occured. EDHTOOLS - Library PMEDHTEST3 => 0000055 errors occured. A detailed spool file is also produced, depending on command parameter (*LISTALL / *LISTERR). The: 12/09/2005 at 11:54:34 EDHTOOLS_-_CHECK_OBJECTS______ Page : Library .... : PMEDDTEST Library PMEDDTEST PMEDDTEST Objec QDDSSRC QPGMSRC Type *FILE *FILE Stat _____________________ Object not managed by EDH Object not managed by EDH 6.7. Option 27 – Periodic control of replications – EDHEXAM Monitor for Replic. problems (EDHEXAM) Type choices, press Enter. Environment to monitor . . . . . Delay time in seconds . . . . . __ 60 Nom, generic* The EDHEXAM command submits, each time the « delay » is reached, the command EDH_STATUS; we recommend that you start EDHEXAM when you start the environment. If Monitoring tool is active, any issue will trigger automatically the sending of an alert. When EDHEXAM is performed, the job EDH_EXAMXX, XX being the name of the environment, starts in sub-system QSYSWRK. To stop it, use option *IMMED. 6.8. Option 28 – Supervise replication activity PMEDHWAT This part allows to add internal supervision for each environment. It can be activated in the general settings of the environment; on source (Src 1) and/or on target (Rmt 1); it will be performed by a job EDH_XX_SWA on source, EDH_XX_RWA on target; XX being the name of the environment (those jobs will run in PMEDH sub-system). 40 12/07/2013 1 If the source hasn't read anything for 15 minutes (‘End/Read’ setting), and/or if the target hasn't written anything for 15 minutes (‘Process’ setting), and/or if delay is greater than 30 minutes (‘Backlog’ setting) a message is sent to QSYSOPR and in the MSGQ PMEDHUSR/PMEDH every 20 minutes (‘Resent’ setting). Of course, those values can be customized. SWA and RWA jobs start when the environment is started, but don't stop if the environment stops. Should you need to stop them (for example for a planned stop of the environment), you will have to use the commands: PMEDHWAT ENV(XX) ENT(*SND) OPT(*END) on source PMEDHWAT ENV(XX) ENT(*RCV) OPT(*END) on target The activation of the supervision changes the display colors of the environments An environment which is supervised will be displayed in white If there is an issue (End of Read and/or End of Write and/or Delay), the display becomes red and blinking. 6.9. Option 29 EDHIOAEXC - Run Verify function – This command allows to schedule the IOA process. EDH - Run IOA control (EDHIOAEXC) Type choices, then press ENTER Environment Control level . . . . . . . . . . . . . . . . __ *ALL Nam *ALL, *OBJ, *IFS, *CFG... Control level *ALL: the entire environment *OBJ: all objects within Libraries domain *LIB: a specific library *IFS: all objects within IFS domain *DIR: a specific directory *CFG: all objects in Config domain *SPL: all spool files *SV: all system values For more details regarding IOA, see EDD_HA_Supervision.pdf 41 12/07/2013 7. OTHER COMMANDS 7.1. Options 41 à 45 – PMEDHOPX* All those commands work the same way. Only « OBJ » parameter is specific, allowing the selection of objects with a filter on the name. Command PMEDHOPXOB will be used as a sample to describe all those commands: PMEDH - Options on objects (PMEDHOPXOB) Type choices, press Enter. Source environment Type Snd or Rcv . . . Option to run : Option . . . . Mode Exec or Trace . . Object type . . . . Objects . . . . . . . Libraries . . . Selections : Defined group . . Hold . . . . . . Exist . . . . . . Synchro running ... . Mini. Entries waiting Defined journal . . . . Library . . . . . . . . . . . . . __ *SND Nam *SND, *RCV . . . . . . . . . . . . . . . . . . . . . . . . . . . . *SYN *EXEC *OBJ *ALL *ALL *HLD, *RLS, *SYN, *COP, *PRT *EXEC, *TRACE, *ALL, *NONE Alpha, *OBJ Name,*ALL Name,*ALL . . . . . . . . . . . . . . . . . . * *ALL *ALL *ALL *ALL *ALL *ALL Name, generic*, * *ALL, *NO, *YES *ALL, *NO, *YES *ALL, *NO, *YES Number, *ALL Nom, *ALL, *ALLJRN, *NOJRN Name,*ALL Command parameters Source environment Environment code which manages objects to synchronize Type Snd or RCV Type of environment *SND – Source environment *RCV – Target environment Option Option to run *SYN / *COP will perform the synchronization Note: This command can be used to run other actions: *HLD/*RLS – Hold / release the selected objects *PRT – Print the list of selected objects Mode Exec or Trace Reserved. 42 12/07/2013 Object type Selection based on type of objects Objects / Libraries Selection based on objects and libraries names (generic names are allowed) Defined group Selection based on a group code. Enter a group code, or * to select all the groups Hold Selection based on the status Hold/Release of the object Exist Selection based on the existence of the object in the library Synchro running Selection based on the synchronization status of the objects: *ALL – All the objects are selected *YES – Forced synchronization for the objects already being synchronized *NO – Forced synchronization only if the objects are not currently being synchronized Mini. Entries waiting Selection based on a number of entries waiting in the replication loop. Enter the minimum number of entries to select files. Defined journal and libraries Selection based on a journal. All objects attached to this journal will be selected. Additional Note: 43 selections Owner : owner name ASP defined: ASP number For *FILE, select only: allow selecting the type of file: physical, logical Check Constraints if PF: enable or disable the synchronization of constraints Check Triggers if PF: enable or disable the synchronization of triggers Check Blobs if PF: enable or disable the synchronization of blob fields If PF, check Identity: enable or disable the synchronization of identity field Other commands PMEDHOPXIF / PMEDHOPXCF / PMEDHOPXSP /PMEDHOPXSV / PMEDHOPXJO are identical except for OBJ selection parameter (selection based on the name) 12/07/2013 7.2. Option 45 - Statistics per Objects – EDH_STATS EDH_STATS command allows you to add the replication statistics to a database file and print the results. EDH - Statistics (EDH_STATS) Type choices, press Enter. Environement . . . . Type of environnement Output file . . . . . Library . . . . . . Replace or add records . . . . . . . . . . . . . . . . . . . . . . . . . __ *SND EDH_STATS QTEMP *REPLACE Name *SND, *RCV Name Name *REPLACE, *ADD Running this command, the following steps are performed: Analyze the environment Write data to the defined output file Run a Query to print results The produced spool file gives the following information: List of objects – Sorted by Object type Number of processed entries (descending order) Printed data Object definition – Name, library - Type Dependent journal (if journalized) Number of entries selected for this object Number of performed I/Os Number of ADD Number of UPDATE Number of DELETE Two peculiarities of the command (which can be changed thanks to the availability of source files): Only objects having made at least 1 journal entry are recorded in the output file Only objects having made at least 1000 journal entries are reported in the printout Note: This command allows you to quickly determine which replicated files generate the most I/O operations. Those files can be omitted of the replication if they are work files, for example, or setup differently 44 12/07/2013 7.3. Option 46 EDH_STATJ - Statistics per Jobs – This command works exactly the same way as EDH_STATS, only the sorting method is different. The focus here is to check which jobs produce the largest amount of I/Os on the system. Attention: this tool only works if it is used on an environment where JFP – Jobs Follow-Up is active. 7.4. Option 47 - Collect performance data – EDH_PERF The EDH_PERF command collects data related to replication environment. This data will be written to an output database file, so you may examine the data with an analysis tool (SQL, Query, etc.) The command presents the following parameters: EDH - Data collection (EDH_PERF) Type choices, press Enter. Environment . . . . . . . . Environment type . . . . . Collection interval (minutes) Output file . . . . . . Library . . . . . . . . Replace or add records . . . . . . . __ *SND 15 EDH_PERF__ PMEDHUSR__ *REPLACE Name *SND, *RCV 0-60 Name Name *REPLACE, *ADD The environment code is mandatory. Define the interval, in minutes Define the target output file and the library Caution: Submit this command in batch, using SBMJOB The command will perform a collection of data every n minutes, according to defined parameters. For every period, the following information will be extracted: Extraction date (EXDATE) Extraction time (EXTIME) Tag – New collection – Position in the journal (date EXPOSD and time EXPOST) Replication delay – in seconds (EXPOSS) Number of objects out of sync (EXSYNC) Number of journal entries read in all journals (EXENTRD) Number of selected entries (EXENTSL) Amount of data read (EXSIZRD) 45 12/07/2013 Amount of data sent to the target system (EXSIZSN) Counts ADD operation (EXECARC) UPDATE operation (EXECARM) DELETE operation (EXECARD) OTHERS operation (EXECARO) 7.5. Option EDH_MIGKIT 51-Migration Kit - See documentation EDD_HA_Migration_Kit.pdf 46 12/07/2013 8. REMOTE PROCESS AND BACKUP 8.1. S.R.S. (Smart Remote Staging) - Storage of the journals entries Reminder: The basic principle of Quick-EDD/HA is a replication though a synchronous communication between the two systems (Detection / Sending / W riting / Acknowledgement) 8.1.1. Independent management of I/Os To address different needs of processing jobs on the target system, Quick-EDD/HA provides a function to manage I/Os on the system in an independent manner. To use this function, you need to run the PMEDHMOD command on the target system in *NOIO/*IO mode: Mode exécution environnement (PMEDHMOD) Type choices, press Enter Environment Type Snd or Rcv Mode opératoire . . . . . . . . . . . . . . . . . . . XX *SND *NOIO Name, generic*, * *SND, *RCV *NOJRN, *JRN, *NOIO, *IO... To manage the servers running I/Os, two options: *NOIO The writing function is disabled *IO The writing function is re-enabled When the *NOIO mode is enabled, journal entries keep being sent between the source system and the target system, but are stored in specific spaces, while waiting for the writing function to be re-enabled. When the *IO mode is activated, apply servers will empty the temporary storage spaces, then restart the usual synchronous cycle to manage the replication. This function can be used to manage any operation which needs to read the data on the target system: backup, data extraction, statistics batch… Note: The option *NOIO is always run on the target system. PMEDHMOD command will be used, usually, in combination with the TRP mode in order to manage suspending the writes at specific points of a process; in that case, SRS will be started from the source system. 47 12/07/2013 8.2. TRP – « Total Remote Process » / Remote control Basic functions of replication are managed from journals. It was therefore logical to offer a means by which you may manage functions on the Remote server and achieve goals of increased availability on the Source server. Function "TRP" allows you to trigger from the source system any kind of operation that you wish to execute on the target system. This function is very simple to use. Simply place an entry into the journal using the SNDJRNE command. This journal entry will contain the function to process: a function of Quick-EDD /HA, a system command, or the execution of a program. 8.2.1. List of functionalities Through journal entries, Quick-EDD/HA proposes the following functionalities: “CDP” – Continuous Data Protection: To perform a disk backup during replication process. EDHSAVRMT: Manage complete back up on the target system Commands o Run a command on the target system, or call a user program During the activation of one of these functions, it is important to understand how these requests are processed by Quick-EDD/HA. Function "TRP" uses the following steps: Taking advantage of S.I.P which assures the sequence of the journal entries, it ensures that command will be exactly processed in desired sequence When the target system receives a request " TRP ", it performs an additional loop of control, and is going to close all files currently opened (having fulfilled the I/Os preceding the request) Automatic switch in *NOIO mode Once the files are closed, execution of command in exclusive mode, by job EDH_xx_RCV Once the command is processed, replication engine restarts its updates in sequence o o o Automatic switch in *IO mode Processing of journals entries which have been stored on the target system (In *NOIO mode, journals entries have been sent from the source to the target and have been stored). Once the storage is processed, back to the synchronous replication mode. 8.3. CDP - Continuous Data Protection CDP offers a dynamic backup feature; integrated into the replication process. It can be used for several purposes: Back up data to a save file at a desired moment (eg. before running a critical batch job) Back up critical files periodically, to protect them from an error of manipulation (CLRPFM on the system of production reproduced in real-time on the target) Etc. The CDP function is based upon two commands. These commands allow you to perform disk backups without any stop in the replication process. 48 12/07/2013 Moreover, because of the synchronous cycle and the single SND control job of QuickEDD/HA which controls all journals, you are assured to perform the backup at a precise moment in time. 8.3.1. Backup request - EDHCDPRQS The EDHCDPRQS command must be incorporated into your operational jobs schedule. Parameters allow you to specify the environment, the object(s) to be saved, and the save file name. CDP request (EDHCDPRQS) Type choices, press Enter. Environment . . . Object . . . . . . . Library . . . Save file Library . . . Object Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . __ __________ __________ __________ __________ *ALL Name Name, generic*, *ALL, *LIB Name Name Name *ALL, Object type This command sends a journal entry (using a SNDJRNE), in « TRP » format, in the audit journal QAUDJRN. 8.3.2. Run backup request - EDHCDPEXC The EDHCDPRQS command is executed on the Source server and creates a journal entry which sends parameters to the EDHCDPEXC command on the Target server for execution. CDP process (EDHCDPEXC) Type choices, press Enter. Library . . . . . . . . Object . . . . . . . . . . . Object Type . . . . . . . . Save file . . . SAVF library . . . . . . . . . . __________ . __________ . *ALL . . Name Name, generic*, *ALL, *LIB *ALL, Object type Nam Name,*ALL After receiving the request on the target system, Quick-EDD/HA will run the backup, using received parameters. Note: If the SAVF doesn’t exist, it is automatically created by CDP; if it exists, it will be cleared before running the backup. 49 12/07/2013 8.4. Remote backup - EDHSAVRMT The availability of the complete database on a remote system allows you to manage backups on the remote system to reduce the downtime window on your production system. QuickEDD/HA allows this function: the backup on the target system will be triggered thanks to EDHSAVRMT command. 8.4.1. Remote backup – How it works Generally, the IT managers will prefer to process backups on the remote system if it is operationally possible. In addition to the remote backup, they will also wish that updates performed on the source system during the backup period are transmitted or even applied to the target system. Concurrent transmission of updates during the backup window will minimize bandwidth requirements after the backup. Quick-EDD/HA provides those benefits by utilizing the functions of the i5/OS "Save While Active", directly linked to the process of replication. The Source system executes the EDHSAVRMT command which requests the backup. This command will be inserted into the operational process, so the backup is carried out at an instant corresponding to a stable position (ie before nightly processing). The target system accepts request. This request is treated by "TRP", which ensures the backups are initiated at the correct time. Quick-EDD/HA closes all files which are currently opened, then submits backups as a batch job. This backup is submitted using options of "Save While Active". QuickEDD/HA temporarily holds the replication jobs. When the *SYNCLIB checkpoint is reached, i5/OS sends a message which is intercepted by Quick-EDD/HA. Quick-EDD/HA releases the replication jobs, and the normal replication cycle continues. Backups are processed in the meantime, in a safely manner because the system took the exact image by building the checkpoint Attention: If you use a job schedule entry to perform the backup, create a job description that contains the library list entries for PMEDH and PMEDHTOOLS. Reference that job description on the job schedule entry. 8.4.2. Submit the remote backup - EDHSAVRMT The command EDHSAVRMT is performed by the Production system. It submits the remote backup, using a TRP processing through a journal entry. Remote Backup (EDHSAVRMT) Type choices, press Enter. Environment . . . . . . . . . . Group code . . . . . . . . . . Max. wait time . . . . . . . . __ __________ 1800 Name Alphabetic 180-5400 Environment Code of the environment which will process the request (the journal entry) 50 12/07/2013 Group Code Alphanumeric value which will be sent to the target program EDHSAVRMT2. It allows to manage different backups in the same program (See “Usage of group code”) This journal entry sent by Quick-EDD/HA on the remote system starts the program EDHSAVRMT1 Program EDHSAVRMT1 submits a batch job « EDH_SAVRMT », based on a second program EDHSAVRMT2 Program EDHSAVRMT2 will perform the backup – it must be adapted to customer’s needs. 8.4.3. Adaptation of the program EDHSAVRMT2 Backups are initiated by the CLP program EDHSAVRMT2. THE PROGRAM MUST BE ADAPTED TO CUSTOMER NEEDS By default, program contains only a basic backup definition IN COMMENTS, with standard parameters: SAVLIB LIB(*ALLUSR) DEV(TAP01) … It must be adapted to fit with the system (device, omit, etc.) Moreover, the command already contains parameters to manage the « Save While Active » options, especially the synchronization mode and the dedicated message queue. Those parameters must be kept with same values Note: Before moving backups to the Recovery system, you must ensure that the Recovery system is totally synchronized with the Production system and ensure integrity of data. Moreover, it is important to use compatible devices on both source and target system to have capabilities to restore data directly on Production system if needed. 8.4.4. Usage a group code The group code is an alphanumeric character stream which can be received and tested on the target system, to manage different levels of backup. For example, you can organize backups with one group with production libraries and a second one for development part: IF COND(&GROUP *EQ ‘PRD’) THEN(DO) SAVLIB LIB(PRD*) DEV(TAP01) … IF COND(&GROUP *EQ ‘DEV’) THEN(DO) SAVLIB LIB(TST*) DEV(TAP01) … Note: The remote backup is based on Save While Active process. Sometimes, for huge systems it can need a long time before reaching the synchronization point, and the group code is an easy way to split the full backup in different parts. 51 12/07/2013 7.5. Remote backup EDHBRMSRMT using BRMS - BRMS is very popular software to manage back up; Quick-EDD/HA offers a command to manage a remote back up using this software. 7.5.1. BRMS/Quick-EDD/HA – How it works BRMS uses “groups” to define parts of the system you want to back up. The command EDHBRMSRMT will be very similar to EDHSAVRMT, but includes the Group code as used by BRMS to be able to manage the different cases of back up you want to manage on the target system. 7.5.2. Submit the remote backup - EDHBRMSRMT Command EDHBRMSRMT is performed by the Production system. It submits the remote backup, using a “TRP” processing through a journal entry. Save on target (EDHBRMSRMT) Type choices, press Enter. Environment . . . . . . . . . _________ BRMS Group code . . . . . . . . _________ Name Name This journal entry sent by Quick-EDD/HA on the remote system starts the program EDHBRMSRM1 – It includes the transmission of the group code The EDHBRMSRM1 batch job is submitted, based on EDHBRMSRM2 command 7.6. Remote backup and S.R.S As previously explained, the S.R.S mode allows to suspend the processing of I/Os on the target system and will store journals entries in a dedicated space. You can also run backups based on this function, especially if you want to hold I/Os during THE WHOLE TIME of the backup (need to validate the backup) For this specific case, you will use a dedicated CLP that will be run though T.R.P: Submission of CLP from the source via TRP Switch in *NOIO mode Backup – depending on the needs Switch in *IO mode Using this sequence of operation, all journals entries will be sent on the target system during the backup and then applied as soon as the *IO mode starts. 52 12/07/2013 9. SWITCH Several tools commands are dedicated to switch. 9.1. Command EDHCVTSEL EDH - Convert select. lines (EDHCVTSEL) Type choices, press Enter Environment . . . . . . . . . __ Nam This command allows, after the switch, to remove “TGT lib.” from the settings, replacing them by “*”. 9.2. Commands EDHDB2SAV and EDHDB2RST When stored procedures are used on the source system, it may be necessary to replicate some files from QSYS2 and SYSIBM. This replication is only possible if OS releases are the same on source and target systems. In order to replicate those files, we now recommend to use the management of specific objects, as described below. 2 commands have been created in the tools: EDHDB2SAV to save the needed tables of QSYS2 and SYSIBM on the source EDHDB2RST to restore these tables on the target at the time of the switch EDHDB2SAV is automatically called when EDHSAVDTA command is used, there is no need to tick any option. Obviously, EDHSAVDTA must be used on a regular basis on the source system (see tools documentation) EDHDB2RST will have to be called in the switch scenarios; it automatically saves the target files in a specific SAVF. 10.3. Command EDHJRNU This command allows, during a switch-over, before ending the replication, to create a journal entry which displays the switch point in each journal of the environment. EDH - U entry / All journals (EDHJRNU) Type choices, press Enter Environment Entry data . . . . . . . . . . . . . . . . . __ Nam '***** SWITCH POINT *****' Entry data can be filled in as you want. 53 12/07/2013 9.3. Command EDHMQSYNC To help with daily replication of MQ Series, the tool library from release V11_0407 includes a command which does all the needed operations: EDHMQSYNC EDH/MQ - Sync a Queue Manager (EDHMQSYNC) Select option, and press Enter. Environment . . . . . . . . . Queue manager name. . . . . . _____________ xx Name TSTQ01___________________________ Enter the Quick-EDD/HA environment code and the name of the Queue Manager. This command will perform the three following steps: o Change the journal receiver for journal AMQAJRN of the selected Queue Manager o Run the RCDMQMIMG for the selected Queue Manager o Force the synchronization of IFS files to ensure all modification are immediately reported to the target system You will have to run this command once a day, for each queue manager. You must also include it in the switch scenarios; step “Controlled stop of the production system” For more information regarding MQ EDD_HA_MQ_Replication_and_Switch_EN 9.4. Series replication see the FAQ EDHSAVSWI / EDHSAVSWR See above 9.5. EDH_NWSUSR The command EDH_NWSUSR allows to use at the time of the switch the command CHGNWSUSRA on all the system user profiles, with its settings. This command is dedicated to the propagation of profiles towards an integrated server (*NWSD). 9.6. EDH_ROLE The command EDH_ROLE allows to indicate if the system is the source – role PRODUCTION – or the target – role RECOVERY. On the target system, the options 1 to 5 of EDH menu are then deactivated. At the time of the switch, this command will allow to reverse the displayed roles. The role is written in the DTAARA PMEDHUSR/PMEDH_ROLE. Therefore, it’s automatically omitted from the replication. 54 12/07/2013 9.7. Option 11 of EDH menu - Switch Scenarios Option 11 of the EDH menu enables you to define switch scenarios. You can define as many scenarios as you want depending on your environment, and depending on special steps you want to define (different scenarios for switch-over and failover for example). EDHTools SWITCH – SCENARIOS__________________________ 2=Change 3=Copy 4=Delete 8=Commands 9=Run S _ _ _ _ _ _ _ _ _ _ Name STEP01 STEP02 STEP03 STEP04 STEP05 STEP06 STEP07 STEP08 STEP09 STEP10 5=Display Scenario : _________ Text description End of production system Switch on BACKUP system Start production on the new production The old production becomes backup Start replication from new prod to new backup End of production system Switch on PROD system Start production on the PROD system BACKUP partition becomes backup Start replication from PROD to BACKUP System PROD BACKUP BACKUP PROD BACKUP BACKUP PROD PROD BACKUP PROD Fin F3=Exit F5=Refresh F13=Copy commands F6=Create F11=Command F12=Cancel Each scenario contains a group of functions (commands to run) to be performed on the production or the recovery system. A scenario is defined as follows: Scenario name Description System the scenario is dedicated to Default execution mode Caution: Scenarios are stored in the database file EDHSWIPF. This file is automatically created in the library PMEDHUSR during first usage of the function. It will be MANDATORY to include this library PMEDHUSR in the replication definition so that the scenarios become available on the target system. Some samples of scenarios are available in the corresponding file located in PMEDHTOOLS library. To use those samples, run a copy command from the tool library to the final file, as follows: CRTDUPOBJ OBJ(EDHSWIPF) FROMLIB(PMEDHTOOLS) OBJTYPE(*FILE) TOLIB(PMEDHUSR) DATA(*YES) CRTDUPOBJ OBJ(EDHSWIL1) FROMLIB(PMEDHTOOLS) OBJTYPE(*FILE) TOLIB(PMEDHUSR) DATA(*YES) 55 12/07/2013 Function key F6 allows creating a new scenario: SCENARIO DEFINITION Scenario : SWITCH2___ Description : Start Activity on Recover y system_________________ System name : CLUSTER_ Mode : 2 1=Batch, 2=Interactive 3=By step F12=Cancel Enter the following parameters: Scenario name. Name of the scenario, with 10 characters Description text System name where the scenario will be performed (will be used to be sure that you run the correct scenario on the correct system) Execution mode BATCH – Submit the scenario in batch mode INTERACTIVE – Perform the scenario in interactive mode BY STEP – Each function will be confirmed by the user Note: Execution mode can be changed when the scenario is launched After having created the scenario, you can open it, using option “8=Commands”. It will show the detail of the scenario EDHTools 2=Change Scenario : Slt _ _ _ _ _ _ _ _ _ _ Seq. 5 10 20 30 40 50 60 70 80 90 F3=Exit 56 SWITCH - COMMANDS TO RUN____________________________ 3=Copy 4=Delete STEP2 5=Display Switch on RECOVERY system Command to execute DLTUSRIDX USRIDX(PMEDHUSR/AT_SND) PMEDHSWI ENV(AT) MOD(*YES) SNDMSG MSG('Switch Quick-EDD terminé - Démarrage d ADDTCPIFC INTNETADR('192.168.100.8') LIND(ETHLINE) STRTCPIFC INTNETADR('192.168.100.8') NETSTAT OPTION(*IFC) STRSBS SBSD(QINTER) STRSBS SBSD(QBATCH) STRSBS SBSD(QCMN) EDHUSRENA USRPRF(*ALL) STATUS(*ENABLED) QINCLUDE(* F5=Refresh F6=Create F12=Cancel Err 0 1 0 1 1 0 0 0 0 0 Lck 0 0 0 0 1 0 0 0 0 0 More ... F22=Re-number 12/07/2013 Use option « 2=Modify » to modify an existing command, or press F6 to create a new one. COMMAND TO EXECUTE Sequence : 30 (0-999) Action on error : 0 (0=Ignore, 1=Stop) Hold : 0 (0=No, 1=Yes) Command : SNDMSG MSG('Be sure to use console screen or HMC i_ n order to keep connection during switch') TOUSR(*R EQUESTER) MSGTYPE(*INQ)____________________________ ___________________________________________________ ___________________________________________________ Description Alert______________________________________________ F4=Prompt F12=Cancel Enter the following parameters: Sequence – Sequence number for the processing of this command Action on error – This parameter allows to define the action in case of command failure 0 – Process will continue 1 – Process is ended. You must examine the joblog, determine the failure, and restart on the sequence number of the command which failed. Hold – This setting allows to prevent the command from being processed, it will be displayed in yellow. Command – Detail of command to perform. Function key F4 allows prompting of the command. Description – Will be displayed while the replication will be running in “By step” mode Scenarios allow the use of any OS/400 command and of any Quick-EDD/HA command. The option F13 allows to copy several commands from one scenario to another: COPY OF A SCENARIO Scenario . . . . : From sequence : To sequence : Target scenario : Sequence . . . : Increment . . : 0 0 0 0 F12=Cancel The option F11 allows to display a standard command line. 57 12/07/2013 Run a switch scenario – EDHSWIRUN 9.8. Switch scenarios will be performed by command EDHSWIRUN Run a Switch scenario (EDHSWIRUN) Enter your choice, then press Enter. System name for control . . Switch scenario . . . . . . Execution mode . . . . . . Sequence number for retry . . . . . . . . . ________ __________ *DFT 0 Name Alphabetic *DFT, *BATCH, *INTER... 0-999 Enter command parameters System name - compares the value with the switch scenario and to system name (DSPNETA) for security check. The three values must be identical in order to start the scenario. Scenario – Name of the scenario to run Execution mode *DFT – Mode which is defined in the scenario. *BATCH – Scenario is submitted in batch mode. *INTER – Run interactively. A window will show the different steps of the scenario. *STEP – Step by step. Each command will be displayed and the user will have to confirm each command to run Retry sequence. Indicate a sequence number to run part of a scenario (after command failure) 10.5.1. Step by step mode Same presentation, but user must confirm the command processing using function key F23. PERFORM A SCENARIO DEMO Demonstration scenario ***** Press F23 to CONFIRM COMMAND TO RUN ***** Sequence : 30 Command : WRKACTJOB 2011/07/21 Comment : Check active jobs F3=Exit F12=Cancel Note: F13=Skip 18:12:42 F23=Confirm command You may press F3 or F12 to stop the scenario. The EDHSWIRUN command would be performed again, using a retry sequence number. Function key F13 allows to skip a command. Step by step mode is appropriate for the first switch tests you will perform. 58 12/07/2013 10.5.2. Interactive mode During processing of the scenario, in *INTER mode, the following window will be displayed. No action is possible, and commands are only displayed when running. PERFORM A SCENARIO DEMO Demonstration scenario ***** COMMAND IS RUNNING ***** Sequence : 30 Command : WRKACTJOB Comment F3=Exit : Check active jobs F12=Cancel F13=Skip 2011/07/21 18:12:42 F23=Confirm command Interactive processing is appropriate once the scenarios have been fully tested in step by step mode 10.5.3. Batch mode Scenario is performed without any screens This choice IMPLIES that the scenario doesn’t have any command which displays a screen (commands WRK*, DSP* can’t be used in this mode). Batch processing is appropriate once the scenarios have been fully tested in step by step mode 10.5.4. Spools allowing to track the scenarios processing No matter the chosen mode, 2 spool files are produced. Command WRKSPLF allows to check them: Spool EDH_SWILOG contains the entire joblog of the processing. The user reference of this spool is the name of the scenario. Spool EDHSWIRUNP contains the execution times of each step of the scenario. The user reference of this spool is the name of the scenario. The spool looks like this: 59 12/07/2013 Spool file *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8....+....9....+....0....+.... The: 11/05/10 Quick-EDD/HA_-_SWITCH_LOG System : QSLFRA2 Scenario : DEMO Demo Job : QPADEV0020 GODEC 683231 -- Date / time --- Sequence Operation Command --------------------------------------------------------------------------------2010/05/11 11:54:38 000 DISPLAY *** START SWITCH SCENARIO *** 2010/05/11 11:54:40 000 ** RUN ** 2010/05/11 11:54:40 000 DONE --------------------------------------------------------------------------------2010/05/11 11:54:40 010 DISPLAY SNDMSG MSG(TEST) TOUSR(*REQUESTER) 2010/05/11 11:54:42 010 ** RUN ** 2010/05/11 11:54:43 010 DONE --------------------------------------------------------------------------------2010/05/11 11:54:43 020 DISPLAY DLYJOB DLY(10) 2010/05/11 11:54:44 020 ** RUN ** 2010/05/11 11:54:54 020 DONE F3=Exit F12=Cancel F19=Left F20=Right Time the command was displayed Time the command was launched Time the command was processed In step by step mode, the difference between the display and the launch indicates the time used to take the decision. In all modes, the difference between the launch and the end of the processing allows to know precisely the time that each step took. 60 12/07/2013 10. MISCELLANEOUS COMMANDS 10.1. EDHOBJERR This command, used on a SND environment, produces a spool indicating if there are objects waiting or in error of synchronization, and their list. 10.2. Adapt EDHSVRA synchronization – servers EDH - Change Sync Servers (EDHSVRA) Type your choices, press Enter Environment . . . . . . . . . MIN number of servers . . . . MAX number of servers . . . . __ *SAME *SAME Nam 1-16, *SAME 1-16, *SAME This command allows, for the selected environment, to dynamically change (without ending the replication) the minimal and maximal numbers of active synchronization jobs. 10.3. EDHSTART Command: environments and tools EDH - Start EDH servers start of (EDHSTART) Type choices, press Enter Environment . . . . . . . . . Start environment . . Start supervision (EDHCTL) Start Message Monitoring . Start Journal Manager Backup of the Environment . __ *YES *YES *NO *NO *NO Name, *YES, *YES, *YES, *YES, *YES, generic*, * *NO *NO *NO *NO *NO Environment name, mandatory Specify the environment name to start Accept a name, a generic name, or * for all This command allows to start replication and tools: supervision / monitoring / Journal Manager; and to save the environment (in library PMEDHUSRBK). 61 12/07/2013 10.4. EDHSTOP Command: environments and tools EDH - Stop EDH servers stop of (EDHSTOP) Type choices, press Enter Environment . . . . . . . . . End environment . . . . End Supervision (EDHCTL) . . . End Journal Manager . . . __ *YES *YES *NO Name, *YES, *YES, *YES, generic*, * *NO *NO *NO Environment name; mandatory Specify the environment name to stop Accept a name, a generic name, or * for all This command allows to end replication and tools: supervision and Journal Manager. Monitoring can be stopped by an ENDJOB with *IMMED option. 10.5. Replication EDH_ACGINS of ACG application – Quick-EDD/HA for ACG (EDH_ACGINS) Type your choices, press Enter ACG parameters file . . . . Library . . . . . . . . . ACG environment code . . . . Restore standard environment . . . . . . . . KFSIF00F *LIBL AC *NO Name, generic* Name,*LIBL Nam *NO, *YES This command allows, from the setting file of ACG, to automatically create an environment, for example AC, which contains needed parameters to run the replication. 10.6. Synchronize a library - EDHOBJREP The Synchronization function allows you to force replication of any object. You may specify a date to force replication of objects on the Production server that were modified after the specified date. Retry objects (EDHOBJREP) Type choices, press Enter. Object . . . . . . . Library . . . . Object Type . . . . Retry type . . 62 . . . . . . . . . . . . . . . . . . . . . . . __________ ___________ *ALL *ALL Name, generic*, *ALL Name *ALL, Object type *ALL, *DATE 12/07/2013 Selection with object type, or *ALL Replicate objects with name, generic name, or *ALL for an entire library Force replication of ALL objects in the recovery library OR Check objects modified after the specified date. This command is useful after having inserted a new library in the replication perimeter (cf. EDD_HA_06_Settings) 10.7. Data Extraction - EDHRTVINF This command extracts information from object parameters and converts it in a structured database file EDHRTVINF. EDHRTVINF fields - file LINETYPE LIBNAME OBJNAME OBJTYPE REFLIB REFOBJ description: Line type Library Object Object type Library of dependent object Dependent object 2 10 10 8 10 10 Line-type field can receive the following values: 04 – Journal processed by EDD/HA 05 – Receiver associated with a processed journal 10 – Library managed by EDD/HA 11 – Object managed by EDD/HA 16 – QSYS object managed by EDD/HA 11.4. Data Extraction - EDHRTVINX This command is similar to EDHRTVINF. Furthermore, for each object it includes the information about the target library when the library is renamed on the target system. Note: The two commands use the same output file definition. 63 12/07/2013