Skip to main content

Copyright statement

© Copyright Transiom Software, Inc. 2015, 2020. 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, 2020. All rights reserved. For legal information, see http://www.ibm.com/legal/copytrade.shtml.


Using the Find command while browsing an HTML Document
   Use Ctrl-f to initiate the Find dialog.
   The Find dialog is opened on the Browser Screen.

Accessibility Compliance Information
   Government agencies, educational institutions as well as private companies have accessibility requirements for software purchased.
   In order to comply with accessibility standards, the software and content must be enabled for use by people with disabilities.

   IMU Explorer provides the use of keyboard only capability by employing the Operating Platform and the JAVA/SWT standards .
   Thus, people who cannot use the mouse or a pointing device can use keyboard only to interact with IMU Explorer.

   While we cannot map everything, the following hints should help:

  a) Menu Items:
     Use Alt key to get to the the 1st Menu Item then use the right and left arrow to navigate through the items. Depress Enter key to select an item. 
 
     Use Alt key to underscore the shortcut character for individual Menu Item. The underscored character is the short-cut character. 
     Example: Alt-f selects the File item if F is underscored on the File item.

  b) Tab Items:  
     Use Alt-RightArrow key to move control to the right tab.  
     Use Alt-LeftArrow key to move control to the left tab.  
     Use Ctrl-w key to close the tab item. 

  c) Standard Dialogs:  
     Use the Tab and Shift-Tab to navigate through the dialog text boxes or push buttons. Depress Enter key to process selection. 
 
     Use Alt-&char key to process individual Buttons. The underscored character is the short-cut character.  
     Example: Alt-c selects the Cancel button if C is underscored on the Cancel button.
 
     Use Alt-&char key to process individual Check Boxes. The underscored character is the short-cut character.  
     Example: Alt-u checks or un-checks the Upper box if U is underscored on the Upper button.
 
     Use Esc key to close/exit the dialog.  
 
  d) Key-Values Text Boxes:  
     Use the Tab and Shift-Tab to navigate through the text boxes on the Key-Values screen.  
 
  e) Scrollable Selection Dialogs:  
     Use the Tab and Shift-Tab to navigate through the check boxes in the scrollable area. Depress Space Bar key to select or un-select.  
 
     Use Alt-&char key to process individual Buttons. The underscored character is the short-cut character.  
     Example: Alt-c selects the Cancel button if C is underscored on the Cancel button.
 
     Use Alt-&char key to check or un-check individual Check Boxes outside of the scrollable area. The underscored character is the short-cut character.  
     Example: Alt-u checks or un-checks the Upper box if U is underscored on the Upper button.
  

Home Screen: Description
 The Home screen consists of four (4) parts:
 1. The Main Menu located at the top of the Screen.
 2. The Tool Bar located at the top below the Main Menu.
 3. A tree of opened directories on the left of the Home Screen. The Tree
    consists of directories found in the Work Folder opened at start-up time and the
    directories subsequently opened via the Home Screen File -> Open Directory selection.
 4. A general purpose screen on the right side of the Screen where Help documents, JES Tabs, Quick Search Trees
    and browsed files are shown. This screen is  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.

Home Screen: Main Menu
The Main Menu is located at the top of the screen.
Items on the main menu provide for the management of various resources supported by IMU Explorer.
Menu Items can be selected with a click of the mouse
          or
You can use Alt-&char to select a Main Menu item where &char is the underscored character of the Main Menu item name.

Home Screen: Toolbar Area
The Tool Bar  is located at the top of the screen below the Main Menu.
Buttons on the toolbar allow for easy navigation through IMU Explorer screens.
Place mouse over the button of interest to see the tool tip that describes the button.

Home Screen: Open a Local Directory (Ctrl+O)
On Home screen menu bar:
1. Select File
2. Select Open Directory

The Open Directory dialog will be presented. Select Local file system at the top of the dialog. 
 You can select a directory from the pull-down list, use the Browse
 button to select a directory or type in a directory of your choice,
 then select Open.

The selected directory will be shown in the Explorer Tree on the left side.
The child nodes for the selected directory will consist of files and Sub-directories.

Home Screen: Open a Remote PDS/PDSE on z/OS System (Ctrl+O)
On Home screen menu bar:
1. Select File
2. Select Open Directory

This request requires an FTP connection to z/OS. Select FTP Connect =>
Manage Connection (Ctrl-K) from the Home screen menu bar to connect
to z/OS first.  If you fail to do so, you will be prompted to establish
an FTP connection when you click on the Open button in Open Directory.

Open Directory dialog will be presented. Select Remote file system button.
You can select a PDS/PDSE from the pull-down list, use the Browse
button to select a PDS/PDSE or type in a PDS/PDSE of your choice.

For Wild Card choices, see the  WildCardPdsFilter document.

Home Screen: Open Multiple Local Directories (Ctrl+Shift+O)
On Home screen menu bar:
1. Select File
2. Select Open Multiple Directories

 Open Multiple Directories Dialog is presented.

 You can select a directory from the pull-down list, use the Browse
 button to select a directory or type in a directory of your choice.

 Click on Select or Cancel.

 A Directory Names Selection Dialog is presented of closed directories only.
 Check box next to directories you wish to open.

 Click on Finish or Cancel.

The selected directory will be opened in the Explorer Tree on the left side.
The child nodes for the selected directory will consist of will consist of files and Sub-directories.

Home Screen: Open Multiple Remote Libraries (Ctrl+Shift+O)
On Home screen menu bar:
1. Select File
2. Select Open Multiple Directories

 Open Multiple Directories Dialog is presented.

 Remote PDS/PDSE names are located in your  ...workFolder/RemoteLibs directory.
 PDS/PDSE libraries that reside on the local system are considered only.

 You can navigate to the RemoteLibs by clicking on Browse button, 
 or select it from the pull-down list if previously used.

 A Directory Names Selection Dialog is presented of closed directories only.

 Check box next to directories you wish to open.

 Click on Finish or Cancel.

The selected directory will be shown in the Explorer Tree on the left side.
The child nodes for the selected directory will consist of files only.

Sub-directories are NOT shown.

Home Screen: Open with Text Editor
On Home screen menu bar:
1. Select File
2. Select Open with Text Editor

You will be presented with a System Explorer file selection dialog.
1. Double mouse click on file you wish to edit
The text editor screen will be presented.

Caution:
        Use Text Editor to make appropriate changes. You can Undo and Redo changes while in edit mode by clicking on Edit button.
        The original copy of the edited file is not archived. The previous contents of the file cannot be recovered.

Home Screen Explorer Tree: Edit in Simple Text Editor
On Home screen Explorer Tree
1. Right click on a file node you wish to edit/browse
2. Select Edit in Simple Text Editor
The text editor screen is presented.

If you make changes, the original copy of the edited file is archived.
For how to view the edited file archive, click on View Archive.

Home Screen Explorer Tree: Edit in Hex
On Home screen Explorer Tree
1. Right click on a file node you wish to edit/browse
2. Select Edit in Hex
The hex editor screen is presented.

If you make changes, the original copy of the edited file is archived.
For how to view the edited file archive, click on View Archive.

Home Screen: Creating a New Directory (Ctrl+N)
On Home screen menu bar:
1. Select File
2. Select New Directory

You will be presented with a New Directory dialog. Enter a valid
directory name. The new directory will be created in the WorkFolder
and added to the Explorer Tree.

Home Screen: Creating Demo Directories (Ctrl+Shift+N)

Caution:

To create a demo system, you must first connect to z/OS System with FTP where you will be testing.

To do so, on the home Screen Tool Bar click: FTP Connect -> Manage Connections. 

A &sys_GlobalJclSetSymbols.txt file is created for each FTP connection you make. This file must be customized to your requirements.

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 the GlobalTemplates folder.

The GlobalTemplates directory will appear in the tree on the left of your screen.

To edit, double click on &sys_GlobalJclSetSymbols.txt node, or Right Mouse click -> System Open to use a System Editor. 

Make the required changes and exit the editor. 
      
Now you are ready to create the demo system.

On Home screen menu bar:
1. Select File
2. Select New Demo Directories

You will be presented with a Create Demo System dialog.

TSO User is 1-8 characters z/OS TSO User Id to be used with this Demo.

Demo Name is 1-8 characters DEMO Folders/Directories middle qualifier.
Example: DEMO creates &tsouser.DEMO.JCL, etc. 

You may change DEMO to a different name. 

The value you provide is used as the middle qualifier for the new DEMO directories. 

DEMO System consists of five (5) directories as follows:
   1. &tsoid.&demoname.DCLGEN
   2. &tsoid.&demoname.JCL
   3. &tsoid.&demoname.MACROS
   4. &tsoid.&demoname.PROCS
   5. &tsoid.&demoname.UTILITY

To use the DEMO system, the created directories must be sent to z/OS. First, you need to tailor and submit JGENDEMO.jcl to build PDS/PDSE libraries on z/OS. (Be careful, this job deletes, then creates new PDS/PDSE libraries on z/OS. Make sure duplicates do not exist.) Then send DEMO directories to z/OS: Ctrl -> left Mouse click on each directory node, then right Mouse click -> Update z/OS. or Select one directory at a time with: Left Mouse click -> right Mouse click -> Update z/OS.

For further steps, follow instructions in the &tsoid.&demoname.JCL(#readme0.txt) file.

Home Screen: Closing all opened directories (Ctrl+shift+W)
On Home screen menu bar:
1. Select File
2. Select Close All

Upon exit, you will be given a chance to save changes made to
programs opened for Edit.
Be careful, selecting no will discard all changes you made.

Home Screen: Refreshing the tree (Ctrl F5)
On Home screen menu bar:
1. Select File
2. Select Refresh Tree

This option resets tree selections and updates tree nodes with the most recent resources.

Home Screen: Reset Tree Selections (Ctrl+R)
On Home screen menu bar:
1. Select File
2. Select Reset Tree Selections

Tree selections are reset to one item.

Home Screen: Reset Tree Nodes Color (Ctrl+shift+R)
On Home screen menu bar:
1. Select File
2. Select Refresh Tree Nodes Color

The tree nodes foreground color is reset to default color.

Home Screen: Collapse all expanded Tree Nodes (Ctrl+C)
On Home screen menu bar:
1. Select File
2. Select Collapse Tree Nodes

All opened directory nodes in the tree are collapsed.

Home Screen: Expand all Tree Nodes (Ctrl+E)
On Home screen menu bar:
1. Select File
2. Select Expand Tree Nodes

All opened directory nodes in the tree are expanded to show sub-nodes.

Home Screen: Sort Tree Directory Nodes by Name
This action sorts the directory nodes only. Directory sub-nodes are left unchanged.
On Home screen menu bar:
1. Select File
2. Select Sort Directory Nodes by Name (A) or Sort Directory Nodes by Name(D)

Note:
(A) Sorts tree directory nodes by name in ascending sequence.
(D) Sorts tree directory nodes by name in descending sequence.

Tree directory nodes can be sorted when there are no programs opened for edit.

Home Screen: Sort Tree Directory Nodes by Date
This action sorts the directory nodes only. Directory sub-nodes are left unchanged.
On Home screen menu bar:
1. Select File
2. Select Sort Directory Nodes by Date (A) or Sort Directory Nodes by Date(D)

Note:
(A) Sorts tree directory nodes by date last changed in ascending sequence.
(D) Sorts tree directory nodes by date last changed in descending sequence.

Tree directory nodes can be sorted when there are no programs opened for edit.

Home Screen: Export/Copy Work Folder
On Home screen menu bar:
1. Select File
2. Select Export/Copy Work Folder

You will be presented with the Export/Copy Work Folder dialog.
(Click on Help Icon for more details)
3. Click on Export to complete the export.

Home Screen: Import/Merge JES Spool Folder
On Home screen menu bar:
1. Select File
2. Select Import/Merge JES Spool Folder

You will be presented with the Import/Merge JES Directories Dialog.
(Click on Help Icon for more details)
3. Click on Import or Cancel to complete the task.

Home Screen: Import/Merge User Profiles
On Home screen menu bar:
1. Select File
2. Select Import/Merge User Profiles

You will be presented with the Import/Merge User Profiles Dialog.
(Click on Help Icon for more details)
3. Click on Import or Cancel to complete the task.

Home Screen: Exit IBM Migration Utility Explorer (Ctrl+Q)
On Home screen menu bar:
1. Select File
2. Select Exit
      or
1. Click on X in the upper right corner of the Home screen.

Upon exit, you will be given a chance to save changes made to
programs opened for Edit.
Be careful, no will void all changes you made.

Home Screen: Recovering a deleted program (Ctrl+Z)
On Home screen menu bar:
1. Select Edit
2. Select Undo Delete
The latest deleted program on the delete stack will be restored.

Home Screen: Re-deleting restored program (Ctrl+Y)
On Home screen menu bar:
1. Select Edit
2. Select Redo Delete
The latest recovered program will be deleted.

Home Screen: Searching the Mainshell Tree
The quick search text box is opened by default at the left corner above the Mainshell tree.
You can use wild card(s) to locate the Mainshell tree items of interest. Strings are not
case sensitive.
For Wild Card choices, see the  WildCardFilter document.

Search highlights Mainshell tree items as you type.

Click on Enter button next to the Quick Search box or Enter key on the keyboard to create a
Quick Search Tree of located items in the Tab area.

Use x button next to the Quick Search box to collapse all nodes in the Mainshell tree to its original state.


Home Screen Explorer Tree: Change Default File Encoding on your Local System
Attention! This option is no longer available. Document kept for future implementation.
On Home screen menu bar:
1. Select Edit
2. Select Default Encoding (Local)

You will be presented with the Client System Encoding Selection Dialog.
Choose appropriate encoding from the drop down list. The selected encoding becomes the default encoding on your local system.

Switch updates the file encoding with the selected choice and closes the dialog.

 Cancel cancels the request closes the dialog and exists.

Home Screen: FTP Connection to z/OS
On Home screen menu bar:
1. Select FTP Connect
2. Select Manage Connection (Ctrl+k)

FTP Connection Dialog will be presented.

Click on question button at the bottom left corner of the screen for more details.

Home Screen: Viewing logs
View Log allows the user to view the IBM Migration Utility Explorer runtime messages log file.

The log file is available when messages_eclipse_off flag is set in the IMU Explorer root directory.
The IMU Explorer for non-Eclipse users is always set to messages_eclipse_off.

On Home screen menu bar or Sub-shell screen menu bar:
1. Select Logs
2. Select View Log
View Log allows the user to view the IBM Migration Utility Explorer runtime messages log file.

The log file name is ~javalog.txt. It is located in the work folder currently in use.

A new log file is created each time you bring up IMU Explorer. The prior log file copies are archived
into ~javalog_archive directory also located in the current work folder.

Several archived versions are kept.
The ~javalog.txt file name of each archived version ends with a number starting with
zero(0) to n, zero being the last archived copy and n is the Archiving Limit.
For archiving limit, refer to  Manage File Archiving Limit

Home Screen: Logs on/off
On Home screen menu bar or Sub-shell screen menu bar:
1. Select Logs
2. Select Turn Messages On or Turn Messages Off
Messages On activates the debugging messages logger.
Messages Off deactivates the debugging message logger.

Home Screen: System File Manager
On Home screen menu bar:
1. Select File
2. Select System Open

On Sub-shell screen (Editor Screen) menu bar:
1. Select Tools
2. Select System Open

On Explorer Tree:
1. Right click on node of interest:
2. Select System Open

System Open gives you access to resources using the operating system Explorer.

Home Screen: Manage File Archiving Limit
On Home screen menu bar:
1. Select Tools
2. Select Manage File Archiving Limit
Managing the file archiving limit gives users the freedom to choose the number of
back-ups they wish IBM Migration Utility Explorer to keep of changed files.

Home Screen: Manage Dialogs History Limit
On Home screen menu bar:
1. Select Tools
2. Select Manage Dialogs History Limit
The archiving limit is the number of items that IBM Migration Utility Explorer keeps in the
dialog history for the drop-down list selection.

Home Screen: Manage Log File Size Limit
On Home screen menu bar:
1. Select Tools
2. Select Manage Log File Size Limit
The limit is the number of messages that IBM Migration Utility Explorer keeps on the log file. 
Specify a number between 0 and 4096. 
Use the drop-down list selection for a quick selection.

Home Screen: Manage Archive Retain Option
On Home screen menu bar:
1. Select Tools
2. Select Manage Archive Retain Option

The Archive Retain Time number (minutes) is the number of minutes to keep the History Log available for 
Undo/Redo options selected from the Explorer Tree right click Drop Down list for the following selections: 
   1. Copy  -> Paste
   2. Cut   -> Paste
   3. Tools -> Rename Files
   4. Tools -> Import Files
   5  Tools -> Search and Replace

Select a number or select DeleteOnExit from the drop down list.

For example, 60 means that Undo/Redo will be available for 60 minutes.
The DeleteOnExit will delete the log upon orderly shut-down of IMU Explorer. 
Keep in mind that Undo/Redo are no longer available after the Archiving Log Retain files are deleted.  

Home Screen: Manage Tree Size Limits
This dialog provides the capability to set capacity limits for the IMU Explorer trees.
On Home screen menu bar:
1. Select Tools
2. Select Manage Tree Size Limits
3. Select a tree from the drop down list.

A limit can be set for the following trees: 
   1. Main File Tree
   2. JES File Tree
   3. File Selection Tree
   4. Results Tree
   5. Remote Time Stamp Compare Tree
   6. Document Tree 

Enter a number for upper limit. A value of zero implies the tree will have no upper limit.  

Home Screen: Manage Macro Exceptions list
The Macro Exceptions list provides a way of inhibiting the automatic macro retrieval attempt
by the syntax checker.

The IBM Migration Utility Explorer syntax checker detects macros embedded in the Easytrieve
Plus program source and internally expands them to collect fields defined in the macro definitions.
Macros are retrieved from a local directory as per Macro Search Directory list.

When a macro is not located in the macro search directory list, the IBM Migration Utility Explorer macros 
interface attempts to retrieve the not found macro from a Remote System. If the attempt to retrieve
the not found macro from the remote system fails for whatever reason, the not found macro can be
added to the Macro Exceptions List.

On Home screen menu bar or Sub-shell screen menu bar:
1. Select Tools
2. Select Manage Macro Exceptions
You will be presented with the Macro Exceptions Manager dialog.
Existing macros located in the Macro Exceptions history file are listed in the text area.
A selection box for each macro is located on the left side of each listed macro.

To add a new macro, type a new macro name in the New Item text box at the top of the dialog,
then click on the Add button. 

To delete macros from the macro exceptions list, check selection box for one or more macro names,
then click on the Remove button.

Click on Finish to commit changes to Macro Exceptions list and exit the dialog.

Click on Cancel to void all changes changes to MacroDExceptions list and exit the dialog.

Home Screen: Manage Macro Search Directories
The IBM Migration Utility Explorer syntax checker looks for Easytrieve Plus macro names in the
local directories listed in the Macro Search history file. The history file contains local directory
names to be searched.

Directories are searched in the same sequence as listed in the history file. You can add or remove
directory names from the list.

On Home screen menu bar or Sub-shell screen menu bar:
1. Select Tools
2. Select Manage Macros Search
You will be presented with the Macro Libraries Manager dialog.
Existing directories in the Macros Search history file are listed in the text area.
A selection box for each search directory is located on the left side of each listed directory.

To add a new search directory, type a new directory name in the New Item text box at the top of
the dialog, then click on the Add button. 

To delete directories from the search list, check selection box for one or more directory names,
then click on the Remove button.

Click on Finish to commit changes to Macro Directories Search list and exit the dialog.

Click on Cancel to void all changes changes to Macro Directories Search list and exit the dialog.

Home Screen: Manage Open Dialog History
IBM Migration Utility Explorer keeps track of directories that have been opened at some
point in the past. This dialog lets you remove unused directories from the Open Directories list.

On Home screen menu bar:
1. Select Tools
2. Select Manage Open Dialog History
You will be presented with the Open Directory History Manager dialog.
Existing directories in the history file are shown in the text area with
a check box on the left side of each directory shown on the screen.

To delete one or more directories, check the check box next to each directory,
then click on Remove button.

Click on Cancel to void all changes made the Open Directory list and exit the dialog.

Caution: Use this dialog to remove directory names from the Open Directory list that do not exist on your
local system due to rename or delete.

Home Screen: Manage Global Set Symbols
On Home screen menu bar:
1. Select Tools
2. Select Manage Global Set Symbols
The GlobalTemplates directory will be opened in the Explorer Tree on the left side showing
all history files in the directory. Right click on any file and select a function from the
pull-down menu.

Home Screen: View all history files
On Home screen menu bar:
1. Select Tools
2. Select View Dialogs History
The History directory will be opened in the Explorer Tree on the left side showing
all history files in the directory. Right click on any file and select a function from the
pull-down menu.

Home Screen: Sync z/OS with Pending Updates
IBM Migration Utility Explorer keeps track of remote files that have been changed by
editor on your local system but never sent to z/OS. This option lets you synchronize
local files with z/OS.

On Home screen menu bar:
1. Select Tools
2. Select Sync z/OS with Pending Updates
A selection screen will be presented of non-synchronized files.
You can check all files or select individual files to be synchronized.

Press on Send to send checked files or Keep for Later to keep files for later.

All sent files (checked) are removed from the z/OS Pending Updates history file.
Unsent (unchecked) files are retained in the z/OS Pending Updates history file for later use.

Note: To edit the list of pending updates click on  Manage Pending z/OS Updates.

To send files to z/OS, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can send files to z/OS.

Home Screen: View z/OS Pending Updates
On Home screen menu bar:
1. Select Tools
2. Select View z/OS Pending Updates

Home Screen: Change z/OS Pending Update Option
On Home screen menu bar:
1. Select Tools
2. Select Change z/OS Pending Update Option

Choose yes or no from the drop-down list.

 yes means that edited files that reside in the WorkSpace/RemoteLibs
directories are to be sent to z/OS automatically upon exit from the editor.

 no inhibits automatic synchronization.
selection

Home Screen: Manage Pending z/OS Updates
This option enables you to remove file names from the z/OS Pending Updates history file.
On Home screen menu bar:
1. Select Tools
2. Select Manage Pending z/OS Updates
A selection screen will be presented of files on your local system that have not been synchronized with z/OS.

Check box before the item you wish to remove from the z/OS Pending Updates history file.

Choose Remove or Cancel from the drop-down list.

Remove removes files from the Z/OS Pending Updates history file.

 Cancel cancels the dialog without any action.

 Caution: Remove file names with caution. The automatic tracking of pending updates will no longer be available for the removed file(s).

Home Screen: Set Tab Spaces
On Home screen menu bar:
1. Select Tools
2. Select Set Tab Spaces
The tab spaces is the number of spaces that IBM Migration Utility Explorer Editor uses for the tab character.

Specify a number between 1 and 12. 

Home Screen: Change Mainshell Tree right click option
On Home screen menu bar:
1. Select Tools
2. Select Change Mainshell Tree right click option
When you right click on a Mainshell Tree node, a list of options is presented in one of two ways:
a) List of widgets that are active for the tree node you clicked on.  
b) List of all widgets available for all nodes. In this case the inactive widgets are grayed out but are visible in the list.
 
The current option is described by the message shown in the dialog.
    
Select Yes or No to complete the change.

Home Screen: Change Editor Panel selection on exit
On Home screen menu bar:
1. Select Tools
2. Select Change Editor Panel selection on exit
When you exit an Editor screen (via F3 or Exit) IMU Explorer closes Editor Shell and steps down to previous screen as follows:

a) Last visited Editor screen prior to the current screen.
b) The Home (Mainshell tree) screen.

The current option is described by the message shown in the dialog.

Select Yes or No to complete the change. 

Home Screen: File Compare utility
On Home screen menu bar:
1. Select Tools
2. Select Compare Files
3. Select File Contents Compare

 The File Compare dialog will be presented. Select New and Old directories
 to compare. A wild card can be used for the file name. Select Compare
 to compare selected Directories/Files.

For Wild Card choices, see the  WildCardFilter document.

 Upon completion, you will be presented with the outcome. Use system tools
 to view the differences.

Home Screen: File Compare on Date Changed utility
On Home screen menu bar:
1. Select Tools
2. Select Compare Files
3. Select File Time Stamp Compare

 The File Compare dialog will be presented. Select New and Old directories
 to compare. A wild card can be used for the file name. Select Compare
 to compare selected Directories/Files.

For Wild Card choices, see the  WildCardFilter document.

 Upon completion, you will be presented with the outcome. Use system
 tools to view the differences.

Home Screen: View Last File Compare utility
On Home screen menu bar:
1. Select Tools
2. Select Compare Files
3. Select View Last File Compare

 This utility allows the user to view the last run file compare, without having
 to rerun the utility.

Home Screen and Explorer Tree: String Search utility
On Home screen menu bar (or on Explorer Tree right click on directory node):
1. Select Tools
2. Select Search
3. Select String Search to search for a new string

 The String Search dialog will be presented. Select the directory to search
 and enter the search string. Check Case sensitive and/or Hex Search if
 appropriate. Select Search.

 Upon completion, you will be presented with the outcome. Use system
 tools to view the findings.

Home Screen and Explorer Tree: View Last String Search
On Home screen menu bar (or on Explorer Tree right click on directory node):
1. Select Tools
2. Select Search
3. Select View Last String Search to search the outcome of the last String Search

 The result directory of the last String Search will be displayed if it exists.
 Use system tools to view the findings.

Home Screen and Explorer Tree: File Search utility
On Home screen menu bar (or on Explorer Tree right click on directory node):
1. Select Tools
2. Select Search
3. Select File Search to search for file names

 The File Search dialog will be presented. Select the directory to search
 and enter the search string. Check Case sensitive if appropriate.
 Select Search.

 Upon completion, you will be presented with the outcome. Use system
 tools to view the findings.

Home Screen and Explorer Tree: View Last File Search
On Home screen menu bar (or on Explorer Tree right click on directory node):
1. Select Tools
2. Select Search
3. Select View Last File Search to search the outcome of the last File Search.

 The result directory of the last File Search will be displayed if it exists.
 Use system tools to view the findings.

Home Screen and Explorer Tree: File Date Search utility
On Home screen menu bar (or on Explorer Tree right click on directory node):
1. Select Tools
2. Select Search
3. Select File Date Search to search for files with specific date last changed.

 The File Date Search dialog will be presented. Select the directory, Search File(s) wild card to search
 and enter the search date in ccyy-mm-dd format. current will use the current date.

For Wild Card choices, see the  WildCardFilter document.

 Select one relation operator to be used in comparison:
        EQ selects files with date of last update equal to the File Date Search.
        NE selects files with date of last update not equal to the File Date Search.
        GT selects files with date of last update greater than the File Date Search.
        GE selects files with date of last update greater or equal than the File Date Search.
        LT selects files with date of last update less than the File Date Search.
        LE selects files with date of last update less or equal than the File Date Search.

 Select Search.

 Upon completion, you will be presented with the outcome. Use system
 tools to view the findings.

Home Screen and Explorer Tree: View Last File Date Search
On Home screen menu bar (or on Explorer Tree right click on directory node):
1. Select Tools
2. Select Search
3. Select View Last File Date Search to search the outcome of the last File Search

 The result directory of the last File Date Search will be displayed if it exists.
 Use system tools to view the findings.

Home Screen: View Last RMU Report
On Home screen menu bar:
1. Select Tools
2. Select View z/OS Reports
3. Select View Last RMU Report

 The result directory of the last RMU Report will be displayed if it exists.
 Use system tools to view the findings.

Home Screen: View Last Drill Down Report
On Home screen menu bar:
1. Select Tools
2. Select View z/OS Reports
3. Select View Last Drill Down Report

 The result directory of the last Drill Down Report will be displayed if it exists.
 Use system tools to view the findings.

Home Screen: Synchronize Work Folder Archives
On Home screen menu bar:
1. Select Tools
2. Select Synchronize Work Folder Archives

 Archives in the WorkFolder directories are deleted for files that no longer exist
 in the Work Folder directories archive.
 Directory archives located in the work folder are analyzed only. Directories located
 outside of the work folder are not analyzed. 

 Caution! The deleted archive files cannot be restored. You will not get a second chance. 

Home Screen: Clear String Search
On Home screen menu bar:
1. Select Tools
2. Select Clear Temporary Space
3. Select Clear String Search

 Clears temporary space of the last string search outcome.

Home Screen: Clear File Search
On Home screen menu bar:
1. Select Tools
2. Select Clear Temporary Space
3. Select Clear File Search

 Clears temporary space of the last file search outcome.

Home Screen: Clear RMD Reports
On Home screen menu bar:
1. Select Tools
2. Select Clear Temporary Space
3. Select Clear RMD Reports

 Clears temporary space of the last viewed RMD Reports file.

Home Screen: Clear Drill Down Reports
On Home screen menu bar:
1. Select Tools
2. Select Clear Temporary Space
3. Select Clear Drill Down Reports

 Clears temporary space of the last viewed Drill Down Reports file.

Home Screen: Clear File Date Search
On Home screen menu bar:
1. Select Tools
2. Select Clear Temporary Space
3. Select Clear File Date Search

 Clears temporary space of the last viewed File Date Search file.

Home Screen: Clear all of the above
On Home screen menu bar:
1. Select Tools
2. Select Clear Temporary Space
3. Select Clear all of the above

 Clears temporary space of all last viewed strings, file searches, 
 viewed RMU Reports and Drill Down Reports files.

Home Screen: Switch: Focus on specific Home Screen region
The home screen is composed of three (3) distinct regions.
This option provides a short-cut to specific regions without tabbing.
The following regions are available:
1. Select Switch
2. Choose a region from the drop-down choices

    Ctrl-0 or Mainshell Tree to focus on the Mainshell Tree on the left
    Ctrl-1 or Quick Search to focus on Quick Search on the left
    Ctrl-2 or Tab Area to focus on the last Tab Region on the right
    Ctrl-3 or Tab Items to focus on a specific Tab Screen

Home Screen: Window: Focus on Home Screen or an Editor Screen
1. Select Window
2. Choose a window from the drop-down choices

Home Screen: Help Documents
On Home screen menu bar:
1. Select Help
2. Select Help Contents
The IBM Migration Utility Explorer Help Interface screen is presented.
The Documents directory will be opened in the Tree showing all available
documents. You can right click on any document file and select a function
from the pull-down menu, or you can double click on any document file to
open it in the default browser.

Home Screen: Search Internet (Ctrl+I)
On Home screen menu bar or Sub-shell screen menu bar:
1. Select Help
2. Select Search Internet
This selection runs user's system default browser.

Home Screen: Updates and News(Ctrl+U)
On Home screen menu bar or Sub-shell screen menu bar:
1. Select Help
2. Select Updates and News

Home Screen: About IBM Migration Utility Explorer
On Home screen menu bar or Sub-shell screen menu bar:
1. Select Help
2. Select About IBM Migration Utility Explorer

Home Screen: View Eclipse Foundation Software User Agreement
On Home screen menu bar:
1. Select Help
2. Select About IBM Migration Utility Explorer
3. Click on Eclipse Foundation Software User Agreement
The document will be opened with your default Browser. 

Home Screen: View License(English)
On Home screen menu bar:
1. Select Help
2. Select About IBM Migration Utility Explorer
3. Click on ILAN & LI license agreement (English)
The document will be opened with your default Browser.

Home Screen: View License in international Languages
On Home screen menu bar:
1. Select Help
2. Select About IBM Migration Utility Explorer
3. Select ILAN & LI license agreement (translated versions)
The IBM Migration Utility Explorer License screen is presented.
The Documents directory will be opened showing all available languages.
You can click on any document to view it.
The document will be opened with your default Browser.

Home Screen Explorer Tree: Browse file contents
On Home screen Explorer Tree
1. Right click on a file node
2. Select Browse
The file content is shown in the TAB area on the right side. Multiple
files can be opened as needed.

Home Screen Explorer Tree: Open JES Queue in TAB area on the right side
On Home screen Explorer Tree
1. Right click on a #JesSpool(&sys_&tsoid) tree node
2. Select JES Tab Open
All sub nodes in the MainShell tree are removed and JES Queue node is opened in the TAB area on the right side.
Note: The sub nodes are added back to the MainShell tree when you close the JES TAB item.

Home Screen Explorer Tree: Browse file via the Operating System default program
On Home screen Explorer Tree
1. Right click on a file node
2. Select System Open
The file is opened with the System Default program associated with the
file type. Files are opened in the TAB area or a separate shell,
depending on the file type. In general, .txt and .htm/html files are
opened in the TAB area. PDF files are opened in a separate shell.
Multiple files can be opened concurrently as needed.

Home Screen Explorer Tree: Editing files of type .ezt, .ezx, .txt and .jcl
1. Double click on a file node
      or
1. Right click on a file node
2. Select Edit
The Editor screen is opened in a separate shell.

Home Screen Explorer Tree: Create a New File of type .ezt, .ezx, .txt and .jcl
On Home screen Explorer Tree
1. Right click on a directory node
2. Select New File
A selection screen of available new file templates is presented.
Right click on template of interest then click Select to copy
the template.
Make sure that you rename the new file to a proper name.

Home Screen Explorer Tree: Submit Job to z/OS
On Home screen Explorer Tree
1. Right click on a file node
2. Select Submit Job
To send files to z/OS, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can send files to z/OS.

If your program does not contain JCL for compiling
you will be prompted to select a JCL file. The program
source and the JCL file will be automatically merged and
sent to the z/OS internal reader.

Important: Jobs with //NONAME JOB statement are submitted via the Submit Template option automatically.
For more information refer to: Submit Template selection option.

Home Screen Explorer Tree: Refresh local job list from JES Queue
This function is valid for #JesSpool folder only.
On Home screen Explorer Tree
1. Right click on a #JesSpool directory node
2. Select Refresh local job list from JES Queue

To receive spool list, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can receive files from z/OS.

The list of JES files on z/OS is received and placed in the @zOS_jes_queueu~.lst file.

The format of the list depends on the z/OS FTP Server Jesinterfacelevel option.
For Jesinterfacelevel=1, the list reflects only the files in the output/hold queue. 
The job completion code is not available.  
 
For Jesinterfacelevel=2, the list reflects the output/hold, active and input queues.
The job completion code is available.

The refreshed @zOS_jes_queueu~.lst file is opened in the Tab folder on the right side.

A Dummy JES file is created in the #JesSpool folder for each file in the list.
The existing Dummy JES files are replaced.

The existing Dummy JES files that do not exist on z/OS are removed from the local #JesSpool folder.   

The JES files that have been previously received and exist on z/OS are retained.

The JES files that have been previously received and do not exist on z/OS are retained.


Home Screen Explorer Tree: Refresh local job list and retrieve from JES Queue
This function is valid for #JesSpool folder only.
On Home screen Explorer Tree
1. Right click on a #JesSpool directory node
2. Select Refresh local job list and retrieve from JES Queue

Local job list of Jes jobs on remote system is refreshed and receive is initiated for every job not previously received.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before





Home Screen Explorer Tree: Synchronize with JES Queue
This function is valid for #JesSpool folder only.
On Home screen Explorer Tree
1. Right click on a #JesSpool directory node
2. Select Synchronize with JES Queue

To receive spool list, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can receive files from z/OS.

The list of JES files on z/OS is received and placed in the @zOS_jes_queueu~.lst file.

The format of the list depends on the z/OS FTP Server Jesinterfacelevel option.
For Jesinterfacelevel=1, the list reflects only the files in the output/hold queue. 
The job completion code is not available.  
 
For Jesinterfacelevel=2, the list reflects the output/hold, active and input queues.
The job completion code is available.

The refreshed @zOS_jes_queueu~.lst file is opened in the Tab folder on the right side.

A Dummy JES file is created in the #JesSpool folder for each file in the list.
The existing Dummy JES files are replaced.

The existing Dummy JES files that do not exist on z/OS are removed from the local #JesSpool folder.  

The JES files that have been previously received and exist on z/OS are retained unchanged.

The JES files that have been previously received and do not exist on z/OS are purged from the local #JesSpool folder.


Home Screen Explorer Tree: Retrieve from JES Queue  
This function is valid for job nodes in #JesSpool folder only (Dummy JES Job files or JES Job folders).
On Home screen Explorer Tree:
1. Expand a #JesSpool directory then right click on a Dummy JES Job file or a JES Job folder node.
2. Select Retrieve from JES Queue

A selection screen will be presented of all files within the selected job. You can select one or more files
or all files to receive.

The selected JES Job files will be received only.

For received JES Job multiple files are received as follows:
   a. When Jesinterfacelevel=1 is in use, files are numbered sequentially from 1 to n.   
   b. When Jesinterfacelevel=2 is in use, files are numbered sequentially from 1 to n with DDname appended to the file name.


Home Screen Explorer Tree: Purge from JES Queue   
This function is valid for #JesSpool folder and JES jobs within the folder.
On Home screen Explorer Tree
1. Right click on a #JesSpool directory or a JES job node.
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple jobs.
2. Select Purge from JES Queue

If you clicked on #JesSpool directory, all output JES files on z/OS will be purged.

If you clicked on a JES Job, only the selected job on z/OS will be purged. 

The Dummy JES files are removed from the local #JesSpool folder.

The JES files that have been previously received are retained in the local #JesSpool folder.



Home Screen Explorer Tree: Synchronize a file with z/OS
This function is available for programs located in a local directory that
was created from a PDS/PDSE.
On Home screen Explorer Tree
1. Right click on a file node
2. Select Update z/OS
To send files to z/OS, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can send files to z/OS.

Home Screen Explorer Tree: Receive files from z/OS
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Receive from z/OS

Related   Receive and Send Activity Logs document.

To receive files from z/OS, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with the FTP
Connect dialog. FTP must be connected to z/OS before sending files to z/OS.

You will be prompted with the Receive dialog to select the PDS/PDSE and
the file name to receive from z/OS.

Check Default, Binary or Text box at the bottom of the dialog to receive files in respective code format.

Default is the Codeset chosen on FTP Connection Dialog.
Binary transfers files in binary mode (bytes are transmitted as 8 bits without conversion).
Text transfers files in ASCII text mode (bytes are converted to ASCII before transmission.)

PDS name is a z/OS Partitioned Data Set that contains file(s) to be retrieved.

In the Receive dialog, the Browse button next to PDS name text box allows you to browse
for PDS/PDSE names on the remote system.  If a PDS/PDSE list exists, you will be
asked if you wish to refresh the list or create a new one.

Selecting yes prompts you with the Remote PDS/PDSE Wild Card dialog to specify the wild
card for generating a new list. On this dialog, Select Search to create a list of PDS/PDSE libraries on z/OS.

For Wild Card choices, see the  WildCardPdsFilter document.

Caution: The PDS/PDSE name can be a maximum of 44 characters long.
The file name can be a maximum 8 characters long.
Partial qualifiers are not accepted. You must specify the leading qualifiers names in full.
For example: TSOUSER1.COBOL.*

File name is the file name to be retrieved.

If you select Receive for a program node, the file name will be automatically selected for you.

If you select Receive for a directory node, you can receive a single file or multiple files using a wild card
from the drop-down list, or you can specify a wild card of your own.

For Wild Card choices, see the  WildCardFilter document.

Wild Card *.&type* for file name in combination with a PDS/PDSE name can be used when clicked Receive from z/OS 
on directory node. Use the drop-down list to select the wild card of interest.
For example, when *.* is selected, all file names in local directory would be received and replaced by the copy
on z/OS if they exist.
   
When clicked Receive from z/OS on directory node, you can receive a new file by specifying a &progname.&type 
file name in combination with a PDS/PDSE name. Use the drop-down list items that start with .&type to select the file type or
provide it as part of your file name.

Note: you may have to scroll the drop-down list to see the available types.
   
Wild Card <dummies> for file name can be used when clicked on Receive from z/OS on directory constructed from a PDS/PDSE. 
In this case, all Dummy Stubs in the local directory will be replaced by the files from z/OS. Previously retrieved files 
are preserved.

The Browse button next to File Name box allows you to browse for file names in the selected PDS/PDSE.  
If a file names list exists, you will be asked if you wish to refresh the list or not.  Selecting no loads
the existing list.  Selecting yes retrieves the PDS/PDSE directory from z/OS. 

Home Screen Explorer Tree: Transfer file(s) to z/OS
On Home screen Explorer Tree
1. Right click on a file node
2. Select Send to z/OS

Related   Receive and Send Activity Logs document.

To send files to z/OS, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can send files to z/OS.

You will be prompted with the Send dialog to input the PDS/PDSE and
the file name where to place the file on z/OS.

Caution 1: Files can be transferred to a PDS/PDSE library or a sequential file (DSN). if the specified
PDS/PDSE/DSN does not on exist on z/OS, a sequential file (DSN) is created.
The local file is then transferred into the newly created DSN.
 
Caution 2: The PDS/PDSE name can be a maximum of 44 characters long.
The file name can be a maximum 8 characters long.

Home Screen Explorer Tree: Refreshing a file in a local directory using a copy from z/OS
On Home screen Explorer Tree
1. Right click on a file node
2. Select Refresh from z/OS

To receive files, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can receive files from z/OS.

You will be prompted with the Receive File dialog.
Make sure that you select the correct PDS/PDSE name that contains
the file you wish to receive.

Home Screen Explorer Tree: Renaming a file
On Home screen Explorer Tree
1. Right click on a file node
2. Select Rename
The Rename/Paste dialog is opened. Provide a valid new file name then
Select Create.

Home Screen Explorer Tree: Rename (remove spaces from file name)
On Home screen Explorer Tree
1. Right click on a file node
2. Select Rename (remove spaces)
The target file is renamed, i.e., spaces in file name are replaced with '_'.

Note: This option is presented only when file name contains spaces.

Home Screen Explorer Tree: Renaming multiple Files in a Directory
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select Rename Files

Rename Selection dialog is presented.

The Browse button next to Directory Name box, if it exists, allows you to browse for directories on your PC.
If the Browse button next to Directory Name box does not exist exist, the supplied directory is used.
The directory name cannot be changed when the text box is displayed in gray.   

Use Select File(s) box to select one or more files of interest. File names are not 
case sensitive. The wild card choices are in the drop-down list.

For Wild Card choices, see the  WildCardFilter document.

Use Rename To box to select the new name pattern. File names are not 
case sensitive. The wild card choices are in the drop-down list.

Wild Card choices are:  *&name, &name*, *.&type  and &type.

The Accept button accepts your entries and presents a list of files for further filtering.

The Cancel button exists without any action.

Be careful, renaming using wild card may impact multiple files.

For life cycle of Undo Rename and Redo Rename capabilities, see the  Manage Archive Retain Option document.

Home Screen Explorer Tree: Undo Rename
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select Undo Rename
 
Undo Rename is available after Rename Files is processed. A File Selection dialog is presented.
The selected files are renamed in the current directory back to the original name.

Important note:
The original files replaced by the Rename (if any) are restored into the current directory from the Directory Archive.

For life cycle of Undo Rename and Redo Rename capabilities, see the  Manage Archive Retain Option document.

Home Screen Explorer Tree: Redo Rename
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select Redo Rename

A File Selection dialog is presented.

The Redo Rename reverses the Undo Rename action.

Everything else is according to the Rename rules.

For life cycle of Undo Rename and Redo Rename capabilities, see the  Manage Archive Retain Option document.

Home Screen Explorer Tree: Import Files
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select Import Files
 
This dialog enables you to import one or more files from a directory of your choice.
 
The From Directory may be a directory opened in the Manshell Tree or an external directory (not in the Mainshell Tree).
  
The selected file(s) in the From Directory are imported using the copy and paste rules. 
 
Specify File Name to import a specific file from the From Directory. Use *.* in the file name to import multiple files. 
  
When the file name is wild card *.*, you will be prompted with a selection dialog of all files in the From Directory.
The sub-directories cannot be imported. 
 
To undo the import, right click on the To Directory node and select Undo Paste. You can utilize the Redo Paste to re-apply the import.
 
From Directory: 
This text box provides the full path of the directory from which to import files. You can use Browse button to choose a directory of interest.
   
File Name: 
You can type a file name that exists in From Directory, or you can use the Select File to choose a file of interest. 
Use *.* in the file name to to display a dialog that lets you import multiple files. 

Home Screen Explorer Tree: Search and Replace 
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
2. Select Search And Replace

Search And Replace Dialog is presented.

The Browse button next to Search Directory box, if it exists, allows you to browse for directories on your PC.
If the Browse button next to Search Directory box does not exist exist, the supplied directory is used.
The directory name cannot be changed when the text box is displayed in gray.   

Use Select File(s) box to select one or more files of interest. File names are not 
case sensitive. The wild card choices are in the drop-down list.

Use Search String box to provide the search string. 
The drop-down list contains history of strings used in the past.
When Hex search button is checked, the string must contain a valid hex string (characters 0-f).

Use Replace With box to provide the replace string. 
The drop-down list contains history of strings used in the past.
When Hex replace button is checked, the string must contain a valid hex string (characters 0-f).

Check Case Sensitive button to make search characters case sensitive. 
Un-check Case Sensitive button to make search case insensitive. 

The Search and Replace button accepts your entries and presents a list of files for further filtering.

The Cancel button exists without any action.

Be careful, doing Search and Replace using wild card may impact multiple files.

For replacement rules, refer to  Special File Types and String Replacement Rules sections.
 
For life cycle of Undo Search and Replace and Redo Search and Replace capabilities, see the  Manage Archive Retain Option document.

Home Screen Explorer Tree: Undo Search and Replace
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select Undo Search and Replace
 
Undo Search and Replace is available after a Search and Replace is processed. A File Selection dialog is presented.
The selected files are restored to their previous state.

For life cycle of Undo Search and Replace and Redo Search and Replace capabilities, see the  Manage Archive Retain Option document.

Home Screen Explorer Tree: Redo Search and Replace
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select Redo Search and Replace

A File Selection dialog is presented.

The Redo Search and Replace does a new Search and Replace on files reversed by Undo Search and Replace action.

Everything else is according to the Search and Replace rules.

For life cycle of Undo Search and Replace and Redo Search and Replace capabilities, see the  Manage Archive Retain Option document.

Home Screen Explorer Tree: View Search and Replace Log
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools
3. Select View Search and Replace Log

The log file of last Search and Replace results is displayed (if any).

Only one copy of Search and Replace Log is available. Previous Search and Replace logs are not retained.

Home Screen Explorer Tree: Recovering/restoring edited file
IBM Migration Utility Explorer saves the original copy of the file being edited to an archive
directory before changes are made. Several archived versions are kept.
The file name of each archived version ends with a number starting with
zero(0) to n, zero being the recent version before the change.

On Home screen Explorer Tree
1. Right click on a file node
2. Select Restore
The Selection Interface screen is presented with an archive directory tree
that contains the archived versions. Right click on the file version you
wish to restore, then click on Select.

Home Screen Explorer Tree: Refactor JCL Data
Related item: Combine refactored Data

The editor supports syntax checking of one Easytrieve Plus program per editor session. JOBs/JCL with multiple steps that
contain in-stream Easytrieve Plus programs must be re-factored such that each in-stream file/program can be edited separately.
Only files of type .jcl can be re-factored.  When a .jcl file is re-factored, a new directory is created in the same directory
where the JCL file is located. The directory name is composed of the word refactored_ + the file name without the type (.jcl).
For example, re-factoring testjob1.jcl would create a directory named refactored_testjob1

On Home screen Explorer Tree
1. Right click on a file node
2. Select Refactor -> Refactor JCL Data

The original  file is removed from the original directory and the directory tree node.
The newly created directory is populated by the original JCL and the extracted data files if any.  A ++INCLUDE DATAnnnn statement
is placed in the original JCL in the place of the removed data. The extracted data file names are sequenced from 0 - n.
The newly created directory is added to the tree. The focus is set on the newly created directory node.
Re-factoring a JCL file without in-stream data does not produce any data files. The JCL file in the refactored directory is equivalent to the original file.
Once re-factored, you can edit the extracted files as time permits.

When you Submit an extracted file from the Mainshell tree, all extracted files are merged with the JCL and the entire job is submitted. The data files are placed back in
 the JCL in the place of their ++INCLUDE statements.

When you Submit a re-factored file from the editor screen, the extracted files are not merged with the JCL.  This gives a flexibility to test individual programs independent of the original steps.

Home Screen Explorer Tree: Combine refactored JCL
Related item: Refactor JCL Data

On Home screen Explorer Tree
1. Right click on a refactored_&directory node
2. Select Refactor -> Combine refactored JCL

All extracted files in the re-factored directory are merged with the JCL
and the newly created file is placed back in the original directory node where it was located
before re-factoring. 
The re-factored directory is removed from the tree node and deleted from the hard media (hard disk).
The original copy is archived if changes were made to any files in the re-factored directory.

 Home Screen Explorer Tree: Refactor File Extension
When you open a PDS/PDSE to work with using the Open Dialog, the open retrieves the PDS/PDSE directory
and creates a local directory of files located in the PDS/PDSE. The created files in the local directory are Dummy stubs
and have no file extension assigned to them.  When you edit a dummy stub with the IMU Explorer editor, the actual content of
the file is down loaded from the PDS/PDSE library. At this point, the down load file still does not have a file type
assigned to it. The same is true if you receive files from z/OS but do not check the Auto Extension option on the
"Receive Files from Remote System Dialog.
The Refactor File Extension option lets you assign a file type based on file content automatically.
When you chose a directory node, the file types are assigned automatically to all file names without extension.
When you choose a file name, the file type is assigned automatically to the selected file if the file does not have a
file type assigned to it.

On Home screen Explorer Tree
1. Right click on a directory node or a program node
2. Select Refactor -> Refactor File Extension

 Home Screen Explorer Tree: Undo refactored Extension

On Home screen Explorer Tree
1. Right click on a directory node or a program node
2. Select Refactor -> Undo refactored File Extension

The previously refactored file extensions are reversed.

Home Screen Explorer Tree: Comparing two files or directories
On Home screen Explorer Tree
1. Right click on the directory or the file node you wish to compare
2. Select Tools-> Compare to
The Compare dialog is presented. Your New Directory and the New File are derived from the node you clicked on.
When a directory node is selected, enter an Old Directory then Select Compare.
When a file node is selected, enter an Old Directory and an Old File, then Select Compare.
Use the Browse button next to the Old Directory box to choose from the available directories.
Use the Browse button next to the Old File box to choose a file to compare to.

Home Screen Explorer Tree: Comparing to PDS Member(s)
This request provides the ability to compare files in your local directory to the files/members
in a remote PDS/PDSE. 

On Home screen Explorer Tree
1. Right click on the directory or the file node you wish to compare
2. Select Tools-> Compare to PDS Member(s)
The Receive from PDS for file Compare dialog is presented.

To receive files, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can receive files from z/OS.

Make sure that you select the correct PDS/PDSE name that contains
the file(s)/member(s) you wish to compare.
3. Click on Receive
If you are comparing to a PDS/PDSE, a selection dialog of PDS/PDSE members is presented.
Make your selection, then click on Finish

The remote files(s)/member(s) are downloaded into ~tempPDS temporary directory in your local folder.

The Compare dialog is presented.
4. Click on Compare to complete the compare.

Caution: The ~tempPDS directory should not be used for production work as it is deleted or modified whenever
you do a new compare.

Home Screen Explorer Tree: Comparing to PDS Members Time Stamp
This request provides the ability to compare the time stamp of files in your local directory to
the files/members time stamp in a remote PDS/PDSE. 

On Home screen Explorer Tree
1. Right click on the directory or the file node you wish to compare
2. Select Tools-> Compare to PDS Members Time Stamp
The Select PDS for Multiple Remote Files Time Stamp Compare dialog is presented.

To receive time stamps from the remote PDS/PDSE, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can receive files from z/OS.

Make sure that you select the correct PDS/PDSE name that contains
the file(s)/member(s) you wish to compare.
3. Click on Select
A selection dialog of PDS/PDSE members is presented.
Make your selection, then click on Finish

A time stamp comparison tree is opened in the tab area with the local and remote time stamp.

The unequal time stamps are shown in magenta color. The  equal time stamps are shown in black.

Caution: Be careful with the time locality. Time stamp may not be quaul due to FTP transfers as FTP
may be using the GMT/UTC time when updating the time stamp of PDS members on z/OS.

Caution: The locality of the time stamp on your local system may be different from the locality of z/OS.
The only time when the time stamp will be equal is if you never changed the downloaded file.

Home Screen Explorer Tree: List Remote Data Set Names (DSN)
On Home screen Explorer Tree
1. Right click on directory node where you want to save your DSN List
2. Select Tools-> List Remote Data Set Names (DSN)
The "Receive DSN List from z/OS" dialog will be presented.
On the dialog, click on question symbol for further details.

Home Screen Explorer Tree: List Remote PDS/PDSE Members
On Home screen Explorer Tree
1. Right click on directory node where you want to save your PDS/PDSE members List
2. Select Tools-> List Remote PDS/PDSE Members
The "Receive PDS/PDSE Members List from z/OS" dialog will be presented.
On the dialog, click on question symbol for further details.

Home Screen Explorer Tree: Sort file content
On Home screen Explorer Tree
1. Right click on a file node you wish to sort
2. Select Tools-> Sort File Text
The Sort screen is presented. Click on the question mark to learn more about the Sort feature.

Home Screen Explorer Tree: Expand Print Control Characters
(This selection is valid for files of type .lst only)
On Home screen Explorer Tree
1. Right click on a file node you wish to expand
2. Select Tools-> Expand Print CC

A copy of the file with expanded control characters is created in the directory of the original file.
The created file name ends with ~.lst.

Home Screen Explorer Tree: EBCDIC to ASCII
(This selection is valid for files only)
On Home screen Explorer Tree
1. Right click on a file node you wish to convert
2. Select Tools-> EBCDIC to ASCII
The New File dialog is presented. Choose a new file name and the record length.

This feature is for converting z/OS files that had been downloaded in binary mode.

Caution:
      Bytes that do not map to any ASCII characters may be corrupted. Proceed with caution. 


Home Screen Explorer Tree: ASCII to EBCDIC
(This selection is valid for files only)
On Home screen Explorer Tree
1. Right click on a file node you wish to convert
2. Select Tools-> ASCII to EBCDIC
The New File dialog is presented. Choose a new file name and the record length.

This feature is for converting ASCII files to z/OS files for uploading binary mode.

Caution:
      Bytes that do not map to any EBCDIC characters may be corrupted. Proceed with caution. 


Home Screen Explorer Tree: Trim White Spaces
(This selection is valid for files only)
On Home screen Explorer Tree
1. Right click on a file node you wish to expand
2. Select Tools-> Trim White Spaces
The dialog gives you a choice of: Trim Leading, Trim Trailing and Trim All.

Trim Leading removes all leading white spaces on each line.
Trim Trailing removes all trailing white spaces on each line.
Trim All removes leading and trailing white spaces on each line.


Home Screen Explorer Tree: Carve a New File
(This selection is valid for files only)
On Home screen Explorer Tree
1. Right click on a file node you wish to expand
2. Select Tools-> Carve a New File
Click on question icon to learn more details.

Home Screen Explorer Tree: Synchronize Encoding
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Tools-> Synchronize Encoding
The .metafolder that contains file encoding is synchronized with the files in the folder.
The encoding registry is removed from .metafolder for all files that no longer exist in the folder.
The removed encoding registry cannot be recovered. Please proceed with caution.

Home Screen Explorer Tree: Change file Encoding

Individual file encoding on your Local System can be changed from three (3) places:

1. While in Edit mode
    Click on Edit on the Tooolbar
    Select Switch Encoding

2. While in Browse mode due to Browse selection
    Right click on  the Browse Screen
    Select Switch Encoding

3. On Home screen Explorer Tree
    Right click on a file node
    Select Tools-> Change Encoding

You will be presented with the Client Sytem Encoding Selection Dialog.
Choose appropriate encoding from the drop down list.

Switch updates the file encoding with the selected choice and closes the dialog.

 Cancel cancels the request closes the dialog and exists.

Note: To use default encoding, select Default from the drop down list.

Default encoding is the encoding of your local system. The local default encoding can be changed
from the Home screen menu bar by selecting: Edit -> Default Encoding (Local).


Home Screen Explorer Tree: Synchronize Archive
On Home screen Explorer Tree
1. Right click on a directory node
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple directories.
2. Select Tools-> Synchronize Archive
The archive folder contains archive copies of files changed by the editor.
The archive is removed for all files that no longer exist in the folder.

The removed arhive cannot be recovered. Please proceed with caution.

Home Screen Explorer Tree: View Archive
On Home screen Explorer Tree
1. Right click on a directory or a file node
2. Select Tools-> View Archive
The archive directory for the node is opened by the System Explore.
The alternative is to click on the System Open item to do the same thing.

Home Screen Explorer Tree: Transferring a files from one directory to another
On Home screen Explorer Tree
1. Right click on a directory node or a file node you wish to transfer
2. Select Cut
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple files.
Position mouse on the directory you wish to receive the file then:
1. Right click on the directory node
2. Select Paste

When you Cut from a directory, a File Selection dialog is presented.
You can use wild card(s) to paste files of interest. File names are not 
case sensitive.
The selected files are removed from the source directory.

For Wild Card choices, see the  WildCardFilter document.
ctrl

Home Screen Explorer Tree: Copy one or more files
On Home screen Explorer Tree or System Explorer Window
1. Right click on a directory node or a file node you wish to copy
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple files.
2. Select Copy
Position mouse on a directory in Explorer Tree you wish to receive the file then:
1. Right click on the directory node
2. Select Paste

When you Copy from a directory, a File Selection dialog is presented.
You can use wild card(s) to paste files of interest. File names are not 
case sensitive.

The selected files are copied from the source directory.

For Wild Card choices, see the  WildCardFilter document.

Home Screen Explorer Tree: Copy file name
On Home screen Explorer Tree
1. Right click on a file node you wish to copy
2. Select Copy name-> Copy Name
Position mouse on the target text area in the Editor screen or any opened
document/file.
1. Right click
2. Select on Paste

Home Screen Explorer Tree: Copy Node path (path relative to the work folder)
On Home screen Explorer Tree
1. Right click on a file node you wish to copy
2. Select Copy name-> Copy Node Path
Position mouse on the target text area in the Editor screen or any opened
document/file.
1. Right click
2. Select Paste

Home Screen Explorer Tree: Copy Full path (full file path)
On Home screen Explorer Tree
1. Right click on a file node you wish to copy
2. Select Copy name-> Copy Full Path
Position mouse on the target text area in the Editor screen or any opened
document/file.
1. Right click
2. Select Paste

Home Screen Explorer Tree: Copy Remote Path (PDS/PDSE name)
This option is available on directories built from a remote PDS/PDSE.
On Home screen Explorer Tree
1. Right click on a file node you wish to copy
2. Select Copy name-> Copy Remote Path
Position mouse on the target text area in the Editor screen or any opened
document/file.
1. Right click
2. Select Paste

Home Screen Explorer Tree: Copy Directory List
This option is available on directory nodes only
On Home screen Explorer Tree
1. Right click on a directory node you wish to copy
2. Select Copy name-> Copy Directory List
Position mouse on the target text area in the Editor screen or any opened
document/file.
1. Right click
2. Select Paste

Home Screen Explorer Tree: Deleting a file
On Home screen Explorer Tree
1. Right click on a file node you wish to delete
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple files.
2. Select Delete
The Delete program confirm dialog is presented.
Select Confirm Delete

To recover deleted file:
On Home screen menu bar:
1. Select Edit
2. Select Undo Delete

Home Screen Explorer Tree: Close a directory in the Home screen Explorer Tree
On Home screen Explorer Tree
1. Right click on the directory you wish to close
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple directories.
2. Select Close Directory
Directory will be removed from the Explorer Tree.

Home Screen Explorer Tree: Show Directory 1st Level nodes in the Home screen Explorer Tree
On Home screen Explorer Tree
1. Right click on the directory node you wish to show
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple directories.
2. Select Show 1st Level Nodes
The 1st Level nodes within the selected Directory node will be shown.

Home Screen Explorer Tree: Expand Directory 1st Level nodes in the Home screen Explorer Tree
On Home screen Explorer Tree
1. Right click on the directory node you wish to expand
Note: Alternatively, you can do Ctrl -> Mouse Click to select multiple directories.
2. Select Expand 1st Level Nodes
The sub directory nodes within the selected Directory node will be expanded.

Home Screen Explorer Tree: Paste
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Paste

When you do Paste due to Copy from a directory, a File Selection dialog is presented.
You can use wild card(s) to copy and paste files of interest. File names are not 
case sensitive.
The selected files are copied from the source directory.

When you do Paste due to Copy on a file node, the selected file is copied from the source directory.

When you do Paste due to Cut from a directory, a File Selection dialog is presented.
You can use wild card(s) to cut and paste files of interest. File names are not 
case sensitive.
The selected files are copied and then deleted from the source directory.

When you do Paste due to Cut on a file node, the selected file is copied and then deleted from the source directory.

For Wild Card choices, see the  WildCardFilter document.

Home Screen Explorer Tree: Undo Paste
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Undo Paste

When you do Undo Paste due to Copy from a directory, a File Selection dialog is presented.
The selected files are removed from the current directory.

When you do Undo Paste due to Copy a file, the selected file is removed from the current directory.

When you do Undo Paste due to Cut from a directory, a File Selection dialog is presented.
The selected files are copied back to its original directory and removed from the current directory.

When you do Undo Paste due to Cut a file, the selected file is copied to its original director and removed
from the current directory.
 
Important note:
The original files replaced by the Paste (if any) are restored into the current directory from the Directory Archive.

Home Screen Explorer Tree: Redo Paste
On Home screen Explorer Tree
1. Right click on a directory node
2. Select Redo Paste

The Redo Paste reverses the Undo Paste action.
A File Selection dialog is presented if Redo Paste is due to Copy/Cut from a directory.
Action is completed according to the Paste rules.


Home Screen Explorer Tree: Sort directory in the Home screen Explorer Tree
On Home screen Explorer Tree
1. Right click on the directory you wish to sort
2. Click on Sort Directory:
3. Click on a sort option:
   Sort by Name (A) - sorts by file name in ascending sequence
   Sort by Name (D) - sorts by file name in descending sequence
   Sort by Date (A) - sorts by date changed in ascending sequence
   Sort by Date (D) - sorts by date changed in descending sequence
   Sort by Type (A) - sorts by file type in ascending sequence
   Sort by Type (D) - sorts by file type in descending sequence
   Sort by Size (A) - sorts by file size in ascending sequence
   Sort by Size (D) - sorts by file size in descending sequence

Home Screen Explorer Tree: Display file properties
On Home screen Explorer Tree
1. Right click on a file node
2. Select Properties

Editor: Sub-shell screen description
The Sub-shell screen consists of four(6) parts:
1. The Main Menu located at the top of the Screen.
2. The Tool Bar located at the top below the Main Menu.
3. On the left side, there is a Tree of Program Sections.
Click on the + sign to expand each Tree node to view child nodes.
Double click on the most minor child node to view properties for
the item. The properties are shown in the middle of the screen.
Note that shown properties are for informational purposes only.
You cannot make any changes to the TAB that opens due to a double
click.

4. The editor is opened in the middle of the screen (TAB). This is
where you create or make changes to your program. The editor screen
is similar to the z/OS ISPF screen.

The editor screen consists of:
a. The MESSAGE line at the top
b. The main COMMAND line at the top
c. The line numbers on the left
d. The line attribute to the left of each line number.
   RR means line is in read only mode
   RW means line is in read-write mode.
e. Error indicator is to the left of the line attribute.
   E means there is one or more errors on this line.
    You can click on E to view the error. Select Help
    below the error message to get help. Select Close to close
    the error message.
    You can enter commands on the COMMAND line and sub-commands on the
    line number.
         COMMAND Line:
         Line Commands:

5. The default values for opened child nodes are shown on the right side
of the screen. The default values may or may not be available,
depending on the item type. The values are informational.

6. At the bottom below the middle (Editor screen) are error messages.
These error messages are generated by the Syntax Checker when
Ctrl-T is pressed or during the automatic syntax check request.
The line number is the line in the program source that caused the
error. See #2.e above on how to view line errors.

Note: The Syntax Checker checks for Easytrieve Plus macros and DCLGENs embedded in the
program.  If they are not found, the user is prompted to retrieve missing
macros. The RemoteMacrosDialog provides the PDS/PDSE library and macro/DCLGEN
(Member) name to be retrieved.  There is a choice to add the macro/DCLGEN
name to the exceptions list.

Editor: Main Menu
The Main Menu is located at the top of the screen.
Items on the main menu provide for the management of various resources supported by IMU Explorer.
Menu Items can be selected with a click of the mouse
          or
You can use Alt-&char to select a Main Menu item where &char is the underscored character of the Main Menu item name.

Editor: Toolbar Area
The Tool Bar  is located at the top of the screen below the Main Menu.
Buttons on the toolbar allow for easy navigation through IMU Explorer screens.
Place mouse over the button of interest to see the tool tip that describes the button.

Editor: Save work in progress to temporary file(Ctrl+S)
On Sub-shell screen menu bar:
1. Select File
2. Select Save
   All changes made to the edited file are written to temporary work file for potential recovery.
   Note: Save does a full syntax check for Easytrieve Plus programs.

Editor: Save edited file as a new file name
A new file is created in the same directory where the edited file resides.
All changes made to the edited file are applied and saved to the new file name.
The editor session continues with the original file.
Note: The Save to New File saves the entire file. It is equivalent to a CREATE on ISPF editor command line.

On Sub-shell screen menu bar:
1. Select File
2. Select Save to New File
   The file name dialog will be presented. Enter a new file name.
   You can use the drop-down list to append a specific file extension.
3. Click on the Create button to create the file or the Quit button too exit.

Editor: Save work in progress to temporary file and launch System Open
A new temporary file is created in the work folder temporary work space.
All changes made to the edited file are applied and saved before System Open.
System Open is launched to view the saved file with the operating system default application.
The editor session continues with the original file.

On Sub-shell screen menu bar:
1. Select File
2. Select Save and System Open
System Open will open the file with the operating system default application.

Editor: Syntax check (Ctrl+T)
On Sub-shell screen menu bar:
1. Select File
2. Select Check Syntax
   All changes made to the edited file are applied (if any).
   The syntax check is done on the entire file unconditionally.

Editor: Exit Editor (F3)
On Sub-shell screen menu bar:
1. Select File
2. Select Exit
      or
1. Click on the X in the upper right corner of the Sub-shell screen.

Note: Upon exit, you will be given a chance to save changes made to
the file. Be careful, no will void all changes you made.

Editor: Edit undo command
On Sub-shell screen menu bar:
1. Select Edit
2. Select Undo Edit

Editor: Edit redo command
On Sub-shell screen menu bar:
1. Select Edit
2. Select Redo Edit

Editor: Switching mode Browse/Edit
On Sub-shell screen menu bar:
1. Select Edit
2. Select Switch to Edit to switch to edit mode
              or
3. Select Switch to Browse to switch to browse mode

Note: Switch to Edit and Switch to Browse share the same button.
If you see the Browse, it means that the editor is in Edit mode.
Select Switch to Browse to switch to browse mode.

If you see the Edit, it means that the editor is in Browse mode.
Click on Switch to Edit to switch to edit mode.

Editor: Setting Fonts and Colors
On Sub-shell screen menu bar:
1. Select Edit
2. Select Editor Preferences

 The Editor Preferences dialog will pop up. Chose from available options to
 set your preferences.

Editor: Submit edited program to z/OS
On Sub-shell screen menu bar:
1. Select Submit
2. Select Submit Job

If your program does not contain JCL for compiling
you will be prompted to select a JCL file. The program
source and the JCL file will be automatically merged and
sent to the z/OS internal reader.

Editor: Submit template to z/OS
On Sub-shell screen menu bar:
1. Select Submit
2. Select Submit Template
         or
On Home screen Explorer Tree
1. Right click on a file node you wish to submit
2. Select Submit Template

If your program does not contain JCL for compiling
you will be prompted to select a JCL file. The program
source and the JCL file will be automatically merged and
sent to the z/OS internal reader.

_______

Submit Template allows you to imbed // SET symbols/variables in the program source for general use.

_______

Templates (JOB/JCL) files may or may not contain one or more // SET statements. A key/value selection dialog is always presented. The selection dialog enables you to change key values as deemed necessary. When you submit a template, all // SET keyword=&value symbols in the instream data are replaced. Symbols in non-instream data files are not changed. With the exception of JOB statement, comments and JCL statements are left unchaged.

_______

There are two special reserved symbols that you need to be aware of: a) &SYSUID is the TSO User Id that submits the job. This is a z/OS/JES symbol. This symbol is replaced in the instream data only. JCL statements are left for JES to take care of it. The &SYSUID is not presented on the selection dialog. b) &JOBNAME is an IMU Explorer generated symbol. The initial value is as follows: 1. If JOB statement is //NONAME JOB. . . the &JOBNAME is set to TSO User from FTP connection + A. 2 If JOB name starts with TSO User, it is left unchanged. 3. For all others, the &JOBNAME is set to TSO User from FTP connection + the last character of input job name.

_______

There are two types of SET Symbols: a. Global symbols available to every JOB These symbols are made available to each z/OS FTP Connection. The default value of each symbol is placed in the drop-down list on Template Screen. Symbol default value is included if there is a // SET statement symbol in the JCL. b. Symbols imbedded in the JCL These symbols are the // SET statements in the JCL. They may or may not be Global symbols.

_______

The history of key values for Global symbols is kept in the /&instalDir/UserProfiles/GlobalTemplates folder. The defaults are kept in &sys_GlobalJclSetSymbols file, where &sys is your FTP connection name. Thus, there is one global symbols file per FTP connection. Example: If FTP is connected to DEMO1 z/OS system, then DEMO1_GlobalJclSetSymbols is the file. The history of the default symbol values is kept in the &sys subdirectory, where &sys is your FTP connection name. Example: For system DEMO1 and symbol CEERUN: /&instalDir/UserProfiles/GlobalTemplates/DEMO01/CEERUN.txt Important note: The initial Global symbols are located in the /&instalDir/UserProfiles/GlobalTemplates/GlobalJclSetSymbols.txt file. The above file is copied into your &sys_GlobalJclSetSymbols.txt file the first time a JOB is submitted with template. The &sys_GlobalJclSetSymbols.txt file should be customized at installation time to reflect values/libraries specific to &sys system.

_______

The history of symbol values for non-global symbols is kept in the special sub-directory named .templates. This sub-directory can be found in the same directory where your JCL file is located. You can use System Open to view these files. For example, if JCDEMO01.JCL file is located in c:\imuExplorer\WorkFolder The .templates directory would be: c:\imuExplorer\WorkFolder\.templates\JCLDEMO001.JCL. One subfolder for each FTP connection is created. The subfolder name is the z/OS Name + Tso User from FTP Connection. Example: if FTP connection z/OS name is ibmsys1 and TSO User is USER1, the history folder would be: c:\imuExplorer\WorkFolder\.templates\JCLDEMO001.JCL\ibmsys1_USER1 The above directory contains one file per keyword where history is kept. The nuber of values kept is the default set by the Tools --> Manage Dialogs History Limit on the Home Screen Toolbar.

_______

Example 1. You can define in the JCL (after the JOB statement), a date as: // SET MYDATE=09/01/2015 then reference &MYDATE in the program on any statement that may be appropriate. For example: IF WS-DATE = &MYDATE do something END-IF

_______

Example 2. You can define multiple symbols (after the JOB statement): Note that //NONAME JOB statement is used here. Notice symbols usage after the //SYSTSIN DD * statement. //NONAME JOB ,,NOTIFY=&SYSUID, // CLASS=A,MSGCLASS=X,COND=(05,LT),REGION=0M //* CHANGE THE FOLLOWING VALUES TO YOUR DEFAULTS. // SET JOBLIB=DB2.V7R1M0.SDSNLOAD // SET SSID=DL11 // SET OWNER=&SYSUID // SET TABLE=DB2TABLE // SET LIBRARY=&SYSUID..DCLGEN.DATA //* //JOBLIB DD DSN=&JOBLIB,DISP=SHR //********************************************************************* //* STEP 1: CREATE DCLGEN (DB2 TABLE DESCRIPTIONS * //********************************************************************* //PUNCH01 EXEC PGM=IKJEFT01,DYNAMNBR=20 //SYSTSPRT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SYSTSIN DD * DSN SYSTEM(&SSID) DCLGEN TABLE(&OWNER...&TABLE) + LIBRARY('&LIBRARY(&TABLE)') + ACTION(REP) + STRUCTURE(&TABLE) + LANGUAGE(COBOL) END /* //

Editor: Update z/OS (synchronize edited file with z/OS)
On Sub-shell screen menu bar:
1. Select Submit
2. Select Update z/OS
This function is available for files located in a local directory that
was created from a PDS/PDSE library. File is placed in the same library where it was retrieved from.

To send files to z/OS, an FTP connection must be established.
If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
 you can send files to z/OS.

Editor: Send to z/OS (transfer edited program to z/OS)
On Sub-shell screen menu bar:
1. Select Submit
2. Select Send to z/OS


To send files to z/OS, an FTP connection must be established.

If FTP is not in a connected state, you will be prompted with
the FTP Connect dialog. FTP must be connected to z/OS before
you can send files to z/OS.

You will be prompted with the Send dialog to input the PDS/PDSE and
the file name where to place the file on z/OS.

Caution: The PDS/PDSE name can be a maximum of 44 characters long.
The file name can be a maximum of 8 characters long.

The file being currently edited will be saved to a temporary
work file and sent to z/OS. The original copy will not be
affected until you exit the Editor.

Editor: Logs
Please refer to the  Viewing logs  and the  Logs on/off  sections of the main shell menu bar.

Editor: Tools
Please refer to the  System Open , the  Manage Macro Exceptions 
and the  Manage Macros Search sections of the main shell menu bar.

Editor: Tools: Comparing edited file to the original copy
The current state of edited file is compared to the original copy initially loaded by the editor.
This option is usefull for detecting changes that were made since the launch of the editor.
On Sub-shell screen menu bar:
1. Select Tools-> Compare to Original
 Upon completion, you will be presented with the outcome. Use system
 tools to view the differences.

Editor: Keypad: Soft Keyboard
On Sub-shell screen menu bar:
1. Select Keypad
A keypad of frequently used keyboard function keys is opened at the bottom right.
Do mouse click on any button of interest to simulate the keyboard.

Editor: Switch: Focus on specific Editor Screen region
The editor screen is composed of six (6) distinct regions.
This option provides a short-cut to specific regions without tabbing.
The following regions are available:
1. Select Switch
2. Choose a region from the drop-down choices
    Ctrl-1 or Quick Search to focus on Quick Search on the left
    Ctrl-2 or Tree Panel to focus on the Tree Panel on the left
    Ctrl-3 or Editor Panel to focus on the Editor Panel
    Ctrl-4 or Tab Items to focus on a specific Tab Screen
    Ctrl-5 or Default Values Search to focus on the Defaults Quick Search on the right
    Ctrl-6 or Key Defaults to focus on the Defaults Panel on the right
    Ctrl-7 or Messages Panel to focus on the Messages Panel at the bottom

Home Screen: Window: Focus on Home Screen or an Editor Screen
1. Select Window
2. Choose a window from the drop-down choices

Editor: Readme first
On Sub-shell screen menu bar:
1. Select Help
2. Select Readme first

The Readme First screen will be displayed.

Editor: Help documents
On Sub-shell screen menu bar:
1. Select Help
2. Select Help Contents

The help screen with the documents on the left side will be displayed.
Double click on document(s) of interest to view the contents.

Editor: Searching Tree for program items
The search text box is opened by default at the left corner above the tree.
If you close the text box, you can re-open it as follows:
On Sub-shell screen menu bar:
1. Select Edit
2. Select Search Tree
The search text box will be opened at the left corner above the tree.
You can use wild card(s) to locate tree items of interest. Strings are not
case sensitive.

For Wild Card choices, see the  WildCardFilter document.

Be aware, only the expanded nodes are searched.
Expand node(s) of interest on initial search to make it available to the search engine.
Example: ws- shows all node names with the ws- prefix.

Editor: Search Internet (Ctrl+I)
Please refer to the  Search Internet section of the main shell menu bar.

Eclipse Foundation Software User Agreement
Please refer to the  About IBM Migration Utility Explorer section of the main shell menu bar.

Back to top