Skip to main content

Editor Help

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.

Contents

Using Help Screen

Use Ctrl-f to initiate the 'Find' dialog.

The 'Find' dialog is opened at the bottom left corner or at the top right corner, depending on the browser settings.

This document is in .html format. To open this document in your default Browser right click on the html file and select "System Browse".

Overview

The editor is an integral part of the IBM Migration Utility Explorer environment that gives workstation users the capability to edit and syntax check IBM Migration Utility V5.1 and later versions of programs.

The editor screen consists of:

  1. Objects Tree window on the left

    • Shows program nodes (sections) located in the program. The tree is visible for Easytrieve Plus (.ezt) and JCL (.jcl) files that may or may not contain Easytrieve Plus programs.

  2. Defaults window on the right

    • Shows the available defaults when a node in the Objects Tree is double clicked.

  3. Text editor window in the middle

    • MESSAGES Box at the top of the screen
    • Shows command errors encountered during command processing.

    • COMMAND Box at the top and below the MESSAGES Box
    • This is where you enter Primary Commands.

    • Optional Find tool bar at the top but below the COMMAND Box
    • This tool bar is activated by pressing Ctrl-f.

    • Optional Cursor Column Ruler at the top but below the COMMAND Box
    • This is a ruler that shows the current cursor (caret) position.

    • File Text of 0 or more lines depending on the file size
    • Click on Editor Text Area Regions for region details

    • Text line numbers to the left of the text

    • Text line attributes to the left of the line numbers
    • Informational line at the bottom and below the File Text
  4. Syntax errors window below the Text editor window

    • Shows errors detected by the Check Syntax request. Double clicking on the line number brings the error line in the view.

Primary Commands

Command lines are entered at the top of the text editor panel in the COMMAND Box.

Use F12 to recall previously entered commands.

or

Click on drop down list on the right side to select a previously entered command.

The following primary commands are available: (note that commands can be lower or upper case)

Line Sub-commands

Line Sub-commands are entered on the line number displayed to the left of the text lines.

The following line sub-commands are available: (note that commands can be lower or upper case)

Keyboard Keys

Mouse Right click

Right click with your mouse in any place on the Text Screen to view the drop down list of available options.

Selecting Text

You can use Mouse or Keyboard to select the text.

Selecting text with the mouse:

Selecting text with the keyboard:

Editor Preferences

The Preferences Dialog lets you tailor editor options such as fonts, colors, etc. to your conventions.

Right click with your mouse in any place on the Text Screen for the drop down list, then select 'Preferences'.

Error Messages: Command and Syntax Errors

There are three(3) types of errors:

  1. Command errors. These errors are issued in the Messages Box above the COMMAND line.
  2. Syntax check errors. These errors are displayed at the bottom of the screen as a separate dialog. Syntax check errors apply to Easytrieve Plus programs only.

    When Syntax Errors exist, an 'E' is displayed on the left of the line number in error.

    You can click on the error message at the bottom of the screen to navigate to the line in error.

  3. Pop-up TroubleWidgets.

    All messages are self explanatory.

    There is a Control Tab (Tab) at the top left corner of the Text Editor window.

    The Tab is shown in Green, Yellow and Red color.

    Green means ther are no error, Yellow means there are warning messages only and Red means there are Syntax Errors displayed at the bottom of the screen.

Auto Save option

The Auto Save option is active when the Enable Auto Save box is checked on the Preferences screen.

To turn it on or off, right click on editor text area, choose Preferences and check the Enable Auto Save box.

The Auto Save Frequency specifies the auto save interval in seconds. Be careful, Save for large programs may take a few seconds. Doing automatic save too frequently may slow down the editing.

The Auto Save Number of Files specifies the number of history files to maintain. For example, 16 maintains the last sixteen saved copies of edited program.

Editor Bookmarks

To bookmark a line in your program, right click with your mouse in any place on the Text Screen for the drop down list, then select 'Create Bookmark'. The text following the caret position is used for the bookmark name. Maximum of 32 characters are used.

Alternatively, you can highlight a line text, then select 'Create Bookmark'. The highlighted text is used for the bookmark name. Maximum of 32 characters are used.

Bookmarks allow you to re-visit your screen to bookmarked line(s).

To view bookmarks, right click with your mouse in any place on the Text Screen for the drop down list, then select 'View Bookmarks'.

Navigating Hints

Use Bookmarks Editor Bookmarks to quickly navigate to the points of interest.

Use the Highlight Tree Node to locate all tree nodes that begin with the highlighted word. To do so, highlight a word in the text area, right click and select Highlight Tree Node. You can double click on the highlighted tree node(s) to view the properties, or single click to navigate editor screen to the node/object definition in your program.

Use Mouse to scroll up, down, left and right.

Use Keyboard keys Keyboard Keys to quickly navigate to the points of interest.

Use Primary Commands, 'top', 'bottom, 'find' Primary Commands.

Single click on a tree node to navigate editor screen to the node/object definition in your program.

Use Quick Search above the tree node and use a wild card to locate nodes of interest.

Use Syntax errors window below the Text editor window to bring error lines in the view. Double click on the line number of interest to bring the error line in the view.

On the Menu bar, use 'Switch' or 'Window' button to focus on other editor screens.

On the Toolbar, use left, right and up and down arrows to navigate Editor screens in sequential order.

Search and Replace

Use 'find' and 'change' on Command Line Keyboard Keys to find and/or replace strings.

Use 'Ctrl-f' or Ctrl-r to open up the Search And replace box below the Command Line. Also, this dialog provides 'Advanced Search' option that opens the Advanced Search dialog, The Advanced Search option is self contained. Use its various options to accommodate your needs.

Caution! Search options for Ctrl-f and Ctrl-r dialogues are inherited from the Advanced Search dialog. Choosing Hex Mode on Advance Dialog automatically puts the Ctrl-f and the Ctrl-r dialogues in Hex Search mode. These options stay in effect until the dialogues are closed.

'Esc' closes Search and Search And Replace dialogs and resets all options to the default values.

Debug Option

The Debug option is active when the 'Enable Debug' box is checked on the Preferences screen.

The Debug is in disabled state by default. To turn it on, right click on editor text area, choose Preferences and check the 'Enable Debug' box.

Note: The debug option is for IMU Explorer developers use only. You may turn it on to trace events should you encounter any editor issues.

Editor Text Area Regions Regions

The file you are editing consists of three (3) regions depending on the file type.
Each screen text line is sub-divided by editor into three (3) distinct regions: Region A, Region B and Region C.

When your CHANGE or Find command contains the From column or From and To columns, editor restricts the search to the region that contains those columns. The From and To columns cannot overlap a region boundary.

Regions are assigned by default to the following file types:

*.bal Region A n/a, Region B col 1-71, region C col 72-80
*.ccl Region A n/a, Region B col 1-71, region C col 72-80
*.jcl Region A n/a, Region B col 1-71, region C col 72-80
*.mac Region A n/a, Region B col 1-71, region C col 72-80

*.cob Region A col 1-6 Region B col 7-72, region C col 73-80
*.dcl Region A col 1-6 Region B col 7-72, region C col 73-80

*.cpy Region A n/a, Region B col 1-72, region C col 73-80
*.ezt Region A n/a, Region B col 1-72, region C col 73-80
*.ezx Region A n/a, Region B col 1-72, region C col 73-80

All others, Region A n/a, Regiob B col 1 - nn, Region C n/a
-----

*** End of Document **