Topaz text editor

Topaz Text Editor is an available option for edit, browse, and open actions for files with any extension that is not mapped to one of the other Topaz Editors. There is no outline view, syntax highlighting, or configurable preferences for this editor.

To find a text string or EBCDIC hex characters

The editor supports default Eclipse functionality for finding text. In addition, users can find EBCDIC hex and all occurrences of a text string or EBCDIC hex characters, as described below.

1. In the editor, do any of the following:

1. 
   
   • 
     
     • Click CTRL+F.
     • Highlight the desired search text in the editor and click CTRL+F.
     • From the Edit menu, select Find/Replace.The Find/Replace dialog box appears.1. Do any of the following:
   • • To find a text string, in the Type box, select String.

     • To find all occurrences of a text string, in the Type box, select String, then select the Find all occurrences check box.

     • To find a EBCDIC hex characters, in the Type box, select EBCDIC hex.

     • To find all occurrences of EBCDIC hex characters,in the Type box, select EBCDIC hex, then select the Find all occurrences check box.
2. Complete the remainder of the dialog box as desired.
3. Click Find.

• 
  
  • When searching for all occurrences, the matches are highlighted in the editor and the Search view shows the results. Refer to the Eclipse documentation for information about the Search view.
  • When searching for EBCDIC hex characters, the matches (whether in the Search view or in the editor) show the UTF display value based on the currently selected code page. For example, searching for F1F2F3F4F5 finds 12345 when using code page 1047 in the editor.

To select a block of code

Toggle Block Selection functionality allows users to select a block of code and then copy it, delete it, or replace it.

1. Do one of the following:
   • Right-click in the editor and select Toggle Block Selection.
   • Within the editor, press Alt+Shift+A.
2. Drag the crosshairs to select the desired code.
3. Do any of the following:

• 
  
  • To delete the code, click Delete.
  • To copy the code, press Ctrl+C. To paste it elsewhere, place the cursor in the new position and press Ctrl+V.
  • To replace the code, begin typin

To change the case of selected text

1. Select the desired text in the editor.
2. Right-click the text and do either of the following:

• 
  
  • To change the text to uppercase, select Source>To Upper Case.
  • To change the text to lowercase, select Source>To Lower Case.

To view, edit, and insert a character using hex

The Topaz Workbench editors allow users to view the value of a non-displayable character, edit a character using hex, and insert a character using hex.

1. In the editor, do any of the following:
   • To view the value of a non-displayable character, highlight the character (represented by ), right-click and select Source>Edit Character using Hex. The Edit Character dialog box appears and the EBCDIC hex value field shows the hex value of the non-displayable character. To change the character, enter its EBCDIC hex value.
   • To edit a character using hex, select the character, right-click and select Source>Edit Character using Hex. The Edit Character dialog box appears. Enter the desired value in the EBCDIC hex value field.
   • To insert a character using hex, place the cursor in the desired location, right-click and select Source>Insert Character using Hex. The Insert Character dialog box appears. Enter the desired value in the EBCDIC hex value field.
2. Click OK.

To edit a single line using hex

The Topaz Workbench allows users to edit a single line of characters, including non-displayable characters, using a vertical hex editor.

1. In the Topaz editor, select the desired line, click  or right-click and select Source>Toggle Hex Line Editor. The hex line editor appears and shows the hex value of the non-displayable characters in a four-line hex display. The first line shows the readable characters; the second, and third rows show the vertical EBCDIC hex value of each character. When logged in with a code page supporting double byte characters, the fourth line displays the ideogram for any double byte characters in the text. The fourth line cannot be used for editing.

   Important

   Repeat any of these methods to toggle the hex line editor closed.

2. In the hex line editor, use the arrow keys or mouse to select the character to change in either the first line (readable text) or the hex value rows, then enter the new value. To append characters to the end of the line, continue entering data when the cursor is at the end of the line.

To add or remove bookmarks or tasks

The editor supports default Eclipse functionality for adding and removing bookmarks and tasks. However, markers only persist for files stored in projects, not those opened from Host Explorer. When a marker is added or the editor is closed, a warning message notifies users that the markers will be deleted. This warning can be customized as described below.

Do either of the following:

• To disable the warning message, click the Don't show this warning again check box on the warning message.
• To re-enable the warning message, from the Window menu, select Preferences. Toggle open the node and select Editors. Select the Show warning when adding bookmarks and tasks outside of projects check box.