HP OpenVMS Systems Documentation

Content starts here DECset

DECset

DIGITAL Language-Sensitive Editor/Source Code Analyzer for OpenVMS Reference Manual

Order Number: AA--QJERB--TK


November 1998

This manual describes the commands of the DIGITAL Language-Sensitive Editor for OpenVMS and DIGITAL Source Code Analyzer for OpenVMS, and provides other reference information.

Revision/Update information: This is a revised manual.

Operating System and Version: OpenVMS VAX, Version 6.2 or higher
OpenVMS Alpha, Version 6.2 or higher
DECwindows Motif, Versions 1.2-3 or higher

Software Version: DECset for OpenVMS, Version 12.3

DIGITAL Language-Sensitive Editor/
Source Code Analyzer for OpenVMS, Version 4.6



Digital Equipment Corporation Maynard, Massachusetts


First Printing, 1993 Revised, May 1995 Revised, November 1998

While DIGITAL or EDS believes the information included in this publication is correct as of the date of publication, it is subject to change without notice.

Possession, use, or copying of the software described in this documentation is authorized only pursuant to a valid written license from DIGITAL, an authorized sublicensor, or the identified licensor.

Digital Equipment Corporation or EDS makes no representations that the interconnection of its products in the manner described in this document will not infringe existing or future patent rights, nor do the descriptions contained in this document imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

© Electronic Data Systems Limited 1994, 1995, 1998.

© Digital Equipment Corporation 1993, 1995, 1998. All rights reserved.

The following are trademaeks of Digital Equipment Corporation: DECspell, DECset, DECwindows, DIGITAL, DIGITAL COBOL, DIGITAL Fortran, EDT, OpenVMS, VAX, VAX DOCUMENT, VMS, and the DIGITAL logo.

All other trademarks and registered trademarks are the property of their respective holders.

This document is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2n.

Contents Index


Preface

This manual contains reference material on the DIGITAL Language-Sensitive Editor for OpenVMS (SCA) and the DIGITAL Source Code Analyzer for OpenVMS (SCA). The LSE commands are in the VMSLSE format, and the SCA commands are in the VMS format. See the DIGITAL Language-Sensitive Editor Command-Line Interface and Callable Routines Reference Manual for information on the VMSLSE, VMS, and Portable command language syntaxes.

Intended Audience

This manual is for experienced programmers, technical writers, and technical managers.

Document Structure

This manual has a command dictionary and appendixes that contain reference information. The structure is as follows:

  • The Command Dictionary contains an alphabetical list of all the LSE and SCA commands that are available from command-line mode.
  • Appendix A provides information on writing your own DECTPU procedures.
  • Appendix B contains information of interest to DIGITAL Fortran and DIGITAL COBOL programmers.
  • Appendix C describes how to write your own DECTPU routines for use with the package facility.
  • Appendix D contains a list of the EVE commands with the corresponding LSE commands.
  • Appendix E contains a list of the Portable commands with their equivalent VMSLSE commands.
  • Appendix F contains information about using the OpenVMS Terminal Fallback Facility to translate double-angle brackets to single-angle brackets on 7-bit terminals.

Associated Documents

The following documents might also be helpful when using LSE and SCA:

  • See your installation guide for installation instructions for LSE and SCA.
  • The Guide to DIGITAL Language-Sensitive Editor for OpenVMS Systems contains tutorial information on using the DIGITAL Language-Sensitive Editor for OpenVMS.
  • The Guide to DIGITAL Source Code Analyzer for OpenVMS Systems contains tutorial information on using the DIGITAL Source Code Analyzer for OpenVMS.
  • The DIGITAL Language-Sensitive Editor Command-Line Interface and Callable Routines Reference Manual contains command-line interface and callable routine information for the DIGITAL Language-Sensitive Editor for OpenVMS.
  • The DIGITAL Source Code Analyzer Command-Line Interface and Callable Routines Reference Manual contains callable routine and query information for the DIGITAL Source Code Analyzer for OpenVMS.
  • The DIGITAL Text Processing Utility Reference Manual describes the DIGITAL Text Processing Utility features, including the high-level procedural language available for use with LSE.
  • Using DECset for OpenVMS Systems describes how to use the DECset products with other OpenVMS software development facilities to create an effective development environment.

References to Other Products

Some older products that DECset components previously worked with might no longer be available or supported by DIGITAL. Any reference in this manual to such products does not imply actual support, or that recent interoperability testing has been conducted with these products.

Note

These references serve only to provide examples to those who continue to use these products with DECset.

Refer to the Software Product Description for a current list of the products that the DECset components are warranted to interact with and support.

Conventions

Table 1 lists the conventions used in this guide.

Table 1 Conventions Used in This Guide
Convention Description
$ A dollar sign ($) represents the OpenVMS DCL system prompt.
[Return] In interactive examples, a label enclosed in a box indicates that you press a key on the terminal, for example, [Return].
Ctrl/ x The key combination Ctrl/ x indicates that you must press the key labeled Ctrl while you simultaneously press another key, for example, Ctrl/Y or Ctrl/Z.
KP n The phrase KP n indicates that you must press the key labeled with the number or character n on the numeric keypad, for example, KP3 or KP-.
file-spec, ... A horizontal ellipsis following a parameter, option, or value in syntax descriptions indicates additional parameters, options, or values you can enter.
... A horizontal ellipsis in a figure or example indicates that not all of the statements are shown.
.
.
.
A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being described.
() In format descriptions, if you choose more than one option, parentheses indicate that you must enclose the choices in parentheses.
[] In format descriptions, brackets indicate that whatever is enclosed is optional; you can select none, one, or all of the choices.
{} In format descriptions, braces surround a required choice of options; you must choose one of the options listed.
boldface text Boldface text represents the introduction of a new term.
monospaced boldface text Boldface, monospace text represents user input in interactive examples.
italic text Italic text represents book titles, parameters, arguments, and information that can vary in system messages (for example, Internal error number).
UPPERCASE Uppercase indicates the name of a command, routine, file, file protection code, or the abbreviation of a system privilege.
lowercase Lowercase in examples indicates that you are to substitute a word or value of your choice.
mouse The term mouse refers to any pointing device, such as a mouse, puck, or stylus.
MB1,MB2,MB3 MB1 indicates the left mouse button, MB2 indicates the middle mouse button, and MB3 indicates the right mouse button.


Command Dictionary

This dictionary describes all the commands for DIGITAL Language-Sensitive Editor (LSE) for OpenVMS, and Source Code Analyzer (SCA) for OpenVMS. Section 1 describes how to enter command mode from your editing session. Section 2 describes how to cancel commands and return to your editing session. Section 3 describes how to execute commands typed into a buffer. Section 4 groups LSE and SCA commands by function. The remainder of the dictionary contains the individual command descriptions.

Note that if a section, such as Qualifiers or Parameters, is not applicable to a specific command, the section does not appear under that command.

1 Executing Commands

As described in the related user guides, all the LSE and SCA commands described in this manual can be entered at the LSE command line. Invoke LSE (in either character-cell or DECwindows format) with the LSEDIT command at the OpenVMS prompt. You have the option of executing a single command and returning to keypad mode, or executing several commands without leaving command mode, as follows:
  • To execute only one command---Enter command mode by pressing the Do key, or use the PF1 and COMMAND (KP7) sequence. Type the command at the LSE Command> prompt and press the Return key. The command executes and LSE returns to keypad mode. In DECwindows only, you can also enter command mode by clicking MB1 below the status line.
  • To execute several commands---Enter command mode by pressing Ctrl/Z. Type the first command at the LSE> prompt and terminate the command string by pressing the Return key. You will still be at the LSE> prompt after the command executes. Press Ctrl/Z or enter the CONTINUE command to return to keypad mode.

LSE provides multiple command recall; by using the up and down arrow keys at the LSE> or LSE Command> prompt, you can recall any of the commands you entered during your current editing session.

LSE provides two command languages: VMSLSE (the commands described in this manual) and Portable. See the DIGITAL Language-Sensitive Editor Command-Line Interface and Callable Routines Reference Manual for information on setting your default command language and bypassing the default with individual commands.

Appendix E contains a translation table that lists VMSLSE equivalents to Portable commands.

Descriptions of Portable commands are available only in online Help. To get help on Portable commands, execute one of the following commands:

  • VMSLSE to Portable translation table


    
    LSE>  PLSE HELP VMSLSE_Command_translation_Table
    
    
  • Top-level Help for Portable commands


    
    LSE>  PLSE HELP
    
    

  • List of Portable commands with the same first word


    
    LSE>  PLSE HELP SET
    
    

    This example would generate a window containing a list similar to the following:


    
        SET ADJUSTMENT COMPRESS 
    
        SET ADJUSTMENT COUNT 
    
        SET ADJUSTMENT CURRENT 
    
        .
    
        .
    
        .
    
    

    Get Help by moving the cursor to the desired command and pressing the Return key.

2 Canceling Commands

To cancel a command, press Ctrl/Z in response to a prompt. For example, pressing Ctrl/Z in response to the Search for: prompt cancels the SEARCH command. Pressing Ctrl/Z in response to the LSE> or LSE Command> prompt returns you to keypad editing.

Pressing Ctrl/C while the REPEAT or DO/BUFFER command is executing terminates that command.

3 Commands in Buffers

You can execute commands that have been typed into a buffer. At the LSE> prompt, enter the DO command with the /BUFFER qualifier and supply the name of the buffer containing the commands you want (see the individual command descriptions for more information).

4 Command Categories

The following lists identify the related LSE and SCA commands and tasks. For information on a command, see its individual description in the Command Descriptions section of this manual.

4.1 Editing Session Control Commands

ATTACH REPEAT
CONTINUE SET DEFAULT_DIRECTORY
DCL SET FONT
DO SET JOURNALING
EXIT SET MAX_UNDO
GOTO COMMAND SET NOJOURNALING
QUIT SPAWN
RECALL  

4.2 Text Manipulation Commands

CANCEL SELECT_MARK QUOTE
CAPITALIZE WORD REDO
CENTER LINE SELECT ALL
CHANGE CASE SET AUTO_ERASE
CHANGE DIRECTION SET FORWARD
CHANGE INDENTATION SET INSERT
CHANGE TEXT_ENTRY_MODE SET NOAUTO_ERASE
CUT SET NOWRAP
ENTER LINE SET OVERSTRIKE
ENTER SPACE SET REVERSE
ENTER SPECIAL SET SELECT_MARK
ENTER TAB SET WRAP
ENTER TEXT SPELL
ERASE CHARACTER SUBSTITUTE
ERASE LINE TAB
ERASE PLACEHOLDER TOGGLE SELECT_MARK
ERASE SELECTION UNERASE
ERASE WORD UNEXPAND
EXPAND UNTAB
FILL UPPERCASE WORD
LOWERCASE WORD UNDO
PASTE  

4.3 Entering Source Code Commands

ENTER COMMENT SET LANGUAGE
ENTER PSEUDOCODE SET NOAUTO_ERASE
ERASE PLACEHOLDER SET NOLANGUAGE
EXPAND UNDO ENTER COMMENT
GOTO PLACEHOLDER UNERASE
SET AUTO_ERASE UNEXPAND

4.4 SCA Navigation Commands

EXPAND NEXT SYMBOL
GOTO SOURCE PREVIOUS OCCURRENCE
IMPORT PREVIOUS STEP
NEXT OCCURRENCE PREVIOUS SYMBOL
NEXT STEP UNEXPAND

4.5 SCA Library Commands

ANALYZE REORGANIZE
CONVERT LIBRARY SET LIBRARY
CREATE LIBRARY SET NOLIBRARY
DELETE LIBRARY SHOW LIBRARY
DELETE MODULE SHOW MODULE
EXTRACT MODULE VERIFY
LOAD  

4.6 SCA Query Commands

FIND INSPECT
GOTO DECLARATION  

4.7 Query Session Manipulation Commands

DELETE QUERY PREVIOUS QUERY
GOTO QUERY SHOW QUERY
NEXT QUERY  

4.8 Commands for Compiling Source Code and Reviewing Errors

COMPILE NEXT STEP
END REVIEW PREVIOUS ERROR
GOTO REVIEW PREVIOUS STEP
GOTO SOURCE REVIEW
NEXT ERROR  

4.9 Indenting Source Code Commands

ALIGN SET TAB_INCREMENT
CHANGE INDENTATION SET WRAP
ENTER TAB TAB
FILL UNTAB
SET INDENTATION  

4.10 Cursor Movement Commands

CANCEL MARK GOTO TOP
CHANGE DIRECTION GOTO WORD
GOTO BOTTOM LINE
GOTO MARK SET FORWARD
GOTO PAGE SET MARK
GOTO PLACEHOLDER SET REVERSE
GOTO SCREEN SET SEARCH
GOTO SOURCE  

4.11 Screen Manipulation Commands

CHANGE WINDOW_MODE OTHER WINDOW
DELETE WINDOW PREVIOUS WINDOW
ENLARGE WINDOW REFRESH
GOTO BUFFER SET SCREEN
GOTO FILE SET SCROLL_MARGINS
GOTO SCREEN SHIFT
GOTO SOURCE SHRINK WINDOW
NEXT WINDOW SPLIT WINDOW
ONE WINDOW TWO WINDOWS


Next Contents Index