HP OpenVMS Systems Documentation

Order Number: AA--QJERB--TK

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

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.

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.

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.

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

• 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.

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

4.7 Query Session Manipulation Commands