WDSC tips/Editor

EDITOR

For keyboard shortcuts, see WDSC shortcuts

Editor Commands

Original article(s) in the midrange archive: [1]

(Note the post mentions ?SEU, I found ?Editor to be also useful)

• Type ?Editor on the command line
• Click on 'Default editor commands' to see the commands
• Click on the command for more info, including usage

Check LPEX commands.

1. Note the Short Commands (see following small extract from the text)

/text Find the next occurrence of the specified text. 
-/text Find the specified text searching backwards from the current position. 
'text Find the next occurrence of the specified text.  The search is a case-sensitive search. 
-'text Find the specified text searching backwards from the current position.  The search is a case-sensitive search. 

(there is more info in the help text)

There is more find info at WDSC Find Tips

#top

WDSCi vs SEU F15=Browse options

Original article(s) in the midrange archive: [2][3]

• To edit the same member, the method most analogous to the SEU F15 browse is Ctrl+2 to split view,
  • click on subroutine name in Outline View to position the new view to the subroutine,
  • do whatever,
  • Ctrl+0 to close the second view.

Note that new views opened this way can all allow editing, and you can have up to 5 views open on a single member, not just 2 as in SEU.

• To edit/browse a different member, Ctrl+Shift+A (or open using any other method). Then drag the member name tab down or to the right until it turns into an arrow and release. This splits the screen (top/bottom or left right) for editing/browse. Does not work when in maximized mode.

• Alternately,
  • just go to the subroutine by clicking on it in the Outline View,
  • do whatever,
  • then return to the Exsr by clicking on the line number where the subroutine is used.

• A third way is to set a quick mark and return to it.

• A fourth way is to set a named mark and return to it.

• A fifth way (but the Outline View is easier) is to filter the source by the subroutine name
  • (either Ctrl+F, enter name, click All, or right click, Selected, Filter selected,
  • which can also be set up as a key combo if you like),
  • put the cursor on the Exsr or Begsr as you choose, and then Ctrl+W.

Note: If you have 6.0.0.1, you're too far behind - I believe you need 6.0.1.0 or higher to be able to open multiple views on the same member.

Position my cursor to where I need to key additional data. (On IBM rqmts list)

Original article(s) in the midrange archive: [4]

In SEU, when I hit Enter, the editor will automatically position my cursor to where I need to key additional data? I know tab moves me to the next input position, but not whether it requires input. And by the time auto syntax checking informs me, I have spent time reading the message, relocating my cursor, etc.

• There is no way to currently do this. It is on IBM's list of requirements.

Automatic cursor positioning can be configured by choosing 'Preferences' from the 'Window' menu.

• In version 7, you are looking for Remote Systems→ Remote Systems LPEX Editor→ iSeries Parsers→ ILE RPG

#top

Do I have to use the mouse to copy lines from one member to another?

Original article(s) in the midrange archive: [5]

Standard windows copy/paste keys can be used, along with a few extras provided in LPEX (check the Edit menu for selection options)

To copy X lines,

• put your cursor is on the first line of the block you want to move,
• press Home,
• then hold Shift and press the down arrow X times.
• Now press Ctrl+C,
• then Shift+F6 (this is like Alt-Tab in windows, but for LPEX editor tabs) until you get to the target member.
• Now find the line you want to insert at, and press Ctrl+V.

Another method is to

• mark the lines to copy using Alt-L,
• then copy them into position using Alt-C.

The lines will be inserted beginning with the line after your cursor position. You should also explore the other Select/Selected functions, which are listed under the Edit menu with their keyboard shortcuts.

See list, WDSC_shortcuts.

#top

How can I copy field names in to the member? (On IBM rqmts list)

Original article(s) in the midrange archive: [6]

• This is on IBM's list of requirements.

• I added a table to the Table View, I can see all my fields, but can't copy and paste from there.

• Drag and drop from table view to RS LPEX is currently not available.
• You can always open the DDS source and copy the names from there.
• Be sure to have a look at the rectangle select - it may come in handy for this (alt+R, alt+C.)

#top

Can I condition page ups and downs by cursor position?

Original article(s) in the midrange archive: [7][8]

• Or at least jump the cursor to the top or bottom of the displayed view, then I could roll by line up or down.
• Keys can be easily remapped to do other things - check the mailing list archives for discussions on this at length.
• You'll also want to read the reference help for what LPEX actions are available/do (scrollTop, scrollUp come to mind)

Try this from the archives; How to set an Alt++ xx key to position the current line to the top or bottom of your source window.

• I use the alt+page up and alt+down keys,
• I also have alt+T set to put the current line at the top of the editor window.

• Ctrl+T (v7) will put the line where the cursor is at the top of the screen.

Also check WDSC Workbench for more info on key remapping.

#top

Do I have to continually save my work?

Original article(s) in the midrange archive: [9]

In SEU, when I hit Enter, I know it has been saved, even if I lose my session.

• Remote Systems LPEX Editor has an auto-save feature.
• Default is set to every 5 minutes.
• Check out Windows→ Preferences→Remote Systems→ LPEX Editor

I save every PC document after every few lines.

Virtually all PC software recognises Ctrl+S as the 'Save' sequence.

#top

Auto Marking Changes to the Source

ref FKOL, 3 January 2007 (CST)

Select Window →Preferences→ Remote Systems→ Iseries→ LPEX Editor Parsers

• Check the box with text 'Add signature to changed lines'
• and enter your Change number in the Signature box.
• Click OK

Now whenever you change a line of source code, the 'signature' will be placed in pos 1-5 of the source line.

also see Record/Playback for Signature marks

#top

How do I shift a block of text left/right?

ref Starbuck5250, 5 November 2007 (CST)

Select the block of text by putting the cursor on the upper left corner of the block.

Press alt+R.  
Move the cursor to the lower left corner.  
Press alt+R again.  
Do NOT use Windows copy/paste (ctrl+c/x/v)  
You now have a block of text selected.  

• An alternate way to select is alt+L (line)

and then hold down the Shift key while using the cursor keys to continue highlighting lines.

• You can also alt+L on the first and last lines of the block.

You can shift it left/right with alt+F7/alt+F8 If you remap the keys, the action is blockShiftLeft and blockShiftRight

• You can shift it via the menu Edit→Selected→Shift selection
• You can uppercase or lowercase it with alt-k/alt-i or via the menu
• You can move it: position the cursor where you want the upper left corner to end up and press alt-m or use the menu
• You can copy it with alt+C
• You can delete it with alt+D

Remember that alt+U de-selects the block.

• Note the following will shift the entire line of code, not just a section or block.

You can use SEU mode line commands LL and RR typed over the sequence number area.
LLnn will shift left nn columns.

See list of other keyboard shortcuts: WDSC_shortcuts.

#top

Vertical line in WDSCI editor

Original article(s) in the midrange archive: [10]

Select Window→ Preferences→ LPEX Editor→ User commands

• Click on the drop down arrow in Class Name box,
• select com.ibm.lpex.samples.HairlineCommand
• Click Set, apply, OK.
• Then in the LPEX command line I enter
• 'hairline cursor' or 'hairline off', to turn on and off.

#top

Prevent Enter generating a new line

Original article(s) in the midrange archive: [11]

• Window→ Preferences→ LPEX Editor→ User Key actions
• Map Enter to action 'home' or 'end'

Note if Automatic structure completion is on then 'Enter' will always generate a new line.

Helpful Keys to edit lines
 CTRL|Enter            Generate an empty Line
 CTRL|Backspace        Delete a line
 CTRL|Delete           Field Exit 
 Home                  Position cursor to beginning of line
 Home then back-cursor Position cursor in Line Numbers
 Home then SHFT|Tab    Position cursor in Line Numbers

See list of other keyboard shortcuts: WDSC_shortcuts.

#top

To Print RPG Indented Source

Original article(s) in the midrange archive: [12]

• You can print using the command line below the editor window
• press Esc when you are in the source. Or just click the command line.
• Type ? print - you will see all the options.
• To get the entire source use

print tokenized off lineNumbers off

• To print only what you've selected, use

print block tokenized off lineNumbers off

• If you want line numbers and/or shading of elements, make the obvious changes.
• The print command works even if the File→Print option is disabled - as it is for indented source.

#top

To show dates for source lines:

Original article(s) in the midrange archive: [13]

• 1. Open source in LPEX
• 2. Right click on the source pane, select SOURCE, then SHOW DATE AREA.

To filter source line by date:

• 1. Open source in LPEX
• 2. Right click on the source pane, select FILTER VIEW, then DATE.
• 3. Enter the date (or range) and selection criteria on the popup.

#top

See SQL HOST variables in OUTLINE view. (is not possible)

Original article(s) in the midrange archive: [14]

• I've long wished that SQL host variables would be part of the outline.
• And file references in SQL statements - they CAN be parsed, after all, otherwise they could never be run by the system.
• So it is not impossible, just not in scope, it seems.

See Find Field usage (for SQL where OUTLINE doesnt work) for a work around.

#top

Downloading source to PC to work offline

Original article(s) in the midrange archive: [15]

• Select all the members that you want to download,
• right click,
• select Make available offline.
• Select Yes to the next dialog box.

WDSC will download all the selected members to a iSeries project (named in my version as the CONNECTIONNAME_WINUSERNAME).

• You can also travel with this project by exporting it,
• right click on project name and selecting Export.
• Then select Other, Project Interchange, check off your project,
• name a zip file to store it in, click finish.

You can then put the zip on a mem-stick and take it home (if that's what you want to do with your time off).

• You will need to have WDSCi installed on your home PC.
• In Iseries Project Navigator you need to Import the zip file, reverse the Export steps above.
• You may need to create a project. File→ New→ Iseries Project

Be aware of the issue with Iseries Projects in the RPG source was not being saved tip.

Don Yantzi has some interesting comments on Iseries Projects PLUS MORE tips [16].

#top

OFFLINE work vs ONLINE

Original article(s) in the midrange archive: [17]

There is a difference between editing in Iseries Projects and Editing in RSE.

In Iseries Projects you are working OFFLINE. WSDCi will track your changes.

In RSE you are working ONLINE. WDSCI does no tracking.

Even on your local PC you can work OFFLINE.

When you are ready you PUSH your changes to the ONLINE source.

• Right click on your source Projects Remote Actions→Push Selected.

You are warned if someone else has done other changes while you did yours.

#top

Fast Open another Source

Original article(s) in the midrange archive: [18]

Use Ctrl+ Shift+ A

Check WDSC shortcuts

#top

Record/Playback for Signature marks

Original article(s) in the midrange archive: [19]

You can also record the key strokes by using the start and stop recording icons ( small squares) on the toolbar.

• Press the start recording icon, insert your signature once, then stop the recording.
• Everytime you want to insert the signature,
• press the Playback recording (green arrow beside the two squares).

also see Auto Marking Changes to the Source

#top

Field Exit

Original article(s) in the midrange archive: [20]

Ctrl+Del works like Field Exit.

#top

Automatic structure completion

Original article(s) in the midrange archive: [21]

In Window→ Preferences→ Remote Systems→ iSeries→LPEX Editor Parsers→ILE RPG

Check the 'Automatic closure of control block' and select your style.

You may need to 'Check' the 'Repeat previous specification type' to see the 'Automatic closure of control block'

#top

Enter Key not Working

Original article(s) in the midrange archive: [22]

• The profile had been changed to LPEX.
• Changed it back to Seu.

Windows →Preferences → LPEX Editor

Change the Editor Profile to SEU

FWIW My setting is LPEX and Enter key is OK.

#top

Snippets

Check SNIPPETS

#top

Switch Auto Syntax Check On/Off

Original article(s) in the midrange archive: [23]

If you are not editing the SQL statements and want to just enable the syntax checking of the rest of your RPG source, you can turn off the SQL syntax checking.

• Windows →Preferences→ Remote Systems→iSeries→LPEX Editor Parsers→ILE RPG,
• check box "Automatic syntax checking of SQL statements (performed on the server)"

#top

CL auto format

Original article(s) in the midrange archive: [24]

To turn it on/off, go to Windows→ Preferences→ RemoteSystems→Remote Systems Lpex Editor→ iSeries Parsers→ CL

#top

Show fields in a file

Original article(s) in the midrange archive: [25]

Right-click on the line with the F-spec and select Show fields

#top

Refresh Cache for New Field

Original article(s) in the midrange archive: [26]

Select a FILE OBJECT, not source member. Right click and you should see Cache File Descriptions.

VERIFY (prompt)> Refresh Cache will also work.

#top

Work on a fix while keeping another project open

Original article(s) in the midrange archive: [27]

Open another window in the same workspace Window →New Window.

#top

Tracking Source changes

Original article(s) in the midrange archive: [28]

This option is only available for Offline Projects For normal projects this option does not show up.

A local history of a file is maintained by WDSCi.

The default settings allow you to save the last 50 versions of a file for at least seven days.

If you make a mistake and want to go back to an older version of a file, you don’t need to have a team environment installed.

You can use your local history feature.

To change the default setting for the local history feature, select Window→Preferences→Workbench→Local History.

To use this feature, right-click any file in the Navigator view and select Replace With →Local History.

The workbench shows you the list of available versions and the compare utility.

#top

Column Sensitive Editing

Original article(s) in the midrange archive: [29]

• Window→Preferences→Remote Systems→iSeries→Lpex Editor Parsers
• Check Column sensitive editing

There is a IBM mod. request to have this setting at the Parser level.

#top

Block Nesting

Original article(s) in the midrange archive: [30]

Indent View does not work for CLP, but Block Nesting works for RPG and CLP.

Position Cursor on the IF Right Click → Source→Show Block Nesting

(max 5 levels deep)

Crtl F5 to remove Nesting Marks

#top

View Source Side By Side

Original article(s) in the midrange archive: [31]

In RSE you can right click on the tab and drag it across until the cursor changes to a left pointing arrow and then the sources will appear side by side.

Right Click and drag back to restore.

#top

Refreshing the Project Perspective

Original article(s) in the midrange archive: [32]

Window→Open Perspective→Iseries Projects

To see the status of your local source versus the contents of the remote source members.

• In tab iSeries Project Navigator click 'menu' (upside-down triangle icon)
• 'menu'→Show Local/Remote Decorator
• 'menu'→Show→Remote Objects

To make iSeries Projects match the host source.

If you have local changes or new members you may want to save them first.

• right click on src→Remote Actions→Push Changes

To Refresh from host

• right click on src→Replace from Associated Library

or

In Remote Systems View (after you Delete the source in iSeries Projects)

• right click on src → Add to iSeries Project
• or right click on src → Make Available Offline

#top