FDRPAS for large scale synchronized migration

This section gives examples of the steps for a Large Scale Migration with SWAPDUMP.

All examples in this section are found in the JCL library installed with FDRPAS. The member names are PA31509x.

SWAPDUMP procedure

The recommended sequence of operations for SWAPDUMP is:

1. Run SIMSWAP.
   Set up SIMSWAP with all of the same operands and MOUNT commands that you will use for SIMSWAPMON and SWAPDUMP. SIMSWAP validates most of the control statement parameters.

   SIMSWAP verifies that the source volumes are online.

   SIMSWAP lists the LPARs that are connected to the source volumes.

2. Add a PASJOB DD statement with a monitor job for each LPAR that is connected to the source volumes, and then run:
   SIMSWAPMON.

   SIMSWAPMON verifies the connections between the SWAPDUMP job and the monitor jobs.

3. Run SWAPDUMP with KEEPACTIVE=REPEAT.
4. Run MONITOR TYPE=KEEPACTIVE with PRINT=STATUS.
   Run this periodically during the initial copy cycle of the SWAPDUMP to monitor progress. This function prints a line for each volume showing its status (inactive, copy pass, update pass, or KEEPACTIVE), and a summary line showing the number of volumes in each state.
5. Run MONITOR TYPE=KEEPACTIVE with EMCSIN DD DUMMY.
   Run this toward the end of the initial copy cycle. It periodically produces a one line summary showing the number of volumes in each state (inactive, copy pass, update pass, or KEEPACTIVE), and terminates when all of the source volumes have completed the initial copy pass. When this job terminates, it means that all volumes have reached synchronization, and the operation is eligible to be completed.
6. When you are ready, quiesce all system and application activity on all of the LPARs as much as possible.
7. Run MONITOR TYPE=KEEPACTIVE with EMCSIN containing KEEPACTIVE=DONE commands.
   This tells the SWAPDUMP job to complete the operation after one final cycle.

Examples

The data center has three LPARs. A single SWAPDUMP job on one of the LPARs copies all 2900 of the volumes. SIMSWAP and SIMSWAPMON jobs will be run before the SWAPDUMP, to prepare for it. Since there is only one job of each type, the GENSWAP procedure (FDRPAS-GENSWAP) is not needed. The SIMSWAPMON and SWADUMP jobs submit monitor jobs to the other two LPARs. MONITOR TYPE=KEEPACTIVE jobs are used to check on the progress of the SWAPDUMP and to tell SWAPDUMP when to complete the operation.

The MOUNT statements are the same for all of the jobs.

Example A: FDRPAS SIMSWAP for a Large Number of Volumes

Run a SIMSWAP to prepare for a SWAPDUMP. See the introduction under Examples.

The purpose of SIMSWAP is to check the control statements for validity, verify that the source volumes are online, and list the LPARs that need monitors. SIMSWAP should be run on the same LPAR where the SWAPDUMP will run.

SIMSWAP does not connect with monitors.

//SIM1 EXEC PGM=FDRPAS,REGION=0K//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//FDRSUMM DD SYSOUT=*//SYSUDUMP DD SYSOUT=*//SYSIN DD * SIMSWAP TYPE=FULL, ALLOWPAV=YES, ALLOWZHPF=YES, KEEPACTIVE=REPEAT, LARGERSIZE=OK, LARGESWAP=4000, LOGMESS=NO, MAXCARDS=3000, MAXTASKS=64 MOUNT VOL=SH20D1,SWAPUNIT=20D0 MOUNT VOL=SH20CD,SWAPUNIT=21CD MOUNT VOL=SH20C6,SWAPUNIT=21C6 MOUNT VOL=SH20C3,SWAPUNIT=21C3 … MOUNT VOL=SH20C0,SWAPUNIT=21C0 MOUNT VOL=SH23C0,SWAPUNIT=23C2 MOUNT VOL=SH93C9,SWAPUNIT=23CC MOUNT VOL=SH2510,SWAPUNIT=2511/*

FDRPAS SIMSWAP SYSPRINT Report

Example B: FDRPAS SIMSWAPMON for a Large Number of Volumes

Run a SIMSWAPMON to prepare for a SWAPDUMP. See the introduction under Examples.

SIMSWAPMON submits monitor jobs to all LPARs where the source volumes are online. You supply model JCL for the monitor jobs in the PASJOB DD statement of the SIMSWAPMON job. The model JCL for each monitor is preceded by a //*CPUID= statement specifying the CPU serial number of the LPAR where that monitor is intended to run. The CPU serial numbers were shown in FDR233 messages from the SIMSWAP job. The model JCL for each monitor includes the routing information to cause the job to execute on the desired LPAR, such as /*ROUTE XEQ, /*JOBPARM SYSAFF=, CLASS=, or //*MAIN SYSTEM=. SIMSWAPMON communicates with the monitors to verify the connections.

//SIM2 EXEC PGM=FDRPAS,REGION=0K//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//FDRSUMM DD SYSOUT=*//SYSUDUMP DD SYSOUT=*//SYSIN DD * SIMSWAPMON TYPE=FULL, ALLOWPAV=YES, ALLOWZHPF=YES, KEEPACTIVE=REPEAT, LARGERSIZE=OK, LARGESWAP=4000, LOGMESS=NO, MAXCARDS=3000, MAXTASKS=64 MOUNT VOL=SH20D1,SWAPUNIT=20D0 MOUNT VOL=SH20CD,SWAPUNIT=21CD MOUNT VOL=SH20C6,SWAPUNIT=21C6 MOUNT VOL=SH20C3,SWAPUNIT=21C3 … MOUNT VOL=SH20C0,SWAPUNIT=21C0 MOUNT VOL=SH23C0,SWAPUNIT=23C2 MOUNT VOL=SH93C9,SWAPUNIT=23CC MOUNT VOL=SH2510,SWAPUNIT=2511/*//PASJOB DD DATA,DLM=ZZ//*CPUID=ssssssssss <--- fill in cpu serial number
//PASMONA JOB (ACCT),'NAME',CLASS=M,MSGCLASS=X,NOTIFY=&SYSUID/*ROUTE XEQ JESCPUA//MONA EXEC PASPROC//********************************************************************//* MONITOR - SWAPUNIT=&&&& WILL GENERATE JUST-IN-TIME MONITORING *//* USING THE “OFFLINE” DEVICES *//********************************************************************//PAS.SYSIN DD * MONITOR TYPE=SWAP, ALLOWPAV=YES, ALLOWZHPF=YES, DURATION=600, LARGESWAP=4000, MOUNT SWAPUNIT=&&&&/*//*CPUID=ssssssssss <--- fill in CPU serial number
//PASMONB JOB (ACCT),'NAME',CLASS=M,MSGCLASS=X,NOTIFY=&SYSUID/*ROUTE XEQ JESCPUB//MONB EXEC PASPROC//********************************************************************//* MONITOR - SWAPUNIT=&&&& WILL GENERATE JUST-IN-TIME MONITORING *//* USING THE “OFFLINE” DEVICES *//********************************************************************//PAS.SYSIN DD * MONITOR TYPE=SWAP, ALLOWPAV=YES, ALLOWZHPF=YES, DURATION=600, LARGESWAP=4000, MOUNT SWAPUNIT=&&&&/*ZZ

FDRPAS SIMSWAPMON SYSPRINT Report

Example C: FDRPAS SWAPDUMP with KEEPACTIVE for a Large Number of Volumes

Run a SWAPDUMP. See the introduction under Examples.

This SWAPDUMP job will submit monitor jobs to the other two LPARs; the model jobstreams for the monitors are in the PASJOB DD statement. These model jobstreams are the same as in the SIMSWAPMON job.

KEEPACTIVE=REPEAT specifies that after FDRPAS processes each volume, it keeps the I/O intercepts active to continue to record updated tracks, and after it processes all of the volumes, it starts over and processes all of them again. MAXTASKS=64 specifies that 64 volumes at a time should be copied.

Once all of the data has been copied and the applications have been quiesced, the SWAPDUMP can be completed by issuing a z/OS “MODIFY PASSWDMP,KEEPACTIVE=DONE” command, or by running MONITOR TYPE=KEEPACTIVE with EMCSIN containing KEEPACTIVE=DONE commands (Example F: FDRPAS MONITOR TYPE=KEEPACTIVE with KEEPACTIVE=DONE Commands).

//PASSWDMP JOB (ACCT),'NAME',CLASS=M,MSGCLASS=X,NOTIFY=&SYSUID//SWAPDMP EXEC PGM=FDRPAS,REGION=0K,TIME=1440//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//FDRSUMM DD SYSOUT=*//SYSUDUMP DD SYSOUT=*//SYSIN DD * SWAPDUMP TYPE=FULL, ALLOWPAV=YES, ALLOWZHPF=YES, KEEPACTIVE=REPEAT, LARGERSIZE=OK, LARGESWAP=4000, LOGMESS=NO, MAXCARDS=3000, MAXTASKS=64 MOUNT VOL=SH20D1,SWAPUNIT=20D0 MOUNT VOL=SH20CD,SWAPUNIT=21CD MOUNT VOL=SH20C6,SWAPUNIT=21C6 MOUNT VOL=SH20C3,SWAPUNIT=21C3 … MOUNT VOL=SH20C0,SWAPUNIT=21C0 MOUNT VOL=SH23C0,SWAPUNIT=23C2 MOUNT VOL=SH93C9,SWAPUNIT=23CC MOUNT VOL=SH2510,SWAPUNIT=2511/*//PASJOB DD DATA,DLM=ZZ//*CPUID=ssssssssss <--- fill in cpu serial number
//PASMONA JOB (ACCT),'NAME',CLASS=M,MSGCLASS=X,NOTIFY=&SYSUID/*ROUTE XEQ JESCPUA//MONA EXEC PASPROC//********************************************************************//* MONITOR - SWAPUNIT=&&&& WILL GENERATE JUST-IN-TIME MONITORING *//* USING THE "OFFLINE" DEVICES *//********************************************************************//PAS.SYSIN DD * MONITOR TYPE=SWAP, ALLOWPAV=YES, ALLOWZHPF=YES, DURATION=600, LARGESWAP=4000, MOUNT SWAPUNIT=&&&&/*//*CPUID=ssssssssss <--- fill in cpu serial number
//PASMONB JOB (ACCT),'NAME',CLASS=M,MSGCLASS=X,NOTIFY=&SYSUID/*ROUTE XEQ JESCPUB//MONB EXEC PASPROC//********************************************************************//* MONITOR - SWAPUNIT=&&&& WILL GENERATE JUST-IN-TIME MONITORING *//* USING THE "OFFLINE" DEVICES *//********************************************************************//PAS.SYSIN DD * MONITOR TYPE=SWAP, ALLOWPAV=YES, ALLOWZHPF=YES, DURATION=600, LARGESWAP=4000, MOUNT SWAPUNIT=&&&&/*ZZ

FDRPAS Display Showing SWAPDUMP w/KEEPACTIVE=REPEAT: Data Being Copied

FDRPAS Display Showing SWAPDUMP w/KEEPACTIVE=REPEAT: All Data Copied; Volumes in KEEPACTIVE State

FDRPAS SWAPDUMP FDRSUMM REPORT for KEEPACTIVE=REPEAT

Volumes are repeated for each KEEPACTIVE pass.

FDRPAS SWAPDUMP SYSPRINx Report for KEEPACTIVE=REPEAT

Statistics are repeated for each KEEPACTIVE pass.

FDRPAS MONITOR SYSPRTxx Report for KEEPACTIVE=REPEAT

Statistics are repeated for each KEEPACTIVE pass.

Example D: FDRPAS MONITOR TYPE=KEEPACTIVE with PRINT=STATUS

Run MONITOR TYPE=KEEPACTIVE with PRINT=STATUS during the initial copy cycle of the SWAPDUMP job(s) running with KEEPACTIVE=REPEAT to display the progress of the SWAPDUMP(s). The MONITOR TYPE=KEEPACTIVE job should be run on the same LPAR as the SWAPDUMP job(s).

//MON1 EXEC PGM=FDRPAS,REGION=0K//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//FDRSUMM DD SYSOUT=*//SYSUDUMP DD SYSOUT=*//EMCSPRT DD SYSOUT=*//EMCSIN DD DUMMY//SYSIN DD * MONITOR TYPE=KEEPACTIVE,MAXCARDS=3000,PRINT=STATUS MOUNT VOL=SH20D1,SWAPUNIT=20D0 MOUNT VOL=SH20CD,SWAPUNIT=21CD MOUNT VOL=SH20C6,SWAPUNIT=21C6 MOUNT VOL=SH20C3,SWAPUNIT=21C3 … MOUNT VOL=SH20C0,SWAPUNIT=21C0 MOUNT VOL=SH23C0,SWAPUNIT=23C2 MOUNT VOL=SH93C9,SWAPUNIT=23CC MOUNT VOL=SH2510,SWAPUNIT=2511/*

FDRPAS MONITOR TYPE=KEEPACTIVE with PRINT=STATUS Report #1

FDRPAS MONITOR TYPE=KEEPACTIVE with PRINT=STATUS Report #2

This report was run one minute after the previous one. It shows that two volumes have completed the initial copy pass.

Example E: FDRPAS MONITOR TYPE=KEEPACTIVE with EMCSIN DD DUMMY

If any of the volumes are inactive or are in the initial copy pass, MONITOR TYPE=KEEPACTIVE produces a one-line summary at a specified interval to display the progress of the SWAPDUMP job(s) running with KEEPACTIVE=REPEAT. SWAPDELAY= specifies the interval, in seconds. The MONITOR TYPE=KEEPACTIVE job should be run on the same LPAR as the SWAPDUMP job(s). If more than one SWAPDUMP job is running, then the MONITOR TYPE=KEEPACTIVE job should have MOUNT commands for all of the volumes in all of the SWAPDUMP jobs. When all of the volumes have completed the initial copy pass, the MONITOR TYPE=KEEPACTIVE job terminates. When that happens, it means that all volumes have reached synchronization, and the operation is eligible to be completed. When you are ready, quiesce all system and application activity on all of the LPARs as much as possible. Then complete the operation, either with a z/OS “MODIFY swapjob,KEEPACTIVE=DONE” command or by running MONITOR TYPE=KEEPACTIVE with EMCSIN containing KEEPACTIVE=DONE commands (Example F: FDRPAS MONITOR TYPE=KEEPACTIVE with KEEPACTIVE=DONE Commands).

After all of the volumes have completed the initial copy pass, you can rerun MONITOR TYPE=KEEPACTIVE with EMCSIN DD DUMMY periodically to make sure that no failures have occurred. If the job does not terminate right away, it means that one or more of the volumes have encountered a problem and have returned to the inactive state. The SWAPDUMP job containing that volume will terminate at the end of the current cycle.

//MON1 EXEC PGM=FDRPAS,REGION=0K//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//FDRSUMM DD SYSOUT=*//SYSUDUMP DD SYSOUT=*//EMCSPRT DD SYSOUT=*//EMCSIN DD DUMMY//SYSIN DD * MONITOR TYPE=KEEPACTIVE,MAXCARDS=3000,SWAPDELAY=15 MOUNT VOL=SH20D1,SWAPUNIT=20D0 MOUNT VOL=SH20CD,SWAPUNIT=21CD MOUNT VOL=SH20C6,SWAPUNIT=21C6 MOUNT VOL=SH20C3,SWAPUNIT=21C3 … MOUNT VOL=SH20C0,SWAPUNIT=21C0 MOUNT VOL=SH23C0,SWAPUNIT=23C2 MOUNT VOL=SH93C9,SWAPUNIT=23CC MOUNT VOL=SH2510,SWAPUNIT=2511/*

FDRPAS MONITOR TYPE=KEEPACTIVE Report (Volumes Active)

z/OS MODIFY Command to Complete FDRPAS SWAPDUMP Job Running with KEEPACTIVE=REPEAT

F swapjob,KEEPACTIVE=DONE

Example F: FDRPAS MONITOR TYPE=KEEPACTIVE with KEEPACTIVE=DONE Commands

Run this job to tell the SWAPDUMP job(s) to complete. If more than one SWAPDUMP job is running, then the MONITOR TYPE=KEEPACTIVE job should have MOUNT commands for all of the volumes in all of the SWAPDUMP jobs. The MONITOR TYPE=KEEPACTIVE job should be run on the same LPAR as the SWAPDUMP job(s). It is expected that you will run MONITOR TYPE=KEEPACTIVE with KEEPACTIVE=DONE commands after MONITOR TYPE=KEEPACTIVE with EMCSIN DD DUMMY (Example E: FDRPAS MONITOR TYPE=KEEPACTIVE with EMCSIN DD DUMMY) has shown that all of the volumes have reached synchronization, and the operation is eligible to be completed; and after you have quiesced all system and application activity on all of the LPARs as much as possible. If all of the volumes are synchronized (i.e. their state is either KEEPACTIVE or update pass), MONITOR TYPE=KEEPACTIVE invokes program FDREMCS (FDR-Extended-MCS-Software-Console-FDREMCS) and then terminates. When FDREMCS runs under MONITOR TYPE=KEEPACTIVE, it uses EMCSIN and EMCSPRT DD statements for input and output instead of SYSIN and SYSPRINT. In EMCSIN, supply “MODIFY swapjob,KEEPACTIVE=DONE” commands for all of the SWAPDUMP jobs. In this way, you can be assured that all of the commands will be issued at the same time. The SWAPDUMP job(s) will complete after one final cycle.

If MONITOR TYPE=KEEPACTIVE does not terminate quickly, it means that you have submitted it too soon and one or more of the volumes are still in the initial copy phase, and/or that one or more volumes have failed and returned to the inactive state. The SWAPDUMP job(s) containing volumes that have failed will terminate at the end of the current cycle.

//MON1 EXEC PGM=FDRPAS,REGION=0K//STEPLIB DD DISP=SHR,DSN=fdrpas.loadlib//SYSPRINT DD SYSOUT=*//FDRSUMM DD SYSOUT=*//EMCSPRT DD SYSOUT=*//SYSUDUMP DD SYSOUT=*//EMCSIN DD * COMMAND=F swapjob1,KEEPACTIVE=DONE
 COMMAND=F swapjob2,KEEPACTIVE=DONE
/*//SYSIN DD * MONITOR TYPE=KEEPACTIVE,MAXCARDS=3000,SWAPDELAY=15 MOUNT VOL=SH20D1,SWAPUNIT=20D0 MOUNT VOL=SH20CD,SWAPUNIT=21CD MOUNT VOL=SH20C6,SWAPUNIT=21C6 MOUNT VOL=SH20C3,SWAPUNIT=21C3 … MOUNT VOL=SH20C0,SWAPUNIT=21C0 MOUNT VOL=SH23C0,SWAPUNIT=23C2 MOUNT VOL=SH93C9,SWAPUNIT=23CC MOUNT VOL=SH2510,SWAPUNIT=2511/*

FDRPAS MONITOR TYPE=KEEPACTIVE Report (Showing All Volumes Copied)

FDREMCS LISTING from Monitor TYPE=KEEPACTIVE with KEEPACTIVE=DONE