Data Transfer from Physical Mainframe to PopUp

To populate your PopUp with applications and data, it is necessary to copy application libraries and associated data from your physical mainframe to your PopUp.

There are a number of ways to do this including IBM Migration Utility, Connect:Direct, and FTP. The choice will largely be dependant on the tools available and the amount of data to transfer. We recommend using IBM Migration Utility, for a simple and repeatable process (a hybrid approach may also be appropriate).

Data transfer process using IBM Migration Utility

The transfer process requires a few setup activities before the data is moved. It is summarised below.

A. Setup

  1. Determine which data on the physical mainframe needs to be transferred to the PopUp.
  2. Install the IBM Migration Utility.
  3. Allocate one or more dedicated “Transport Volumes” on your physical mainframe.
  4. Install Popup Auto Migration & Data Corraling tool (optional).

B. Transferring the Data

  1. Corral all required data to these transport volumes, typically using the Popup Auto Migration & Data Corraling tool.
  2. Initiate the data transfer via Linux server.
  3. De-corral the data on the PopUp.
  4. Repeat steps 5-7 until all data is transferred.

The steps are described in detail below.

A. Setup

1. Determine the scope of the Migration "Project"

Before starting a migration, a good understanding of the applications and the scope of the work is needed.

Documenting all application libraries and any data requirements will form the basis of a swift and successful data migration.

2. Install IBM Migration Server Utility on Physical Mainframe

To install the IBM Migration Server Utility:

  • A transfer file, ZOSSERV.XMIT , is shipped with the PopUp and should be transferred to your mainframe in binary mode. The file should be uploaded, typically using 3270 file transfer, with the following attributes RECFM=FB, LRECL=80, BLKSIZE=3120.
  • Allocate a load library e.g. ABCD01.MIGSERV.LOAD with attributes LRECL=0,BLKSIZE=32760,RECFM=U.
  • In TSO/ISPF option 6 enter the command: RECEIVE INDATASET('ABCD01.XMIT’) and when prompted enter DATASET(‘ABCD01.MIGSERV.LOAD’)
  • The load module in ABCD01.MIGSERV.LOAD is ZPDTMSRV. This needs to be moved into an APF Authorised library OR the library itself needs to be added temporarily or permanently to the APF Authorised list.
  • A job will need to be created to run ZPDTMSRV. The job will start ZPDTMSRV as a long running job but this program will automatically end if there has been no volume transfer activity for 10 minutes.

Typical JCL:

//     TIME=1440 
//STEPLIB  DD DISP=SHR,DSN=an.apf.auth.LOADLIB           
//SYSPRINT DD SYSOUT=*                                       
//SYSUDUMP DD SYSOUT=*                                       

Typically, the Migration Utility, ZPDTMSRV , listens on port 3990 (PARM=3990 , above). Multiple jobs can run in parallel, however, depending on the throughput required.

3. Allocate dedicated DASD (Transport Volumes) for use by IBM Migration Utility

The IBM Migration Utility transfers whole volumes at a time. An efficient migration method is to gather copies of libraries, data and other objects onto the smallest volume necessary to accommodate them.

The volume should be non-SMS in order to allow datasets to retain their original names (while being non-catalogued) and to prevent SMS overruling the volume in JCL.

A mostly empty volume will take the same time to migrate as a mostly full volume of the same size. Therefore, it is sensible to assign differently sized volumes for large or small migrations.

Ideally, make a variety of Volume sizes available:

  • Large - 200+ Gb
  • Medium - 30 to 50 Gb
  • Small - 3 Gb

4. Install Auto Migration & Data Corraling Solution

If you wish to make use of the Popup Auto Migration & Data Corraling tool, this should be installed on your mainframe. The libraries can be found on the PopUp UTIL01 volume.

A simple use case is provided to smoke test the operation.

B. Transferring the Data

Once the pre-requisites are in place, you can begin the data transfer.

5. Corral data with the Popup Auto Migration & Data Corraling tool

The IBM Migration Server Utility method of file transfer to a PopUp requires all necessary files to be bundled up into one or more transport volumes. The Popup Auto Migration & Data Corraling tool helps to standardize this.

The tool takes a list of datasets, interrogates each and then determines how best to copy to the Transport volume.

The following derivatives are covered:

  1. VSAM datasets
  2. Sequential files
  3. PDS libraries
  4. PDSE libraries

The process uses LISTCAT and LISTDSI to determine which of the following methods to generate:

  3. IDCAMS Export / Import

Further methods can be added as required.

The process can be used to execute various scenarios including initial transfer of application libraries, initial load of application data, refreshing application data and upgrading software.

The tool also creates jobs to de-corral the datasets once the volumes have been transferred.

The jobs can be executed manually, via a suitable mainframe scheduling application or via the provided Auto Migration tool.

6. Initiate the data transfer

Volume migration requests are instigated by entering a line command in the ZD&T Linux. Once the Migration Server Utility job is running, a command is entered, as below:

hckd2ckd /z/ibmsys1/dasd/trn001 -v TRN001

where the arguments are IP address of the source mainframe, the path of the Linux volume file and the VolSer of the required volume.

Note: PopUp's Auto Migration Utility will handle requests to the Migration Server Utility where autonomous operation is preferred.


IBM documentation refers to ZPDTMSRV requiring the userid to have read access on the volumes to be migrated, via the DASDVOL class. If you are not using RACF, you will need to verify that ZPDTMSRV works in your setup e.g. via IBM’s SAF (Security Authorization Facility).

The above job could be run from a mainframe scheduler using a functional userid with e.g. storage management privileges, but submitted by a mainframe user who doesn’t themselves have those privileges.

7. De-Corral the data on the PopUp

Once the volumnes gave been transferred to the PopUp, datasets should be de-corralled.

The corraling will have created the necessary jobs to do this.

The jobs can be submitted individually or under control of the Auto Migration tool.

8. Repeat as needed

Repeat steps 5-7 as needed until all data is transferred. These steps can be performed on an ongoing basis.

Page last revised on: 2023-03-30