Skip to main content

IBM Migration Utility Explorer README

Copyright Statement

© Copyright Transiom Software, Inc. 2015, 2018. All rights reserved. Unauthorized use or disclosure of any part of the system is prohibited. Transiom Software, Inc. has granted IBM a non-exclusive license to market PEngiGUI as IBM Migration Utility Explorer.

© Copyright IBM® Corporation 2015, 2018. All rights reserved. For legal information, see http://www.ibm.com/legal/copytrade.shtml

Contents

• IBM Migration Utility Explorer Process Flowchart
• Overview
• Hardware Requirements
• Supported Platforms
• Software Requirements
• Mainframe (z/OS) Requirements
• General Concepts
• Mainframe Interface Summary
• Installing IBM Migration Utility Explorer
• Getting Started with IBM Migration Utility Explorer
• Updating IBM Migration Utility Explorer
• Technical Support
• Glossary

IBM Migration Utility Explorer Process Flowchart

Link to an easy to follow flow chart style presentation.

The flowchart provides information regarding:

• The IMU Explorer Installation Steps
• Overview of the IMU Explorer
• IMU Explorer Features
• IMU Explorer Editor Capabilities

Back to Contents

Overview

IBM Migration Utility Explorer is a stand-alone Eclipse-based IDE environment that gives workstation users the capability to create, edit and syntax check IMU V4.1 and later versions of programs. More significant features of the IBM Migration Utility Explorer are:

• IBM Migration Utility Explorer text files editor
• IBM Migration Utility Explorer syntax check and editor for Easytrieve Plus programs
• IBM Migration Utility Explorer syntax check and editor express for Easytrieve Plus programs
• IBM Migration Utility Explorer File Transfer Manager (FTP)
• IBM Migration Utility Drill Down reports viewer
• IBM Report Modernization Utility (RMU) reports viewer
• IBM z/OS JES Interface via FTP Server

There is a 32 bit and 64 bit version of the IBM Migration Utility Explorer.

The version you run is dependent on the Java you have installed, not whether your Windows operating system is 32 bit or 64 bit.

If you are not sure what version of Java you are running, try the 32 bit version of the IBM Migration Utility Explorer first.

For more comprehensive details on using the IBM Migration Utility Explorer please see the following documentation located under Help -> Help Contents.

• IMU-Explorer_buttons.html
• IMU-Exlorer_howto.html

Back to Contents

Hardware Requirements

The following minimum hardware levels are required:

• CPU - 1 GHz or faster 64-bit (x64) processor, dual or quad core recommended
• RAM - 1.0 GB minimum, 2.0 GB recommended
• Hard disk - minimum of 200 MB available space

Back to Contents

Supported Platforms

One of the following levels of the Microsoft Windows operating system:

• Microsoft Windows 7 (64-bit)
• Microsoft Windows 10 (64-bit)

Back to Contents

Software Requirements

One of the following Java versions are required:

• Java V7.1 (64 bit) or later versions
• Java V7.1 (32 bit) or later versions
• Java V8.0 (64 bit) or later versions
• Java V8.0 (32 bit) or later versions

The following IBM products for z/OS are needed:

1. Required Products:
• IBM Migration Utility (IMU) for z/OS, V4.1 or later
• IBM Enterprise COBOL for z/OS, V4.2 or later
2. Optional Products:
• Db2 for z/OS, V11.1 or later

Visit the IBM Migration Utility maintenance page for required COBOL PTF's: http://www-01.ibm.com/support/docview.wss?uid=swg24042466.

Back to Contents

Mainframe (z/OS) Requirements

The users of IBM Migration Utility Explorer will need the following:

1. A TSO User ID with ISPF capability
2. FTP Client to z/OS and z/OS to Client capability
3. IBM Migration Utility for z/OS V4.1 or later
4. The knowledge of how to use IMU
5. The knowledge of how to run Jobs on z/OS
6. The ability to look at input, output and hold JES2/JES3 queues
7. The FTP Server on z/OS with Jesinterfacelevel=1 or Jesinterfacelevel=2

Back to Contents

General Concepts

IBM Migration Utility Explorer runs on you personal computer. It allows you to do mainframe tasks on your PC using the Graphical User Interface (GUI), eliminating the use of mainframe resources. Its use is supplemented by your existing 3270 access to TSO/ISPF and the z/OS environment. IMU JOBs/JCL and programs are developed on your PC and run on z/OS. The 3270 session or IBM Migration Utility Explorer z/OS JES Interface is used to look at the JOB completion, the output and/or any other mainframe resources.

Note: IBM Migration Utility Explorer does not provide a 3270 emulator. Use your existing 3270 environment or obtain a 3270 emulator like IBM Personal Communications.

The IMU Explorer Graphical User Interface consists of the following:

• The Home Screen
• The Editor Screen(s)
• The Help Documents Screen(s)
• The FTP Connection interface
• File management feature
• Work Space/Folder
• Easytrieve Plus macros and DCLGens interface

The Home Screen

1. The Main Menu at the top
2. The Tool bar below the Menu at the top
3. The Mainshell Tree of opened directories on the left. The tree consists of directories found in the Work Space/Folder opened at start-up time, and directories subsequently opened via the Home Screen menu File -> Open Directory choice.
4. The General Purpose Screen on the right. The General Purpose Screen is where the z/OS JES Queue, the Help documents and the program Browse screen are shown. The screen is also referred to as the TAB area. Multiple TABs can be opened. Each opened TAB is shown at the top of the TAB area. Initially, the TAB area is blank.

The Editor Screen(s)

This is the edit and browse interactive screen.

The editor is primarily designed to do syntax check and edit Easytrieve Plus programs. However, you can use editor to browse and edit other text files such as COBOL, BAL, Macros etc.

The Help Documents Screen(s)

This screen lets you select documents to be searched for help.

The FTP connection interface

This is your FTP Client for communicating with the mainframe, including JES.

FTP Connection is needed to traffic files from and to z/OS.

A JES interface folder is created in the work folder for each unique FTP Connection. The JES Interface folders are named as #JesSpool(FTPSite_TSOUSER). These are readily seen at the top of the Tree.

File management feature

Manages files in your work folder including, copy, paste, delete, recovery and file archiving, etc.

Work Space Folder

A Work Space/Folder is needed on your local machine where all programs, macros, DCLGENs and JES Spool files are kept. This Work Space/Folder is created for you when you launch IBM Migration Utility Explorer for the first time. You can create multiple work folders as needed. Each new Work Folder is created with all the necessary components/sub-folders from the default WorkFolder located in the IMU Explorer supplied AppData folder.

One instance of IMU Explorer works with a single Work Folder. You can launch a separate IMU Explorer for each Work Folder in use.

A Default work folder contains directories of programs, files, macros, DCLGENs and JES Spool files.

You can create new files or download existing files located on z/OS system.

A work folder consists of:

1. One or more Local directories where local files are kept
2. One z/OS JES Spool directory for each FTP connection
3. RemoteLibs directory where z/OS PDS/PDSE libraries are kept
4. ~RunFolder (dialogs history and Temporary work files)
5. ~javalog.txt (IMU Explorer messages)
6. ~editor_debug.txt (IMU Explorer editor debug messages)
7. System-Error-Message.txt (System ABEND messages)

Each directory in the work folder may contain the following:

1. Temporary files internally used by IMU Explorer
• .templates - JCL template symbols
• .metafolder - file(s) encoding information
• ~tempPDS - PDS Member names used for comparing of PDS/PDSE to local Directory
• Work files and directories that start with ~
• Work files and directories that end with ~
2. An archive sub-directory used to house edited file changes

Easytrieve Plus macros and DCLGens interface

Manages Easytrieve Plus macros and DCLGens on yout local system.

There may be a need to download the Easytrieve Plus macros and DCLGENs for DB2. You can download the needed files before hand with FTP, otherwise the editor will prompt you to retrieve the required component when needed.

The default directory/folder for macros is "eztMacros" but you can create your own as needed.

The default directory/folder for DCLGENs is "DCLgens" but you can create your own as needed.

The default directory/folder for Easytrieve Plus programs is "eztPrograms" but you can create your own as needed.

The "rmuReports" and "drlReports" folders are reserved for each reporting system respectively.

Back to Contents

Installing IBM Migration Utility Explorer

To install IBM Migration Utility Explorer:

1. Make a new folder where to store the IBM Migration Utility Explorer file. Choose an easy to remember folder name.
2. Download the self extracting install file (IMU_Explorer_V2.1.exe) from the from the IBM Migration Utility Explorer home page: http://www.ibm.com/support/docview.wss?uid=swg24042661.
3. Double click on the download file to extract product components into the newly created folder.
4. Open the IBM Migration Utility Explorer folder that contains the extracted files.
5. If you are using 32 bit JAVA, double click on the Setup32.vbs file.
6. If you are using 64 bit JAVA, double click on the Setup64.vbs file.
7. Note: A shortcut is created to your desktop, a 64bit JAVA shortcut or a 32bit JAVA shortcut, depending on which one you chose.

Back to Contents

Getting Started with IBM Migration Utility Explorer

Once you have installed IBM Migration Utility Explorer, follow the steps below to get started.

On the Desktop, double-click the IMU_Explorer shortcut (or double click on the IMU_Explorer_32.jar or IMU_Explorer_64.jar file in the installed folder depending which Setup.vbs file you executed during installation).

You will be prompted with an option to review the ReadmeFirst document or Continue with the setup.
It is highly recommended that you carefully review the readme and follow the steps for setup and customization.
You can leave the ReadmeFirst file open and continue.

When you select Continue, the IBM Migration Utility Explorer splash screen will appear displaying copyright information.

You will be prompted to specify a Work Directory (workspace/folder) location for the IBM Migration Utility Explorer. We recommend the default workspace as shown in the dialog. If you select a workspace/folder that does not exist, one is created for you.

Depending on your installation you may be prompted to import select folders. Select the Help button (?) for more details.

The license will be displayed for your review and acceptance.

Next will be the IMU verification configuration prompting you for the IMU product library and an FTP connection to verify your IBM Migration Utility V4.1 or later installation.

With a successful verification you will see a message that GlobalJclSetSymbols.txt symbols file were created. The global symbols file template must be customized before use. See Important Notes below for more details.

The IBM Migration Utility Explorer Home Screen will appear with a tree on the left. The tree shows all available Directories in your work space.

• Observe the 'Main Menu' Tool Bar at the top. Right click on the item of interest to see the available choices.
• Observe the 'Directory Tree' on the left (click on '+' to expand the list of files contained in the directory).
• Observe 'JES Spool' Tree on the right. This is a general screen area for JES Interface and file browsing.
• Right Click on any file in the expanded Tree to see the available choices.

Note: All file names that will be sent to z/OS must be compatible with the z/OS PDS/PDSE naming conventions.

Continue to Important Notes for recommended next steps.

The file type in local directory(s) describes the type of file as follows:

___
COBOL Source

  .cob

___
Easytrieve Plus macros

  .cpy

___
SQL/DB2 DCLGEN files

  .dcl

___
IBM Migration Utility Drill Down reports

  .drl

___
Easytrieve Plus programs files

  .ezt

___
IBM Migration Utility Explorer express files

  .ezx

___
HTML Files

  .html or .htm

___
z/OS JCL files (can contain in stream Easytrieve Plus programs)

  .jcl

___
Standard z/OS reports (Legacy Reports) and JES Spool Files

  .lst

___
Assembler Macros

  .mac

___
PDF Document (Acrobat Reader documents)

  .pdf

___
IBM Report Modernization Utility reports

  .rmd

___
Standard text files (ASCII)

  .txt

___

For files with no extension, editor assumes the type based on the file content.

Important notes:

• You will be using IMU Explorer to run IMU, RMU and/or any other JOBs on z/OS. Now is a good time to customize the system dependent libraries that are specific to your z/OS system.


• There are global JCL //SET symbols in the /&installDir/UserProfiles/GlobalTemplates folder.
• The GlobalJclSetSymbols.txt file is the IMU Explorer default template. Do not Change it.
• A &sys_GlobalJclSetSymbols.txt file is created for each FTP connection you make. This is the file you need to customize.
• The symbols file provides the default values for your COBOL/IMU and RMU library names. Other symbols can be added, however.


• On the Home Screen, click on Tools -> Manage Global Set Symbols to open GlobalTemplates directory.
The GlobalTemplates directory will appear in the tree on the left of your Home Screen.
• Double Click on &sys_GlobalJclSetSymbols.txt node in the Mainshell Tree to invoke the editor.
• Make the required changes and exit the editor.


• Optionally, you can create a Demo system to experiment with.
• At the tool bar click File -> New Demo Directories to create new demo directories.
• To get started with the Demo, at the tool bar click Help -> Help Contents -> Demo_Readme.html

Back to Contents

Mainframe Interface Summary

You can do the following using the FTP connection:

1. Manage connections using profile names (z/OS system names.)
2. Transfer files to and from mainframe at folder (mass transfer) or file level.
3. Submit Jobs to run on z/OS from Mainshell Tree or the Editor Screen:
   1. Submit Jobs that contain standard JCL.
4. JES interface provides for:
   1. Viewing Jobs output in the JES Queue.
   2. Synchronizing Local JES Folder with the JES Queue.
   3. Purging Jobs from the JES Queue.
   4. Retrieving Jobs from the JES Queue.
5. Synchronize edited programs/files with remote system:
   1. Update PDS/PDSE with a specific file.
   2. On demand, update PDS/PDSE from the history log of edited files.
   3. At shut down, update PDS/PDSE from the history log of edited files.

Back to Contents

Updating IBM Migration Utility Explorer

1. Updates to the IBM Migration Utility Explorer will be placed on the IBM Migration Utility Explorer home page. New updates will replace the existing build.
2. The IBM Migration Utility Explorer update is configured to replace the entire product.

Back to Contents

Technical Support

IBM Migration Utility Explorer is available at no charge to all licensed users of the following z/OS product:

1. IBM Migration Utility (IMU) for z/OS V4.1, or later versions.

For technical support open a Service Request under IBM Migration Utility for z/OS and indicate IBM Migration Utility Explorer in the problem description.

IBM Migration Utility Explorer is supplied under the standard terms and conditions of the IBM International Program License Agreement (IPLA) and of the associated License Information and other documentation, and provides a defect correction for those licensed users entitled to service for the IMU for z/OS product listed above. IBM Migration Utility Explorer service is available as long as the IMU for z/OS product with which IBM Migration Utility Explorer is used is generally supported by IBM. In addition, IBM reserves the right to discontinue service on IBM Migration Utility Explorer.

Back to Contents

Glossary

This glossary lists the meaning of special symbols and terms used in IBM Migration Utility Explorer. These terms may or may not have the same meaning in other IBM or non-IBM systems and publications.
___
%home%.   Represents the directory where IBM Migration Utility Explorer is installed (Home Directory).
___
%work%.   Represents the IBM Migration Utility Explorer Work Space Folder.
___
Assembler Macro.   High Level Language file interpreted and executed by the Assembler at assembly time.
___
COBOL Source.   IBM Enterprise COBOL for z/OS.
___
Drill Down report.   HTML Document produced by IBM Migration Utility.
___
Dummy Stub.   An empty file in RemoteLibs PDS/PDSE that represents a member in a PDS/PDSE on z/OS.
___
Easytrieve Classic.   An interpretive Report generator product of CA Technologies.
___
Easytrieve Plus.   A compilable Report generator product of CA Technologies.
___
Easytrieve Plus macro.   File that contains Easytrieve Plus external definitions (%macros).
___
Explorer express.   Template for building Easytrieve Plus program from supplied macro arguments.
___
HTML Files.   Markup language used for making web pages.
___
IBM Migration Utility (IMU).   Easytrieve Plus language translator to COBOL. Converts Easytrieve Plus to COBOL.
___
IBM Report Modernization Utility (RMU).   Report Modernization Utility for z/OS. Converts legacy reports to html or csv files.
___
PDF Document.   Acrobat Reader document.
___
RemoteLibs.   Directory in the Work Folder reserved for mirroring PDS/PDSE libraries on z/OS.
___
SQL/DB2 DCLGEN.   File that contains SQL/DB2 table definitions.
___
z/OS JCL.   Job control language for running jobs on z/OS.
___
Work Folder.   A directory/folder on local system used by IBM IMU Explorer.
This folder is of special format specific to IBM IMU Explorer.
___
z/OS report.   Legacy Report produced on z/OS.
___

Back to Contents