Rational Developer for System z

Interactive System Productivity Facility LPEX commands

The SCLM Developer Toolkit LPEX editor enables you to use the following Interactive System Productivity Facility (ISPF) commands in addition to those provided by the LPEX editor:

The behavior of these commands is similar to the behavior of the same commands in the ISPF editor. For detailed descriptions of the ISPF editor commands and string specification, please refer to the ISPF Edit and Edit Macros book. The commands within the LPEX editor provide a subset of the functions available in the ISPF editor.

Commands that accept strings generally accept the same formats that the ISPF commands accept. For example, quoted, character, text and picture strings are accepted. Additionally, regular expressions are accepted for as search strings by placing the regular expression in quotes preceded by an R. For example, FIND R'[0-9]{3}' will find strings containing three numbers. Hexadecimal specification is not accepted.

By default, the function keys are set as follows:

F5 Repeat Find
F6 Repeat Change
F7 Scroll Up
F8 Scroll Down
F10 Page Left
F11 Page Right

The highlighting of strings is done differently in LPEX than it is in ISPF. In ISPF, all instances of a found string are highlighted. In LPEX, only the current instance of the string is highlighted.

Labels also behave slightly differently within the LPEX editor because ISPF labels are not a native feature of the LPEX editor.

Multiple edit primary commands can be chained together by placing a semicolon between the commands. However, the semicolon must have a space before and after it.
Note: Before you can use ISPF commands in the LPEX editor you have to enable the ISPF editor profile. Refer to http://publib.boulder.ibm.com/infocenter/wdzinfo/v7r0/topic/com.ibm.lpex.doc.user/concepts/coverview.htm for detailed instructions.

The user profile name that enables the ISPF primary commands within the ISPF profile of LPEX is com.ibm.etools.team.sclm.bwb.lpex.ispfe.UserProfileISPFExtra. In most cases, this profile name is automatically set the first time you use the ISPF profile. However, if you have previously used the ISPF profile within LPEX and this user profile name was not already set, you might need to manually set the user profile name and restart the workbench in order to use the ISPF primary commands.

Table 1. ISPF commands supported by the SCLM Developer Toolkit LPEX editor
Name* Description Supported parameters
C Find and replace

{FIRST, LAST, NEXT, PREV, ALL}
{CHARS, WORD, SUFFIX, PREFIX }
{column numbers}
{label range}

F Find

{FIRST, LAST, NEXT, PREV, ALL}
{CHARS, WORD, SUFFIX, PREFIX }
{column numbers}
{label range}

X Exclude lines.

{FIRST, LAST, NEXT, PREV, ALL}
{CHARS, WORD, SUFFIX, PREFIX }
{column numbers}
{label range}

SORT Sort document lines.

{ A, D }
{ X, NX }
{column numbers}
{label range}

BOUNDS Set context boundary for commands. {column numbers}
RFIND Repeat the last find command. N/A
RCHANGE Repeat the last change command. N/A
FLIP Inverts the include/exclude status of each line in the document. Hidden lines become shown and vice versa. N/A
RESET Show excluded lines and remove the highlighting of found strings . { X, CHG, FIND }
DELETE Deletes lines in a specified range. { ALL, X, NX , label range }
* Many of these commands have aliases. For example:

FIND, F CHANGE, C EXCLUDE, X BOUNDS, BNDS RESET, RES DELETE, DEL


Feedback