© 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.
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