RDi Remote System Explorer editor - IBM€¦ · – Basic editor features – Outline view and content assist – Editor customization ... Enter key behavior Tab key behavior. Rational

®

IBM Software Group

© 2009 IBM CorporationLast Update: 8/28/2009

Rational Developer for IBM i (RDi) Editing RPG source

Featuring: Basic editor functions, outline view, content assist and a lot more

Rational Developer for System i

© 2008 IBM Corporation2

Agenda

Remote System Explorer (RSE) Source Editing– Basic editor features– Outline view and content assist

– Editor customization with parsers

– More editor features

– Editor customization for keyboard and look and feel



Remote Systems LPEX Editor- Overview

LPEX* is designed to serve many different platforms and programming languages.

– Insert, delete, move, copy is implemented in the base LPEX

– Extend the base to add programming-language and system-specific functionality

– Done through parsers

– Different places for preferences

*LPEX - Live Parsing EXtensible Editor

IBM Software Group | Rational software

Remote System LPEX editor

RSE job on IBM i serverMember PAYROLL is locked

Library

RSE job with your profile

Source file

Member AMember BMember PAYROLL

Member DMember E

Double click on member or select Open With > Remote Systems LPEXEditorRSE checks for required authority and member locks

Prompted if either check failsMember is locked on i5/OS, downloaded and opened in editorChanges written back to remote member on saveLocks released when editor is closed

Or the RSE connection is disconnected

What happens during editing?RSE LPEX editorMember PAYROLL open



Remote Systems LPEX Editor

Editor and parsers– “LPEX Editor” provides basic editing

capabilities– Copy, paste, undo, redo, find / replace,

etc...– Not language specific

– “Parsers” provide language specific features– Color tokenizing, prompting, syntax

checking, content assist, etc...Two different preferences in workbench



Remote Systems LPEX Editor Best of Both Worlds

SEU look and feel-prefix commands-format bar

Modern Editor-Color tokenizing-Undo / redo-Highlight code with mouse and copy / paste



Editor featuresBasic editing

– Moving in the editor – of course there is always a mouse…– Press the Up, Down, Left, or Right arrows. – Press Home to move the cursor to the beginning of a line and End to

move it to the end of a line. – Press Ctrl + Left arrow to move the cursor one word left, or Ctrl + Right

arrow to move it one word right. – Press Page Up or Page Down to move the cursor up or down one window

at a time. – Press Ctrl + Up arrow to scroll the editor up one line without changing the

current line, or Ctrl + Down arrow to scroll the editor down one line. – Press Ctrl + Home to move the cursor to the beginning of the document,

or Ctrl + End to move it to the end of the document. – Press Ctrl + J to return the cursor to the place in the editor where you last

entered text. – Press Home and then Shift + Tab to position the cursor in the Prefix area.



Editor features (cont’d)– Undo /Redo

– Edit > Undo (Ctrl + Z)– Edit > Redo (Ctrl + Y) – You can undo even after saving the source – as long as you have

not closed the member– Location marks

– Edit > Mark > Name a Mark to set a mark – Edit > Find other > Find Mark to locate a mark– Ctrl + Q to se the quick mark / Alt + Q to return to set quick mark

– Keystroke recorder – Edit > Keystroke Recorder > Start– Edit > Keystroke Recorder > Stop– Edit > Keystroke Recorder > Playback

– Find and Replace– Edit > Find/Replace (Ctrl + F)

– Compare Function – Split screen

– Multiple source at the same time – Multiple views of the same editor



Editing multiple members, working with multiple views

In the RSE you can edit as many members as you like at once– Each editor opens up as a separate tab

Double click on editor tab maximizes editor within workbench window

Split screen editing of two or more members– Drag and drop editors to the left or right for vertical split screen editing of two (or

more) members – Drag and drop editors to the bottom for horizontal split screen editing

Split screen editing of the same member– Use the LPEX View > Open new view pop-up menu to open 2 views in the

same source member– Each view is editable– Open more than 2 if you want– Ctrl+2 to open a new view, Ctrl+0 (zero) to close the view



Three members, one split horizontally

along the bottom and two split vertically at

the top

Editing multiple members



One member with three editable views

Editing the same member in multiple views



Editing features

Copy/paste– Use the SEU prefix commands CC – CC / A

– or• Use the mouse to select • Copy to clipboard and paste CTRL- C and CTRL - V

– Careful where the cursor is positioned when pasting• Also available Block copy using Alt+R. (see next page)



Block copy

Use Alt+R to copy blocks

Tip: Need to upper/lower case some text?Select and use Uppercase or Lowercase selection



Agenda

Remote System Explorer (RSE) Source Editing– Basic editor features

– Outline view and content assist– Editor customization with parsers





Outline View

Refresh:This

populates Outline view

Click on entry to position to it

In the editor useCtrl+Shift+F5To refresh outline view



Outline View…. continued

Click on entry to position to it

FilesRecordformats

KeyfieldsFields (Type, length)

Where used:Read or Modified

Refresh To update with changes from your edit session





Click on entry to position to it in

the editor

Fields and IndicatorsWhere:

DefinedReadModified





Click on entry to position to it in

the editor

Subroutines and ProceduresWhere:

• Defined • Used

Prototype



Content AssistPosition cursor in the editor to area you need to edit.Use Ctrl+Space to invoke content assist

Available for RPG and COBOL

Don’t know your D spec keywordsNo problem use content assist

List of available choices

Select a choice in the list and get help for it



Content Assist … continued Position cursor in the editor to area you need to edit.Do you know which character it starts with to filter from all variables?Enter character and use Ctrl+Space to invoke content assist

Don’t know a variable name?No problem use content assist

List of available variables

Select a choice in the list and get its type defintion

Tip: Outline view needs to be populated for this to work



Agenda


– Outline view and content assist

– Editor customization with parsers– More editor features




Parsers for language sensitive editing For the common source member types, the correct parser is associated with it. Menu actions are added by the parserToolbar is updatedRight-click actions in the editor Customization per language parser

Menu and toolbar when no editor is open

Menu and toolbar with editor open for RPG member



Which parser is used for a file type Parsers need an association with a document type.There is a default parser association but you can change the default preferences



LPEX Editor Functions: Source Pull-Down Menu

Create new:procedureD-specJava method call

PromptSyntax checkProgram verifyShow indent viewShow fields of selected F-specOpen selected /copy memberResequence

The RPG parser adds certain actions to the source menu



Prompting for RPG

F4

Disable/EnablePrompter andSyntax checkingToggle insert/replace



Agenda


– Outline view

– Content assist

– RPG Language parsers

– More editor features– Editor customization



Indent View



Show block nesting

Source submenu from editor popup:

Show Block Nesting (ILE RPG, CL):

Position cursor at beginning of block

Editor draws block boundaries in editor margin, 5 levels max, Ctrl+Shift+O



Open subroutine/procedure declaration

Cursor jumps to BEGSR

For ILE RPG onlyPosition cursor at subroutine/procedure invocation and use

Editor popup Source Open Declaration

OrPress F3

Tip: Use ALT-Q quick mark to jump between 2 locations in the editor



Filtering predefined criteria

Right click in editor to filter

view

Only lines meeting filter

criteria are shown

Use + / - to expand or

collapse filtered sections



Filtering selected strings

•Select a string•Right click

• Selected Filter selection

Only lines meeting filter

criteria are shown

Use + / - to expand or

collapse filtered sections



Help – at your Fingertips

RPG, Cobol, DDS online referencesProgramming Guidesincluding CLF1 Help

Sensitive to where cursor is in the editor

Message Helpand much more



Editing Embedded SQL Automatic formatting of

SQL statements

Templates(predefined + add

your own)

Color tokenization

(customizable)



Agenda


– Outline view

– Content assist

– RPG Language parsers


– Editor customization



LPEX Preferences

Two sets of “LPEX”preferences:

1. LPEX Editor (generic editor preferences)

2. Remote Systems > Remote Systems LPEX

Editor



LPEX Editor Functions: Preferences

Language-specific editor preferences

Enable auto syntax checking

Enable auto uppercasing

Enter key behavior

Tab key behavior



SQL Formatting Settings



SQL Create/change templates



More customization Use workbench Preferences

– LPEX editor– Change look and feel – Change Keyboard shortcuts

– Modifying existing ones– Adding new ones



Sample look and feel changes

Tokens and current line are different colorsNo status, format, message or command line

Default tokens and current line colorsShow Status, format, message or command line

Default

Customized



Modify / Add keyboard shortcuts



View the keyboard shortcuts



LPEX editor keyboard shortcuts Take an example of changing the Enter key behaviorCheck if the IBM i parser has defined its behavior – example ILE RPG



Define through LPEX preferences


© 2008 IBM Corporation

Tip: Get list of existing keyboard shortcuts

Use CTRL – Shift - L



Existing Keyboard ShortcutsMany keys have default actions already defined by the editor. The Workbench also defines some keys with actions.

RSE Specific – Ctrl + Shift + A: open a member– In the Object Table view just start typing and a “Position To...” dialog will appear

General Workbench – F1: context sensitive help– Ctrl + F6: Switch between open editors– Ctrl + F7: Switch between open views– Ctrl + F8: Switch between open perspectives– Ctrl + M: toggles a view or editor between normal and maximized– Ctrl + E: displays list of open editors– Ctrl + F4: close open editor– Ctrl + . And Ctrl + ,: position to next / previous message within an editor

Standard Windows shortcut keys:– Use the arrow keys to navigate through tree and table views– In any list, just start typing and the an item that matches will be selected– Ctrl + S, Ctrl + Home, Ctrl + End, Tab

Tip: All of these can be customized using the Workbench > Keys preference pageWindow > Preferences > General > Keys



More existing Keyboard ShortcutsRemote Systems LPEX Editor (to list a few)

– Alt+J: Join the current line with the next line

– Alt+S: Split the line at the cursor position mF1: context sensitive help

– Ctrl+J: Return the cursor to the place in the editor where text was last entered

– Ctrl+L: Position the cursor to the line specified

– Ctrl+N: After a search, find the next occurrence of the string

– Ctrl+F5: Remove error messages, pending actions, and filtering

– Ctrl+Space: Invoke Content assist

– Ctrl+Shift+D: Find the date

– Ctrl+Shift+F5: Refresh Outline view

– Ctrl+Shift+S: Save contents of all open members



SummaryRemote System Explorer (RSE) LPEX Editor

– Much more than just a replacement for SEU – Features workstation tools for IBM i developer – Easily customizable for your working style – Gain productivity using:

• Application Diagram Viewer• Outline view• Content assist • Many more

Lots of resources available to get you started:– RPG Café with RDi hub

• www.ibm.com/software/rational/cafe/community/rpg/rdi– midrange mailing list

– http://lists.midrange.com/mailman/listinfo/wdsci-l– Webcasts and System i magazines– COMMON and IBM Power Technical Conferences– User group meetings



Trademarks & Disclaimers8 IBM Corporation 1994-2008. All rights reserved.References in this document to IBM products or services do not imply that IBM intends to make them available in every country.The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both:

Lotus, Freelance Graphics, and Word Pro are registered trademarks of Lotus Development Corporation and/or IBM Corporation.Domino is a trademark of Lotus Development Corporation and/or IBM Corporation.

C-bus is a trademark of Corollary, Inc. in the United States, other countries, or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. ActionMedia, LANDesk, MMX, Pentium and ProShare are trademarks of Intel Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries.SET and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC. Other company, product and service names may be trademarks or service marks of others.

Information is provided "AS IS" without warranty of any kind.

All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer.

Information in this presentation concerning non-IBM products was obtained from a supplier of these products, published announcement material, or other publicly available sources and does not constitute an endorsement of such products by IBM. Sources for non-IBM list prices and performance numbers are taken from publicly available information, including vendor announcements and vendor worldwide homepages. IBM has not tested these products and cannot confirm the accuracy of performance, capability, or any other claims related to non-IBM products. Questions on the capability of non-IBM products should be addressed to the supplier of those products.

All statements regarding IBM future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only. Contact your local IBM office or IBM authorized reseller for the full text of the specific Statement of Direction.

Some information in this presentation addresses anticipated future capabilities. Such information is not intended as a definitive statement of a commitment to specific levels of performance, function or delivery schedules with respect to any future products. Such commitments are only made in IBM product announcements. The information is presented here to communicate IBM's current investment and development activities as a good faith effort to help with our customers' future planning.

Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve throughput or performance improvements equivalent to the ratios stated here.

Photographs shown are of engineering prototypes. Changes may be incorporated in production models.

AS/400 IBM(logo) i5/OSAS/400e iSeriese (logo) business OS/400IBM System i

Documents

RDi Remote System Explorer editor - IBM€¦ · – Basic editor features – Outline view and content assist – Editor customization ... Enter key behavior Tab key behavior. Rational