© 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.
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".
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:
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.
Defaults window on the right
Shows the available defaults when a node in the Objects Tree is double clicked.
Text editor window in the middle
Shows command errors encountered during command processing.
This is where you enter Primary Commands.
This tool bar is activated by pressing Ctrl-f.
This is a ruler that shows the current cursor (caret) position.
Click on Editor Text Area Regions for region details
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.
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)
Displays the Editor Commands Help document.
Shortcut key: n/a
Example: ?
The same can be invoked by clicking on the tool bar Help -> Help Contents -> EditorCommands_help.html.
Positions and places cursor on the last line.
Shortcut key: n/a
Example: bot
The same as placing an 'm' on Command line and then depressing F8.
Change command, lets you replace a string or a hex string with a new value."all" changes all occurrences. Consider using the Replace Widget instead (Ctrl-r).
Strings with multiple words must be enclosed in quotes. Make sure that case sensitive strings are replaced by the correct upper or lower case.
Use x'nn' syntax to replace hexadecimal values.
Shortcut key: F6 repeats the CHANGE.
Click on Editor Text Area Regions for region details.
Example 1: c balance amount
The above example changes one occurrence of 'balance' to 'amount' starting with the current caret position.
Example 2: c balance amount 20 60
The above example changes one occurrence of 'balance' to 'amount' between columns 20 and 60 inclusive.
The search starts with the current caret position.
Example 3: c balance amount 20 60 all
The above example changes all occurrences of 'balance' to 'amount' between columns 20 and 60 inclusive.
The search starts with the current caret position.
Example 4: c 'balance 1' 'balance 2' all
The above example changes all occurrences of 'balance 1' to 'balance 2' in the entire file.
The search starts with the current caret position and wraps around until all lines are checked.
Example 5: c x'20' x'31' all
The above example changes all occurrences of x'20' to x'31' in the entire file.
The search starts with the current caret position and wraps around until all lines are checked.
Turns caps on or caps off (this applies to text typed on edited lines).
Shortcut key: n/a
Example 1: caps on
Example 2: caps off
Toggle ruler below the Command line ON/OFF.
Shortcut key: n/a
Example1: cols on
Example2: cols off
Lets you copy a local file at specified location. Enter COPY followed by a full path with file name. If no file is supplied, you are presented with a file selection dialog.
Shortcut key: n/a
Enter 'a' on a line number to add file after it.
Example1: copy JIMUJCL1.jcl
Example2: copy
Lets you create a file at specified location. Enter CREATE or CRE followed by a full path with file name. If no file is supplied, you are presented with a file selection dialog.
Shortcut key: n/a
Enter cc - cc or cnn(where nn is the number of lines) on lines you wish to put in the new file.
Example1: create jobfile1
Example2: create
Find command, lets you locate a string or a hex string in the source file. "all" finds all occurrences. Consider using the Find Dialog (Ctrl-f) for more flexibility.
Strings with multiple words must be enclosed in quotes.
Use x'nn' syntax to find hex values.
Use f p'.' to locate non printable characters.
This command is not case sensitive.
Shortcut key: F5 repeats the find.
Click on Editor Text Area Regions for region details.
Example 1: f 123
Example 2: f 123 all
Example 3: f x'31'
Example 4: f p'.'
Example 5: f 'aaa' 20 60
Example 6: f 'bb' 20 60 all
Changes screen to hex mode.
Shortcut key: n/a
Example 1: hex on
Example 2: hex off
Note: Hex mode is for browsing only. Changes are not allowed while in Hex Mode.
Controls the visibility of soft keypad.
Shortcut key: n/a
Example 1: keypad on
Example 2: keypad off
Positions and places cursor on the specified line.
Shortcut key: n/a
Example: l 10 goes to line 10
Removes trailing spaces from text lines so that text can be inserted.
Shortcut key: n/a
Example 1: nulls on
Example 2: nulls off
Resets all outstanding Primary and Line commands.
Shortcut key: n/a
Example: reset
Saves current edited file to a temporary disk file and does syntax check.
Shortcut key: n/a
Example: sav
SAVE is the same as selecting File -> Save on the toolbar.
Send file to internal reader on remote system (Submit Job).
Shortcut key: n/a
Example: sub
SUBMIT is the same as selecting Submit -> Submit Job on the toolbar.
Positions and places cursor on the 1st line.
Shortcut key: n/a
Example: top
The same as placing an 'm' on Command line and depressing F7.
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)
'A' executes 'C', 'Cn', command and block CC-CC commands. Text lines are placed after the line where 'A' is typed.
You must press the enter key to complete the action.
'B' executes 'C', 'Cn', command and block CC-CC commands. Text lines are placed before the line where 'B' is typed.
You must press the enter key to complete the action.
Copies a line and puts it in the editor clipboard for copy.
You must place 'A' or 'B' on the line where to place the copied line, then press enter to complete copy.
Copy n number of lines ('n' is a number from 1 - n).
Puts n number of lines in the editor clipboard for copy.
You must place 'A' or 'B' on the line where to place the copied block, then press the enter key to complete copy.
This is a block command. It is used to copy a range of lines.
The first CC marks the first line in the range of lines to copy.
The second CC marks the last line in the range of lines to copy and puts those lines in the editor clipboard for copy.
You must place 'A' or 'B' on the line where to place the copied block, then press the enter key to complete copy.
Deletes the line on which 'D' is placed.
You must press the enter key to complete delete.
Deletes n number of lines ('n' is a number from 1 - n).
You must press the enter key to complete delete.
This is a block command. It is used to delete a range of lines.
The first DD marks the first line in the range of lines to delete.
The second DD marks the last line in the range of lines to delete.
This is an immediate command. Lines are deleted when the enter key is pressed.
Display line in hex. The hex line is displayed in a new screen. You can view but not change the hex values.
You must press the enter key to complete the display.
Display multiple lines in hex. The nn is the number of lines to display. The hex lines are displayed in a new screen. You can view but not change the hex values.
You must press the enter key to complete the display.
Insert a line after. A new line is inserted for editing. One or more characters must be typed for the line to be saved.
You must press the enter key to complete the insert.
Insert multiple lines after. N number of lines are inserted for editing. One or more characters must be typed on any line to be saved.
You must press the enter key to complete the insert.
Moves the line on which 'M' is placed to a different location.
You must place 'A' or 'B' on the line where to place the moved line, then press the enter key to complete move.
Moves n number of lines ('n' is a number from 1 - n).
You must place 'A' or 'B' on the line where to place the moved block, then press the enter key to complete move.
This is a block command. It is used to move a range of lines.
The first MM marks the first line in the range of lines to move.
The second MM marks the last line in the range of lines to move.
You must place 'A' or 'B' on the line where to place the moved block, then press the enter key to complete move.
Replicates the line on which 'R' is placed.
You must press the enter key to complete replication.
Replicates the line n number of times ('n' is a number from 1 - n).
You must press the enter key to complete replication.
Closes Search and Search And Replace dialogs and resets all options to the default values.
Toggles Insert mode On/Off.
Deletes highlighted text.
Splits line at caret position.
Joins a split line.
Positions caret to end of the line.
Insert a line at caret position.
Pop-up a line error message tool tip widget.
Error message is shown when the caret is positioned on a line that contains errors.
When the caret is positioned on a line that contains no errors, Ctrl-? toggles to
the last opened tool tip widget if one exists, otherwise the request is ignored.
Puts the caret on the COMMAND line.
Erases all text from the caret (inclusive) to the end of the line.
Scrolls page up.
Scrolls page down.
Locks keyboard caps on/off.
Tabs through line numbers and from the COMMAND line.
Tabs through line numbers backwards.
Closes Editor Panel (the same as Exit).
Repeats the find command.
Page backward.
You can use 'm' on Command line and depress F7 to go to the TOP.
Page forward.
You can use 'm' on Command line and depress F8 to go to the BOTTOM.
Recalls the last command entered on the COMMAND line.
Backspace.
Right click with your mouse in any place on the Text Screen to view the drop down list of available options.
Saves the current state of the file to a temporary file and does a full syntax check of the entire program. The saved file is used for recovery should the system fail while in edit mode.
Saves the current state of the file to a temporary file and does a full syntax check of the entire program. The saved file is used for recovery should the system fail while in edit mode.
Restores text to before the last typing.
Restores text to before the last typing.
Restores text to before the last typing.
Re-applies changes of the last typing.
Copies the selected text to the System Clip Board.
Copies block of lines marked with CC-CC or C to the System Clip Board.
Copies the selected text to the System Clip Board and removes the selected text from the screen.
Converts highlighted text to lower case.
Converts highlighted text to Upper Case.
Inverts letter case of highlighted text. i.e., lower case becomes upper case and vice versa.
Paste the content of the system System Clip Board at the current cursor/caret position. You must exit editor insert mode before doing this operation. If your keyboard is in replace mode, text is placed over the existing text. If your keyboard is in insert mode, text is inserted at the cursor/caret position. You are notified when line size is exceeded.
Opens the Book Marks dialog and bookmarks the current line. Bookmarks allow you to re-position your screen to bookmarked line.
Opens the Book Marks dialog. Click on bookmarks to re-position your screen to bookmarked line.
Prints the selected text.
Prints the entire program.
Activates the Optional Find tool bar at the top but below the COMMAND Box.
Activates the Optional Find tool bar at the top but below the COMMAND Box.
Activates the Optional Find and replace advanced tool bar at the top but below the COMMAND Box.
Change screen to edit in Hex mode. Text cannot be changed while in this mode.
Change screen to Hex Off (returns back to original edit mode)
This dialog enables you to change the maximum record length of the file you are editing.
The purpose is to allow file record expansion, should longer lines be needed.
Highlights the tree nodes on the left side of the editor screen that match the highlighted text.
This lets you easily located the objects of interest. For example, if you highlight the word FIELDA-
,
clicking on the Highlight Tree Node
will locate all nodes that begin with the word FIELDA-
. You can
then double click on the highlighted node(s) to view the properties, or single click to navigate editor
screen to the node/object definition in your program.
Opens the Preferences Dialog where you can change the editor preferences.
You can use Mouse or Keyboard to select the text.
Selecting text with the mouse:
Selecting text with the keyboard:
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'.
There are three(3) types of errors:
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.
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.
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.
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'.
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.
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.
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.
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 **>