HP DECforms Guide to Commands and Utilities

HP DECforms
Guide to Commands and Utilities
Order Number: AA–Q501C–TE
January 2006
HP DECforms is a software product for applications, services, and tools
that require a structured, forms-based, or menu-based user interface.
DECforms is the first commercial implementation of an ANSI/ISO standard
for forms-based interfaces, the CODASYL Form Interface Management
System (FIMS).
Revision/Update Information:
This is a revised manual.
Operating System:
OpenVMS Alpha Version 7.3-2 or later
OpenVMS I64 Version 8.2 or later
Software Version:
HP DECforms Version 4.0
Hewlett-Packard Company
Palo Alto, California
© Copyright 2006 Hewlett-Packard Development Company, L.P.
Confidential computer software. Valid license from HP required for possession, use, or copying.
Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government
under vendors standard commercial license.
The information contained herein is subject to change without notice. The only warranties
for HP products and services are set forth in the express warranty statements accompanying
such products and services. Nothing herein should be construed as constituting an additional
warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its
subsidiaries in the United States and other countries.
Oracle CDD, Oracle/Administrator, Oracle CDD/Repository, Oracle Rdb, and Oracle TRACE are
trademarks of Oracle Corporation.
Motif is a registered trademark of the Open Software Foundation, Inc.
ISO is a trademark of the International Organization for Standardization.
PostScript is a registered trademark of Adobe Systems, Incorporated.
Printed in the US
This document was prepared using VAX DOCUMENT Version 2.1.
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xiii
1 DECforms Commands
1.1
1.2
1.2.1
1.2.2
1.3
DCL Command Format . . . . . . . . . .
Error Messages . . . . . . . . . . . . . . . .
Message Format . . . . . . . . . . . . .
Correcting Errors . . . . . . . . . . . .
DCL Command Descriptions . . . . . .
FORMS BACK_TRANSLATE . . . . . .
FORMS CONVERT FMS . . . . . . . . .
FORMS DEVELOP . . . . . . . . . . . . .
FORMS EDIT . . . . . . . . . . . . . . . . .
FORMS EXTRACT APPEARANCES
FORMS EXTRACT OBJECT . . . . . .
FORMS TEST APPEARANCES . . . .
FORMS TRANSLATE . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1–1
1–2
1–2
1–3
1–3
1–4
1–6
1–8
1–13
1–16
1–18
1–21
1–23
Invoking the FDE . . . . . . . . . . . . . . . . . . . . . .
Specifying an Editor for IFDL Text Editing
Using the Main Menu . . . . . . . . . . . . . . . .
Using Function Keys . . . . . . . . . . . . . . . . .
Creating a New Form . . . . . . . . . . . . . . . .
Editing an Existing Form . . . . . . . . . . . . .
Using Main Menu Choices at the Form Level .
Specifying the Output Type . . . . . . . . . . . .
Changing the Form Name . . . . . . . . . . . . .
Editing IFDL Source Code . . . . . . . . . . . . .
Using Main Menu Choices at the Layout Level
Selecting a Layout . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2–2
2–3
2–3
2–5
2–5
2–6
2–6
2–6
2–7
2–7
2–10
2–10
2 Form Development Environment
2.1
2.1.1
2.1.2
2.1.3
2.1.4
2.1.5
2.2
2.2.1
2.2.2
2.2.3
2.3
2.3.1
iii
2.3.2
2.3.3
2.3.4
2.3.5
2.4
2.4.1
2.4.2
2.4.3
2.4.4
2.4.5
2.5
2.6
Creating a Layout . . . . . . . . . . . . . . . . . .
Changing Layout Attributes . . . . . . . . . .
Testing Your Form . . . . . . . . . . . . . . . . . .
Editing IFDL Source Code . . . . . . . . . . . .
Using Main Menu Choices at the Panel Level
Selecting a Panel . . . . . . . . . . . . . . . . . . .
Creating a Panel . . . . . . . . . . . . . . . . . . .
Changing Panel Attributes . . . . . . . . . . . .
Editing Panel Appearance . . . . . . . . . . . .
Editing IFDL Source Code . . . . . . . . . . . .
Exiting the FDE . . . . . . . . . . . . . . . . . . . . . . .
Recovering an FDE Session . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2–10
2–13
2–13
2–16
2–16
2–16
2–17
2–20
2–20
2–20
2–20
2–21
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3–2
3–3
3–3
3–4
3–5
3–5
3–5
3–6
3–6
3–8
3–8
3–9
3–11
3–12
3–12
3–13
3–14
3–15
3–15
3–16
3–17
3–18
3–18
3–19
3 Editing Panel Appearance Using the Character-Cell Panel
Editor (CCPED)
3.1
3.2
3.3
3.3.1
3.3.2
3.3.3
3.3.4
3.3.5
3.3.6
3.3.7
3.4
3.4.1
3.4.2
3.4.3
3.4.4
3.4.5
3.4.6
3.4.7
3.5
3.5.1
3.5.2
3.5.3
3.5.4
3.5.5
iv
Invoking and Exiting CCPED . . . . . . . . . . . . . . . . . . . . . . .
Recovering an Editing Session . . . . . . . . . . . . . . . . . . . . . . .
CCPED Screen Display . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Current Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Message Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Information Window . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using CCPED Commands and Keys . . . . . . . . . . . . . . . . . .
Entering Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Command Macros for Text Substitution . . . . . . . .
Using Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defining Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defining CCPED Function Keys . . . . . . . . . . . . . . . . . . .
Executing a Series of Commands in a Command Script .
Using the CCPED Default Keypad . . . . . . . . . . . . . . . . .
Creating and Editing the Appearance of Panels . . . . . . . . .
Moving the Cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the Repeat Key Function . . . . . . . . . . . . . . . . . . .
Creating, Deleting, and Restoring Viewports . . . . . . . . .
Creating, Deleting, and Restoring Panels . . . . . . . . . . .
Choosing Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Setting and Modifying Attributes . . . . . . . . . . . . . . . .
Setting Video Attributes . . . . . . . . . . . . . . . . . . . .
Modifying Video Attributes . . . . . . . . . . . . . . . . .
Modifying the Color of Display Attributes . . . . . .
Setting the Font Size . . . . . . . . . . . . . . . . . . . . . .
Modifying the Font Size . . . . . . . . . . . . . . . . . . . .
Setting Line Width . . . . . . . . . . . . . . . . . . . . . . . .
Modifying Line Width . . . . . . . . . . . . . . . . . . . . .
Specifying Display Attributes Based on Terminal
Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5.6.9
Setting the Character Set . . . . . . . . . . . . . . . . . .
3.5.6.10
Modifying the Character Set . . . . . . . . . . . . . . . .
3.5.6.11
Setting the Text Path . . . . . . . . . . . . . . . . . . . . . .
3.5.6.12
Modifying the Text Path . . . . . . . . . . . . . . . . . . . .
3.5.7
Creating and Deleting Objects . . . . . . . . . . . . . . . . . .
3.5.7.1
Creating and Editing Text Objects . . . . . . . . . . . .
3.5.7.2
Creating Graphic Objects . . . . . . . . . . . . . . . . . . .
3.5.7.3
Creating Icons . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5.7.4
Creating an Icon-Based Menu . . . . . . . . . . . . . . .
3.5.7.5
Creating Panel Fields . . . . . . . . . . . . . . . . . . . . .
3.5.7.6
Modifying Panel Field Descriptions and Pictures .
3.5.7.7
Creating Panel Groups . . . . . . . . . . . . . . . . . . . . .
3.5.7.8
Deleting and Restoring Panel Objects . . . . . . . . .
3.5.8
Manipulating Objects . . . . . . . . . . . . . . . . . . . . . . . . .
3.5.8.1
Selecting and Deselecting Objects . . . . . . . . . . . .
3.5.8.2
Selecting and Deselecting Compound Objects . . .
3.5.8.3
Moving Objects . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5.8.4
Using the Clipboard . . . . . . . . . . . . . . . . . . . . . . .
3.5.8.5
Changing the Order of Objects in a Panel . . . . . .
3.6
Checking Panel Appearance . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3–19
3–19
3–20
3–21
3–21
3–22
3–23
3–24
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3–25
3–27
3–28
3–28
3–29
3–29
3–30
3–30
3–31
3–31
3–32
3–34
3–35
3–36
3–36
3–36
3–37
3–38
3–38
3–40
3–41
Invoking and Exiting the Test Utility . . . . . . . . . . . . . . . . . . . . .
Testing Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navigating Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–1
4–2
4–3
3.5.6
3.5.6.1
3.5.6.2
3.5.6.3
3.5.6.4
3.5.6.5
3.5.6.6
3.5.6.7
3.5.6.8
4 Testing a Form
4.1
4.2
4.3
v
5 Translating IFDL Source Files and Form Files
5.1
Translating IFDL Source Files into Form Files . . . . .
5.1.1
Invoking the IFDL Translator . . . . . . . . . . . . . . .
5.1.2
IFDL Translator Output . . . . . . . . . . . . . . . . . . .
5.1.2.1
Form File . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.1.2.2
Listing File . . . . . . . . . . . . . . . . . . . . . . . . . .
5.1.2.3
DEC LSE Diagnostics File . . . . . . . . . . . . . . .
5.1.3
Avoiding Translation Errors . . . . . . . . . . . . . . . . .
5.1.4
Correcting Translation Errors . . . . . . . . . . . . . . .
5.2
Translating Form Files Back into IFDL Source Files .
5.2.1
Invoking the Back Translator . . . . . . . . . . . . . . .
5.2.2
Source File Differences after Back Translation . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5–1
5–1
5–2
5–2
5–3
5–4
5–4
5–5
5–6
5–6
5–6
Extracting Objects from a Form File . . . . . . . . . . . . . . . . . . . . . .
Extracting Panel Appearances from a Form File . . . . . . . . . . . . .
6–1
6–1
6 Extracting Objects and Appearances
6.1
6.2
A CCPED Keypad, Function Keys, and Definable Keys
A.1
A.2
A.3
CCPED Default Keypad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CCPED Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Names of Keys Definable in CCPED . . . . . . . . . . . . . . . . . . . . . .
A–1
A–6
A–6
B CCPED Commands
CENTER SELECTED OBJECTS . . . . . . . . . . . .
CHOOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
COPY FROM CLIPBOARD . . . . . . . . . . . . . . . .
COPY SELECTED OBJECTS TO CLIPBOARD
CREATE FIELD . . . . . . . . . . . . . . . . . . . . . . . . .
CREATE GROUP . . . . . . . . . . . . . . . . . . . . . . . .
CREATE ICON . . . . . . . . . . . . . . . . . . . . . . . . .
CREATE MARKED OBJECT . . . . . . . . . . . . . .
CREATE PANEL . . . . . . . . . . . . . . . . . . . . . . . .
CREATE POINT . . . . . . . . . . . . . . . . . . . . . . . .
CREATE POLYLINE . . . . . . . . . . . . . . . . . . . . .
CREATE RECTANGLE . . . . . . . . . . . . . . . . . . .
CREATE TEXT . . . . . . . . . . . . . . . . . . . . . . . . .
CREATE VIEWPORT . . . . . . . . . . . . . . . . . . . .
vi
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
B–2
B–3
B–5
B–6
B–7
B–9
B–12
B–13
B–14
B–15
B–16
B–17
B–18
B–19
DEFINE COLOR . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DEFINE KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DEFINE SYMBOL . . . . . . . . . . . . . . . . . . . . . . . . . . .
DELETE CHARACTER . . . . . . . . . . . . . . . . . . . . . . .
DELETE NAMED . . . . . . . . . . . . . . . . . . . . . . . . . . .
DELETE PANEL . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DELETE SELECTED OBJECTS . . . . . . . . . . . . . . . .
DELETE VIEWPORT . . . . . . . . . . . . . . . . . . . . . . . .
DESELECT ALL OBJECTS . . . . . . . . . . . . . . . . . . . .
DESELECT AREA . . . . . . . . . . . . . . . . . . . . . . . . . . .
DESELECT AT . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DESELECT LAST . . . . . . . . . . . . . . . . . . . . . . . . . . .
DESELECT MARKED AREA . . . . . . . . . . . . . . . . . .
DESELECT NAMED . . . . . . . . . . . . . . . . . . . . . . . . .
DISABLE BELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DISABLE ECHO . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DISABLE HINTS . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ENABLE BELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ENABLE ECHO . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ENABLE HINTS . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
GROUP SELECTED OBJECTS . . . . . . . . . . . . . . . . .
HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
INSERT FROM CLIPBOARD . . . . . . . . . . . . . . . . . .
LIST PANELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LIST VIEWPORTS . . . . . . . . . . . . . . . . . . . . . . . . . .
MARK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MODIFY FIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MODIFY GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MODIFY PANEL display-attribute COLOR . . . . . . . .
MODIFY PANEL TERMINAL WIDTH . . . . . . . . . . .
MODIFY PANEL VIEWPORT . . . . . . . . . . . . . . . . . .
MODIFY SELECTED display-attribute COLOR . . . .
MODIFY SELECTED OBJECTS CHARACTER SET
MODIFY SELECTED OBJECTS FONT SIZE . . . . . .
MODIFY SELECTED OBJECTS LINE WIDTH . . . .
MODIFY SELECTED OBJECTS TEXT PATH . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
B–20
B–22
B–24
B–25
B–26
B–27
B–28
B–29
B–30
B–31
B–32
B–33
B–34
B–35
B–36
B–37
B–38
B–39
B–40
B–41
B–42
B–43
B–44
B–45
B–46
B–47
B–48
B–49
B–51
B–52
B–54
B–55
B–56
B–57
B–59
B–61
B–63
vii
MODIFY SELECTED OBJECTS VIDEO . . . . . . . . .
MODIFY VIEWPORT display-attribute COLOR . . .
MODIFY VIEWPORT TERMINAL WIDTH . . . . . . .
MOVE CURRENT VIEWPORT . . . . . . . . . . . . . . . .
MOVE SELECTED OBJECTS . . . . . . . . . . . . . . . . .
MOVE VIEWPORT . . . . . . . . . . . . . . . . . . . . . . . . .
ORDER SELECTED OBJECTS . . . . . . . . . . . . . . . .
POSITION HORIZONTAL . . . . . . . . . . . . . . . . . . . .
POSITION NEXT . . . . . . . . . . . . . . . . . . . . . . . . . . .
POSITION PREVIOUS . . . . . . . . . . . . . . . . . . . . . .
POSITION TO . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
POSITION VERTICAL . . . . . . . . . . . . . . . . . . . . . .
QUIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RECALL MESSAGE . . . . . . . . . . . . . . . . . . . . . . . .
REFRESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
REMOVE SELECTED OBJECTS TO CLIPBOARD
RESIZE CURRENT VIEWPORT . . . . . . . . . . . . . . .
RESIZE VIEWPORT . . . . . . . . . . . . . . . . . . . . . . . .
ROTATE CLIPBOARD . . . . . . . . . . . . . . . . . . . . . . .
SELECT ALL OBJECTS . . . . . . . . . . . . . . . . . . . . .
SELECT AREA . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SELECT AT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SELECT MARKED AREA . . . . . . . . . . . . . . . . . . . .
SELECT NAMED . . . . . . . . . . . . . . . . . . . . . . . . . .
SET CHARACTER SET . . . . . . . . . . . . . . . . . . . . . .
SET display-attribute COLOR . . . . . . . . . . . . . . . . .
SET ENTRY MODE . . . . . . . . . . . . . . . . . . . . . . . . .
SET FONT SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . .
SET LINE WIDTH . . . . . . . . . . . . . . . . . . . . . . . . . .
SET ORIGIN MODE . . . . . . . . . . . . . . . . . . . . . . . .
SET TEXT PATH . . . . . . . . . . . . . . . . . . . . . . . . . . .
SET VIDEO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SHOW KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SHOW KEYPAD . . . . . . . . . . . . . . . . . . . . . . . . . . .
SHOW PANEL VIEWPORT . . . . . . . . . . . . . . . . . . .
SHOW POSITION . . . . . . . . . . . . . . . . . . . . . . . . . .
SHOW REFERENCES . . . . . . . . . . . . . . . . . . . . . . .
viii
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
B–64
B–66
B–68
B–69
B–70
B–72
B–73
B–74
B–75
B–76
B–77
B–78
B–79
B–80
B–81
B–82
B–83
B–84
B–85
B–86
B–87
B–88
B–89
B–90
B–91
B–93
B–94
B–95
B–96
B–97
B–98
B–99
B–101
B–102
B–103
B–104
B–105
SHOW SYMBOL . . . . . . . . . . . . . .
SHOW VERSION . . . . . . . . . . . . . .
TEST . . . . . . . . . . . . . . . . . . . . . . .
TOGGLE ENTRY MODE . . . . . . . .
UNDEFINE KEY . . . . . . . . . . . . . .
UNDELETE ALL . . . . . . . . . . . . . .
UNDELETE LAST . . . . . . . . . . . . .
UNDELETE PANEL . . . . . . . . . . .
UNDELETE VIEWPORT . . . . . . . .
UNGROUP SELECTED OBJECTS
UNMARK . . . . . . . . . . . . . . . . . . . .
VIEW CLIPBOARD . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
B–106
B–107
B–108
B–109
B–110
B–111
B–112
B–113
B–114
B–115
B–116
B–117
Invoking and Exiting DEC LSE . . . . . . . . . . . . . . . . . .
Entering Source Code Using Tokens and Placeholders .
Translating Source Code . . . . . . . . . . . . . . . . . . . . . . .
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VIEWPORT Definition . . . . . . . . . . . . . . . . . . . . . .
PANEL Declaration . . . . . . . . . . . . . . . . . . . . . . . .
DATA GROUP Declaration . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
C–1
C–2
C–4
C–5
C–6
C–8
C–12
IFDL Source for Attributes Based on Terminal Type . . . . . . .
3–26
FDE Main Menu . . . . . . . . . . . . . . .
DECTPU Help in the FDE . . . . . . . .
Creating a Layout in the FDE . . . . .
Specifying Screen Colors in the FDE
Testing a Form in the FDE . . . . . . .
Creating a Panel in the FDE . . . . . .
CCPED Screen Display . . . . . . . . . .
2–4
2–9
2–11
2–13
2–14
2–17
3–4
C Using DEC LSE with DECforms Software
C.1
C.2
C.3
C.4
C.4.1
C.4.2
C.4.3
Index
Examples
3–1
Figures
2–1
2–2
2–3
2–4
2–5
2–6
3–1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
ix
3–2
3–3
4–1
5–1
6–1
A–1
CCPED Menus and Submenus . . . . . . . . . . . . . . . . . . . . .
CCPED Information Window . . . . . . . . . . . . . . . . . . . . . .
Panel Displayed by the Test Utility . . . . . . . . . . . . . . . . .
Translating IFDL Source File to Binary Form File and
Back . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PRINTER Panel as Represented by Extract Appearances
CCPED Keypad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
...
...
...
3–6
3–7
4–3
...
...
...
5–2
6–3
A–2
Conventions Used in the Guide . . . . . . . . . . . . . . .
FDE Function Keys . . . . . . . . . . . . . . . . . . . . . . . .
CCPED Editing Keys . . . . . . . . . . . . . . . . . . . . . . .
CCPED Predefined Symbols . . . . . . . . . . . . . . . . . .
CCPED Keys for Cursor Positioning . . . . . . . . . . .
CCPED Clipboard Operations . . . . . . . . . . . . . . . .
Default Panel Navigation Functions . . . . . . . . . . .
CCPED Keypad Operations . . . . . . . . . . . . . . . . . .
CCPED Function Keys . . . . . . . . . . . . . . . . . . . . . .
CCPED Definable Keys . . . . . . . . . . . . . . . . . . . . .
DEC LSE Commands for Tokens and Placeholders
DEC LSE Commands for Examining Source Code .
.
.
.
.
.
.
.
.
.
.
.
.
Tables
1
2–1
3–1
3–2
3–3
3–4
4–1
A–1
A–2
A–3
C–1
C–2
x
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
xvi
2–5
3–9
3–13
3–16
3–39
4–3
A–3
A–6
A–7
C–3
C–5
Preface
This guide describes how to invoke and use the DECforms utilities needed to
develop and test forms.
Who Should Use This Guide
This guide is for programmers who design and develop forms to be used as
interfaces to applications.
You should know how to use the OpenVMS operating system and a text editor,
such as DECTPU or DEC LSE.
Structure of This Guide
This guide contains the following chapters and appendixes:
Chapter 1
Describes how to invoke each DECforms utility from the command
level.
Chapter 2
Explains how to use the Form Development Environment.
Chapter 3
Explains how to use the Character-Cell Panel Editor (CCPED) to
create panels to be used in character-cell layouts.
Chapter 4
Explains how to use the Test Utility to check the appearance of
panels and to test input fields in character-cell layouts.
Chapter 5
Explains how to use the IFDL Translator and Back Translator to
translate IFDL source files and form files.
Chapter 6
Explains how to use the Extract Objects Utility to create object
modules, and how to use the Extract Appearances Utility to create a
printable file showing the appearance of panels in character-cell or
PRINTER layouts.
Appendix A
Contains a diagram and summary of the default CCPED keypad, a
list of CCPED function keys, and a list of key names available for
definition with the CCPED DEFINE KEY command.
Appendix B
Provides detailed descriptions of the CCPED commands.
xiii
Appendix C
Describes how to the use the DEC Language Sensitive Editor (DEC
LSE) with DECforms software.
For More Information
See the online help, the online release notes, and the following documents for
more information about DECforms:
•
HP DECforms Installation Guide for OpenVMS Systems—Describes how to
install DECforms software on processors that are running the OpenVMS
operating system.
•
HP DECforms IFDL Reference Manual—Describes the syntax of the
DECforms Independent Form Description Language.
•
HP DECforms Style Guide for Character-Cell Devices—Describes how
to develop user interfaces for DECforms applications for character-cell
terminals.
•
HP DECforms Programmer’s Reference Manual—Describes how DECforms
software operates at run time and how to call the DECforms requests from
an application program.
•
HP DECforms Guide to Developing an Application—Part I explains to the
beginning DECforms programmer how to create a DECforms application,
including both the form and the program. Part II contains additional
guidelines and examples for more experienced DECforms programmers.
•
HP DECforms Guide to Demonstration Forms and Applications—
Describes how to use various demonstration forms and applications.
This guide is contained in online files named forms$demo_guide.txt and
forms$demo_guide.ps in the FORMS$EXAMPLES directory on OpenVMS
systems. If you cannot find this document, ask your system manager to
install it in the appropriate directory.
For information about displaying these forms, see the HP DECforms Guide
to Developing an Application.
•
HP DECforms Guide to Converting FMS Applications—Describes how to
convert a VAX FMS or DEC FMS application to a DECforms application.
For further information on other topics covered in this guide, see the following:
xiv
•
DEC LSE documentation for information on how to use DEC LSE
•
Oracle CDD/Repository documentation set for information on Oracle
CDD/Repository definitions
•
ISO IS 11730:1994 for information on the standard of which DECforms is
an implementation (see the Acknowledgment section)
Reader’s Comments
HP welcomes your comments on this manual or any of the DECforms. Please
send comments to either of the following addresses:
Internet
openvmsdoc@hp.com
Mail
Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698
How To Order Additional Documentation
For information about how to order additional documentation and for online
versions of most DECforms, visit the following World Wide Web address:
http://www.hp.com/go/openvms/doc/
xv
Conventions
Table 1 lists the conventions used in this guide:
Table 1 Conventions Used in the Guide
Symbol or Term
Meaning
layouts
When discussing layouts, the folllowing terms are
used:
character-cell — to refer to layouts that
display forms on character-cell devices
PRINTER—to refer to layouts that output
forms for quality printing
Alt
The Alt key. This key is labeled Compose Character
on some keyboards.
Ctrl/x
In procedures, a sequence such as Ctrl/x indicates
that you must hold down the key labeled Ctrl while
you press another key.
KPn
Key names that begin with KP indicate keys on the
numeric keypad on the right side of the terminal
keyboard. For example, KP4 and KP. are keys on
the numeric keypad.
PF1-x
A sequence such as PF1-x indicates that you must
first press and release the key labeled PF1, and
then press and release another key.
Shift+PF3
A sequence such as Shift+PF3 indicates that you
must hold down the Shift key while pressing
another key.
...
In examples, a horizontal ellipsis indicates one of
the following possibilities:
•
Additional optional arguments in a statement
have been omitted.
•
The preceding item or items can be repeated
one or more times.
•
Additional parameters, values, or other
information can be entered.
(continued on next page)
xvi
Table 1 (Cont.) Conventions Used in the Guide
Symbol or Term
.
.
.
Meaning
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 discussed.
()
In format descriptions, parentheses indicate that if
you choose more than one option, 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.
$ user input
Bold in examples shows user input in the hardcopy
version of this manual.
Bold
Boldface text indicates a new term that is defined
in the master glossary.
$
The dollar sign is used to indicate the user prompt
on OpenVMS systems.
Unless otherwise specified, you terminate commands by pressing the Return
key.
Send Us Your Comments
We welcome your comments on this or any other DECforms manual. If you
have suggestions for improving a particular section or find any errors, please
indicate the chapter, section, and page number (if available). We also welcome
more general comments. Your input is valuable in improving future releases of
our documentation.
You can send comments to us at the following Internet address:
forms_docs@zko.dec.com
If you have a customer support contract and have comments or questions
about DECforms software, contact the HP Customer Support Center (CSC),
preferably using electronic means such as DSNlink. In the United States,
customers can call the CSC at 1-800-354-9000.
xvii
Acknowledgment
DECforms is the HP implementation of a Form Interface Management System
(FIMS) ANSI/ISO standard prepared by the CODASYL Form Interface
Management System Committee and ISO/IEC JTC1/SC22 Working Group 18.
The FIMS standard is documented in ISO IS 11730:1994 and can be purchased
from the International Organization for Standardization or the American
National Standards Institute.
xviii
1
DECforms Commands
This chapter describes how to start the DECforms utilities from the system
command line, including how to interpret and correct error messages
encountered while using the utilities.
The commands are listed in alphabetical order.
1.1 DCL Command Format
The general format of a DCL command used to invoke DECforms utilities is:
FORMS FUNCTION [/QUALIFIER...] [input-file-spec]
A DECforms command consists of the word forms followed by a parameter
(or parameters) that indicates which function of DECforms software is to be
executed.
Qualifiers have the same meaning whether they follow the function parameter
or the input file specification. For example, the following command lines are
equivalent:
$ FORMS TRANSLATE /LIST TAX_FORM.IFDL
$ FORMS TRANSLATE TAX_FORM.IFDL /LIST
You must place qualifiers after the function parameter; do not place them after
the word FORMS. Spaces or tabs preceding a qualifier are optional.
You can abbreviate any element of a DECforms command line, providing that
its abbreviation is unique. (You can abbreviate FORMS only to FORM; FOR is
not an unique abbreviation because it conflicts with the FORTRAN command.)
If you do not specify a required element on the command line, DCL prompts
you for it.
DECforms Commands 1–1
1.2 Error Messages
Explanations and user actions for DECforms error messages are described in
the online help. To find an error message, enter a command in the following
format:
$ HELP FORMS ERRORS MESSAGE-IDENT
Message-ident (for example, WRITEFORM) is the abbreviation of the message
that appears in the message format. For information on the format of error
messages, see Section 1.2.1.
To create a file containing the error messages, enter the following command:
$ HELP/OUTPUT=FORMS_ERRORS.LIS FORMS ERRORS *
This command creates a file called forms_errors.lis that contains all the
information under the ERRORS help topic. You can substitute another file
name for forms_errors.lis. You can then print the file.
1.2.1 Message Format
DECforms error messages have the following general format:
%FORMS-L-IDENT, Message text.
The facility abbreviation, FORMS, indicates that a DECforms component
issued the message. L indicates the severity level of the message, which can be
one of the following:
S
Success message. Indicates the operation that generated the message was
completed.
I
Informational message. Either gives information about an operation being
performed or gives further information when an error occurred.
W
Warning message. Indicates that the command might have performed some,
but not all, of the operation, and that you might have to verify the command
or component output.
E
Error message. Indicates that an error occurred during processing. The
operation that generated the message may continue if the component
performing the operation can recover from the error.
F
Fatal error message. Indicates that the component cannot continue the
operation.
The IDENT in the general format of messages is an abbreviation of the
message (for example, CDDDIMFIE). You access messages in online help by
using this abbreviation on the help command line.
1–2 DECforms Commands
1.2.2 Correcting Errors
The message text that appears in DECforms messages describes the problem
that caused the message. You should be able to read this message text to
identify the problem. Also, you can use online help to get an explanation and
user action for each message.
If eligible, you can call your Customer Support Center for help. The DECforms
specialists at these centers can provide you with examples and suggestions
for your particular application, as well as workarounds for problems you may
encounter.
1.3 DCL Command Descriptions
This section contains descriptions of all the DECforms DCL commands,
organized alphabetically by function name. Each command description
contains the following:
•
Overview of the command function
•
Format, including a list of command qualifiers and defaults
•
Descriptions of the required and optional parameters
•
Description of each qualifier
•
Command-line examples
DECforms Commands 1–3
FORMS BACK_TRANSLATE
FORMS BACK_TRANSLATE
Invokes the Back Translator to create an IFDL source file from a form file. For
further information on the Back Translator, see Chapter 5.
Format
FORMS BACK_TRANSLATE input-file-spec
Qualifiers
Defaults
/[NO]LOG
/OUTPUT[=file-spec]
/[NO]SHOW=[no]copy
/NOLOG
/OUTPUT
/SHOW=nocopy
Parameter
input-file-spec
The name of the form file to be translated to an IFDL source file. The default
file type is .form. The Back Translator can accept an incomplete form as
input.
Qualifiers
/LOG
/NOLOG
Controls whether a message is displayed upon completion of the operation.
Error messages, if any, are displayed regardless of whether you specified /LOG
or /NOLOG.
The default is /NOLOG.
/OUTPUT[=file-spec]
Specifies a name for the IFDL source file produced by the Back Translator. If
you omit the file specification, the output file has the same name as the input
file, with a file type of .ifdl.
/SHOW=[no]copy
/NOSHOW
Specifies how COPY FROM DICTIONARY statements are translated. If you
specify /NOSHOW or /SHOW=nocopy, or if you do not specify this qualifier,
the COPY FROM DICTIONARY statement is translated as it appeared in the
original IFDL source file. If you specify /SHOW=copy, the expanded definitions
resulting from the Oracle CDD/Repository extraction are also included as a
comment in the IFDL source file produced by the Back Translator.
1–4 DECforms Commands
FORMS BACK_TRANSLATE
The default is /SHOW=nocopy.
Examples
1.
$ FORMS BACK_TRANSLATE PAYROLL
Translates the form file payroll.form to an IFDL source file named
payroll.ifdl. No success message is displayed when the translation is
complete.
2.
$ FORMS BACK_TRANSLATE/OUTPUT=NOW_ACCOUNT CHECKING_ACCOUNT
Translates the form file checking_account.form to an IFDL source file
named now_account.ifdl.
DECforms Commands 1–5
FORMS CONVERT FMS
FORMS CONVERT FMS
Converts a DEC FMS form file or form library file to a DECforms IFDL source
file. For more information on converting FMS forms, see the HP DECforms
Guide to Converting FMS Applications. This feature is supported only on
Alpha platforms.
Format
FORMS CONVERT FMS input-file-spec
Qualifiers
Defaults
/[NO]LOG
/OUTPUT[=file-spec]
/NOLOG
/OUTPUT
Parameter
input-file-spec
The name of the FMS form file or form library to be converted. The default file
type is .frm.
Qualifiers
/LOG
/NOLOG
Controls whether an informational message is displayed upon completion of
the conversion. Error messages, if any, are displayed regardless of whether you
specified /LOG or /NOLOG.
The default is /NOLOG.
/OUTPUT[=file-spec]
Specifies a name for the IFDL source file output by the FMS Converter. If you
omit the file specification, the output file has the same name as the input file,
with a file type of .ifdl.
Examples
1.
$ FORMS CONVERT FMS PAYROLL
Converts the FMS form file payroll.frm to an IFDL source file named
payroll.ifdl.
1–6 DECforms Commands
FORMS CONVERT FMS
2.
$ FORMS CONVERT FMS/OUTPUT=NEW_EQUIPMENT EQUIPMENT.FLB
Converts the FMS form library equipment.flb to an IFDL source file
named new_equipment.ifdl.
DECforms Commands 1–7
FORMS DEVELOP
FORMS DEVELOP
Invokes the Form Development Environment (FDE) to create or modify a form
file. For further information on the FDE, see Chapter 2.
Format
FORMS DEVELOP input-file-spec
Qualifiers
Defaults
/[NO]CHECKPOINT[=file-spec]
/[NO]COMMAND[=(script[,...])]
/[NO]DEPENDENCY_DATA
/[NO]INCLUDE=(pathname[,...])
/LAYOUT=layout-name
/[NO]LOG
/[NO]OUTPUT[=(ifdl[=file-spec],form[=file-spec])]
/PANEL=panel-name
/[NO]RECOVER
/TEXT_EDITOR={lse | tpu | "edit command"}
/CHECKPOINT
/COMMAND
/NODEPENDENCY_DATA
/NOINCLUDE
See description
/LOG
/OUTPUT=(ifdl,form)
See description
/NORECOVER
/TEXT_EDITOR=tpu
Parameter
input-file-spec
The name of the form file that you are creating or modifying. If you do not
specify a file type, the FDE looks first for a form file and then for an IFDL
source file. (The FDE looks at the contents of the file to determine what kind
it is; it does not go by the file type.) If neither a form file nor an IFDL source
file exists, the FDE creates a new form with the name you specified.
The input file parameter is required; however, the file does not have to exist.
The FDE can accept an incomplete form as input.
Qualifiers
/CHECKPOINT[=file-spec]
/NOCHECKPOINT
Enables checkpointing. Checkpointing saves the known state of a form, so the
form can be restored to that state following a system failure. Checkpointing
protects your work when a session ends abnormally for some reason (for
example, if you press Ctrl/Y or if there is a system failure).
1–8 DECforms Commands
FORMS DEVELOP
When checkpointing is enabled, the form is written to a checkpoint file every
time you make a change and return to the Main Menu. Each time a checkpoint
file is written, the previous checkpoint file is deleted. When you exit from the
FDE, the latest version of the checkpoint file is deleted and the output file (or
files) is created. If you select the Main Menu option Quit, the checkpoint file is
deleted and no output files are created.
You can designate a file specification other than the default for the checkpoint
file. By default, the checkpoint information is written to a file that has the
same name as the input file with a file type of .forms$checkpoint in the same
directory as the input file. The checkpoint file name is also passed to the
Character-Cell Panel Editor (CCPED), as though you had entered the FORMS
EDIT/JOURNAL=filename command. Specifying /CHECKPOINT implies the
use of FORMS EDIT/JOURNAL when you edit a panel’s appearance from the
FDE.
The default is /CHECKPOINT.
/COMMAND[=(script[,...])]
/NOCOMMAND
Specifies a list of command scripts to pass to the Character-Cell Panel Editor.
For more information, see the description of the /COMMAND qualifier under
the FORMS EDIT COMMAND.
The default is /COMMAND.
/DEPENDENCY_DATA
/NODEPENDENCY_DATA
Specifies that the IFDL Translator creates dependency relationships for COPY
FROM DICTIONARY statements in the IFDL source file. The dependency
relationships relate the form to the data definitions that are extracted from
Oracle CDD/Repository using a video display Oracle CDD/Repository object
that the IFDL Translator creates in CDD$DEFAULT.
When you specify /NODEPENDENCY_DATA, COPY FROM DICTIONARY
statements cause the IFDL Translator to copy information from Oracle
CDD/Repository, but the IFDL Translator does not create any dependency
relationships.
This qualifier affects the translation that is performed when you use DECTPU
or DEC LSE from the Form Development Environment.
The default is /NODEPENDENCY_DATA.
DECforms Commands 1–9
FORMS DEVELOP
/INCLUDE=(pathname[,...])
/NOINCLUDE
Specifies an additional level of search for an .ifdl file specification in a COPY
statement. Each path name argument can be either a logical name or a legal
directory specification. The search order is the directory containing the source
file, followed by the directory specified in the qualifier.
This option is passed to the FORMS TRANSLATE command when the IFDL
Translator is used.
The default is /NOINCLUDE.
/LAYOUT=layout-name
Specifies which character-cell layout in the form is selected for editing. If you
use this qualifier, you must specify the character-cell layout name. If you do
not use this qualifier, the FDE chooses the first character-cell layout in the
form that contains all the specified panels.
If you specify a PRINTER layout, DECforms displays a message saying that
editing of those layouts is not supported.
/LOG
/NOLOG
Controls whether a message is displayed upon successful completion of the
FDE session.
The default is /LOG.
/OUTPUT[=(ifdl[=file-spec],form[=file-spec])]
/NOOUTPUT
Specifies the name and type of the output files. If you omit this qualifier or
specify it without any keywords, the FDE produces an IFDL source file and a
form file, each having the name of the input file with file types of .ifdl and
.form, respectively.
You can use the keywords IFDL and FORM to specify the type of output file the
FDE will produce. You can specify both keywords if you want an IFDL source
file and a form file. If you specify both, separate them with a comma and
enclose them in parentheses. You also can provide complete file specifications
with these keywords. If you specify a file name but not a file type, the output
file has that file name and a type of .ifdl or .form, depending on the keyword
you specified.
You also can use the File option on the Main Menu to specify output to a file
from within the FDE. For more information, see Chapter 2.
1–10 DECforms Commands
FORMS DEVELOP
/PANEL=panel-name
Specifies which panel in the form to edit initially. If you use this qualifier,
you must specify the panel name, and that panel must exist; you cannot use
this qualifier to create a new panel. If you do not use this qualifier, the FDE
chooses the first panel in the chosen layout as the current initial panel.
/RECOVER
/NORECOVER
Recovers a previously aborted editing session from the checkpoint file specified
with the /CHECKPOINT qualifier.
If an FDE checkpoint file and a panel editor journal file exist, and the creation
date of the panel editor journal file is later than that of the FDE checkpoint
file, the FDE recovers the checkpoint file first, and then recovers the panel
editor journal file.
The default is /NORECOVER.
/TEXT_EDITOR={lse | tpu | "edit command"}
Specifies which editor the FDE should use when it activates a text editor. LSE
specifies that the FDE activates the DEC Language-Sensitive Editor. TPU
specifies that the FDE activates DECTPU. To use another editor, specify the
edit command in quotes, as you would at DCL level.
Use ’P1’ in the command as a placeholder for the name of the file you are
editing. If your editor supports a starting line position (where the cursor can
start on a line in the file other than line 1), you can include that syntax in your
edit command by using ’P2’ to specify the line number.
You also can define a logical name, FORMS$TEXT_EDITOR, to call DEC LSE
automatically when the FDE is invoked, as follows:
$ DEFINE FORMS$TEXT_EDITOR CALLABLE_LSE
The default is /TEXT_EDITOR=tpu.
Examples
1.
$ FORMS DEVELOP/TEXT_EDITOR=LSE PERSONNEL
Invokes the FDE to edit the form file personnel.form and specifies
the Language-Sensitive Editor as the text editor. Two output files are
created: a form file called personnel.form and an IFDL source file called
personnel.ifdl.
DECforms Commands 1–11
FORMS DEVELOP
2.
$ FORMS DEVELOP/TEXT_EDITOR="MY_EDITOR/STARTING_POSITION=’P2’ _$ ’P1’ " MYFORM
Invokes the FDE to edit the form file myform.form using the editor you
specify. The parameter p2 is the symbol for the starting position, and p1
represents the output file. Two output files are created: a form file called
myform.form and an IFDL source file called myform.ifdl.
3.
$ FORMS DEVELOP/OUTPUT=IFDL ACCOUNT.FORM /LAYOUT=ANSI_TERM/PANEL=ADDRESS
Invokes the FDE to edit the panel labeled address in the layout labeled
ansi_term in the form file account.form. The output is an IFDL source
file called account.ifdl. No form file will be produced.
4.
$ FORMS DEVELOP/OUTPUT=(IFDL,FORM=NEW_INVENTORY) INVENTORY
Invokes the FDE to edit the form file inventory. The output is
an IFDL source file called inventory.ifdl and a form file called
new_inventory.form.
5.
$ FORMS DEVELOP/OUTPUT=FORM=STOCK.MYFORM CURRENT_STOCK.FORM
Invokes the FDE to edit the form file current_stock.form. The output is
a form file called stock.myform. No IFDL source file is produced.
1–12 DECforms Commands
FORMS EDIT
FORMS EDIT
Invokes one of the panel editors to create or modify the size and appearance of
a form’s panels and viewports. For further information on the Character-Cell
Panel Editor (CCPED) see Chapter 3.
Format
FORMS EDIT input-file-spec
Qualifiers
Defaults
/[NO]COMMAND[=(script[,...])]
/[NO]JOURNAL[=file-spec]
/LAYOUT=layout-name
/[NO]LOG
/OUTPUT[=file-spec]
/PANEL=panel-name
/[NO]RECOVER
/COMMAND
/JOURNAL
See description
/LOG
/output
See description
/NORECOVER
Parameter
input-file-spec
The name of the form file to be edited. This parameter is required, and the
form file must exist. The default file type is .form. The panel editor can
accept an incomplete form as input.
Qualifiers
/COMMAND[=(script[,...])]
/NOCOMMAND
Specifies whether or not an initialization script (or list of scripts) of CCPED
commands is to be executed during startup procedures. For information on
creating and using CCPED command scripts, see Chapter 3.
When you specify /COMMAND, you can provide an initialization file name or a
list of initialization file names. These file specifications can be logical names.
If the execution of initialization scripts is not disabled explicitly by
means of the /NOCOMMAND qualifier, a script file with the logical name
FORMS$EDIT_INIT is added implicitly to the beginning of the script list. All
files, except FORMS$EDIT_INIT, must exist.
If you also specify the /RECOVER qualifier, the /COMMAND qualifier is
ignored because the commands in the initialization scripts are recorded in the
journal file.
DECforms Commands 1–13
FORMS EDIT
The default is /COMMAND. The default file type for script files is .com.
/JOURNAL[=file-spec]
/NOJOURNAL
Specifies whether the editing session is to be journaled. You can specify a
name for the journal file. If you omit the file specification, the journal file has
the same name as the input file, with a file type of .forms$journal.
The default is /JOURNAL.
If an attempt to write to the journal file fails during journaling, system
displays a warning box with a ‘‘An attempt to write to the journal file has
failed. No more journaling will be attempted, but you can continue the editing
session’’ message. This type of failure can occur because of system problems;
for example, you have run out of disk space or the disk mount is dropped by
the network or the file server.
/LAYOUT=layout-name
Specifies a layout in which the panel editor searches for the initial panel to be
edited. Use this qualifier when you want to edit panels in a particular layout.
When you use /LAYOUT, you must specify a layout name.
/LOG
/NOLOG
Controls whether a message is displayed upon completion of the editing
session.
The default is /LOG.
/OUTPUT[=file-spec]
Specifies a name for the form file output by the panel editor. If you omit the
file specification, the output file has the same name as the input file.
The default file type is .form.
/PANEL=panel-name
Specifies the initial panel to be edited. If you are using CCPED and do not use
/PANEL, the panel editor chooses the first panel found in the form, or in the
specified layout if you used /LAYOUT. If there are no panels in the layout, the
current panel is undefined. In this case, the panel editor displays the message
‘‘No Current Panel’’ in the status line and issues the Command> prompt. You
must create a panel before you can perform any other panel editor operations.
You can use the CREATE PANEL command to create a panel.
1–14 DECforms Commands
FORMS EDIT
/RECOVER
/NORECOVER
Recovers a previously aborted editing session from the journal file specified
with the /JOURNAL qualifier.
If both /RECOVER and /JOURNAL are specified, PED recovers using the file
specified by the /JOURNAL qualifier. If the specified journal file does not exist,
PED exits with a ‘‘Can’t locate specified journal file’’ message.
If /RECOVER is specified but /JOURNAL is not, PED recovers using a journal
file in your current working directory with the name of the form file and a file
type of .forms$journal. If there is no journal file in your current working
directory, PED exits with a ‘‘Can’t locate specified journal file’’ message.
The default is /NORECOVER for CCPED.
Examples
1.
$ FORMS EDIT/LAYOUT=COLOR_TERMINALS ACCOUNT
Invokes CCPED to edit the first panel in the layout color_terminals in the
form file account.form.
2.
$ FORMS EDIT/PANEL=STATEMENT_PANEL/LAYOUT=ANSI_TERM CHECKBOOK
Invokes CCPED to edit the panel labeled statement_panel in the layout
labeled ansi_term in the form file checkbook.form.
3.
$ FORMS EDIT PERSONNEL/COMMAND=(MOE,LARRY,CURLY)
Invokes CCPED to edit the first panel in the form file personnel.form, and
executes the initialization scripts moe.com, larry.com, and curly.com.
DECforms Commands 1–15
FORMS EXTRACT APPEARANCES
FORMS EXTRACT APPEARANCES
Invokes the Extract Appearances Utility to create a file containing printable
representations of panels in a character-cell or PRINTER layout. For further
information on the Extract Appearances Utility, see Chapter 6.
Format
FORMS EXTRACT APPEARANCES input-file-spec
Qualifiers
Defaults
/LAYOUT=layout-name
/[NO]LOG
/OUTPUT[=file-spec]
/PANEL[=(name[,...])]
/SHOW={data | picture}
See description
/NOLOG
/OUTPUT
See description
/SHOW=data
Parameter
input-file-spec
The name of the form file containing the panels you want to print. The
default file type is .form.
Qualifiers
/LAYOUT=layout-name
Specifies a character-cell or PRINTER layout in which the Extract
Appearances Utility searches for panels to extract. When you use
/LAYOUT, you must specify a layout name.
If you do not use /LAYOUT, the Extract Appearances Utility’s search for
a specified or default panel is limited to the first layout that contains all
specified panels.
/LOG
/NOLOG
Controls whether success messages are displayed on the default output
device. Error messages, if any, are displayed regardless of whether you
specified /LOG or /NOLOG.
The default is /NOLOG.
1–16 DECforms Commands
FORMS EDIT
/OUTPUT[=file-spec]
Specifies a name for the output file. If you omit the file specification, the
output file has the same name as the input file, with a file type of .txt.
The default is /OUTPUT.
/PANEL[=(name[,...])]
Specifies the panel or panels to be extracted from a particular layout. You
cannot specify panels on different layouts.
If you use /PANEL, and you have not specified /LAYOUT, all panels in the
first layout containing the specified panels are extracted. If you do not use
/PANEL, and you have not specified /LAYOUT, all panels in the first layout
are extracted.
/SHOW={data | picture}
Specifies whether initial values or text literals should appear in fields in
extracted panels. The /SHOW=data qualifier shows fields with their initial
values. The /SHOW=picture qualifier shows fields with picture strings as
they appear in the panel editor.
The default is /SHOW=data.
4.
$ FORMS EXTRACT APPEARANCES PERSONNEL_DATA
Creates a printable file called personnel_data.txt from the form file
personnel_data.form. This file contains printable representations of all
the panels in the form.
5.
$ FORMS EXTRACT APPEARANCES EQUIPMENT/LAYOUT=ANSI_$ /PANEL=(NEW_EQUIP,CURRENT_EQUIP)
Extracts the appearances of the panels labeled new_equip and
current_equip in the layout labeled ansi in the form file equipment.form,
and creates a printable file called equipment.txt.
DECforms Commands 1–17
FORMS EXTRACT OBJECT
FORMS EXTRACT OBJECT
Invokes the Extract Object Utility to create object modules from form files. The
object modules contain the information necessary to create a table of vectors to
escape routines referenced within the binary form file, and to create memoryresident forms for use at run time. For further information on the Extract
Object Utility, see Chapter 6 and the HP DECforms Programmer’s Reference
Manual.
Format
FORMS EXTRACT OBJECT input-file-spec[,input-file-spec...]
Qualifiers
Defaults
/[NO]FORM_LOAD
/[NO]LIST[=file-spec]
/[NO]LOG
/OBJECT[=file-spec]
/OUTPUT[=file-spec]
/[NO]PORTABLE_API
/REFERENCES={weak | strong}
/FORM_LOAD
/NOLIST This feature is supported only on Alpha platform
/NOLOG
/OBJECT
See description
/NOPORTABLE_API
/REFERENCES=strong This feature is supported only on Itanium platform
Parameter
input-file-spec
The name of the form file from which you want to create an object module. The
default file type is .form.
You can specify several input files. Separate each file name with a comma.
The Extract Object Utility generates one object file, which contains an object
module for each form listed on the command line.
Qualifiers
/FORM_LOAD
/NOFORM_LOAD
Specifies whether a form load, a representation of the form, is generated for
the input forms, or if the content of the object module is limited to the call
table only.
An .obj file can contain the binary representation of the form and its vectors,
or the vectors only. If you specify /FORM_LOAD, you get both the binary form
file and the vectors in the .obj file. If you specify /NOFORM_LOAD, you get
the vectors only.
1–18 DECforms Commands
FORMS EXTRACT OBJECT
The default is /FORM_LOAD.
This qualifier replaces /[NO]VECTORS_ONLY. (Specifying /[NO]VECTORS_
ONLY creates the call table in the object module, but a message is displayed
informing you to use the /[NO]FORM_LOAD qualifier.)
/LIST[=filespec]
/NOLIST This feature is supported only on Alpha platform
Specifies whether a listing file is generated and optionally provides a name
for the file. The listing file contains useful information regarding the contents
of the object modules generated by the Extract Object Utility. If you do not
specify a file name, the listing file has the name of the first input file with a
file type of .lis.
The default is /NOLIST.
/LOG
/NOLOG
Controls whether success messages are displayed on the default output device.
Error messages, if any, are displayed regardless of whether you specified /LOG
or /NOLOG.
The default is /NOLOG.
/OBJECT[=file-spec]
/OUTPUT[=file-spec]
Specifies a name for the object file. If you omit the file specification, the object
file has the same name as the first input file, with a file type of .obj.
The default is /OBJECT.
Note
The /OBJECT and /OUTPUT qualifiers are synonymous. You cannot
use them both on the same command line.
/PORTABLE_API
/NOPORTABLE_API
Specifies whether the information in the object file is configured for the
DECforms portable API (application programming interface). If you specify
/PORTABLE_API, global symbols for form names are generated. If you do
not specify /PORTABLE_API, you must use the FORMS$AR_FORM_TABLE
mechanism to enable memory-resident forms.
The default is /NOPORTABLE_API.
DECforms Commands 1–19
FORMS EXTRACT OBJECT
/REFERENCES={weak | strong}
Controls the type of references made to escape routines by the object module.
The /REFERENCES=weak qualifier specifies that the symbol references to the
escape routines are weak references that the Linker does not need to resolve
to run the application. The /REFERENCES=strong qualifier specifies that the
symbol references to the escape routines are strong references. In this case, if
the Linker cannot locate the escape routines, it issues a warning message.
The default is /REFERENCES=strong.
For more information on weak and strong symbol references, see the OpenVMS
Linker documentation.
/[NO]KEEP This is supported only on Itanium platform
Controls whether the intermediate C and header files are to be retained or not.
These files are used to generate the object file.If /KEEP qualifier is specified,
these intermediate files are retained in [.DECFORMS_TEMP] directory created
to save these files.The default file extension for C file is ’.c’ and for header file
is ’.h’. The default is /NOKEEP which deletes the intermediate files after .obj
file is created.
Examples
1.
$ FORMS EXTRACT OBJECT BIG_FORM
Creates an object file (big_form.obj) containing all possible layout and
device type combinations, as well as escape routine vectors, that are found
in the form file big_form.form.
2.
$ FORMS EXTRACT OBJECT SMALL_FORM/OBJECT=XYZ/LIST/NOFORM_LOAD/LOG
Creates an object file named xyz.obj that contains only the escape routine
vectors found in the form file small_form.form. A listing file named
small_form.lis is generated, and DECforms displays a success message.
1–20 DECforms Commands
FORMS TEST APPEARANCES
FORMS TEST APPEARANCES
Invokes the Test Utility so you can test a character-cell panel’s appearance
without writing an application program first. You cannot test a PRINTER
panel’s appearance. For further information on the Test Utility, see Chapter 4.
Format
FORMS TEST APPEARANCES input-file-spec
Qualifiers
Defaults
/LAYOUT=layout-name
/PANEL[=(name[,...])]
See description
See description
Parameter
input-file-spec
The name of the form file containing the panels to be tested. The default file
type is .form.
Qualifiers
/LAYOUT=layout-name
Specifies a layout in which the Test Utility searches for panels to test. When
you use /LAYOUT, you must specify a layout name.
If you do not use /LAYOUT, the Test Utility’s search for a specified or default
panel is limited to the first layout that contains all specified panels.
/PANEL[=(name[,...])]
Specifies the panel or panels to be tested.
When you specify a list of panels, the Test Utility displays the first panel in
the list. To leave the current panel, press Return to visit all the panel fields.
When you press Return on the last field of the panel, the Test Utility displays
the next panel.
If you do not use /PANEL, all panels are tested. The Test Utility displays the
first panel in the form, and displays the next one when you leave the current
panel.
If you use /PANEL and you have not specified /LAYOUT, all panels in the first
layout containing the specified panels are tested. If you do not use /PANEL
and you have not specified /LAYOUT, all panels in the first layout containing
the panels are tested.
DECforms Commands 1–21
FORMS TEST APPEARANCES
Note
If you attempt to test a layout that is not supported on your device
using the forms test appearances command, the Form Manager issues
an error.
Example
$ FORMS TEST APPEARANCES MORTGAGE_SCHEDULE/PANEL=INTEREST
Invokes the Test Utility to test the appearance of the panel labeled interest in
the form mortgage_schedule.form.
1–22 DECforms Commands
FORMS TRANSLATE
FORMS TRANSLATE
Invokes the IFDL Translator to translate an IFDL source file into a form file.
For further information on the IFDL Translator, see Chapter 5.
Format
FORMS TRANSLATE input-file-spec
Qualifiers
Defaults
/[NO]COMMENTS
/[NO]DEPENDENCY_DATA
/[NO]DIAGNOSTICS[=file-spec]
/ERROR_LIMIT=n
/FLOAT=option
/[NO]INCLUDE=(pathname[,...])
/[NO]LIST[=file-spec]
/[NO]LOG
/[NO]MEMBER_ALIGNMENT
[=(type=alignment,...)]
/[NO]OUTPUT[=file-spec]
/[NO]PAD_RECORDS
/SHOW=[no]copy
/[NO]WARNINGS
/COMMENTS
/NODEPENDENCY_DATA
/NODIAGNOSTICS
/ERROR_LIMIT=30
See description
/NOINCLUDE
See description
/NOLOG
MEMBER_ALIGNMENT
/OUTPUT
PAD_RECORDS
/SHOW=copy
/WARNINGS
Parameter
input-file-spec
The name of the IFDL source file to be translated into a form file. The default
file type is .ifdl.
Qualifiers
/COMMENTS
/NOCOMMENTS
Specifies whether comments in the IFDL source file are saved in the form.
If the form containing the saved comments is translated back to an IFDL
source file, the Back Translator does not preserve the original positions of the
comments, but places the comments as closely as possible to their original
positions.
The default is /COMMENTS.
DECforms Commands 1–23
FORMS TRANSLATE
/DEPENDENCY_DATA
/NODEPENDENCY_DATA
Specifies that the IFDL Translator creates dependency relationships for COPY
FROM DICTIONARY statements in the IFDL source file. The dependency
relationships relate the form to the data definitions that are extracted from
Oracle CDD/Repository using a displayable Oracle CDD/Repository object that
the IFDL Translator creates in CDD$DEFAULT.
When you specify /NODEPENDENCY_DATA, COPY FROM DICTIONARY
statements cause the IFDL Translator to copy information from Oracle
CDD/Repository, but the IFDL Translator does not create any dependency
relationships.
The default is /NODEPENDENCY_DATA.
/DIAGNOSTICS[=file-spec]
/NODIAGNOSTICS
Specifies that the IFDL Translator write DEC Language-Sensitive Editor (DEC
LSE) diagnostics records to a file. DEC LSE uses these records during its
REVIEW phase to locate and describe translation errors. (For information on
DEC LSE, see Appendix C.)
If you omit the file specification, the output file has the same name as the
input file, with a file type of .dia.
The default is /NODIAGNOSTICS.
/ERROR_LIMIT=n
Specifies the number of errors allowed before the IFDL Translator stops the
compilation. The value for n must be a positive integer.
The default error limit is 30.
/FLOAT=option
Specifies the default precision for floating point numbers used within the form.
Prior to DECforms Version 2.1, the default precision for floating point numbers
was H_FLOAT: a much higher level of precision than that required by most
forms. DECforms Version 2.2 supports a default precision of G_FLOAT to be
compatible with OpenVMS Alpha.
You may define the precision used in your form by specifying /FLOAT=option,
where option is one of the following:
D_FLOAT
F_FLOAT
G_FLOAT
1–24 DECforms Commands
FORMS TRANSLATE
H_FLOAT
S_FLOAT
T_FLOAT
X_FLOAT
Note
Specifying H_FLOAT causes hfloating point emulation routines to be
used on the OpenVMS Alpha platform. Specifying D_FLOAT results
in reduced dfloating point precision on OpenVMS Alpha (53 bits of
precision versus 56 bits).
/INCLUDE=(pathname[,...])
/noinclude
Specifies an additional level of search for an .ifdl file specification in a COPY
statement. Each path name argument can be either a logical name or a legal
directory specification. The search order is the directory containing the source
file, followed by the directory specified in the qualifier.
This option is passed to the FORMS TRANSLATE command when the IFDL
Translator is used.
The default is /NOINCLUDE.
/LIST[=file-spec]
/NOLIST
Specifies that a listing file be created. If you omit the file specification, the
output file has the same name as the input file, with a file type of .lis.
The /LIST qualifier has been enhanced in DECforms Version 4.0 to add a new
section title, ‘‘Structure Layout Listing’’.
The Structure Layout Listing provides information on how form records are
interpreted by DECforms. On OpenVMS Alpha systems, records may follow
either of two defined forms specified by the OpenVMS Calling Standard: VAX
compatible or aligned record layout.
The default is /NOLIST for interactive sessions and /LIST for batch jobs. See
the Examples section for an example of the Structure Layout Listing.
/LOG
/NOLOG
Controls whether a message is displayed upon completion of the translation.
Error messages, if any, are displayed whether you specified /LOG or /NOLOG.
DECforms Commands 1–25
FORMS TRANSLATE
The default is /NOLOG.
/MEMBER_ALIGNMENT[=(type=alignment,...)]
/NOMEMBER_ALIGNMENT
Controls the natural alignment of form records and record fields. Natural
alignment is the default record layout of the program’s platform. On OpenVMS
VAX systems, natural alignment means that records are byte aligned. On
OpenVMS Alpha systems, natural alignment specifies that records follow
OpenVMS aligned record layout format.
The alignment qualifier allows you to specify what alignment multiples to use
per type on fields within the record. You may specify type=alignment qualifier
as one of the following data types:
ADT
BYTE
D_FLOAT
F_FLOAT
G_FLOAT
H_FLOAT
LONG
QUAD
S_FLOAT
TEXT
T_FLOAT
VARYING_TEXT
WORD
X_FLOAT
Alignment is specified as a valid alignment multiple directive:
byte_alignment
longword_alignment
octaword_alignment
quadword_alignment
word_alignment
The default alignment multiple directives for each data type are:
ADT = quadword_alignment
BYTE = byte_alignment
D_FLOAT = quadword_alignment
F_FLOAT = longword_alignment
G_FLOAT = quadword_alignment
H_FLOAT = octaword_alignment
LONG = longword_alignment
1–26 DECforms Commands
FORMS TRANSLATE
QUAD = quadword_alignment
S_FLOAT = longword_alignment
TEXT = byte_alignment
T_FLOAT = quadword_alignment
VARYING_TEXT = word_alignment
WORD = word_alignment
X_FLOAT = octaword_alignment
The OpenVMS Alpha language compilers can produce records in either or both
of these formats. Using the alignment clause on the FORM RECORD declaration achieves similar results and overrides the /[NO]MEMBER_ALIGNMENT
qualifier for that record.
Note
You cannot specify the record layout on OpenVMS VAX systems. On
OpenVMS VAX systems records always follow VAX record layout.
The default is /MEMBER_ALIGNMENT.
/OUTPUT[=file-spec]
/NOOUTPUT
Specifies a name for the form file produced by the IFDL Translator. If you omit
the file specification, the output file has the same name as the input file, with
a file type of .form.
The default is /OUTPUT.
/PAD_RECORDS
/NOPAD_RECORDS
Specifies whether to pad the record length in form records to a multiple of the
record’s alignment. If you are using an OpenVMS Alpha system, this qualifier
assists in language-specific differences in aligned record handling.
DEC ADA and DEC COBOL compilers do not pad record lengths and require
the /NOPADS_RECORDS qualifier.
The default is /PAD_RECORDS.
/SHOW=[no]copy
Includes information in the listing file resulting from the expansion of a COPY
or COPY FROM DICTIONARY statement. When you use /SHOW=copy, you
must also specify /LIST; if you do not specify /LIST, the /SHOW qualifier is
ignored.
DECforms Commands 1–27
FORMS TRANSLATE
The default is /SHOW=copy.
/WARNINGS
/NOWARNINGS
Specifies whether the IFDL Translator signals warning and informational
messages.
The default is /WARNINGS.
Examples
1.
$ FORMS TRANSLATE/OUTPUT=NEW_CUSTOMER CUSTOMER
Translates the source file customer.ifdl to a form file named
new_customer.form.
2.
$ FORMS TRANSLATE/LIST/SHOW=COPY CUSTOMER
Translates the source file customer.ifdl into the form file customer.form.
Also generates a listing file, customer.lis. Any copied files, text library
modules, or Oracle CDD/Repository information is expanded in the listing
file.
3.
$ FORMS TRANSLATE/MEMBER_ALIGNMENT=ADT=LONGWORD_ALIGNMENT CUSTOMER
Translates the source file customer.ifdl into customer.form. Also
specifies that date fields in the source file customer.ifdl to be longword
aligned.
4.
$ FORMS TRANSLATE/FLOAT=H_FLOAT ALPHA.IFDL
Translates the source file alpha.ifdl into alpha.form. Also specifies that
the floating point precision in alpha.ifdl is H_FLOAT.
5.
$ FORMS TRANSLATE/LIST/SHOW TEST
Translates the source file test.ifdl into the form file test.form. Also
generates the listing file, test.lis, that follows:
1–28 DECforms Commands
FORMS TRANSLATE
DECforms V4.0 DS V3.9-111 IFDL Translator
SYS$LOGIN_DEVICE:[TEST]TEST.IFDL;1
Structure Layout Listing
Align
Offset
Size
----- -------------------- -------------------Lw
3327/3532 bytes Form Record G_REC
Word
0 bytes
34 bytes
CHOICE_TEXT
Word
34 bytes
34 bytes
CONTROL_TEXT
Byte
68 bytes
1 bytes
GIK_DISPLAY
Word
69/70 bytes
257 bytes
INT_TITLE
Word
Lw
Lw
Lw
Lw
Word
Word
Byte
326/328
583/588
591/596
595/600
599/604
603/608
603/608
615/620
bytes
bytes
bytes
bytes
bytes
bytes
bytes
bytes
257
8
4
4
4
13/14
12
1
bytes
bytes
bytes
bytes
bytes
bytes
bytes
bytes
Lw
Word
Word
Word
3203/3408
3207/3412
3207/3412
3207/3412
bytes
bytes
bytes
bytes
4
60
12
12
bytes
bytes
bytes
bytes
INT_DESC
STIME
GRANULARITY
FILE_SIZE
NUM_KEYWORDS
Group KS Occurs 200
KEYWORD
SELECTED
End Group
NUM_KS_SELECTED
Group KS_S Occurs 2
Group SW Occurs 5
KEYWORD
End Group
End Group
End Record
The "Size" column is the actual size of the data item.
The "Offset" column is the offset from the beginning of the record.
The "Align" column contains the type of data alignment required, where:
Byte = byte aligned
Word = word aligned
Lw = longword aligned
Qw = quadword aligned
Ow = octaword aligned
Note(s):
1. Only the first occurrence of an "OCCURS n" is represented.
2. The "/" separator denotes the "VAX/Natural" Record Alignment values.
No separator indicates the values are equal or
/NOMEMBER_ALIGNMENT was used.
Note #1 in the example exists due to the repetitive nature of groups,
because showing each instance of the OCCURS group has little true
meaning. The actual size requirements of the group are determined by the
group instance.
Note #2 in the example shows how differences between the aligned and
VAX compatible layout schemes are represented. When they match, only a
single value is shown.
DECforms Commands 1–29
FORMS TRANSLATE
All of these notes are not necessarily present in a listing file; therefore,
the numbering would therefore be different. Also, only the given ‘‘Align’’
column values are typically expanded in the description that follows. For
example, the following appears only if Qw is in the ‘‘Align’’ column:
Qw = quadword aligned
The natural alignment of records on OpenVMS Alpha may cause the
introduction of padding between the fields of the record. By rearranging
the field positions within the record, this padding can be minimized. The
address of a field is aligned based on its size and alignment. The listing
shows the given alignment value for that data type. Generally, it is best
to order the fields within a record from the largest alignment value to the
smallest (from octaword to byte). In the previous example you would place
the longword fields first, then the word fields, followed by the byte fields.
Many different arrangements of the fields within a record are possible. The
goal is to arrange them so as to have the least amount of padding possible
between fields.
1–30 DECforms Commands
2
Form Development Environment
From the Form Development Environment (FDE),1 you can perform all form
development tasks, including creating or modifying character-cell layouts and
panels, editing IFDL source files, testing form appearance, extracting forms for
printing, extracting objects and vectors, and creating graphic form elements.
The FDE automatically produces the source and run-time formats of your form.
Beginnning form developers, in particular, use the FDE because it lets them
create a form interactively through a menu-driven interface.
This chapter explains how to:
•
Invoke the FDE
•
Specify an editor for IFDL text editing in the FDE
•
Use the FDE menu choices to perform form development tasks
•
Exit the FDE
•
Recover a session from abnormal termination
1
DECforms software was used to create the FDE user interface. The FDE menus are
DECforms panels. Help in the FDE is provided by DECforms help messages and help
panels and by procedural escapes that access a help library.
Form Development Environment 2–1
Note
If you intend to create forms that use a PRINTER layout, you should
not try to use the FDE because you cannot create a PRINTER layout.
Instead, you should create your form by creating and editing an IFDL
file.
If you are new to DECforms and unfamiliar with the IFDL structure,
you can do one of the following:
•
Use the FDE to create a form that uses a character-cell layout.
•
Use the optional DEC Language Sensitive Editor and its EXPAND
command (described in Appendix C) to produce a template that you
can follow during IFDL editing.
To try tutorial exercises that introduce FDE basics, see Part I of the HP
DECforms Guide to Developing an Application.
2.1 Invoking the FDE
To invoke the FDE, at the system prompt enter a command in the following
format:
FORMS DEVELOP input-file-spec
Replace input-file-spec with the name of the form to be created or modified and
the file type .form (for a form file) or .ifdl (for a IFDL source file). If you do
not specify a file type, the FDE looks first for a form file and, if it does not find
one, it looks next for an IFDL file. If an IFDL source file is used as input to
the FDE, the FDE invokes the IFDL Translator to translate this file to a form
file.
If the specified input file does not exist, the FDE creates a new form with the
name you specified.
For a complete description of the FORMS DEVELOP command and its
qualifiers, see Chapter 1.
2–2 Form Development Environment
2.1.1 Specifying an Editor for IFDL Text Editing
The FDE provides several choices for editing an IFDL source file. In order of
precedence, you can:
•
Specify any available editor, or a quoted string containing the editor
command format, when you invoke the FDE with the FORMS command.
Use the /TEXT_EDITOR qualifier. For example:
$ FORMS DEVELOP/TEXT_EDITOR=LSE MYFORM
•
Specify the editor through the DECforms logical name
FORMS$TEXT_EDITOR. For example:
$ DEFINE FORMS$TEXT_EDITOR CALLABLE_LSE
•
Specify no editor, in which case the FDE invokes the default text editor,
which is defined according to the language setting for your system. For
more information, see the FORMS DEVELOP command in Chapter 1.
Specifying the Editor Command Format
If you are using DECTPU or DEC LSE as your editor, the FDE can determine
the starting position for your editing operation (for example, the panel
declaration section for the selected panel). Otherwise, you are placed at the
beginning of the IFDL source file, unless you specify a quoted string containing
the editor command format. (If your editor is EDT, you are placed at the
beginning of the file.)
The editor command format lets you specify the starting position—provided the
specified editor supports a starting position—and an output file. For example:
$ FORMS DEVELOP/TEXT_EDITOR="MY_EDITOR/STARTING_POSITION= ’P2’ ’P1’" MYFORM
The parameter p2 is the symbol for the starting position; the parameter p1
represents the output file. For the my_editor parameter, specify the name of
your editor.
2.1.2 Using the Main Menu
When you invoke the FDE, it displays a Main Menu. Figure 2–1 shows the
Main Menu displayed for the advanced sample application.
Form Development Environment 2–3
Figure 2–1 FDE Main Menu
ZK-9066A-GE
The Main Menu consists of three levels of choices: Form, Layout, and Panel.
Section 2.2, Section 2.3, and Section 2.4 explain how to use these choices
to perform FDE functions. Table 2–1 describes the FDE function keys for
selecting menu choices and returning to the Main Menu.
The Main Menu also provides choices for exiting or quitting the FDE. Firsttime users might want to select the Getting Started choice for an overview of
the FDE and of DECforms.
2–4 Form Development Environment
2.1.3 Using Function Keys
The FDE provides function keys for performing such tasks as selecting menu
choices and getting help.
Table 2–1 lists the function keys you can use in the FDE.
Table 2–1 FDE Function Keys
Function
Key or Key Sequence
Exit and save changes, or return from a submenu to the
Main Menu
F10, PF1-E
Quit without saving changes, or quit from a submenu
F8, PF1-Q
Display help information
Help, PF2
Turn automatic hinting on or off
PF1-Help, PF1-PF2
Display next screen
Next Screen,
PF1-PF4
Display previous screen
Prev Screen,
PF1-PF3
Select a menu choice
Select, KP-period
Display a list of choices for a field in parentheses
Select, KP-period
Erase the contents of a field
F13, Linefeed
Move among menu choices, among fields, or within fields
Arrow keys
Move to the next field
Tab, Return
Move to the previous field
F12, Backspace
2.1.4 Creating a New Form
When you invoke the FDE to create a new form, the FDE displays the Main
Menu and then overlays it with the following panel:
Form Development Environment 2–5
Select the Yes icon to have the FDE create a default character-cell layout. The
FDE creates the layout and then clears the New Form panel to redisplay the
Main Menu.
2.1.5 Editing an Existing Form
When you invoke the FDE to work on an existing form, the FDE displays the
Main Menu and includes the form name, the layout name, and a panel name,
as shown in Figure 2–1. If your IFDL source file is newer than your form file
(for example, if you edited the IFDL source directly and did not translate it
into a form file), the FDE displays the following panel:
Select the appropriate choice on the panel.
2.2 Using Main Menu Choices at the Form Level
The following sections explain the choices at the Form level on the Main Menu.
2.2.1 Specifying the Output Type
The File choice displays a submenu with choices for the type of output you
want the FDE to produce.
•
IFDL, FORM
Produces an IFDL source file and a binary form file. This is the default.
•
IFDL only
Produces only an IFDL source file.
•
FORM only
Produces only a form file.
•
Panel Images
2–6 Form Development Environment
Uses the Extract Appearances Utility to produce a file containing panel
appearances, suitable for printing. For information about the Extract
Appearances Utility, see Chapter 6.
Another way to print panels is to use the PRINT response step in your
form to print the current display. For more information, see the HP
DECforms IFDL Reference Manual and Part II of the HP DECforms Guide
to Developing an Application.
•
Object of Form
Uses the Extract Object Utility to produce an object module containing the
entire form with strong symbol references to your procedural escapes. You
can link this object module with the application program.
The object module is configured for the OpenVMS API (application
programming interface). To configure the object module for the portable
API, you must run the utility from the command line. For information
about the Extract Object Utility, see Chapter 6.
•
Object Vectors
Uses the Extract Object Utility to produce an object module containing only
procedural escape vectors with strong symbol references to your procedural
escapes. You can link this object module with the application program. For
information about the Extract Object Utility, see Chapter 6.
After you make each output choice, the cursor moves to the Return to Main
Menu choice. When you return to the Main Menu, you can exit the FDE or
continue working on your form.
2.2.2 Changing the Form Name
The Modify Form choice allows you to change the name of the form and to
enter comments about the form. Changing the name of the form does not affect
the name of the file you are editing.
2.2.3 Editing IFDL Source Code
The three Edit choices at the Form level invoke the system’s default text editor,
or the editor you specified when you invoked the FDE, and place you in the
IFDL source file for your form. Generally, the FDE is able to select the starting
position in the IFDL source file according to the Edit choice you select, as
follows:
•
Edit Records
Form Development Environment 2–7
The Edit Records choice places the cursor at the section in the IFDL source
file where you would normally enter form record declarations, as follows:
.
.
.
End Data
Form Record ACCOUNT
ACCOUNT_NUMBER Unsigned Longword
DATE_ESTABLISHED Datetime(8)
ZIP_CODE Unsigned Longword
LAST_NAME Character(20)
.
.
.
•
Edit Data
The Edit Data choice places the cursor at the section in the IFDL source
file where you would normally enter form data declarations, as follows:
.
.
.
Form Data
ACCOUNT_NUMBER Unsigned Longword
AMOUNT Unsigned Longword
CHECKING_BALANCE Unsigned Longword
CHECK_MEMO Character(35)
CHECK_NUMBER Unsigned Word
.
.
.
2–8 Form Development Environment
•
Edit IFDL
The Edit IFDL choice places the cursor at the FORM declaration in the
IFDL source file.
For information on the syntax of form record, form data, and FORM
declarations, see the HP DECforms IFDL Reference Manual.
In EVE-based editors, you can get help on IFDL syntax by pressing Do and
entering the HELP FORMS command. Figure 2–2 shows the first help screen.
Figure 2–2 DECTPU Help in the FDE
Enter the name of the topic on which you want help information. When you
are finished, press Return to resume text editing.
When you finish editing the IFDL source file and exit the text editor, the FDE
uses the IFDL Translator to translate the IFDL source into a form file before
returning to the Main Menu. If translation errors occur, the FDE displays a
panel to notify you and gives you the option of correcting the errors, as follows:
Form Development Environment 2–9
This panel provides the following choices:
•
Edit Again
Select this to reenter the text editor and make the necessary corrections.
•
Exit, Save
Select this to exit the FDE and save the IFDL source file.
•
Discard IFDL
Choose this to return to the Main Menu without saving the changes that
you made to the IFDL source file.
2.3 Using Main Menu Choices at the Layout Level
The following sections explain the choices at the Layout level on the Main
Menu.
2.3.1 Selecting a Layout
The Choose, Create choice displays a panel with the following two choices:
•
Choose Layout
Select Choose Layout to choose a particular character-cell layout from a list
of the layouts for your form. Use the arrow keys to scroll through the list;
press Select to choose the desired layout.
•
Create Layout
Select Create Layout to create a new character-cell layout. Figure 2–3
shows the panel that the FDE displays for you to fill in information about
the new layout. Section 2.3.2 explains the fields and options on this panel.
2.3.2 Creating a Layout
The following list explains how to use the fields and options in the Create
Layout panel shown in Figure 2–3 to specify the attributes for a new layout:
•
Layout Name
Enter a name for the layout. This name is required and must follow the
rules for user-defined names as described in the HP DECforms IFDL
Reference Manual.
•
Type
2–10 Form Development Environment
Figure 2–3 Creating a Layout in the FDE
Specify a layout type. When you move the cursor to this field, parentheses
appear, indicating that you can press Select to request a listing of the types
available. Use the Select key to select a type: Video Terminal or Hebrew
Video Terminal (for displaying Hebrew characters).
•
Enter Comments Here
Enter comments about the layout on the lines below the layout name.
•
Layout Size
Specify new figures to override the default layout size of 24 lines by 80
columns. The layout size specifies the largest rectangular area that the
form is to occupy. It also defines the size of the default viewport.
•
Message Lines
Specify new figures to override the default size of the viewport to be
associated with the message panel. All error messages and all output from
the MESSAGE response step are displayed on the message panel. A layout
can contain only one message panel.
The FDE specifies a default message panel that consists of the bottom line
on the screen. The Form Manager creates the default message panel if you
do not specify a message panel in your layout.
•
Help Panel
Specify a help panel to be displayed for items that do not have help panels
declared for them. When you move the cursor to this field, parentheses
appear, indicating that you can press Select to request a listing of help
panels created in the layout selected previously.
Form Development Environment 2–11
Any existing help panels are displayed in the Select a Help Panel submenu.
Use the Select key to select a help panel from the list. You also can
enter the name of a help panel directly. For information about creating
help panels, see Part II of the HP DECforms Guide to Developing an
Application.
•
Language
Enter the name of the natural language (for example, French or German)
for this layout. If you leave this field blank, the layout can be used with
any language.
The Form Manager determines which natural language layout to use by
translating the logical name FORMS$LANGUAGE. The definition must
match the character string specified for the layout. For more information,
see the HP DECforms Programmer’s Reference Manual.
•
Terminal Types
Use the Select key to choose the terminals for which you want to define
this layout. If you choose more than one terminal, the layout can use only
those capabilities that are available in all the specified terminals. Selecting
VT100 means that the layout supports VT100 or newer terminals. If you
want the layout to support all current HP terminals, select VT100.
For more information about specifying terminals in a layout, see the
description of the DEVICE declaration in the HP DECforms IFDL Reference
Manual.
•
Terminal Width
Use the Select key to choose the screen width when the form is displayed,
as follows:
UnChanged—The terminal width is unchanged from the operator’s
setting.
80 and 132—Set the width to 80 and 132 columns, respectively, unless
the width is specified explicitly for a panel.
•
Colors
Use the Select key to choose colors for the layout’s background and
foreground, and for bold and reverse display attributes. When you select
the Back, Fore, Bold, or Rev option, the FDE displays the Color Choices
menu shown in Figure 2–4.
2–12 Form Development Environment
Figure 2–4 Specifying Screen Colors in the FDE
You can select a standard color or specify RGB values (percentages of red,
green, and blue) to get different colors.
Note
On monochrome terminals, the Back: BLACK option means white
characters on a black background. The Back: WHITE option means
black characters on a white background. Do not select a color or specify
RGB values.
2.3.3 Changing Layout Attributes
The Modify Layout choice lets you modify the attributes of the current
layout. These attributes are the same as for the Create Layout choice (see
Section 2.3.2).
2.3.4 Testing Your Form
The Test choice allows you to check the appearance of your panels without
having to write an application program first. You can evaluate the appearance
of each panel as it is seen at run time, and you can observe the input fields as
they appear to the operator.
When you select the Test choice, the FDE displays the Testing panel, shown in
Figure 2–5.
Form Development Environment 2–13
Figure 2–5 Testing a Form in the FDE
You can choose to test the current panel, test all the panels in the form, or
enable the form.
•
Test Panel and Test All
When you select Test Panel, the FDE invokes the Test Utility to display
the current panel. Selecting Test All causes the Test Utility to display
all panels in the layout in the sequence in which they are declared in the
IFDL source file.
Use the default DECforms function keys to move around a panel. When
you have finished looking at the panel or panels, press F10 or Ctrl/Z to
return to the FDE. For information about the Test Utility, see Chapter 4.
In CCPED, you can use the TEST command to test panels. For more
information, see Appendix B.
•
Test Enable
The Test Enable choice causes the FDE to enable your form and act as the
application program. When you select this choice from the Testing panel,
the FDE displays the following panel:
2–14 Form Development Environment
If you do not specify control text for the test, the Form Manager uses the
enable response so you can do the following:
Test the initial sequence of events when the form is enabled
Test such form operations as panel navigation
If you specify control text, you can test specific pieces of the form. The
control text is passed, forcing execution of a control text response in the
form. For example, you might have a control text response for testing that
initializes variables and activates certain panels. You can use this feature
to test forms or to create demonstrations without using an application
program.
For example, you might enter the following control text response in the
layout section of your IFDL source file before the panel declarations:
Control Text Response "TEST"
Activate All
End Response
To execute a control text response, use the following procedure:
1. Select the Test Enable choice.
2. Enter the name of the control text response in the Test Enable panel;
for example:
TEST
To display a list of all the control text responses in the form, press
Select, or KP. (KP-period). You then can make a selection from the list.
3. Select the Start Test choice.
4. Press F10 to end the test and return to the FDE.
If the enable (or any other) response includes a CALL response step, you
must define the FORMS$IMAGE logical name to point to the shareable
image, or to a search list of shareable images, containing the subroutines
that are called. Otherwise the test stops when it encounters the first CALL
response step.
You can use Test Enable to test the execution of any escape routine,
whether user-written or system-supplied. For example, if you define
FORMS$IMAGE as LIBRTL, you can test calls from a form to the
OpenVMS Run-Time Library routines.
Form Development Environment 2–15
2.3.5 Editing IFDL Source Code
The Edit IFDL choice invokes a text editor and places you at the LAYOUT
statement for the current layout in the IFDL source file, provided the FDE can
specify the starting position to your text editor. Then you can add help panel
declarations, function declarations, and so on. For information about specifying
an editor for text editing, see Section 2.1.1.
When you exit the text editor, the FDE uses the IFDL Translator to translate
the IFDL source to update the current definition of the form before returning
to the Main Menu. If translation errors occur, the FDE gives you the option
of reentering the text editor to correct them. For more information about the
IFDL Translator, see Chapter 5.
2.4 Using Main Menu Choices at the Panel Level
The following sections explain the choices at the Panel level on the Main Menu.
2.4.1 Selecting a Panel
The Choose, Create choice displays a panel with three choices:
•
Choose Panel
Select Choose Panel to choose a particular panel from a list of the data
entry panels in the current layout. Use the arrow keys to scroll through
the list; press Select to choose the desired panel.
•
Choose Help
Select Choose Help to choose a help panel from a list of help panels in
the current layout. Use the arrow keys to scroll through the list; press
Select to choose the desired help panel. For information on help panels, see
Part II of the HP DECforms Guide to Developing an Application.
2–16 Form Development Environment
•
Create Panel
Select Create Panel to create a new panel. Figure 2–6 shows the panel the
FDE displays for you to fill in information. Section 2.4.2 explains the fields
and options on this panel.
Figure 2–6 Creating a Panel in the FDE
2.4.2 Creating a Panel
The following list explains how to use the Create Panel panel shown in
Figure 2–6 to specify the attributes for a new panel.
•
Panel Name
Enter a name for the panel. This name is required and must follow the
rules for user-defined names as described in the HP DECforms IFDL
Reference Manual.
•
Type
Select the type of panel: Data Entry or Help. Data entry is the default.
•
Enter Comments Here
Enter comments about the panel on the lines below the panel name.
•
Viewport Name
Specify a viewport to be associated with the panel. If you specify a viewport
that does not exist, a new viewport with that name is created. If you leave
this field blank, the panel is associated with the default viewport. If you
use the default viewport, you cannot modify the viewport line or column
values or the viewport type.
Form Development Environment 2–17
When you move the cursor to this field, parentheses appear, indicating that
you can press Select to request a listing of viewports in the layout. Any
existing viewports are displayed in the Select a Viewport submenu. Use
the Select key to select a viewport from the list.
The submenu also indicates the line and column values of each viewport
and the size of the panel. The Type column indicates Printing for printing
viewports. If the viewport is a screen viewport, the Type column is left
blank.
•
Screen or Printing
Use the Select key to select the viewport type. A screen viewport cannot be
larger than the size of the layout. A printing viewport can be any size.
•
Lines and Columns
Specify new figures to override the default number of lines and columns
the viewport is to occupy. For a printing viewport, you can enter line and
column values up to 999. To specify larger printing viewports with values
up to 65545, edit the IFDL file.
If the viewport is a screen viewport, the size is validated against the layout
declaration for display on a CRT device.
•
Enter a help message here
Enter a one-line help message to be used by items in the panel that do not
have any help messages explicitly declared for them. Enter this message
on the line above the Help Panel field.
•
Help Panel
Use this field to specify a help panel to be displayed for items that do not
have help panels declared for them. When you move the cursor to this
field, parentheses appear, indicating that you can press Select to request a
listing of help panels in this layout.
Any existing help panels are displayed in the Select a Help Panel submenu.
Use the Select key to select a help panel from the list. You also can
enter the name of a help panel directly. For information about creating
help panels, see Part II of the HP DECforms Guide to Developing an
Application.
•
Erase on Exit
Use the Select key to specify whether the panel is to remain displayed after
the operator exits the panel. The default option, No, keeps the panel on
the screen after the operator exits. Select Yes to remove the panel.
2–18 Form Development Environment
If you accept the default, you can remove the panel from the screen in
a response using the REMOVE response step. For information on this
response step, see the HP DECforms IFDL Reference Manual.
•
Keypad Mode
Use the Select key to select the keypad mode for the operator.
UnChanged—The keypad mode is unchanged from the operator’s
setting when this panel is displayed.
Application—The keypad keys act as function keys.
Numeric (default)—The keypad keys enter numbers.
•
Terminal Width
Use the Select key to set the terminal width for the panel display.
Default (default)—Sets the terminal width to the viewport’s width as
displayed in the square brackets ([ ]).
UnChanged—The terminal width is unchanged when this panel is
displayed.
80 and 132—Set the terminal width to 80 and 132 columns
respectively.
•
Colors
Use the Select key to choose colors for the panel’s background and
foreground, and for bold and reverse display attributes. These selections
override any you made at the Layout level.
When you select the Back, Fore, Bold, or Rev options, the FDE displays the
Color Choices menu shown in Figure 2–4. You can select a standard color
or specify RGB values (percentages of red, green, and blue) to get different
colors.
Note
On monochrome terminals, the Back: BLACK option indicates white
characters on a black background. The Back: WHITE option indicates
black characters on a white background. Do not select a color or specify
RGB values.
Form Development Environment 2–19
2.4.3 Changing Panel Attributes
The Modify Panel choice allows you to modify the attributes of the current
panel. These attributes are the same as for the Create Panel choice (see
Section 2.4.2).
2.4.4 Editing Panel Appearance
The Panel Editor choice invokes the Character-Cell Panel Editor (CCPED) to
let you edit the current panel. CCPED lets you create graphic form elements
in an interactive, what-you-see-is-what-you-get fashion.
When you create a form, you need to specify the visual elements of the form’s
panels: background text and graphics, field attributes, such as location and
size, and so on. You can use CCPED to create and modify these elements and
their attributes, and you can see the results on the screen immediately.
For information on using CCPED, see Chapter 3.
2.4.5 Editing IFDL Source Code
The Edit IFDL choice invokes a text editor and places you at the PANEL
statement for the current panel in the IFDL source file, provided the FDE
can specify the starting position to your text editor. Then you can add field
description attributes, function responses, and so on. For information about
specifying an editor for text editing, see Section 2.1.1.
When you exit the text editor, the FDE uses the IFDL Translator to translate
the IFDL source to update the current definition of the form before returning
to the Main Menu. If translation errors occur, the FDE gives you the option
of reentering the text editor to correct them. For more information about the
IFDL Translator, see Chapter 5.
2.5 Exiting the FDE
To exit the FDE, return to the Main Menu and select either Exit or Quit:
•
The Exit choice terminates the FDE session and saves any changes made
to the form file. By default, the FDE produces a form file and an IFDL
source file. You can choose to have only a form file or an IFDL source
file produced for the type of output. You can specify the type of output
when you invoke the FDE with the FORMS DEVELOP command (see
Chapter 1), or by selecting the File choice at the form level on the FDE
Main Menu (see Section 2.2.1). You also can press PF1-E or F10 to exit the
FDE.
2–20 Form Development Environment
•
The Quit choice terminates the FDE session without saving any changes
you made to the form file. The FDE notifies you that the changes will not
be saved and asks you to verify that you want to quit. You also can press
PF1-Q or F8 to quit the FDE.
2.6 Recovering an FDE Session
The FDE uses checkpointing as a recovery mechanism. Checkpointing saves
the known state of a form, so the form can be restored to that state following
a failure. Checkpointing is enabled by default when you invoke the FDE.
For more information on checkpointing, see the description of the FORMS
DEVELOP command in Chapter 1.
When checkpointing is enabled, the FDE writes the form file out to disk every
time you return to the Main Menu after modifying the current form. Should
your FDE session end abnormally for some reason (for example, if your system
fails), you can recover the state of your editing session at the last checkpoint
before the abnormal termination occurred. During recovery, the FDE also
applies any CCPED journal files to the checkpoint.
To recover an FDE session, from the system prompt enter a command in the
following format:
FORMS DEVELOP input-file-spec /RECOVER
This command causes the FDE to reconstruct your FDE session up to the point
when the checkpoint file was written.
Form Development Environment 2–21
3
Editing Panel Appearance Using the
Character-Cell Panel Editor (CCPED)
The DECforms Character-Cell Panel Editor (CCPED) lets you create and edit
the visual appearance of form panels that will be used in character-cell layouts.
With CCPED, you can create graphic form elements, such as background
text and graphics and the location and size of fields, in an interactive,
what-you-see-is-what-you-get fashion.
CCPED runs under the OpenVMS operating system on a character-cell
terminal or in a terminal emulation window on a workstation.
This chapter explains how to:
•
Invoke and exit CCPED
•
Recover an editing session from abnormal termination
•
Use the CCPED screen display
•
Use CCPED commands and the default keypad
•
Create and edit panel appearance
•
Test panel appearance
As an alternative to using CCPED, you also can specify panel attributes in an
IFDL source file and then translate that file to a binary form file. However,
using CCPED is a more efficient way to create panel appearances, because you
can see the results on the screen immediately.
Note
You cannot use CCPED to edit panels in layouts having display
sizes greater than the page and width values of the terminal you are
currently using.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–1
Many of the examples in this chapter refer to the advanced sample application
described in Part II of the HP DECforms Guide to Developing an Application.
You can follow the examples on your terminal by using the form supplied with
this application. Copy the advanced sample form to your area from the sample
files directory, and then invoke CCPED by entering the following commands:
$ COPY FORMS$EXAMPLES:FORMS$CHECKING_FORM.FORM SAMPLE.FORM
$ FORMS EDIT SAMPLE
For a tutorial covering some of the basics of using CCPED, see Part I of the
HP DECforms Guide to Developing an Application.
3.1 Invoking and Exiting CCPED
To invoke CCPED, use one of two methods:
•
From the FDE Main Menu, select the Panel Editor choice at the Panel
level (see Chapter 2).
•
At the system prompt, enter a command in the following format:
FORMS EDIT form-file-spec
Replace form-file-spec with the name of the form file. The default input file
type is .form.
For a complete description of the FORMS EDIT command and its
qualifiers, see Chapter 1.
Note
When you invoke CCPED from the FDE, an IFDL file is automatically
created from the form file. When you invoke CCPED by using the
FORMS EDIT command, you must back translate the form file to
create the IFDL file. For information about back translating, see
Chapter 5.
To exit CCPED, press F10 or PF1-E, or enter the EXIT or QUIT command
on the CCPED command line. See Section 3.4.1 for information about using
CCPED commands.
Upon exiting, CCPED produces as output an updated version of the form file.
The default output file has the same name and file type as in the input file.
If you try to quit after making changes, CCPED displays a caution box advising
you that your changes will be discarded and asking you to confirm whether or
not you want to quit.
3–2 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.2 Recovering an Editing Session
If your editing session ends abnormally due to a hardware failure or some
other interruption, use journaling to recover it. CCPED journals your editing
session after every few commands that you enter. If the journal file is not
needed, CCPED deletes it when you end your editing session.
To recover your editing session up to the last journal point:
1. Invoke CCPED, specifying the /RECOVER qualifier.
2. Open the form file that needs to be recovered.
CCPED creates the journal file in your working directory, using the default file
format form_file_name.forms$journal.
To direct journaling to a different file name or directory, use the /JOURNAL
qualifier when you invoke CCPED.
3.3 CCPED Screen Display
CCPED divides the screen display into the following areas:
•
Current panel
•
Status line
•
Message panel
Figure 3–1 shows these areas.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–3
Figure 3–1 CCPED Screen Display
Account Data
Enter secret password to change the account data:
NAME
Current
Panel
Last
XXXXXXXXXXXXXXXXXXXX
First XXXXXXXXXXXXXXX
Middle XXXXXXXXXXXXXXX
ADDRESS
Street XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
City
XXXXXXXXXXXXXXXXXXXX
State XX
Zip 99999
XXXXXXXXXXX
Account Number 99999
Opened
99/99/9999
PHONE
Home
(999)999−9999
Business (999)999−9999
To record new account data and return to the menu, press F10 or PF1−E.
To return to the menu without changing the data, press F8 or PF1−Q.
Status
Line
Message
Panel
Panel:
ACCOUNT_PANEL
LAST_NAME
Right
Overstrike
Command>
Current Panel is ACCOUNT_PANEL.
ZK−7907−GE
Depending on whether you are using the command interface or the menu
interface, or whether you are requesting information or help, the screen
display changes to show a command line, menus and submenus, an information
window, or help windows.
The following sections describe all parts of the screen display.1
3.3.1 Current Panel
The current panel is the form panel currently displayed for editing. When
a panel becomes the current panel, it is displayed in the area of the screen
specified in its associated viewport. If a panel is not associated with a viewport,
it is displayed in the default viewport (which is based on the size of the current
layout).
1
DECforms software was used to create the CCPED user interface. The CCPED menus
are DECforms panels. Help in CCPED is provided by DECforms help messages and
help panels and by procedural escapes that access a help library.
3–4 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
CCPED displays markers for the viewport boundary for the current panel
whenever possible. The markers are shown in Figure 3–1 as a short line in
each corner of the current panel. The boundary markers do not appear as part
of the current panel, but appear one line or column outside the current panel’s
border. If the panel size extends to the edge of the display, CCPED does not
resize the display to show the boundary markers.
If the current panel is associated with a viewport having a width greater
than 80 columns or whose position is beyond column 80, CCPED changes the
terminal width to 132 columns (if it is not set to that width).
3.3.2 Status Line
The status line contains information about your editing session. Such
information includes the name of the current panel, the name of the current
object (panel field, panel group, or icon) on which the cursor is currently
positioned (if any), the text path or direction for entering text literals and
fields, and the current text entry mode (insert or overstrike).
The status line is displayed in reverse video as the message panel boundary,
and it moves as the message panel moves.
3.3.3 Message Panel
CCPED displays all messages in the message panel. Messages include warning
and informational messages, broadcast messages, and hints—help messages
that are displayed as a result of using the ENABLE HINTS command. Old
messages are scrolled out of the message window as new messages are
displayed.
To look at the most recently displayed message, use the Recall Message key
(PF1-PF3) or enter the RECALL MESSAGE command. CCPED displays the
message in the Information Window (see Section 3.3.6).
The message panel is two lines long and can appear initially at either the top
or the bottom of the screen, depending on the location and size of the current
panel. The message panel can move to the top or bottom of the screen during
your editing session.
3.3.4 Command Line
You can create and edit panels by entering CCPED commands on the command
line.
To display the Command> prompt, press Do or the Command key (PF1-KP7).
The command line overlays the top line of the message panel and disappears
after a command is executed.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–5
For information about how to enter and use CCPED commands, see
Section 3.4.
3.3.5 Menus
CCPED displays menus when you press certain keys on the CCPED default
keypad or when you enter certain commands without parameters. For
example, pressing the Set key (KP7) invokes the Set Display Attribute Menu;
items on some menus display submenus, as shown in Figure 3–2.
Figure 3–2 CCPED Menus and Submenus
To select an item, use the arrow keys to move to the menu item you want, and
then press Select.
To save and apply the selected item, select OK (or press F10 or PF1-E). To
cancel the selection, select Cancel (or press F8 or PF1-Q). CCPED returns you
to the previous menu or to the current panel.
3.3.6 Information Window
You can request information about your current form or editing session, such
as a listing of panels or viewports. You also can ask to see the message most
recently displayed in the message panel, in case the message was too long or
was obscured. CCPED displays the requested information in the Information
Window, shown in Figure 3–3.
To request information, use either:
•
The following commands:
LIST PANELS
LIST VIEWPORTS
RECALL MESSAGE
SHOW REFERENCES
3–6 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
•
The following keys:
List Panels (KP5)
List Viewports (KP6)
Recall Message (PF1-PF3)
For example, Figure 3–3 shows the information displayed in the Information
Window when you press List Panels while editing a panel in the sample
application form.
Figure 3–3 CCPED Information Window
CCPED lists the panels contained in the current layout and displays
additional information, including panel size and the associated viewport.
If the information is too long to be displayed at once, you can use the scroll
bar to the right of the window to scroll through the list of information.
To use the scroll bar:
1. Use the arrow keys to move the cursor to the diamond at the top of the
scroll bar (to move down the list) or to the diamond at the bottom of the
scroll bar (to move up the list).
2. Press Select to move through the list one line at a time, or press Next
Screen or Prev Screen to scroll page by page.
For help on using the Information Window, select the Help icon. When you
are finished with the Information Window, select OK. CCPED removes the
Information Window and returns the cursor to its previous position in the
current panel.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–7
3.3.7 Help Windows
There are two kinds of help windows in CCPED:
•
The Help window that results when you enter the HELP command or press
the Help key (PF1-PF2) on the CCPED keypad
The top part of the window displays help information; the bottom part
displays a list of additional topics.
To use this help, you can do any of the following:
Use the arrow keys to choose a topic from the list of additional topics,
and then press Select to display information about that topic.
Press Prev Screen and Next Screen to scroll through topic text.
Press Backspace, Ctrl/H, or F12 to go to the previous topic in the
current help level.
Press PF1-Backspace, PF1-Ctrl/H, or PF1-F12 to go back one help level,
and PF1-T or F11 to go back to the top help level.
Press PF1-E, F10, or F8 to exit the Help window.
•
The Help window that results when you select the Help icon in the
upper-right corner of a CCPED menu
The window displays help information and supplies icons for moving
through the information or for dismissing help.
You also can use the message panel to see brief help about the menu choice
or icon on which the cursor is currently positioned. To display menu hints,
enter the ENABLE HINTS command. Hints are displayed automatically as
you move the cursor in the menu. Menu hints are disabled by default.
3.4 Using CCPED Commands and Keys
This section contains general information about how to use CCPED commands
and keys. You perform CCPED functions by entering a command at the
Command> prompt. Many commands also are bound to keypad keys. You can
redefine these keys or define other function keys to customize your editing
session.
For a summary of the CCPED keys, see Appendix A. For a complete description
of each CCPED command, see Appendix B.
3–8 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.4.1 Entering Commands
To enter a CCPED command, use the following procedure:
1. Press Do or the Command key (PF1-KP7).
The Command> prompt is displayed in the message panel.
2. Enter the command at the prompt and press Return.
The command is executed, and the prompt is cleared from the screen.
To leave the command line without executing a command, leave the line
blank and press Return.
To enter several commands at once, separate each command with a semicolon
(;). For example:
Command> SELECT ALL; ORDER SELECTED OBJECTS; CHOOSE NEXT PANEL
CCPED commands that are too long to fit in the message panel are scrolled
horizontally. To see the complete command line, use the left and right arrow
keys.
To recall the previous command line, press Ctrl/B. You can recall up to 20
command lines.
To edit command lines, use the editing keys listed in Table 3–1. You also can
use these keys to edit text literals on the current panel.
Table 3–1 CCPED Editing Keys
Key or Key
Sequence
Command-Line Function
Text-Entry Function
Ctrl/A or F14
Switches text entry
mode between insert and
overstrike.
Same.
Ctrl/B or up arrow
Recalls up to 20 previously
entered command lines.
Ctrl/B recalls the previously
entered command. The up
arrow moves the cursor up one
line.
Ctrl/D or left arrow
Moves the cursor one
character to the left.
Ctrl/D ends the session. The
left arrow moves the cursor one
position to the left.
(continued on next page)
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–9
Table 3–1 (Cont.) CCPED Editing Keys
Key or Key
Sequence
Command-Line Function
Text-Entry Function
Ctrl/E
Moves the cursor to one
character position after the
last character on the line.
Same.
Ctrl/F or right arrow
Moves the cursor one
character to the right.
Same.
Ctrl/H or F12
Moves the cursor to the
beginning of the current
line.
Same.
Ctrl/I or Tab
(N/A)
Moves the cursor to the next
tab position on the line (eight
characters).
Ctrl/J or F13
Deletes characters from
the cursor position to the
beginning of the current
word.
Same.
Ctrl/M or Return
Executes a command line.
Moves the cursor to the
beginning of the next line.
Ctrl/R or Ctrl/W
Refreshes the command
line.
Refreshes the screen.
Ctrl/U
Deletes characters from
the cursor position to the
beginning of the line.
Deletes characters from the
cursor position to the beginning
of the text literal.
Delete
Deletes the previous
character.
Same.
Specifying Qualified Names as Command Parameters
When you enter a field, icon, or group name as a parameter to certain CCPED
commands, you must specify a fully qualified name. You do so by entering
the name of the field, icon, or group, as well as the names of any other groups
in which it is contained, separating each group item from the next with a
period.
For example, to select field FIELD_1, which is defined within group GROUP_1,
specify it as follows:
Command> SELECT NAMED GROUP_1.FIELD_1
3–10 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.4.2 Using Command Macros for Text Substitution
CCPED lets you use command macros for prompting and text substitution
within the command line. You can use command macros for all command
input; however, their primary usefulness is in commands bound to function
keys or used in command scripts. (See Section 3.4.5 for information on defining
function keys and Section 3.4.6 for information on using command scripts.)
To create and use a command macro:
1. Place a number-sign character (#) in the command line where you want the
prompt or substitution to occur.
2. Follow the number sign with the prompt string, enclosing the string in
single quotes (’ ’).
3. Execute the command.
CCPED queries you for text strings to substitute for the number sign and
prompt pair. For example:
Command> CREATE TEXT "Average " (#’Line: ’,#’Column: ’)
Line: 10
Column: 13
The following command gets executed:
CREATE TEXT "Average " (10,13)
If you do not specify a prompt string with the number sign, CCPED uses a
question mark (?) as a prompt.
To include a number sign as part of the command (within a quoted string, for
example), specify two number signs (##). For example:
Command> CREATE TEXT "## of copies: " (#’Line: ’,#’Column: ’)
Line: 12
Column: 2
The following command gets executed:
CREATE TEXT "# of copies: " (12,2)
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–11
3.4.3 Using Expressions
Many commands let you use an expression in place of a numeric value.
An expression consists of operands, which represent numeric values, and
operators, which operate on those values.
Operands can be either numeric literals (integer or floating point) or identifiers
(symbol names). If the context of the expression is such that only integer
values are meaningful (for example, character-cell positions), floating point
literals are truncated to an integer value. You must define a symbol before you
can use it in an expression (see Section 3.4.4).
CCPED provides the following operators:
Unary minus (–)
Unary plus (+)
Subtraction (–)
Addition (+)
Multiplication (*)
Division (/)
Exponentiation (^)
CCPED also provides the ABS$ function, which you can use in place of a
simple operand anywhere within an expression. The ABS$ function has the
following format:
ABS$(expression)
This function returns the absolute value of the specified expression.
3.4.4 Defining Symbols
To define symbols for subsequent use in expressions, use the DEFINE
SYMBOL command. CCPED enters the symbols in the CCPED symbol
table, which contains predefined symbols that you also can use in symbol
definitions. For example, you can use the LINE$ and COLUMN$ symbols to
define symbols for the cursor’s current position.
3–12 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
Table 3–2 lists the predefined symbols.
Table 3–2 CCPED Predefined Symbols
Symbol
Definition
COLUMN$
X$
Return the current, horizontal, character-cell position.
LINE$
Y$
Return the current, vertical, character-cell position.
COLUMN_MAX$
X_MAX$
Return the maximum horizontal position for the current panel.
LINE_MAX$
Y_MAX$
Return the maximum vertical position for the current panel.
In the following example, the symbol THIS_LINE is equated to the line on
which the cursor is located in the current panel when you execute the DEFINE
SYMBOL command. The symbol THIS_COLUMN is equated to the cursor’s
column location when the command is executed. Later on in the editing
session, you can use these symbols to return the cursor to that location, as
shown by the POSITION TO command:
Command> DEFINE SYMBOL This_line LINE$
Command> DEFINE SYMBOL This_column COLUMN$
.
.
.
Command> POSITION TO (This_line,This_column)
3.4.5 Defining CCPED Function Keys
To associate CCPED command strings with keyboard function keys, use the
DEFINE KEY command. The string can contain command-line macros as
well as multiple commands. Once you associate a command with a key, the
command is executed whenever you press that key.
To cancel a key definition, use the UNDEFINE KEY command.
When defining a key, you must specify the name of the key. You cannot define
the keys already used in CCPED command-line editing, listed in Table 3–1. In
addition, you cannot define the following function keys:
Ctrl/C
Ctrl/O
Ctrl/Q
Ctrl/S
Ctrl/T
Ctrl/V
Ctrl/X
Ctrl/Y
For a list of the names of keys you can define, see Appendix A.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–13
The following example shows how to define a key to create rectangular borders
around panels:
Command> DEFINE KEY F20 "CREATE RECTANGLE (1,1) (LINE_MAX$, COLUMN_MAX$)"
This command creates a rectangle the size of the viewport associated with the
current panel.
Note
Because you cannot specify that a viewport be bordered, you must use
the preceding method to create a border around each individual panel
that you want bordered.
3.4.6 Executing a Series of Commands in a Command Script
If you use a series of CCPED commands frequently, consider placing them in
a command script or command file. The following example shows a sample
CCPED command script named myscript.com. The exclamation mark ( ! )
denotes a comment:
! Script to create an icon-based menu
SELECT AT (LINE$,COLUMN$)
CREATE ICON #’Icon Name: ’
DESELECT AT (LINE$,COLUMN$)
POSITION NEXT OBJECT
To execute a command script, enter an at sign (@) and the script file name. For
example:
Command> @MYSCRIPT
By default, CCPED looks for a file with a .com extension. Execution of a
command script terminates when CCPED reaches the end of the file or when a
command in the script generates an error. Recursion is not allowed; you cannot
execute one command script from within another.
To control whether commands in a script are echoed during execution, use
the ENABLE ECHO and DISABLE ECHO commands. Echoing is disabled by
default.
To point to a script you want executed whenever you invoke CCPED, define the
logical name FORMS$EDIT_INIT.
3–14 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.4.7 Using the CCPED Default Keypad
Several CCPED commands are bound to keypad keys. Appendix A contains a
list of CCPED function keys, as well as a diagram of the default keypad.
The keypad diagram also is available on line. To access the online diagram
(and editing keypad on LK201 keyboards), press Help (PF2) or enter the
SHOW KEYPAD command.
With the diagram displayed, you can press any key on the keypad to see which
CCPED command that key reflects. To exit the diagram and return to the
current panel, press PF1-E or F10.
To customize your editing session, you can redefine the default keys or define
your own function keys, as described in Section 3.4.5.
3.5 Creating and Editing the Appearance of Panels
As you use CCPED, keep in mind that CCPED is an object-oriented editor.
Objects include background text and graphics (literals), icons, panel fields
(single or multiline text fields and single-line picture fields), and panel groups
(groups of multiply occurring objects).
An object editor differs from a character-cell editor (such as the FMS Form
Editor or a text editor) by manipulating the entire object, regardless of the
number of character cells it occupies. A character-cell editor manipulates one
character cell at a time.
Just as a single object might span multiple character cells, a single character
cell might contain multiple objects (except for fields, which cannot overlap).
For example, if you move the cursor over a polyline and type a space, the space
overlays the polyline; it does not edit it. The character cell at that position
contains a section of the polyline graphic object and a space text object. Both
are created in the IFDL source file and both exist as separate IFDL objects.
Note
There is one exception to the preceding description. You can edit a text
literal by moving the cursor over the text and editing the individual
characters. You are not creating a second text object.
To initiate CCPED operations, you can enter commands, or in many cases,
you can use the CCPED keypad. For complete information about any CCPED
command, see Appendix B.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–15
Some CCPED operations also are available through the FDE. For information
about using the FDE, see Chapter 2.
3.5.1 Moving the Cursor
To move the cursor within the current panel, use the arrow keys and the
keypad keys listed in Table 3–3. You also can use some of the control key
sequences listed in Table 3–1.
To see the cursor’s current line and column position, press the Show Position
key (PF3).
Note
Do not use the space bar to move the cursor when you are editing a
panel. The space bar creates literal spaces on the panel.
Table 3–3 CCPED Keys for Cursor Positioning
Name
Press . . .
To move the cursor . . .
Up
Up arrow
Up one row in the same column.
Top
PF1-Up arrow
To the top of the panel in the same
column.
Down
Down arrow
Down one row in the same column.
Bottom
PF1-Down arrow
To the bottom of the panel in the same
column; the message panel appears at the
top of the screen.
Left
Left arrow
One column to the left in the same line.
Leftmost Column
PF1-Left arrow
To the leftmost column of the panel in the
same line.
Bottom Left
PF1-KP4
To the bottom-left corner of the panel; the
message panel appears at the top of the
screen.
Upper Left
PF1-KP5
To the upper-left corner of the panel.
Right
Right arrow
One column to the right in the same line.
Rightmost Column
PF1-Right arrow
To the rightmost column of the panel in
the same line.
(continued on next page)
3–16 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
Table 3–3 (Cont.) CCPED Keys for Cursor Positioning
Name
Press . . .
To move the cursor . . .
Bottom Right
PF1-KP6
To the bottom-right corner of the panel;
the message panel appears at the top of
the screen.
Next Word
KP1
To the next word or object in a left-toright, top-to-bottom direction.
Previous Word
PF1-KP1
To the previous word or object in a rightto-left, bottom-to-top direction.
Next Object
Find or
KP3
To the next object or word in a left-toright, top-to-bottom direction.
Previous Object
PF1-Find or
PF1-KP3
To the previous object or word in a rightto-left, bottom-to-top direction.
End of Line
KP2
To the rightmost column of the panel in
the same line.
Beginning of Line
PF1-KP2
To the leftmost column of the panel in the
same line.
Next Line
KP0
To the beginning of the next line.
You also can use these POSITION commands to move the cursor:
POSITION TO
POSITION HORIZONTAL
n
POSITION NEXT OBJECT
WORD
POSITION PREVIOUS
n
o
OBJECT
WORD
o
POSITION VERTICAL
SHOW POSITION
3.5.2 Using the Repeat Key Function
Use the Repeat Key function to execute a character key or an arrow key a
specific number of times.
To use the Repeat Key function:
1. Press Do.
2. Press PF1.
3. Enter the number of repetitions.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–17
4. Press a character key or an arrow key.
For example, to move the cursor eight character-cell locations up from its
current position, press PF1, the number 8, and then the up arrow. To enter
nine X characters at the current cursor position, press PF1, the number 9, and
the character X.
3.5.3 Creating, Deleting, and Restoring Viewports
To create a new viewport in the current layout, use the CREATE VIEWPORT
command.
To delete a viewport, use the DELETE VIEWPORT command. References to
the default viewport replace any references in the form to the deleted viewport.
To restore deleted viewports, use one of these commands:
UNDELETE ALL VIEWPORTS
UNDELETE LAST VIEWPORT
UNDELETE VIEWPORT name
The following CCPED commands supply additional viewport operations:
LIST VIEWPORTS
MODIFY VIEWPORT TERMINAL WIDTH
MOVE CURRENT VIEWPORT
MOVE VIEWPORT name
RESIZE CURRENT VIEWPORT
RESIZE VIEWPORT name
The List Viewports key (KP6) performs the same operation as the LIST
VIEWPORTS FULL command. CCPED lists the viewports contained in the
current layout and displays additional information, including the size and
position of the viewports.
3.5.4 Creating, Deleting, and Restoring Panels
To create panels and associate them with viewports, use the CREATE PANEL
command. Use only alphabetic characters when naming a panel.
To delete panels, use the DELETE PANEL command.
To restore a deleted panel, use one of these commands:
UNDELETE ALL PANELS
UNDELETE LAST PANEL
UNDELETE PANEL name
3–18 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.5.5 Choosing Panels
To choose panels use either:
•
The CHOOSE command
•
One of the following CCPED keys, depending on which panel you want to
choose:
Next Panel (Next Screen)
Previous Panel (Prev Screen)
First Panel (PF1-Prev Screen)
Last Panel (PF1-Next Screen)
The following commands supply additional panel operations:
LIST PANELS
MODIFY PANEL TERMINAL WIDTH
MODIFY PANEL VIEWPORT
SHOW PANEL VIEWPORT
Use the List Panels key (KP5) to perform the same operation as the LIST
PANELS FULL command. CCPED lists the panels contained in the current
layout and displays additional information, including panel size and the
associated viewport.
3.5.6 Setting and Modifying Attributes
When you create a panel, panel object, or viewport, you can assign it a set of
attributes (display characteristics), such as font size or color. The following
sections describe the attributes that you can set and modify using CCPED.
3.5.6.1 Setting Video Attributes
You can set the following video attributes for panel objects:
Bolding
Underlining
Blinking
Reverse video
Once you set an attribute, it is applied to any panel object that you
subsequently create.
To set video attributes, use either of the following:
•
The SET VIDEO command
•
The Video Attributes submenu, as follows:
1. Press Set (KP7) to display the Set Display Attribute Menu.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–19
2. Select Video Attributes.
CCPED displays the Video Attributes submenu.
3. Select the attributes you want to apply to subsequent objects.
A diamond (♦) next to an attribute indicates it is selected. The text
Sample of Video Setting changes to reflect the attributes chosen.
To turn off an attribute, select it again. The diamond disappears,
indicating that the attribute will not be applied. To turn off all
attributes, select None (the default).
4. Select OK to return to the Set Display Attribute Menu, where you can
select another display attribute or return to panel editing.
All subsequent objects that you create will have the video attributes
selected.
You also can specify different video attributes for an object based on the type
of terminal on which the form will be displayed, but you must edit the form
manually. Example 3–1 in Section 3.5.6.8 shows sample IFDL syntax, using
different font sizes as an example.
3.5.6.2 Modifying Video Attributes
To modify the video attributes of existing panel objects, select the objects to be
modified (see Section 3.5.8.1), and then use either:
•
The MODIFY SELECTED OBJECTS VIDEO command
•
The Video Attributes submenu, as follows:
1. Press Modify (KP4) to display the Modify Display Attribute Menu.
This menu is the same as the Set Display Attribute Menu.
2. Select Video Attributes.
3. Select the attributes to be applied to or removed from the selected
objects.
3–20 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
4. Exit the menus.
The selected objects are modified according to the attributes you chose.
3.5.6.3 Modifying the Color of Display Attributes
If your form is going to run on color terminals, you can specify background and
foreground colors for all the panels in a viewport, for the current panel, or for
panel objects. You also can specify colors for bold and reverse video attributes
for panels.
To specify the color of display attributes for all the panels in a viewport,
use the MODIFY VIEWPORT display-attribute COLOR command. The
attributes apply to all panels in the viewport unless the attributes are explicitly
overridden for individual panels.
To specify the color of display attributes for the current panel, use the MODIFY
PANEL display-attribute COLOR command. This command does not change
the viewport attributes, but does override the viewport attributes when the
panel is displayed.
To set the background or foreground color for panel objects, use the SET
display-attribute COLOR command. The color applies to all subsequent panel
objects you create. To specify the color of display attributes for selected panel
objects, use the MODIFY SELECTED display-attributes COLOR command.
For a list of the colors you can specify, see the command descriptions in
Appendix B.
3.5.6.4 Setting the Font Size
You can set the following font sizes to text literals and fields:
Single-high
Double-high
Double-wide
Once you set an attribute, it is applied to any object that you subsequently
create.
To set the attributes, use either of the following:
•
The SET FONT SIZE command
•
The Font Size submenu, as follows:
1. Press Set (KP7) to display the Set Display Attribute Menu.
2. Select Font Size.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–21
CCPED displays the Font Size submenu. \
3. Select the font size you want to apply to subsequent objects.
A diamond (♦) next to the font size indicates that it is selected. You
can select only one font size at a time.
4. Select OK to return to the Set Display Attribute Menu, where you can
select another display attribute or return to panel editing.
All subsequent objects that you create will have the font size selected.
Restrictions
When setting font sizes:
•
You cannot have more than one font size on the same line.
•
If a panel’s viewport begins on an odd-numbered column, doublehigh and double-wide objects must begin on odd-numbered columns.
If a panel’s viewport begins on an even-numbered column, doublehigh and double-wide objects must begin on even-numbered
columns.
•
You cannot create double-high objects on the top line of a panel.
You also can specify different font sizes for an object based on the type of
terminal on which the form will be displayed, but you must edit the form
manually. Example 3–1 in Section 3.5.6.8 shows the IFDL syntax.
3.5.6.5 Modifying the Font Size
To modify the font size of existing objects, select the objects to be modified (see
Section 3.5.8.1), and then use either:
•
The MODIFY SELECTED OBJECTS FONT SIZE command
3–22 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
•
The Font Size submenu, as follows:
1. Press Modify (KP4) to display the Modify Display Attribute Menu.
This menu is the same as the Set Display Attribute Menu.
2. Select Font Size and choose the font size to be applied to or removed
from the selected objects.
3. Exit the menus.
The selected objects are modified according to the font size you chose to
apply or remove.
Restrictions
The restrictions that apply to setting a font size also apply to modifying
a font size. See Section 3.5.6.4.
3.5.6.6 Setting Line Width
You can apply the following line widths to graphic literals:
Single-high
Double-high
Double-wide
To set a line width so it is applied to all subsequent objects you create, use
either:
•
The SET LINE WIDTH command
•
The Line Width submenu, as follows:
1. Press Set (KP7) to display the Set Display Attribute Menu.
2. Select Line Width.
CCPED displays the Line Width submenu.
3. Select the line width you want to apply to subsequent objects.
A diamond (♦) next to the line width indicates that it is selected. You
can set only one line width at a time.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–23
4. Select OK to return to the Set Display Attribute Menu, where you can
select another display attribute or return to CCPED.
All subsequent objects that you create will have the line width
selected.
Restrictions
When setting line widths:
•
You cannot have more than one line width on the same line.
•
If a panel’s viewport begins on an odd-numbered column, doublehigh and double-wide objects must begin on odd-numbered columns.
If a panel’s viewport begins on an even-numbered column, doublehigh and double-wide objects must begin on even-numbered
columns.
•
You cannot create double-high objects on the top line of a panel.
You also can specify different line widths for an object based on the type of
terminal on which the form will be displayed, but you must edit the form
manually. Example 3–1 in Section 3.5.6.8 shows sample IFDL syntax, using
different font sizes as an example.
3.5.6.7 Modifying Line Width
To modify the line width of existing objects, first select the objects to be
modified (see Section 3.5.8.1), and then use either:
•
The MODIFY SELECTED OBJECTS LINE WIDTH command
•
The Line Width submenu, as follows:
1. Press Modify (KP4) to display the Modify Display Attribute Menu.
This menu is the same as the Set Display Attribute Menu.
2. Select Line Width and choose the line width to be applied to or removed
from the selected objects.
3. Exit the menus.
The selected objects are modified according to the line width you chose
to apply or remove.
3–24 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
Restrictions
The restrictions that apply to setting a line width also apply to
modifying a line width. See Section 3.5.6.6.
3.5.6.8 Specifying Display Attributes Based on Terminal Type
You can specify named attributes to apply different video attributes, font
sizes, or line widths to objects based on the type of terminal on which a form
will be displayed. Because CCPED does not allow the specification of named
attributes, you must use the ATTRIBUTE declaration and FOR clause in the
IFDL. Example 3–1 shows the IFDL syntax, based on applying different font
sizes.
When you use these statements to specify different font sizes and then edit the
panel in CCPED, CCPED displays objects in the largest size specified in the
IFDL source file. For different line widths or video attributes, CCPED displays
objects by using whichever attribute occurred first in the FOR clause.
For more information on the IFDL statements used in the example, see the HP
DECforms IFDL Reference Manual.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–25
Example 3–1 IFDL Source for Attributes Based on Terminal Type
Form FOR_CLAUSE_FORM
Layout CC
Device
Terminal T1
Type %VT100
Terminal T2
Type %VT200
Terminal T3
Type %VT300
End Device
Size 25 Lines by 80 Columns
Attribute MULTIPLE_SIZES
For T1
Is
Font Size Double Wide
For T3
Is
Font Size Double High
End Attribute
.
.
.
Panel PANEL_1
Literal Text
Line 4
Column 5
Value "Object with multiple size attribute"
Display
MULTIPLE_SIZES
Reverse
End Literal
End Panel
End Layout
End Form
3–26 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.5.6.9 Setting the Character Set
You can apply the following character sets to text literals and fields:
User Preference
ISO_8859/1
ISO Latin-1
ISO_8859/5
ISO Latin-5
ASCII
UK
Rule
VT100 Set One
VT100 Set Two
Hebrew
Turkish
Hanyu
Hangul
Kanji
Thai
Katakana
MIA-Kanji
This attribute does not apply to graphic literals.
To set a character set so it is applied to all subsequent objects you create, use
either:
•
The SET CHARACTER SET command
•
The Character Set submenu, as follows:
1. Press Set (KP7) to display the Set Display Attribute Menu.
2. Select Character Set.
CCPED displays the Character Set submenu.
3. Select the character set you want to apply to subsequent objects.
A diamond (♦) next to the character set indicates that it is selected.
You can set only one character set at a time.
4. Select OK to return to the Set Display Attribute Menu, where you can
select another display attribute or return to CCPED.
All subsequent objects that you create will have the character set
selected.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–27
Restriction
Not all character sets are supported on all terminals. CCPED lets you
set the character set, but the panel’s appearance depends on the display
device.
3.5.6.10 Modifying the Character Set
To modify the character set of existing objects, select the objects to be modified
(see Section 3.5.8.1), and then use either:
•
The MODIFY SELECTED OBJECTS CHARACTER SET command
•
The Character Set submenu, as follows:
1. Press Modify (KP4) to display the Modify Display Attribute Menu.
This menu is the same as the Set Display Attribute Menu.
2. Select the Character Set choice and choose the character set to be
applied to or removed from the selected objects.
3. Exit the menus.
The selected objects are modified according to the character set chosen.
3.5.6.11 Setting the Text Path
You can set the text path, or direction, for entering text literals and fields as
follows:
Left to right (the default)
Right to left (Hebrew)
To set the text path so it is applied to all subsequent text objects you create,
use either:
•
The SET TEXT PATH command
•
The Text Path submenu, as follows:
1. Press Set (KP7) to display the Set Display Attribute Menu.
2. Select Text Path.
CCPED displays the Text Path submenu.
3–28 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3. Select the text path you want to apply to subsequent objects.
A diamond (♦) next to the text path indicates that it is selected. You
can select only one text path at a time.
4. Select OK to return to the Set Display Attribute Menu, where you can
select another display attribute or return to CCPED.
All subsequent objects that you create will have the text path selected.
3.5.6.12 Modifying the Text Path
To modify the text path of existing objects, select the objects to be modified (see
Section 3.5.8.1), and then modify the text path using either:
•
The MODIFY SELECTED OBJECTS TEXT PATH command
•
The Text Path submenu, as follows:
1. Press Modify (KP4) to display the Modify Display Attribute Menu.
This menu is the same as the Set Display Attribute Menu.
2. Select Text Path and choose the text path to be applied to or removed
from the selected objects.
3. Exit the menus.
The selected objects are modified according to the text path chosen.
3.5.7 Creating and Deleting Objects
The following sections describe how to create background objects (text literals
and graphic objects), icons, panel fields, and panel groups, and how to delete
and restore panel objects.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–29
3.5.7.1 Creating and Editing Text Objects
To create text objects, also known as text literals or text strings, either:
•
Use the CREATE TEXT command.
•
Enter the text directly on the panel at the location where you have
positioned the cursor.
To edit the text:
•
Use the line editing function keys described in Table 3–1.
•
Use the TOGGLE ENTRY MODE command to switch between insert and
overstrike mode, as an alternative to using Ctrl/A.
The default is the mode to which your terminal is set when you invoke
CCPED. The status line tells you the mode you are currently using.
•
Use the KP comma key or the DELETE CHARACTER command to delete
single characters, as alternatives to using the Delete key.
•
Type over or insert characters in an existing text literal by using the
corresponding entry mode.
•
Modify the display attributes of a text object by using the MODIFY
command or the Modify Display Attribute Menu.
For more information, see Section 3.5.6.2, Section 3.5.6.5, and Section 3.5.6.7.
3.5.7.2 Creating Graphic Objects
To create graphic objects, use one of three methods:
•
The MARK and CREATE MARKED OBJECT commands, interactively or
in scripts
•
The following commands to create specific graphic objects:
CREATE POINT
CREATE POLYLINE
CREATE RECTANGLE
•
The Mark (KP9) and Draw Object (KP hyphen) keys to interactively create
and connect marks, as follows:
1. Move the cursor to a location on the panel and press Mark to create a
mark at that location.
2. Do the same for subsequent marks.
3. Press Draw Object to connect the marks to create an object.
3–30 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
To modify the display attributes of graphic objects, use the MODIFY command
or the Modify Display Attribute Menu. See Section 3.5.6.2, Section 3.5.6.5, and
Section 3.5.6.7.
For an example of how you can use CREATE RECTANGLE to create
rectangular borders for panels, see Section 3.4.5.
3.5.7.3 Creating Icons
To create an icon, select the background objects that will compose the icon, and
then enter the CREATE ICON command. For example:
Command> SELECT ALL; CREATE ICON OPTION_1
This command creates an icon named OPTION_1 from all background objects
on the current panel. Any nonbackground objects (for example, panel fields)
that you have selected are ignored. The objects composing the icon must not
belong to any other icons.
After you create an icon, you can use the IFDL to declare a corresponding
function response, or some other response, such as an entry or exit response.
For information about writing function responses, declaring icons in panel
groups, and activating icons, see the HP DECforms Guide to Developing an
Application.
For information about deleting and restoring icons, see Section 3.5.7.8.
For information about modifying the display attributes of an icon, see
Section 3.5.6.2, Section 3.5.6.5, and Section 3.5.6.7.
3.5.7.4 Creating an Icon-Based Menu
This section describes one method of creating a menu panel containing icons
that function as menu choices (similar to the FDE Main Menu, for example). It
also illustrates the use of CCPED command macros.
To create an icon-based menu panel, use the following procedure:
1. Using the text editor of your choice, create a command script named
create_icon.com that contains the following CCPED commands:
SELECT AT (LINE$,COLUMN$)
MODIFY SELECTED VIDEO REVERSE
CREATE ICON #’Icon Name: ’
DESELECT AT (LINE$,COLUMN$)
POSITION NEXT OBJECT
! To highlight the icons
2. Invoke CCPED and create the panel (possibly including a heading).
3. Move the cursor to the location on the panel where you want the first icon.
4. Enter the text (no video attributes) for the first icon.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–31
5. Move the cursor to the location for the next icon and enter the text.
6. Repeat steps 3 to 5 until you have created text literals for all the icons.
7. Position the cursor to the first icon text you created, press Do, and enter
the following:
@CREATE_ICON
8. Name the icon in response to the icon name prompt.
CCPED adds reverse video to the text literal, creates the icon, inserts the
literal in the icon, and moves the cursor to the next icon text.
9. Repeat steps 7 and 8 until all the icons are defined.
You can use command recall to call the command script, or you can define
a CCPED key by entering the following command:
Command> DEFINE KEY PF1_I "@CREATE_ICON"
You can substitute a key of your choice for PF1_I. To execute the script,
press whatever key you define.
After you have defined all the icons, exit CCPED, and then use a text editor to
edit the IFDL source file and add function declarations and function responses
according to how you want the operator to navigate the menu.
3.5.7.5 Creating Panel Fields
To create a panel field in CCPED, use one of three methods:
•
The CREATE FIELD command with the necessary parameters
•
CCPED prompts
Press the Create Field key (PF1-KP8). CCPED prompts you for the field’s
name and type, and creates the field at the current cursor position.
•
The Create Field Menu, as follows:
1. Press Create Field (KP8), or enter the CREATE FIELD command with
no parameters.
CCPED displays the Create Field Menu.
3–32 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
For information about filling in the menu, select the Help icon. For
brief help on a menu field, press Help while the cursor is on that field.
For more detailed information, press Help again.
2. Enter a field name in the Field Name field.
This information is required.
3. Enter a data type in the Data Type field.
If no existing form data item matches the field name, you must supply
a data type. For a list of the valid data types you can choose from,
press Select at the Data Type field. CCPED displays the Choose Data
Type Menu.
4. Specify a field picture in the Picture field, or let CCPED generate a
default from the data type specified.
5. Select the Date Picture option if the field is a date.
6. Specify new line and column values if you want to override the values
of the current cursor position.
7. Specify the number of rows if the field is to contain multiple lines.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–33
8. Specify the number of columns to be used to display the data. For
example, if you specify 10, the field will display 10 characters of data in
each row. (The size of the panel field does not have to be the same as
the form data item being displayed.)
When you create fields in CCPED, CCPED creates matching form data items
if none currently exist. If you have a form data section (delimited by the IFDL
statements FORM DATA and END DATA) that is marked TRACKED, and if
that section is the last or the only form data section in your form, CCPED
creates a new form data section when it creates its first new form data item
or form data group. All subsequent form data items or groups that CCPED
creates are placed in this new form data section.
If the last or only form data section in your form is not marked TRACKED,
CCPED creates all form data items or groups in that section.
For information about form data and how to use the TRACKED clause, see the
HP DECforms Guide to Developing an Application.
When you create a field that maps to a built-in form data item that already
exists and is declared as a built-in, the field is automatically marked
PROTECTED. In this case, an informational message is displayed.
IFDL syntax rules require that you declare fields that map to built-in form
data items as either PROTECTED or NO DATA INPUT. To declare the newly
created field to be NO DATA INPUT, rather than PROTECTED, select the field
and modify its description attributes with the MODIFY FIELD DESCRIPTION
command or the Modify Field Description Menu. For example:
Command> MODIFY FIELD DESCRIPTION NOT PROTECTED NO DATA INPUT
For information about deleting and restoring panel fields, see Section 3.5.7.8.
For information about modifying the display attributes of a panel field, see
Section 3.5.6.2, Section 3.5.6.5, and Section 3.5.6.7.
3.5.7.6 Modifying Panel Field Descriptions and Pictures
To modify default description attributes of panel fields, such as field
justification or minimum field length, use either:
•
The MODIFY FIELD DESCRIPTION command with the necessary
parameters
•
The Modify Field Description menu, as follows:
1. Move to the field to be modified and press Modify Field Description
(PF1-Enter), or select the field and enter the MODIFY FIELD
DESCRIPTION command with no parameters.
3–34 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
CCPED displays the Modify Field Description Menu.
2. Select the attribute you want to modify.
A diamond (♦) next to the attribute indicates that it is selected. The
Minimum Length, Timeout, and Scale fields require values.
Some field description attributes conflict. For information about such conflicts,
see the section on ITEM DESCRIPTION Entry in the HP DECforms IFDL
Reference Manual.
To modify a panel field’s picture or date picture, use the MODIFY FIELD
PICTURE command.
3.5.7.7 Creating Panel Groups
To create a panel group on the current panel, use the CREATE GROUP
command. You must create panel groups in a top-down sequence; you create
the group first, and then create the objects inside the group.
To add literals to an existing panel group, select the objects and enter
the GROUP SELECTED OBJECTS command. This command adds only
background objects to a panel group; you cannot use it to group fields, icons, or
other groups. You must use The CREATE FIELD, CREATE ICON, or CREATE
GROUP command using a fully qualified name.
To remove background literals from an existing panel group, select the objects
and enter the UNGROUP SELECTED OBJECTS command. This command
has the same restrictions as the GROUP SELECTED command.
To change the horizontal or vertical display of a panel group, use the MODIFY
GROUP command.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–35
For information about using panel groups to display form data groups, and
about activating and specifying navigation in panel groups, see the HP
DECforms Guide to Developing an Application.
For information about deleting and restoring panel groups, see Section 3.5.7.8.
For information about modifying the display attributes of a panel group, see
Section 3.5.6.2, Section 3.5.6.5, and Section 3.5.6.7.
3.5.7.8 Deleting and Restoring Panel Objects
To delete objects from a panel, select the objects to be deleted, and then either:
•
Use the DELETE SELECTED OBJECTS command.
If you are deleting panel fields, icons, or panel groups, you can use the
DELETE NAMED command instead.
•
Press Delete.
The deleted objects are added to a deletion list and are discarded when you
exit CCPED.
To restore deleted objects in the same editing session, use one of these
commands:
UNDELETE LAST OBJECT
UNDELETE ALL OBJECTS
3.5.8 Manipulating Objects
Once you have created a panel object, you can use CCPED to select and
deselect the object, move it, copy it using the CCPED clipboard, and change the
order in which it is accessed in a panel. The following sections describe these
operations.
3.5.8.1 Selecting and Deselecting Objects
Before you can perform an operation on an object—such as modifying, moving,
or deleting it—you must first select the object. Reverse highlighting indicates
that an object is selected.
To select an object, either:
•
Use one of the following commands:
SELECT
SELECT
SELECT
SELECT
SELECT
ALL OBJECTS
AREA
AT
MARKED AREA
NAMED
3–36 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
•
Place the cursor on the object to be selected and press Select; repeat this
procedure to select more than one object.
If you decide that you do not want an object to be selected, you can deselect the
object. Some CCPED key commands automatically deselect a selected object
after the command operation.
To deselect objects, either:
•
Use one of the following commands:
DESELECT
DESELECT
DESELECT
DESELECT
DESELECT
DESELECT
•
ALL OBJECTS
AREA
AT
LAST
MARKED AREA
NAMED
Place the cursor on the object to be deselected and press the Deselect key
(PF1-Select or PF1-KP period).
3.5.8.2 Selecting and Deselecting Compound Objects
An object that is composed of other objects (for example, a panel group or an
icon) is a compound object.
To select a compound object, use one of the following commands:
SELECT
SELECT
SELECT
SELECT
SELECT
AT
AREA
MARKED AREA
NAMED
ALL OBJECTS
When you select objects interactively, CCPED adds the lowest-level object to
its internal selection list. For example, assume that you have an icon created
from several literals. CCPED adds elements to the selection list according to
how you select the icon, as follows:
•
If you select the icon using the SELECT AT command or the Select key,
CCPED adds only the individual literals to the panel’s selection list.
•
If you use the SELECT AREA or SELECT MARKED AREA commands, the
icon (and not its individual elements) is added to the selection list, provided
all its components are within the specified area.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–37
•
If you use the SELECT NAMED or SELECT ALL OBJECTS commands,
the icon (and not its individual elements) is added to the selection list. You
should consider using these commands to select a compound object, because
you can be assured of capturing the whole icon.
To deselect a compound object, use either the DESELECT NAMED or
DESELECT ALL OBJECTS command.
3.5.8.3 Moving Objects
To move objects within the current panel, use either:
•
The MOVE SELECTED OBJECTS command
•
The Move key (PF1-KP comma), as follows:
1. Select the objects you want to move.
2. Move the cursor to the new location.
3. Press PF1-KP comma.
The object is moved to the new location.
You also can move and copy objects between panels using the CCPED
clipboard. See Section 3.5.8.4.
3.5.8.4 Using the Clipboard
CCPED contains a clipboard for use as a storage area for selected objects. The
clipboard lets you transfer or copy objects within a panel or from one panel to
other panels. The objects are stored on pages. Each time you copy or remove
objects to the clipboard, a new top page is created and other pages are moved
down the clipboard. Only the top (most recent) page is available to you at any
one time. You can move the top page to the bottom of the clipboard to make
the next page available.
Table 3–4 describes the commands and corresponding keys used for clipboard
operations. The procedure following the table illustrates how to copy objects
between panels.
3–38 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
Table 3–4 CCPED Clipboard Operations
Commands
Keys
Description
COPY FROM CLIPBOARD
PF1-Insert Here
Copies the objects from the top page
to the current panel and retains that
page on the clipboard.
COPY SELECTED OBJECTS
TO CLIPBOARD
PF1-Remove
Copies selected objects to the top
page and retains them on the current
panel. This operation creates a top
page and moves other pages down.
INSERT FROM CLIPBOARD
Insert Here
Places the objects from the top page
on the current panel. That page is
removed from the clipboard and the
next page becomes available.
REMOVE SELECTED
OBJECTS TO CLIPBOARD
Remove
Places selected objects on the top
page and removes them from the
current panel. This operation creates
a top page and moves other pages
down.
ROTATE CLIPBOARD
(N/A)
Moves the top page to the bottom
of the clipboard and makes the next
page the top page.
VIEW CLIPBOARD
Enter
Displays the top page of the
clipboard. Press any key to return
to editing the current panel.
Restriction
You cannot copy or remove individual elements of a compound object to
the clipboard—only the entire compound object. For information about
compound objects, see Section 3.5.8.2.
The following procedure uses CCPED keypad keys to illustrate how to use the
clipboard to copy objects between different panels. Use this same procedure to
copy objects to another location on the current panel.
To copy objects between panels, use the following procedure:
1. Select the objects you want to copy.
2. Press the Copy to Clipboard key (PF1-Remove) to copy the selected object
to the clipboard.
This key sequence keeps a copy of the selected object in its current location.
The Remove to Clipboard key copies the object to the clipboard while
removing it from its current location.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–39
3. Choose the panel where you want to copy the object.
Omit this step if you are copying the selected object to another location on
the current panel.
4. Position the cursor to the location where you want to copy the object.
5. Press the Copy from Clipboard key (PF1-Insert Here) to place a copy of the
object at the new location.
Note
When you copy objects, CCPED also copies any responses defined
within fields, icons, or groups that you are copying. Therefore, you
might need to modify the response steps ACTIVATE, DEACTIVATE,
and POSITION after those objects are copied. For information about
using response steps, see the HP DECforms Guide to Developing an
Application.
3.5.8.5 Changing the Order of Objects in a Panel
You can change the order in which selected objects are drawn on the screen to
give the operator more flexibility in navigating a panel.
The Form Manager draws objects in the following order:
1. Literals, in the order in which they appear in the IFDL source file
Literals within panel groups are drawn in the IFDL order in which they
appear in the groups, and panel groups are processed in IFDL order
relative to other panel objects. Literals within icons are drawn in IFDL
order relative to the icons.
2. Panel fields and icons, in the order in which they appear in the IFDL
source file
Panel fields and icons within panel groups are drawn in the IFDL order in
which they appear in the groups, and panel groups are processed in IFDL
order relative to other panel objects.
To change the order in which objects are drawn on the screen, use the ORDER
SELECTED OBJECTS command.
Restriction
The selected objects must belong to the same parent; for example, you
cannot reorder selected fields that are in different panel groups.
3–40 Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED)
3.6 Checking Panel Appearance
Once you have created the appearance of panels in your form, you can check
panel appearance and test input fields.
To check the appearance of panels in character-cell layouts and test input
fields, use the TEST command to invoke the Test Utility. To exit the Test
Utility, press F10. For more information about the Test Utility, see Chapter 4.
You also can save the form and exit CCPED, and then run the Extract
Appearances Utility from the system prompt to produce a file suitable for
printing. For more information about the Extract Appearances Utility, see
Chapter 6.
Editing Panel Appearance Using the Character-Cell Panel Editor (CCPED) 3–41
4
Testing a Form
The Test Utility provides a way for you to test the appearance of panels in a
character-cell layout without writing an application first. You can evaluate the
appearance of each panel as it is seen at run time, and you can observe the
input fields as they appear to the operator.
This chapter explains how to:
•
Invoke and exit the Test Utility
•
Check panel appearance
•
Navigate panels
Note
You cannot use the Test Utility to test the appearance of panels in
PRINTER layouts. Instead, use the Extract Appearances Utility to
produce a file containing printable representations of the PRINTER
panels. For information about the Extract Appearances Utility, see
Chapter 6.
4.1 Invoking and Exiting the Test Utility
To invoke the Test Utility, at the system prompt enter a command in the
following format:
FORMS TEST APPEARANCES input-file-spec
Replace input-file-spec with the name of the form file containing the panels to
be tested. The default input file type is .form.
When you have finished testing all panels, press F10 or Ctrl/Z to exit the Test
Utility.
For a complete description of the FORMS TEST APPEARANCES command
and its qualifiers, see Chapter 1.
Testing a Form 4–1
4.2 Testing Panels
Use the Test Utility to test panel appearance and field pictures. You can enter
data into the accessible fields on a panel; the Test Utility performs field picture
validation. It does not perform any other validation, such as function responses
and WHEN clauses. You cannot test requests.
In character-cell layouts, if the panel has no fields, or if all the fields are
protected, the Test Utility executes an ACTIVATE WAIT response step for that
panel. Navigate to another panel, or exit the Test Utility. For information
about the ACTIVATE WAIT response step, see the HP DECforms IFDL
Reference Manual.
If you have defined any help messages or help panels for a panel or fields on
a panel, you can check the help information by pressing Help or PF2. (The
information that is displayed is not help about the Test Utility.)
The Test Utility displays panels in the order in which they are declared in the
form. You can display specific panels by naming them in the /PANEL qualifier
when you invoke the Test Utility.
Figure 4–1 shows one of the panels in the introductory sample checking
application as displayed by the Test Utility. Section 4.3 describes how to
navigate fields and panels.
4–2 Testing a Form
Figure 4–1 Panel Displayed by the Test Utility
CHECK_PANEL
WRITE A CHECK
0
Date:
Pay to
April 15, 1997
Amount ********0.00
Memo
FIRST NATIONAL BANK
Account 00000
Enter values and then press CTRL/D to finish check.
ZK−6633A−GE
4.3 Navigating Panels
To move around each panel, use the default DECforms function keys defined
for your system. Functions and function responses defined in your form have
no effect.
Table 4–1 summarizes frequently used navigation functions.
Table 4–1 Default Panel Navigation Functions
To . . .
Press . . .
Move to the next field
Return
Move the previous field
Backspace (F12) or
Ctrl/H
Move the cursor within a field
Left arrow
Right arrow
(continued on next page)
Testing a Form 4–3
Table 4–1 (Cont.) Default Panel Navigation Functions
To . . .
Press . . .
Delete the character to the left of the
cursor
Delete
Erase the current contents of a field
Linefeed (F13)
Switch between overstrike mode (for
typing over characters) and insert mode
(for inserting characters)
Ctrl/A
Move to the Next Panel
Next Screen
Move to the Previous Panel
Prev Screen
Exit
F10
Ctrl/Z
4–4 Testing a Form
5
Translating IFDL Source Files and Form
Files
IFDL source files are text files comprised of IFDL language statements. Form
files are their binary run-time equivalents.
The FDE accepts input files in either format and automatically produces
output files in both formats.
This chapter describes how to use:
•
The IFDL Translator to translate IFDL source files into FORM form files
•
The Back Translator to translate FORM form files back into IFDL source
files
5.1 Translating IFDL Source Files into Form Files
The IFDL Translator translates an IFDL source file to a binary form file. The
form file then can be displayed on a supported display device by the Form
Manager, analyzed with the form development utilities, or edited in the FDE
or by a panel editor.
Figure 5–1 illustrates the translation process.
5.1.1 Invoking the IFDL Translator
To invoke the IFDL Translator, at the system prompt enter a command in the
following format:
FORMS TRANSLATE input-file-spec
Replace input-file-spec with the name of the IFDL source file. The default file
type is .ifdl. If the input file contains a COPY statement, input also can come
from other sources. The IFDL Translator can produce three kinds of output,
described in Section 5.1.2.
Translating IFDL Source Files and Form Files 5–1
Figure 5–1 Translating IFDL Source File to Binary Form File and Back
.IFDL
source
file
IFDL
Translator
.FORM
file
Back
Translator
.IFDL
source
file
ZK−7908−GE
The IFDL Translator translates only the form corresponding to the first FORM
statement in the file. When the translator reaches an END FORM statement,
it issues warning messages for any noncommented text remaining in the file,
closes all files, and terminates all processing.
For a complete description of the FORMS TRANSLATE command, see
Chapter 1. For a description of the COPY statement, see the HP DECforms
IFDL Reference Manual.
5.1.2 IFDL Translator Output
The IFDL Translator can produce three kinds of output files:
•
Form file
•
Listing file
•
Diagnostics file
The following sections describe these files.
5.1.2.1 Form File
The form file produced by the IFDL Translator is the binary version of the
form. In general, the form file is the only file format acceptable as input to the
Form Manager and the form development utilities. The FDE accepts both form
files and IFDL source files as input. The Extract Object Utility can convert a
form file to an object module.
If the form refers to panels or panel objects that do not yet exist (you have not
yet created them in the form), the IFDL Translator produces the form file, but
generates warning messages and marks the form file as incomplete.
The Form Manager cannot display incomplete forms. Also, the Extract Object
Utility does not work with incomplete forms.
5–2 Translating IFDL Source Files and Form Files
The FDE and the panel editors do accept incomplete forms as input so you can
edit them, and the Back Translator does translate incomplete forms.
5.1.2.2 Listing File
The IFDL Translator produces a listing file when you use the /LIST qualifier in
the FORMS TRANSLATE command, or when you run the IFDL Translator in
batch mode.
The listing file contains the following information:
•
Heading—The heading includes:
The date and time the listing file was created
The name and version number of the IFDL Translator
The full file specification of the input file
The date and time of creation or last modification of the input file
•
Source code text—The body of the listing contains the source code text in
consecutively numbered lines. The format of these lines (length, location of
carriage returns, indentation, and so on) is the same as the format in the
input file. All comments appear in the listing just as they appear in the
source file.
There is no restriction on the length of an input line from a source file.
The text is wrapped when written to the listing file, with the line number
appearing at the beginning of the first physical line in the listing file.
•
Error messages—Any syntactic or semantic errors are reported immediately after the end of the full line of source language text that caused
the error (or as close to the end of the line as possible). The end-of-line
delimiter determines the end of the full line.
For information on the format and interpretation of error messages, see
Chapter 1.
•
Compilation summary—At the end of the listing file, the IFDL Translator
supplies a summary of compilation statistics and information. The
summary includes:
The date and time the compilation ended
The number of lines of code parsed
The types of errors detected, and the number of errors of each type
The elapsed CPU time
The elapsed clock time
Translating IFDL Source Files and Form Files 5–3
The command line executed, including input and output files used or
created (whether specified or defaulted to) during the compilation
The IFDL Translator does not truncate source lines and messages that are
output to the listing file.
5.1.2.3 DEC LSE Diagnostics File
The IFDL Translator produces a diagnostics file for the DEC Language
Sensitive Editor (DEC LSE) when you use the /DIAGNOSTICS qualifer with
the FORMS TRANSLATE command. DEC LSE uses the diagnostics file during
its REVIEW phase to locate and describe translation errors.
To create and use the diagnostics file:
1. Enter the FORMS TRANSLATE command in the following format:
FORMS TRANSLATE/DIAGNOSTICS input-file-spec
2. Invoke DEC LSE to edit the IFDL source file.
3. Use the DEC LSE REVIEW command to display the error messages in the
diagnostics file so that you can correct the errors in the IFDL source file.
For more information on DEC LSE and its REVIEW command, see Appendix C.
5.1.3 Avoiding Translation Errors
To avoid translation errors, follow these guidelines when creating IFDL source
files:
•
Check for correct spelling of identifiers and DECforms keywords.
•
Do not use IFDL reserved words as identifiers. See the HP DECforms
IFDL Reference Manual for a list of the IFDL reserved words.
•
Check that attributes applied through the description or validation entries
of a field default do not conflict with settings specified in the declaration
of an affected field. For example, a field default specifying field protection
would conflict with an item description entry specifying input required.
See the HP DECforms IFDL Reference Manual for a list of conflicting item
description entries.
•
If you must use your normal currency or decimal point string for another
purpose in a SIGN, CURRENCY, or REPLACE clause, make sure you
redeclare currency and decimal point strings in EDIT clauses immediately
before SIGN, CURRENCY, and REPLACE clauses.
5–4 Translating IFDL Source Files and Form Files
•
In character-cell layouts, use relative line and column clauses in FIELD
DEFAULT and LITERAL DEFAULT declarations if you want to specify a
default location.
•
In PRINTER layouts, use absolute line and column clauses to express
locations; locations cannot be specified in FIELD DEFAULT and LITERAL
default declarations. Also, PRINTER layouts require full location clauses
for each object in the layout, including groups. (In character-cell layouts,
groups do not allow location clauses.)
•
PRINTER layouts require a UNITS clause in the LAYOUT declaration. In
character-cell layouts, the UNITS clause is optional.
•
In character-cell layouts, make sure that panel objects do not extend
beyond the viewport in any direction. Font sizes and picture string lengths
affect the field sizes. You also can adjust the line and column coordinates
to position the object farther from the viewport boundaries.
•
Make sure that no internal responses include themselves, even indirectly
(by an internal response including a second internal response that includes
the first internal response). Internal responses must not be recursive.
•
Verify that you did not specify a value that is too large or too small to be
stored in the data item.
•
Complete a conditional expression by including an operator and another
operand (for example: IF item_one = ‘‘TRUE’’). A form data item cannot
stand alone in a conditional expression.
•
Use the DEC Language Sensitive Editor (DEC LSE) when creating or
editing a form file. DEC LSE can help you produce syntactically correct
IFDL code.
5.1.4 Correcting Translation Errors
If there are errors when you translate an IFDL source file, error messages are
displayed on the screen. If you used the /LIST or /DIAGNOSTICS qualifier
when invoking the IFDL Translator, error messages also are displayed in the
listing or diagnostics file created by the translator.
You can use online help to get an explanation and user action for each error
message. See Chapter 1 for more information about error messages and how to
use online help to find error message descriptions.
Translating IFDL Source Files and Form Files 5–5
5.2 Translating Form Files Back into IFDL Source Files
The Back Translator translates a form file into an IFDL source file; essentially,
it performs the reverse function of the IFDL Translator. The Back Translator
provides a way of translating a form created or modified from the FDE or with
a panel editor into a format that can be edited with a text editor.
5.2.1 Invoking the Back Translator
To invoke the Back Translator, at the system prompt enter a command in the
following format:
FORMS BACK_TRANSLATE input-file-spec
Replace input-file-spec with the name of the form file to be translated. The
default file type is .form. The Back Translator produces as output an IFDL
file.
Figure 5–1 illustrates the translation process. You can use the IFDL Translator
to translate the IFDL source file produced by the Back Translator into a form
file again.
For a complete command description, see Chapter 1.
5.2.2 Source File Differences after Back Translation
If you create an IFDL source file with a text editor, translate the source file
into a form file with the IFDL Translator, and then translate that form file
back to an IFDL source file with the Back Translator, you will see the following
differences between the back-translated IFDL source file and the original
version:
•
Text formatting (indentation, capitalization, and so forth) in the original
IFDL source file might be changed.
•
Any Format 1 COPY statements in the original IFDL source file are not
preserved (the COPY statement has two formats). Instead, whatever was
copied is included explicitly in the resulting IFDL source file. Format 2
COPY statements in the original IFDL source file are preserved. Record
definitions originally extracted from Oracle CDD/Repository software
continue to be extracted in future translations. For descriptions of the
COPY statement formats, see the HP DECforms IFDL Reference Manual.
•
The location of comments might be changed.
5–6 Translating IFDL Source Files and Form Files
To minimize the repositioning of comments during translation, place
comments inside and at the beginning of syntactic blocks, as follows:
FIELD F1
/* comment placed for minimal migration */
PROTECTED
END FIELD
Avoid placing comments as shown in the following examples:
/* comment placed before block */
FIELD F2
PROTECTED
END FIELD
FIELD F3
PROTECTED
END FIELD
/* comment placed after block */
FIELD F4
PROTECTED
/* comment placed at end of block */
END FIELD
Translating IFDL Source Files and Form Files 5–7
6
Extracting Objects and Appearances
DECforms provides the means to create an object module from a form file for
linking with the application program at run time, and for extracting panel
appearances from the form file for printing. This chapter explains how to:
•
Extract object modules
•
Extract panel appearances
6.1 Extracting Objects from a Form File
The Extract Object Utility produces an object module, called a form object
file, that you can link with your application program at run time for improved
performance. The object module contains vectors to escape routines called at
run time, and, optionally, the form itself.
To invoke the Extract Object Utility, at the system prompt enter the FORMS
command in the following format:
FORMS EXTRACT OBJECT input-file-spec
Replace input-file-spec with the name of the form file from which you want to
create an object module. The default input file type is .form.
The Extract Object Utility creates as output an object file with the file type
.obj.
For a complete description of the FORMS EXTRACT OBJECT and FORMS
OBJECT commands and their qualifiers, see Chapter 1.
6.2 Extracting Panel Appearances from a Form File
The Extract Appearances Utility produces a file containing printable
representations of panels in a character-cell or PRINTER layout. You can
use the file to verify the appearance of panels or for reference while you are
creating other form structures.
Extracting Objects and Appearances 6–1
To invoke the Extract Appearances Utility, at the system prompt enter a
command in the following format:
FORMS EXTRACT APPEARANCES input-file-spec
Replace input-file-spec with the name of the form file containing the panels you
want to print. The default input file type is .form.
The Extract Appearances Utility produces as output a file with the file type
.txt. For character-cell layouts, this is a text file, which you can print or view
online. For PRINTER layouts, this is a DDIF™ file, which you must convert on
a VAX system, using the CDA Converter, to text or PostScript® format before
printing or viewing.
For a complete description of the FORMS EXTRACT APPEARANCES
command and its qualifiers, see Chapter 1.
The Extract Appearances Utility produces one graphic representation (display
or page) for each data entry panel and help panel in the layout. If a panel is
larger than the size of the printer paper, the text might not appear correctly
when the file is printed.
By default, fields are shown with their initial values. You can use the /SHOW
qualifier to display fields with picture strings instead.
Figure 6–1 shows the appearance of a PRINTER panel extracted from the
mileage reimbursement application used in Part I of the HP DECforms Guide
to Developing an Application.
6–2 Extracting Objects and Appearances
Figure 6–1 PRINTER Panel as Represented by Extract Appearances
Extracting Objects and Appearances 6–3
A
CCPED Keypad, Function Keys, and
Definable Keys
This appendix contains:
•
A diagram of the CCPED default keypad and keypad summary
•
A table of CCPED default function keys
•
A list of CCPED definable function keys
A.1 CCPED Default Keypad
Figure A–1 shows the CCPED keypad. The figure also is available on line.
To access it when using CCPED, press Help or enter the SHOW KEYPAD
command.
CCPED Keypad, Function Keys, and Definable Keys A–1
Figure A–1 CCPED Keypad
HELP
COMMAND
NEXT OBJ
INSERT FR
REMV TO
CLIPBOARD CLIPBOARD
PREV OBJ
SELECT
DESELECT
F17
PF1
COPY FR
COPY TO
CLIPBOARD CLIPBOARD
F18
F19
F20
HELP
KEYPAD
SHOW
POSITION
DELETE
HELP
RECALL
MESSAGE
UNDEL
MARK
DRAW OBJ
UNMARK
w/ QUERY
PREV
PANEL
NEXT
PANEL
SET
(menu)
CR FIELD
(menu)
FIRST
PANEL
LAST
PANEL
COMMAND
CR FIELD
w/ QUERY
UNMARK
MODIFY
(menu)
LIST
PANELS
LIST
VIEWPTS
BOTTOM
LEFT
UPPER
LEFT
BOTTOM
RIGHT
UP
TOP
LEFT
DOWN
RIGHT
NEXT W
EOL
NEXT OBJ
LEFTMOST
COLUMN
BOTTOM
RIGHTMOST
COLUMN
PREV W
BOL
PREV OBJ
NEXT LINE
SELECT
OPEN LINE
DESELECT
DEL CHAR
MOVE
VIEW
CLIPBOARD
MOD FIELD
DESCRPT
ZK−7909−GE
Table A–1 summarizes the keypad functions.
A–2 CCPED Keypad, Function Keys, and Definable Keys
Table A–1 CCPED Keypad Operations
Name
Press:
Function
Beginning of Line
PF1-KP2
Moves cursor to the leftmost column of the
panel in the same line.
Bottom
PF1-Down arrow
Moves cursor to the bottom of the panel in
the same column.
Bottom Left
PF1-KP4
Moves cursor to the bottom-left corner of
the panel.
Bottom Right
PF1-KP6
Moves cursor to the bottom-right corner of
the panel.
Command
PF1-KP7
Displays the command line prompt.
Copy From
Clipboard
PF1-Insert Here
Copies objects from the top page of the
clipboard to the current panel and retains
that page on the clipboard.
Copy To Clipboard
PF1-Remove
Copies selected objects to the top page
of the clipboard and retains them on the
current panel.
Create Field
(menu)
KP8
Displays the Create Field Menu.
Create Field
(with query)
PF1-KP8
Prompts for the field name and the data
type, then creates the field at the cursor
position.
Delete
PF4
Deletes selected objects.
Delete Character
KP comma
Deletes a single character to the right of
the cursor.
Deselect
PF1-Select or
PF1-KP period
Deselects selected objects or the object
where the cursor is positioned.
Command Line
Do
Displays command line prompt.
Down
Down arrow
Moves cursor down one row in the same
column.
Draw Object
KP hyphen
Connects marks to create an object.
End of Line
KP2
Moves cursor to the rightmost column of
the panel in the same line.
F17 to F20
First Panel
Undefined.
PF1-Prev Screen
Chooses the first panel in the current
layout.
(continued on next page)
CCPED Keypad, Function Keys, and Definable Keys A–3
Table A–1 (Cont.) CCPED Keypad Operations
Name
Press:
Function
Help
Help (Commands)
PF1-PF2
Displays a help window about using
CCPED.
Help (Keypad)
PF2
Displays online help for the CCPED
keypad.
Insert From
Clipboard
Insert Here
Places objects from the top page of the
clipboard on the current panel; that page
is removed from the clipboard and the
next page becomes available.
Last Panel
PF1-Next Screen
Chooses the last panel in the current
layout.
Left
Left arrow
Moves cursor one column to the left in the
same line.
Leftmost Column
PF1-Left arrow
Moves cursor to the leftmost column of the
panel in the same line.
List Panels
KP5
Lists panels in the current layout.
List Viewports
KP6
Lists viewports in the current layout.
Mark
KP9
Creates marks.
Modify
(Attr Menu)
KP4
Invokes the Modify Display Attribute
Menu (this is the same as the Set Display
Attribute Menu).
Modify Field
Description
(menu)
PF1-Enter
Invokes the Modify Field Description
Menu.
Move
PF1-KP comma
Moves selected objects to the cursor
position.
Next Line
KP0
Moves the cursor to the beginning of the
next line.
Next Object
Find or
KP3
Moves cursor to the next object or word in
a left-to-right, top-to-bottom direction.
Next Panel
Next Screen
Chooses the next panel in the current
layout.
Next Word
KP1
Moves the cursor to the next object or
word in a left-to-right, top-to-bottom
direction.
(continued on next page)
A–4 CCPED Keypad, Function Keys, and Definable Keys
Table A–1 (Cont.) CCPED Keypad Operations
Name
Press:
Function
Open Line
PF1-KP0
Deselects all objects; selects all objects on
and below the line containing the cursor;
moves selected objects down one line;
deselects all objects.
Previous Object
PF1-Find or
PF1-KP3
Moves cursor to the previous object or
word in a right-to-left, bottom-to-top
direction.
Previous Panel
Prev Screen
Chooses the previous panel in the current
layout.
Previous Word
PF1-KP1
Moves the cursor to the previous object
or word in a right-to-left, bottom-to-top
direction.
Recall Message
PF1-PF3
Recalls the most recently displayed
message.
Remove To
Clipboard
Remove
Places selected objects on the top page and
removes them from the current panel.
Right
Right arrow
Moves cursor one column to the right in
the same line.
Rightmost Column
PF1-Right arrow
Moves cursor to the rightmost column of
the panel in the same line.
Select
Select or
KP period
Selects an object or a menu item.
Set
(Attr Menu)
KP7
Invokes the Set Display Attribute Menu
(this is the same as the Modify Display
Attribute Menu).
Show Position
PF3
Displays the cursor’s current line and
column position.
Top
PF1-Up arrow
Moves the cursor to the top of the panel in
the same column.
Undelete
PF1-PF4
Undeletes deleted objects.
Up
Up arrow
Move the cursor up one row in the same
column.
Unmark
PF1-KP9
Removes the mark at the cursor location.
Unmark
(with query)
PF1-KP hyphen
Prompts to remove one or more specified
marks.
(continued on next page)
CCPED Keypad, Function Keys, and Definable Keys A–5
Table A–1 (Cont.) CCPED Keypad Operations
Name
Press:
Function
Upper Left
PF1-KP5
Moves the cursor to the upper-left corner
of the panel.
View Clipboard
Enter
Displays the top page of the clipboard;
press any key to return to editing the
current panel.
A.2 CCPED Function Keys
Table A–2 lists the default function keys available in CCPED.
Table A–2 CCPED Function Keys
Key Sequence
Default Function
PF1-E
Exit
PF1-H
Double-high font size and line width
PF1-M
Modify (menu)
PF1-N
Normal font size and line width
PF1-O
Order objects
PF1-T
Test appearance
PF1-S
Single font size and line width
PF1-W
Double-wide font size and line width
PF1-Q
Quit, save journal
PF1-V
Show version
A.3 Names of Keys Definable in CCPED
Table A–3 lists the names for keys you can define in CCPED by using the
DEFINE KEY command.
A–6 CCPED Keypad, Function Keys, and Definable Keys
Table A–3 CCPED Definable Keys
Function Keys
F17
PF1_F17
F18
PF1_F18
F19
PF1_F19
F20
PF1_F20
PF1_HELP
PF1_DO
PF1_DELETE
Editing Keypad Keys
E1 or FIND
PF1_E1 or PF1_FIND
E2 or INSERT_HERE
PF1_E2 or PF1_INSERT_HERE
E3 or REMOVE
PF1_E3 or PF1_REMOVE
E4 or SELECT
PF1_E4 or PF1_SELECT
E5 or PREV_SCREEN
PF1_E5 or PF1_PREV_SCREEN
E6 or NEXT_SCREEN
PF1_E6 or PF1_NEXT_SCREEN
Numeric Keypad Keys
PF2
PF1_PF2
PF3
PF1_PF3
PF4
PF1_PF4
KP_0
PF1_KP_0
KP_1
PF1_KP_1
KP_2
PF1_KP_2
(continued on next page)
CCPED Keypad, Function Keys, and Definable Keys A–7
Table A–3 (Cont.) CCPED Definable Keys
Numeric Keypad Keys
KP_3
PF1_KP_3
KP_4
PF1_KP_4
KP_5
PF1_KP_5
KP_6
PF1_KP_6
KP_7
PF1_KP_7
KP_8
PF1_KP_8
KP_9
PF1_KP_9
KP_MINUS
PF1_KP_MINUS
KP_COMMA
PF1_KP_COMMA
KP_PERIOD
PF1_KP_PERIOD
KP_ENTER
PF1_ENTER
Alphabetic Characters
PF1_A
PF1_J
PF1_S
PF1_B
PF1_K
PF1_T
PF1_C
PF1_L
PF1_U
PF1_D
PF1_M
PF1_V
PF1_E
PF1_N
PF1_W
PF1_F
PF1_O
PF1_X
PF1_G
PF1_P
PF1_Y
PF1_H
PF1_Q
PF1_Z
PF1_I
PF1_R
Punctuation Marks and Delimiters
PF1_AMPERSAND
PF1_DOLLAR_SIGN
PF1_PERCENT_SIGN
PF1_APOSTROPHE
PF1_EQUAL
PF1_PERIOD
PF1_ASTERISK
PF1_EXCLAMATION_POINT
PF1_PLUS_SIGN
PF1_AT_SIGN
PF1_GREATER_THAN
PF1_QUESTION_MARK
(continued on next page)
A–8 CCPED Keypad, Function Keys, and Definable Keys
Table A–3 (Cont.) CCPED Definable Keys
Punctuation Marks and Delimiters
PF1_BACKSLASH
PF1_LESS_THAN
PF1_QUOTATION_
MARKS
PF1_CIRCUMFLEX
PF1_MINUS_SIGN
PF1_SEMICOLON
PF1_CLOSE_BRACE
PF1_NUMBER_SIGN
PF1_SLASH
PF1_CLOSE_BRACKET
PF1_OPEN_BRACE
PF1_SPACE
PF1_CLOSE_PAREN
PF1_OPEN_BRACKET
PF1_TILDE
PF1_COLON
PF1_OPEN_PAREN
PF1_UNDERLINE
PF1_COMMA
PF1_OPEN_QUOTE
PF1_VERTICAL_LINE
HP and ISO Multinational Special Characters and Currency Signs
PF1_ACUTE_ACCENT
PF1_MIDDLE_DOT
PF1_ANGLE_QUOTE_LEFT
PF1_MULTIPLICATION
PF1_ANGLE_QUOTE_RIGHT
PF1_NO_BREAK_SPACE
PF1_BROKEN_BAR
PF1_NOT_SIGN
PF1_CEDILLA
PF1_PARAGRAPH_SIGN
PF1_CENT_SIGN
PF1_PLUS_MINUS_SIGN
PF1_COPYRIGHT_SIGN
PF1_POUND_SIGN
PF1_DEGREE_SIGN
PF1_QUARTER_FRACTION
PF1_DIAERESIS
PF1_REGISTERED_TRADEMARK
PF1_DIVISION_SIGN
PF1_SECTION_SIGN
PF1_FEMININE_ORDINAL
PF1_SHARP_S
PF1_HALF_FRACTION
PF1_SOFT_HYPHEN
PF1_INVERT_EXCLAMATION
PF1_SUPER_1
PF1_INVERTED_QUESTION_
MARK
PF1_SUPER_2
PF1_MACRON
PF1_SUPER_3
PF1_MASCULINE_ORDINAL
PF1_THREE_QUARTERS_
FRACTION
PF1_MICRO_SIGN
PF1_YEN_SIGN
(continued on next page)
CCPED Keypad, Function Keys, and Definable Keys A–9
Table A–3 (Cont.) CCPED Definable Keys
HP and ISO Multinational Alphabetic Characters
PF1_A_ACUTE
PF1_O_ACUTE
PF1_A_CIRCUMFLEX
PF1_O_CIRCUMFLEX
PF1_A_DIAERESIS
PF1_O_DIAERESIS
PF1_A_GRAVE
PF1_O_GRAVE
PF1_A_RING
PF1_O_TILDE
PF1_A_TILDE
PF1_O_SLASH
PF1_AE_DIPTHONG
PF1_U_ACUTE
PF1_E_ACUTE
PF1_U_CIRCUMFLEX
PF1_E_CIRCUMFLEX
PF1_U_DIAERESIS
PF1_E_DIAERESIS
PF1_U_GRAVE
PF1_E_GRAVE
PF1_C_CEDILLA
PF1_I_ACUTE
PF1_N_TILDE
PF1_I_CIRCUMFLEX
PF1_Y_ACUTE
PF1_I_DIAERESIS
PF1_ICELANDIC_ETH
PF1_I_GRAVE
PF1_ICELANDIC_THORN
A–10 CCPED Keypad, Function Keys, and Definable Keys
B
CCPED Commands
This appendix contains descriptions of the CCPED commands, organized
alphabetically by command name. Each command description contains the
following information:
•
General description of the command
•
A syntax diagram
•
Descriptions of the required and optional parameters
Most command descriptions also contain command-line examples.
Many of the command operations are available as CCPED keypad functions.
Figure A–1 shows the default keypad.
For information about invoking CCPED to create and edit the appearance of
panels, see Chapter 3.
CCPED Commands B–1
CENTER SELECTED OBJECTS
CENTER SELECTED OBJECTS
Centers selected objects vertically, horizontally, or both vertically and
horizontally, in the current panel’s viewport.
Format
CENTER SELECTED [OBJECTS]
h
HORIZONTAL
VERTICAL
i
Parameters
HORIZONTAL
Horizontally centers the imaginary rectangle that encloses selected objects in
the current panel’s viewport.
VERTICAL
Vertically centers the imaginary rectangle that encloses selected objects in the
current panel’s viewport.
If you do not specify either HORIZONTAL or VERTICAL, the selected objects
are centered horizontally and vertically in the current panel’s viewport.
Example
Command> SELECT AREA (1,1) (10,10)
Command> CENTER SELECTED HORIZONTAL
Centers horizontally in the viewport those objects enclosed in the selected area.
B–2 CCPED Commands
CHOOSE
CHOOSE
Makes an existing panel the current panel for editing.
Format
CHOOSE
8
>
>
>
<
>
>
>
:
PANEL panel-name
FIRST [PANEL]
LAST [PANEL]
NEXT [PANEL]
PREVIOUS [PANEL]
9
>
>
>
=
>
>
>
;
Parameters
PANEL panel-name
The specific panel you want to edit. This panel must already exist—you cannot
use CHOOSE PANEL to create a new panel. Use CREATE PANEL to create a
new panel.
If you specify a panel that is too large for the current display, the command
fails.
FIRST [PANEL]
Chooses the first panel in the layout. If the first panel is too large for the
current display, CCPED attempts to locate the first panel in the layout that
can be edited.
LAST [PANEL]
Chooses the last panel listed in the layout. If the last panel is too large for the
current display, CCPED attempts to locate the last panel in the layout that can
be edited.
NEXT [PANEL]
Chooses the next panel listed in the layout. If the panel is too large for the
display, CCPED skips over it, displays a warning message, and tries to find
the next panel in the layout that can be edited. If CCPED does not find such a
panel, the command fails.
PREVIOUS [PANEL]
Chooses the previous panel listed in the layout. If the panel is too large for the
display, CCPED skips over it, displays a warning message, and tries to find the
closest previous panel that can be edited. If CCPED does not find such a panel,
the command fails.
CCPED Commands B–3
CHOOSE
Note
If you specify the /NODISPLAY qualifier to the FORMS EDIT
command, CCPED does not check panel size.
Examples
1.
Command> CHOOSE PANEL Address
Makes the panel named Address the current panel for editing.
2.
Command> CHOOSE FIRST PANEL
Makes the first panel in the layout the current panel for editing.
3.
Command> CHOOSE PREVIOUS
Makes the previous panel in the layout the current panel for editing.
B–4 CCPED Commands
COPY FROM CLIPBOARD
COPY FROM CLIPBOARD
Copies objects from the top page of the clipboard onto the current panel; copied
objects remain on the top page of the clipboard. This command differs from
INSERT FROM CLIPBOARD, which removes the top page from the clipboard.
For information about using the CCPED clipboard, see Chapter 3.
Note
COPY FROM CLIPBOARD also copies any responses defined within
fields, icons, or groups that you are copying. After those objects are
copied, you might need to modify any ACTIVATE, DEACTIVATE, and
POSITION response steps.
Format
COPY FROM CLIPBOARD [TO (l,c)]
Parameter
TO (l,c)
The line and column coordinates of the location on the panel where you
want the clipboard page copied. If you do not specify coordinates, the page is
inserted at the current cursor position.
These coordinates define the start position for the upper-left corner of the
imaginary rectangle that encloses all objects on the clipboard page.
Example
Command>
Command>
Command>
Command>
CREATE POINT (1,1);
COPY FROM CLIPBOARD
COPY FROM CLIPBOARD
COPY FROM CLIPBOARD
SELECT AT (1,1); COPY SELECTED TO CLIPBOARD
TO (10,4)
TO (8,23)
TO (9,2)
Creates a point at line 1, column 1, selects and copies the point to the
clipboard, and then copies the top clipboard page to the three specified
locations on the current panel.
CCPED Commands B–5
COPY SELECTED OBJECTS TO CLIPBOARD
COPY SELECTED OBJECTS TO CLIPBOARD
Places copies of all selected objects from the current panel onto a new page
of the clipboard, leaving copies of those objects on the current panel. This
command differs from REMOVE SELECTED OBJECTS TO CLIPBOARD,
which removes the objects from the panel.
For information about using the CCPED clipboard, see Chapter 3.
Note
COPY SELECTED OBJECTS TO CLIPBOARD also copies any
responses defined within fields, icons, or groups that you are
copying. After those objects are copied, you might need to modify
any ACTIVATE, DEACTIVATE, and POSITION response steps.
Format
COPY SELECTED [OBJECTS] TO CLIPBOARD
Parameters
None.
Example
Command> CREATE TEXT "Copy this literal" (10,2)
Command> CREATE TEXT "and this one, too!" (12,2)
Command> SELECT ALL; COPY SELECTED TO CLIPBOARD
Creates the text literals shown and copies them to the clipboard while leaving
copies on the current panel.
B–6 CCPED Commands
CREATE FIELD
CREATE FIELD
Creates a field in the current panel. Entering CREATE FIELD without any
parameters causes CCPED to display the Create Field Menu. For information
about using this menu, see Chapter 3.
Format
CREATE FIELD [name [(l,c)] [TYPE data-type] [PICTURE [DATE] picture-string] [ROWS n]
[COLUMNS n]]
Parameters
name
The qualified name of the data item that the field represents. This name must
be syntactically and semantically correct. The data item does not have to exist
to create a field. For syntax information, see the HP DECforms IFDL Reference
Manual.
(l,c)
The line and column coordinates for the location of the field. If you do not
specify coordinates, the field is created at the current cursor position. Fields
can neither overlap other fields nor extend past the boundary of any viewport
in which the panel can be displayed.
TYPE data-type
The data type of the form data item to be associated with the field. If the
data item does not exist, this parameter is required; if the data item exists,
this parameter is optional. If a matching data item exists and you specify
it, the data type must match that of the existing data item. For information
about data types, see the atomic clause explanation in the HP DECforms IFDL
Reference Manual.
PICTURE [DATE] picture-string
A DATE picture or a quoted picture string other than the default generated
according to the data type of the field. The picture value must be syntactically
and semantically correct for the data type of the item. For syntax information,
see the HP DECforms IFDL Reference Manual.
ROWS n
The number of rows, if the field is to contain multiple lines.
CCPED Commands B–7
CREATE FIELD
COLUMNS n
The number of columns to be used to display the data.
Examples
1.
Command> CREATE FIELD Name (3,10) TYPE Character(90) ROWS 3 COLUMNS 30
Creates a field 90 characters long called Name at line 3, column 10,
and specifies the CHARACTER data type for the form data item to be
associated with the field. The field will use three lines, each of which can
display up to 30 characters.
2.
Command> CREATE FIELD Phone PICTURE "’(’999’)’999’-’9999"
Creates a field called Phone at the current cursor position, and specifies
a picture string for the phone number. This example assumes that the
data item PHONE exists; you do not need to specify the data type in
this command line. For more information on picture strings, see the HP
DECforms IFDL Reference Manual.
3.
Command> CREATE FIELD
Displays the Create Field Menu. For information about using the Create
Field Menu, see Chapter 3.
B–8 CCPED Commands
CREATE GROUP
CREATE GROUP
Creates a group on the current panel. You must create groups in a top-down
sequence (create all higher level objects before creating or inserting any lower
level objects into the group).
Format
CREATE GROUP name
2 OCCURS expression [BASE expression] [CURRENT data-name]
n data-name
4 n HORIZONTAL o
[DISPLAYS expression] [FIRST
expression
VERTICAL
3
o 5
]
Parameters
name
A qualified name for the group. This name must include any parent groups in
which the newly created group will be placed. For example, a group name of
G1.G2.G3 causes G3 to be created in group G2, which is in group G1. Both G1
and G2 must exist before G3 can be created.
If the corresponding data group for the group name does not exist, it is created.
OCCURS expression
Repeats the data group a specified number of times. If the data group is
created when you enter the CREATE GROUP command, the OCCURS clause
specifies the number of its occurrences; if the data group already exists, this
OCCURS clause must match the previously specified number of occurrences.
The default is 1 for newly created groups.
With OCCURS, you can specify the following:
BASE expression
CURRENT data-name
Specifies that the value of the expression is to be
considered the lowest subscript for the form data
group. If you do not specify BASE, the default value
is 1.
Specifies the value of the subscript of the current data
group item whenever the data group is referenced at
run time. The named data item must be numeric.
CCPED Commands B–9
CREATE GROUP
HORIZONTAL
Displays the group horizontally. With HORIZONTAL, you can specify the
following:
DISPLAYS expression
FIRST
data-name
expression
Specifies how many instances of the group are to be
displayed horizontally on the panel. The default is
1 for newly created groups. If you have two nested
groups with multiple occurrences, you cannot specify
DISPLAYS for the innermost group.
Specifies which indexed element of the group is to be
displayed at the left of the horizontal scrolled region.
The contents of data-name control the index of the
first element displayed at the left of the scrolled area.
The value of expression specifies the index of the
first element displayed at the left of the scrolled
area. The named data item must be numeric. For
more information, see the description of the GROUP
declaration in the HP DECforms IFDL Reference
Manual.
VERTICAL
Displays the group vertically. With VERTICAL, you can specify the following:
DISPLAYS expression
FIRST
data-name
expression
B–10 CCPED Commands
Specifies how many instances of the group are to
be displayed vertically on the panel. The default is
1 for newly created groups. If you have two nested
groups with multiple occurrences, you cannot specify
DISPLAYS for the innermost group.
Specifies which indexed element of the group is to be
displayed at the top of the vertical scrolled region.
The contents of data-name control the index of the
first element displayed at the top of the scrolled area.
The value of expression specifies the index of the
first element displayed at the top of the scrolled
area. The named data item must be numeric. For
more information, see the description of the GROUP
declaration in the HP DECforms IFDL Reference
Manual.
CREATE GROUP
Example
Command> CREATE GROUP Outer OCCURS 5 HORIZONTAL
Command> CREATE GROUP Outer.Inner OCCURS 10 VERTICAL
Command> CREATE FIELD Outer.Inner.F1 (2,10) TYPE INTEGER(3) PICTURE "S999’ ’"
Creates the following panel group beginning at line 2, column 10:
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
S999
CCPED Commands B–11
CREATE ICON
CREATE ICON
Creates an icon element from all selected literals. The literals on the selection
list must not belong to any other icon. Any nonliteral object on the selection
list is ignored.
For information about using icons, see the HP DECforms Guide to Developing
an Application.
Format
CREATE ICON icon-name
Parameter
icon-name
The qualified name for the icon.
Example
Command>
Command>
Command>
Command>
Command>
Command>
CREATE RECTANGLE (9,3) (13,19)
CREATE TEXT "CANCEL" (11,8)
SELECT AT (11,8)
SELECT AT (9,3)
CREATE ICON Cancel_icon
DESELECT ALL
Creates an icon from a selected rectangle and a selected text object.
B–12 CCPED Commands
CREATE MARKED OBJECT
CREATE MARKED OBJECT
Creates a graphic object from coordinates designated by the MARK command.
Marks define a DECforms graphic object as follows:
•
One mark represents a point, as though the object was specified by the
CREATE POINT command.
•
Two marks that do not share the same row or column value define a
rectangle, as though the object was specified by the CREATE RECTANGLE
command.
•
Two marks that share the same row or column value define a polyline, as
though the object was specified by the CREATE POLYLINE command.
•
Multiple marks define a polyline, as though the object was specified by
the CREATE POLYLINE command. These marks must define vertical or
horizontal line segments.
Specifying CREATE MARKED OBJECT unmarks all marks. If no marks are
defined, CCPED displays an error message.
Format
CREATE MARKED [OBJECT]
Parameters
None.
Example
Command> UNMARK ALL; MARK (20,5); MARK (20,15); CREATE MARKED OBJECT
Creates a polyline from line 20, column 5, to line 20, column 15.
CCPED Commands B–13
CREATE PANEL
CREATE PANEL
Creates a new data entry panel or help panel in the current layout. This
becomes the current panel for editing.
Format
CREATE [HELP] PANEL panel-name [ON viewport-name]
Parameters
panel-name
A name for the panel to be created.
ON viewport-name
The name of the viewport to be associated with the new panel. If you specify
a viewport, it must exist; you cannot create a new viewport this way. Use the
CREATE VIEWPORT command to create a new viewport. If you do not specify
a viewport, the new panel is associated with the default viewport.
Examples
1.
Command> CREATE PANEL Deposits
Creates a new panel called Deposits and associates it with the default
viewport. The Deposits panel becomes the current panel for editing.
2.
Command> CREATE HELP PANEL Account_panel_help ON Help_VP
Creates a new help panel called Account_panel_help and associates it
with the viewport Help_VP. The help panel becomes the current panel for
editing.
B–14 CCPED Commands
CREATE POINT
CREATE POINT
Creates a point literal at the specified position.
Format
CREATE POINT (l,c)
Parameter
(l,c)
The line and column coordinates of the point to be created.
Example
Command> CREATE POINT (20,2)
Creates a point at line 20, column 2.
CCPED Commands B–15
CREATE POLYLINE
CREATE POLYLINE
Creates a polyline literal having the specified coordinates.
Format
CREATE POLYLINE (l,c) (l,c) [(l,c)...]
Parameters
(l,c) (l,c)
The line and column coordinate pairs that specify the points of the polyline.
You must specify at least two coordinate pairs. If you specify two points, a line
segment is created. If you specify more than two points, a single polyline object
is created from those points. The points in a CREATE POLYLINE command
must define horizontal or vertical line segments.
Example
Command> CREATE POLYLINE (1,1) (1,40) (5,40) (5,80)
Creates a polyline having the specified points.
B–16 CCPED Commands
CREATE RECTANGLE
CREATE RECTANGLE
Creates a rectangle on the current panel at the specified position.
Format
CREATE RECTANGLE (l,c) (l,c)
Parameters
(l,c) (l,c)
The line and column coordinate pairs that specify the diagonally opposite
corners of the rectangle.
Examples
1.
Command> CREATE RECTANGLE (1,10) (10,40)
Creates a rectangle with opposite corners at the specified coordinates.
2.
Command> CREATE RECTANGLE (1,1) (LINE_MAX$,COLUMN_MAX$)
Creates a bounding rectangle (a rectangle that outlines the panel according
to the size of the current viewport).
CCPED Commands B–17
CREATE TEXT
CREATE TEXT
Creates a text literal on the panel. You also can create a text literal by moving
the cursor to the desired location on the panel and typing the text.
Format
CREATE TEXT ‘‘text-string’’ [(l,c)]
Parameters
‘‘text-string’’
A quoted string specifying the text for the literal. If you do not specify
coordinates, the text literal is placed at the current cursor position.
(l,c)
The line and column coordinates specifying the lower-left character cell for
double-sized text and the leftmost character cell for other text.
Examples
1.
Command> CREATE TEXT "Enter badge number: " (2,5)
Creates the text literal ‘‘Enter badge number: ’’ (including a space after
the colon) at line 2, column 5, on the current panel.
2.
Command> CREATE TEXT "How many widgets do you wish to order?"
Creates a text literal on the current panel starting at the current cursor
position.
B–18 CCPED Commands
CREATE VIEWPORT
CREATE VIEWPORT
Creates a new viewport or a new printing viewport. If you create a printing
viewport, CCPED does not check its size against the size of the layout.
Format
CREATE [PRINTING] VIEWPORT name (l,c)
n
BY
TO
o
(l,c)
Parameters
name
A name for the viewport.
(l,c) BY (l,c)
The first coordinate pair specifies the line and column position for the upperleft corner of the viewport. The second coordinate pair specifies the size of the
viewport in number of lines and number of columns.
(l,c) TO (l,c)
The line and column coordinate pairs that specify the opposite corners of the
viewport. These coordinate values are in relation to the layout size.
Examples
1.
Command> CREATE VIEWPORT Account_VP (1,1) TO (20,80)
Creates a viewport named Account_VP whose upper-left corner is at line 1,
column 1, and whose lower-right corner is at line 20, column 80.
2.
Command> CREATE PRINTING VIEWPORT Print_VP (1,1) BY (60,80)
Creates a printing viewport whose upper-left corner is at line 1, column 1,
and whose size is 60 lines long and 80 columns wide.
CCPED Commands B–19
DEFINE COLOR
DEFINE COLOR
Defines a color symbol. You can use this symbol instead of an RGB specification
in any command that references a color specification. The color symbols you
define are internal to your CCPED session. When you translate the form
file back to an IFDL source file, the IFDL source file will contain the RGB
specifications instead of the color symbol names.
Format
DEFINE
n
COLOR
COLOUR
o
color-name rgb-specification
Parameters
color-name
The name of the color to be defined. It can be any legal DECforms identifier, or
it can be one of the following standard color names:
UNCHANGED
BLACK
BLUE
CYAN
GREEN
MAGENTA
RED
WHITE
YELLOW
Note
If you redefine one of the standard colors, that color’s standard
definition is no longer available to you. HP strongly recommends that
you avoid redefining standard colors.
rgb-specification
The RGB color specification. It has the following format:
(red-expression, green-expression, blue-expression)
The expressions must evaluate to whole numbers in the range 0 to 100,
inclusive. They represent the percentage of the particular color component
B–20 CCPED Commands
DEFINE COLOR
(red, green, or blue) in the overall color specification. (In the IFDL source file,
the values in the RGB specification are in the range 0 to 1, inclusive.)
Examples
1.
Command> DEFINE COLOR GRAY (50,50,50)
Defines the color symbol GRAY as a shade of gray.
2.
Command> DEFINE COLOUR BLUE_RED (90,0,10)
Defines the color symbol BLUE_RED as a shade of red different from the
standard color red.
CCPED Commands B–21
DEFINE KEY
DEFINE KEY
Associates a CCPED command string with a keyboard function key. The string
can contain command-line macros as well as multiple commands. Once you
associate a command with a function key, the command is executed whenever
you press that function key. If you press an undefined function key, CCPED
displays an error message. To cancel a key definition, use the UNDEFINE KEY
command. For information on CCPED command-line macros, see Chapter 3.
Format
DEFINE KEY key-name key-definition [[NO]TERMINATE]
Parameters
key-name
The name of the function key you want to associate with a command string.
Appendix A contains a table of definable key names.
key-definition
A quoted string containing the text of the command. This string can be a single
command, several commands, or a command-line macro (including macros for
command-line substitution). The syntax of the definition is not checked until
CCPED executes the command.
[NO]TERMINATE
The TERMINATE parameter specifies that the function definition is executed
immediately when you press the function key. The NOTERMINATE parameter
specifies that the function definition is not executed until you press Return.
This allows you to edit the command line, if necessary, before executing it.
The default is TERMINATE.
Examples
1.
Command> DEFINE KEY F20 "ROTATE CLIPBOARD" TERMINATE
Associates the ROTATE CLIPBOARD command with the F20 function
key. Thereafter, CCPED executes the ROTATE CLIPBOARD command
whenever you press F20.
B–22 CCPED Commands
DEFINE KEY
2.
Command> DEFINE KEY PF1_KP_8 "CREATE FIELD #"Field name?" (LINE$,COLUMN$)
TYPE #"Type?" PICTURE #"Picture?""
Defines the PF1-KP8 key sequence to prompt you when creating a field.
Note
CCPED commands that are too long for the screen display are scrolled
horizontally and are not continued onto the next line. This and the
following examples use two lines due to the limit of the page width.
3.
Command> DEFINE KEY PF1_ENTER "DESELECT ALL;SELECT;MODIFY FIELD
DESCRIPTION;DESELECT ALL"
Defines the key sequence PF1-Enter to select the field the cursor is on and
bring up the Modify Field Description menu.
4.
Command> DEFINE KEY F17 "DEFINE SYMBOL Save_line LINE$;
DEFINE SYMBOL Save_col COLUMN$"
Command> DEFINE KEY F18 "POSITION TO (Save_line,Save_col)"
Defines the F17 function key to save the cursor’s current position by
defining the symbols Save_line and Save_col. Also defines the F18 key to
position the cursor to the location saved by the F17 key definition. LINE$
and COLUMN$ are CCPED predefined symbols. For a list of predefined
symbols, see Chapter 3.
CCPED Commands B–23
DEFINE SYMBOL
DEFINE SYMBOL
Defines a symbol that you can use subsequently in expressions. CCPED enters
the symbol in its symbol table.
CCPED contains a set of predefined symbols. For a list of the predefined
symbols, see Chapter 3.
Format
DEFINE SYMBOL symbol-name symbol-value
Parameters
symbol-name
A name for the symbol. Do not use a dollar-sign character ( $ ) as part of the
symbol name because a symbol name containing a dollar sign can be confused
with an expression function or a predefined symbol, both of which end with a
dollar-sign character.
symbol-value
The expression for which you want to define the symbol.
Examples
1.
Command> DEFINE SYMBOL My_Symbol 1+2
Assigns a value of 3 to the symbol My_Symbol, and adds it to the symbol
table.
2.
Command> DEFINE SYMBOL This_line LINE$
Command> DEFINE SYMBOL This_column COLUMN$
Command> .
.
.
Command> POSITION TO (This_line,This_column)
Defines symbols for the cursor’s current location and later in the editing
session returns the cursor to that location in the current panel, as shown
by the POSITION TO command in the example. LINE$ and COLUMN$
are predefined symbols.
B–24 CCPED Commands
DELETE CHARACTER
DELETE CHARACTER
Deletes a single character from a text literal. If text entry mode is set to insert,
trailing characters of the literal are shifted to the left when the specified
character is deleted. If the mode is overstrike, trailing characters are not
shifted and the specified character is replaced with a space.
If you delete the last character in the literal, the literal is shortened whether
text entry mode is set to insert or overstrike.
Format
DELETE CHARACTER [(l,c)] [PREVIOUS]
Parameters
(l,c)
The line and column coordinates of the character to be deleted. If you do not
specify coordinates, the character at the current cursor position is deleted.
PREVIOUS
Deletes the character located one column to the left of the specified cursor
position. The cursor then moves one character cell to the left.
Example
Command> CREATE TEXT "Total" (2,5); DELETE CHARACTER (2,6)
Creates a text literal, ‘‘Total’’, at line 2, column 5, and deletes the character at
line 2, column 6 (the letter ‘‘o’’). If the current entry mode is insert, the result
is ‘‘Ttal’’; if the entry mode is overstrike, the result is ‘‘T tal’’.
CCPED Commands B–25
DELETE NAMED
DELETE NAMED
Deletes the named objects (which can include fields, icons, or groups) from the
current panel and adds them to a deletion list. When you exit CCPED, the
deleted objects are discarded.
To restore deleted objects, you can use the UNDELETE LAST or UNDELETE
ALL UNDELETE ALL OBJECTS command, provided you are in the same
editing session during which you deleted them.
Format
DELETE NAMED name [,name...]
Parameter
name
A qualified name for the object to be deleted. If you specify more than one
name, separate each name with a comma.
Example
Command> CREATE FIELD Tulip_Bulbs (LINE$+3,COLUMN$+3) TYPE UNSIGNED BYTE
Command> DELETE NAMED Tulip_Bulbs
Deletes the field Tulip_Bulbs.
B–26 CCPED Commands
DELETE PANEL
DELETE PANEL
Deletes a panel from the current layout. To restore deleted panels, you can use
the UNDELETE PANEL, UNDELETE LAST, or UNDELETE ALL command,
provided you are in the same editing session during which you deleted them.
Format
DELETE PANEL [panel-name]
Parameter
panel-name
The name of the panel to be deleted.
If you do not specify a name, the current panel is deleted and the next panel in
the layout becomes the current panel.
If the deleted panel is the last one in the layout, the next-to-last panel (now
the last panel) becomes the current panel.
If all panels in the layout are deleted, the current panel becomes undefined,
and you cannot perform panel or panel content functions until you create a
new panel.
Example
Command> DELETE PANEL Account_Data
Deletes the panel named Account_Data from the current layout.
CCPED Commands B–27
DELETE SELECTED OBJECTS
DELETE SELECTED OBJECTS
Deletes all selected objects from the current panel and adds them to a deletion
list. When you exit CCPED, the deleted objects are discarded.
You restore deleted objects with the UNDELETE LAST OBJECT or
UNDELETE ALL OBJECTS command, provided you are in the same editing
session during which you deleted them.
Format
DELETE SELECTED [OBJECTS]
Parameters
None.
Examples
1.
Command> DELETE SELECTED OBJECTS
Deletes all selected objects from the current panel.
2.
Command>
Command>
Command>
Command>
CREATE
CREATE
SELECT
DELETE
TEXT "Parquet" (1,10)
TEXT "Larry Danny Chief DJ Kevin" (3,15)
AT (1,10); SELECT AT (3,20)
SELECTED
Deletes the selected text literals.
B–28 CCPED Commands
DELETE VIEWPORT
DELETE VIEWPORT
Deletes a viewport from the current layout. Any references in the form to the
deleted viewport are replaced with references to the default viewport.
You restore deleted viewports with the UNDELETE VIEWPORT, UNDELETE
LAST, or UNDELETE ALL command, provided you are in the same editing
session during which you deleted them.
Format
DELETE VIEWPORT viewport-name
Parameter
viewport-name
The name of the viewport to be deleted.
Example
Command> DELETE VIEWPORT Account_VP
Deletes the viewport named Account_VP from the current layout.
CCPED Commands B–29
DESELECT ALL OBJECTS
DESELECT ALL OBJECTS
Removes all selected objects in the current panel from the selection list.
Format
DESELECT ALL [OBJECTS]
Parameters
None.
Example
Command>
Command>
Command>
Command>
Command>
CREATE TEXT "Birthdate: " (10,2)
SELECT AREA (9,1) (11,COLUMN_MAX$)
CREATE TEXT "Place of Birth: " (15,2)
SELECT AT (15,10)
DESELECT ALL
Creates text at the specified locations. Selects all objects enclosed by the
area defined by line 9, column 1 and line 11 and the maximum horizontal
position for the current panel, and selects the object that passes through line
15, column 10. Removes all selected objects from the selection list.
B–30 CCPED Commands
DESELECT AREA
DESELECT AREA
Removes all selected objects within an area in the current panel from the
selection list.
Format
DESELECT AREA (l,c) (l,c)
Parameters
(l,c) (l,c)
The line and column coordinates specifying the diagonally opposite corners of
the rectangle enclosing the selected area.
Example
Command>
Command>
Command>
Command>
CREATE RECTANGLE (7,3) (14,48)
CREATE TEXT "16 World Championships" (10,5)
SELECT ALL
DESELECT AREA (9,1) (LINE_MAX$,COLUMN_MAX$)
Creates objects at the specified locations and then selects all objects on the
current panel. Removes all selected objects within the area bounded by line 9,
column 1 and the maximum horizontal and vertical positions defined for the
current panel.
CCPED Commands B–31
DESELECT AT
DESELECT AT
Removes an object at the specified location from the selection list.
Format
DESELECT [[AT] (l,c)]
Parameter
[AT] (l,c)
The line and column coordinates through which the selected object passes. If
you do not specify coordinates, the current cursor position is used.
Example
Command> CREATE RECTANGLE (LINE$,COLUMN$) (LINE_MAX$,COLUMN_MAX$)
Command> SELECT ALL
Command> DESELECT AT (LINE$,COLUMN$)
Creates a rectangle outlining the panel, selects everything on the panel,
and then deselects the object at the current cursor position (in this case, the
rectangle).
B–32 CCPED Commands
DESELECT LAST
DESELECT LAST
Removes the last selected object from the selection list.
Format
DESELECT LAST
Parameters
None.
Example
Command> SELECT NAMED Icon_1
Command> SELECT NAMED Field_2
Command> DESELECT LAST
Removes FIELD_2 from the selection list.
CCPED Commands B–33
DESELECT MARKED AREA
DESELECT MARKED AREA
Removes from the selection list all selected objects contained within an area
defined by two marks. For information about marks, see the description of the
MARK command.
Format
DESELECT MARKED [AREA]
Parameters
None.
Example
Command>
Command>
Command>
Command>
Command>
CREATE TEXT "The Pirates of Penzance"
CREATE POINT (11,30)
SELECT ALL
MARK (11,1); MARK (12,COLUMN_MAX$)
DESELECT MARKED
Deselects the object within the marked area (in this case, the point).
B–34 CCPED Commands
DESELECT NAMED
DESELECT NAMED
Removes the named panel elements (fields, icons, or groups) from the selection
list.
Format
DESELECT NAMED name [,name...]
Parameter
name
The qualified name of the object to be removed from the selection list. If you
specify more than one name, separate each name with a comma.
Example
Command>
Command>
Command>
Command>
CREATE GROUP Flower OCCURS 10 VERTICAL DISPLAYS 2
CREATE FIELD Flower.Tulip (3,2) TYPE CHARACTER(20)
SELECT AT (3,2)
DESELECT NAMED Flower.Tulip
Deselects the field Tulip in the group Flower.
CCPED Commands B–35
DISABLE BELL
DISABLE BELL
Prevents the terminal bell from ringing when CCPED signals an error. By
default, the terminal bell is enabled.
Format
DISABLE BELL
Parameters
None.
B–36 CCPED Commands
DISABLE ECHO
DISABLE ECHO
Turns off CCPED echoing of commands executed in command scripts. By
default, command echoing is disabled.
Format
DISABLE ECHO
Parameters
None.
Example
Command> ENABLE ECHO
%FORMS-I-ECHOENAB, echo of command script input has been enabled.
Command> @DEFINE_POSITION_KEYS
DEFINE_KEYS> Define Key PF1_Up
’Position (1,Column$)’
%FORMS-I-KEYDEF, function key PF1_UP has been defined.
DEFINE_KEYS> Define Key PF1_Down ’Position (Line_Max$,Column$)’
%FORMS-I-KEYDEF, function key PF1_DOWN has been defined.
DEFINE_KEYS> Define Key PF1_Right ’Position (Line$,Column_Max$)’
%FORMS-I-KEYDEF, function key PF1_RIGHT has been defined.
DEFINE_KEYS> Define Key PF1_Left ’Position (Line$,1)’
%FORMS-I-KEYDEF, function key PF1_LEFT has been defined.
Command> DISABLE ECHO
Command> @DEFINE_OTHER_KEYS
Command>
Turns off echoing of script commands.
CCPED Commands B–37
DISABLE HINTS
DISABLE HINTS
Prevents CCPED from displaying help messages during the editing session. By
default, hints are disabled.
Format
DISABLE HINTS
Parameters
None.
B–38 CCPED Commands
ENABLE BELL
ENABLE BELL
Causes the terminal bell to ring when CCPED signals an error. By default, the
terminal bell is enabled.
Format
ENABLE BELL
Parameters
None.
CCPED Commands B–39
ENABLE ECHO
ENABLE ECHO
Turns on CCPED echoing of commands executed in command scripts. By
default, command script echoing is disabled.
Format
ENABLE ECHO
Parameters
None.
Example
Command> ENABLE ECHO
%FORMS-I-ECHOENAB, echo of command script input has been enabled.
Command> @Define_Keys
DEFINE_KEYS> Define Key PF1_Up
’Position (1,Column$)’
%FORMS-I-KEYDEF, function key PF1_UP has been defined.
DEFINE_KEYS> Define Key PF1_Down ’Position (Line_Max$,Column$)’
%FORMS-I-KEYDEF, function key PF1_DOWN has been defined.
DEFINE_KEYS> Define Key PF1_Right ’Position (Line$,Column_Max$)’
%FORMS-I-KEYDEF, function key PF1_RIGHT has been defined.
DEFINE_KEYS> Define Key PF1_Left ’Position (Line$,1)’
%FORMS-I-KEYDEF, function key PF1_LEFT has been defined.
Command>
Turns on echoing of script commands.
B–40 CCPED Commands
ENABLE HINTS
ENABLE HINTS
Causes CCPED to display help messages in the message window about the
current cursor position when CCPED menus are displayed. By default, hints
are disabled.
Format
ENABLE HINTS
Parameters
None.
CCPED Commands B–41
EXIT
EXIT
Terminates the editing session and saves all changes made to the form.
Format
EXIT
Parameters
None.
B–42 CCPED Commands
GROUP SELECTED OBJECTS
GROUP SELECTED OBJECTS
Adds selected literals to an existing panel group. The literals cannot be part
of any other group. The selection list must contain only literals when you use
this command.
You cannot use this command to add fields, icons, or other groups to a group.
You must use the CREATE FIELD, CREATE ICON, or CREATE GROUP
command with a fully qualified name.
Format
GROUP SELECTED [OBJECTS] INTO group-name
Parameter
group-name
The qualified name of the group to which you are adding selected literals.
Example
Command>
Command>
Command>
Command>
Command>
Command>
Command>
CREATE GROUP Outer_group OCCURS 5 HORIZONTAL
CREATE GROUP Outer_group.Inner_group OCCURS 10 VERTICAL
CREATE FIELD Outer_group.Inner_group.F_1 (2,10) TYPE CHARACTER(5)
CREATE TEXT " Value: " (2,2)
SELECT (2,2)
GROUP SELECTED INTO Outer_group.Inner_group
DESELECT ALL
Adds the text literal ‘‘ Value: ’’ (including spaces) to the group as follows:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
Value:
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
XXXXX
CCPED Commands B–43
HELP
HELP
Invokes an online help session. CCPED displays the Help window with some
help text and a list of additional topics. Use the arrow keys to choose a topic,
and press Select to display information about that topic.
For information about navigating within and among help topics, see Chapter 3.
To return to the panel you are editing at any time during the help session,
press PF1-E.
Format
HELP [topic [subtopic...]]
Parameters
topic [subtopic...]
The topic and, optionally, subtopics on which you want help.
Example
Command> HELP Clipboard
Displays help information about the Clipboard topic.
B–44 CCPED Commands
INSERT FROM CLIPBOARD
INSERT FROM CLIPBOARD
Places objects from the top page of the clipboard onto the current panel, and
removes that page from the clipboard. To place an object from the clipboard
onto a panel and retain a copy of that object on the clipboard, use the COPY
FROM CLIPBOARD command.
For information about using the CCPED clipboard, see Chapter 3.
Format
INSERT FROM CLIPBOARD [TO (l,c)]
Parameter
TO (l,c)
The line and column coordinates of the location on the panel where you want
the clipboard page inserted. If you do not specify coordinates, the page is
inserted at the current cursor position.
These coordinates define the start position for the upper-left corner of the
imaginary rectangle that encloses all objects on the clipboard page.
Examples
1.
Command> INSERT FROM CLIPBOARD
Inserts the top page of the clipboard onto the current panel at the current
cursor location.
2.
Command> INSERT FROM CLIPBOARD TO (5,15)
Inserts the top page of the clipboard onto the current panel at line 5,
column 15.
CCPED Commands B–45
LIST PANELS
LIST PANELS
Displays in the CCPED Information Window a list of panels contained in the
current layout.
Format
LIST PANELS [FULL]
Parameter
FULL
Displays additional information such as panel size and associated viewport.
B–46 CCPED Commands
LIST VIEWPORTS
LIST VIEWPORTS
Displays in the CCPED Information Window a list of viewports contained in
the current layout.
Format
LIST VIEWPORTS [FULL]
Parameter
FULL
Lists the position and size of each viewport.
CCPED Commands B–47
MARK
MARK
Interactively defines graphic objects or area selections. MARK places a visual
marker (a graphic box) at the specified position in the current panel. CCPED
validates each mark against the positions of previous marks.
To create an object specified by MARK commands, use the CREATE MARKED
OBJECT command. To select objects within an area specified by MARK
commands, use the SELECT MARKED AREA command.
Format
MARK [(l,c)]
Parameter
(l,c)
The line and column coordinates of the mark’s position. If you do not specify
coordinates, the mark is placed at the current cursor position. Two consecutive
marks must be positioned horizontally or vertically, unless they are the only
two marks currently specified in the panel.
Examples
1.
Command> MARK
Places a mark at the cursor position in the current panel.
2.
Command> MARK (1,1); MARK (LINE_MAX$,COLUMN_MAX$)
Command> CREATE MARKED OBJECT
Creates a rectangle enclosing the entire panel.
B–48 CCPED Commands
MODIFY FIELD
MODIFY FIELD
Modifies the description or picture of selected fields. You must select the fields
before you can modify their description or picture.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Field Description Menu. This menu allows you to modify the field description
interactively. For information on using this menu, see Chapter 3.
Format
MODIFY FIELD
h
DESCRIPTION [field-description-entry]
PICTURE [DATE] ‘‘picture-string’’
i
Parameters
DESCRIPTION [field-description-entry]
Specifies that the field’s description is to be modified.
You can specify the following field description attributes in CCPED:
[NO | NOT]
[NO | NOT]
[NO | NOT]
[NO | NOT]
[NO | NOT]
[NO | NOT]
AUTOSKIP
CONCEALED
DATA INPUT
INPUT REQUIRED
PROTECTED
TIMEOUT
n LEFT o
JUSTIFICATION
RIGHT
UPPERCASE
MIXED [CASE]
MINIMUM LENGTH expression
{NO | NOT} MINIMUM LENGTH
TIMEOUT expression
SCALE expression
n
o
DECIMAL POINT PERIOD
COMMA
REPLACE
n
LEADING
TRAILING
o
quoted-character
CCPED Commands B–49
MODIFY FIELD
To restore default behavior for REPLACE LEADING and REPLACE
TRAILING, use a quoted space character. For example:
REPLACE LEADING " "
For more information on these attributes, see the section describing ITEM
DESCRIPTION Entry clauses in the HP DECforms IFDL Reference Manual.
PICTURE [DATE] ‘‘picture-string’’
Modifies the field’s picture or date picture. The picture-string parameter
specifies the new string for the field’s picture; it must be enclosed in quotation
marks. For information on the format of a picture string, see the HP DECforms
IFDL Reference Manual.
Examples
1.
Command> CREATE FIELD Amount TYPE UNSIGNED BYTE PICTURE "999"
Command> SELECT NAMED Amount
Command> MODIFY FIELD PICTURE "99W9.99"
Modifies the picture of the field Amount.
2.
Command> CREATE FIELD Address TYPE CHARACTER(30)
Command> SELECT NAMED Address
Command> MODIFY FIELD DESCRIPTION REPLACE TRAILING "_"
Modifies the REPLACE TRAILING character for the field Address.
B–50 CCPED Commands
MODIFY GROUP
MODIFY GROUP
Modifies the horizontal or vertical display of a panel group.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Field Description Menu.
Format
MODIFY GROUP name
n
HORIZONTAL
VERTICAL
o
[DISPLAYS expression]
Parameters
name
Names the panel group to be modified.
HORIZONTAL
Modifies the group so that it is displayed horizontally.
VERTICAL
Modifies the group so that it is displayed vertically.
DISPLAYS expression
Specifies how many occurrences of the group are to be displayed horizontally or
vertically on the panel. The number of occurrences you specify with DISPLAYS
must be less than or equal to the number of data group occurrences. If you do
not specify DISPLAYS, CCPED assumes a value equal to the number of data
group occurrences.
The number of display occurrences must fit in all viewports in which the panel
might be displayed.
Example
Command>
Command>
Command>
Command>
CREATE
CREATE
MODIFY
MODIFY
GROUP
FIELD
GROUP
GROUP
GROUP_1 OCCURS 3 VERTICAL DISPLAYS 2
GROUP_1.FIELD_1 TYPE CHAR(2) PICTURE "XX’ ’"
GROUP_1 VERTICAL DISPLAYS 3
GROUP_1 HORIZONTAL
Creates a panel group, modifies the number of occurrences in the vertical
display, and changes the display so that it is horizontal.
CCPED Commands B–51
MODIFY PANEL display-attribute COLOR
MODIFY PANEL display-attribute COLOR
Specifies colors for certain display attributes when the panel is displayed.
This command overrides the attributes specified by the MODIFY VIEWPORT
display-attribute COLOR command.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Field Description Menu.
Format
8
>
<
MODIFY PANEL
>
:
BACKGROUND
REVERSE FOREGROUND
BOLD FOREGROUND
FOREGROUND
9
>n
=
>
;
COLOR
COLOUR
on
color-name
rgb-specification
o
Parameters
color-name
The color for the attribute. You can use a color you have defined with the
DEFINE COLOR command or one of the following:
UNCHANGED
BLACK
BLUE
CYAN
GREEN
MAGENTA
RED
WHITE
YELLOW
rgb-specification
The RGB color specification, which has the following format:
(red-expression, green-expression, blue-expression)
The expressions must evaluate to whole numbers in the range 0 to 100. They
represent the percentage of the particular color component (red, green, or blue)
in the overall color specification. (In the IFDL source file, the values in the
RGB specification are in the range 0 through 1, inclusive.)
B–52 CCPED Commands
MODIFY PANEL display-attribute COLOR
Examples
1.
Command> MODIFY PANEL REVERSE FOREGROUND COLOR YELLOW
Specifies that objects with the reverse attribute are yellow when the panel
is displayed.
2.
Command> MODIFY PANEL BACKGROUND COLOUR (50,50,50)
Specifies that the panel’s background color is the color indicated by the
RGB expression (in this case, gray) when the panel is displayed.
CCPED Commands B–53
MODIFY PANEL TERMINAL WIDTH
MODIFY PANEL TERMINAL WIDTH
Specifies the display width for the current panel. This command overrides the
attribute specified by the MODIFY VIEWPORT TERMINAL WIDTH command.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Field Description Menu.
Format
MODIFY PANEL TERMINAL WIDTH width
Parameter
width
One of the following:
80
132
UNCHANGED
Specifies that the panel is displayed in 80 columns. If the
associated viewport is wider than 80 columns, the panel is
displayed in 132-column mode.
Specifies that the panel is displayed in 132 columns.
Specifies that the panel is displayed at the width
determined by the operator’s terminal setting.
Example
Command> MODIFY PANEL TERMINAL WIDTH 132
Specifies a display width of 132 columns for the current panel.
B–54 CCPED Commands
MODIFY PANEL VIEWPORT
MODIFY PANEL VIEWPORT
Associates a different viewport with the current panel. This command checks
whether the new viewport is larger than the current display.
Note
If the panel contains double-high or double-wide objects that begin in
an odd (even) column, the viewport also must begin in an odd (even)
column.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Field Description Menu.
Format
MODIFY PANEL VIEWPORT [viewport-name]
Parameter
viewport-name
The name of the viewport with which the panel is to be associated. If you do
not specify a viewport name, the panel is associated with the default viewport.
If you specify a printing viewport that is larger than the layout size, you can
no longer edit the current panel. As a result, CCPED attempts to locate a new
current panel as follows:
•
The panel after the current panel becomes the new current panel.
•
If there is no such panel, the panel before the current panel becomes the
new current panel.
•
If there is no such panel, the new current panel becomes undefined.
Example
Command> MODIFY PANEL VIEWPORT Account_VP
Associates the current panel with the viewport named Account_VP.
CCPED Commands B–55
MODIFY SELECTED display-attribute COLOR
MODIFY SELECTED display-attribute COLOR
Modifies the colors specified for the background or foreground of selected panel
objects.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Field Description Menu.
Format
MODIFY SELECTED
n
BACKGROUND
FOREGROUND
on
COLOR
COLOUR
o
color-name
Parameter
color-name
The color for the background or foreground of the selected objects. You can
use a color you have defined with the DEFINE COLOR command or one of the
following:
BLACK
BLUE
CYAN
GREEN
MAGENTA
RED
WHITE
YELLOW
Examples
1.
Command> MODIFY SELECTED FOREGROUND COLOR YELLOW
Changes the foreground color of selected objects to yellow.
2.
Command> MODIFY SELECTED BACKGROUND COLOUR GREEN
Changes the background color of selected objects to green.
B–56 CCPED Commands
MODIFY SELECTED OBJECTS CHARACTER SET
MODIFY SELECTED OBJECTS CHARACTER SET
Changes the character set attribute of selected text literals and fields. This
attribute does not apply to graphic literals.
You must select text literals and fields before you can modify their character
set.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Display Attribute Menu. For information on using this menu to change
character set attributes, see Chapter 3.
Note
Not all character sets are supported on all terminals. CCPED lets you
set the character set to whatever you want, but the panel’s appearance
depends on the display device.
Format
MODIFY SELECTED [OBJECTS] CHARACTER SET char-set
Parameter
char-set
One of the following keywords:
ASCII
ISO_8859_1
ISO LATIN_1 (equivalent to ISO_8859_1)
RULE
UK
USER [PREFERENCE]
VT100 SET1
VT100 SET2
ISO_8859_5
ISO LATIN_5 (equivalent to ISO_8859_5)
Hebrew
Turkish
Hanyu
Hangul
Kanji
Thai
CCPED Commands B–57
MODIFY SELECTED OBJECTS CHARACTER SET
Katakana
MIA-Kanji
Examples
1.
Command> MODIFY SELECTED OBJECTS CHARACTER SET ASCII
Changes the character set attribute of all selected text literals in the panel
to ASCII.
2.
Command> CREATE TEXT "‘" (1,1)
Command> SELECT AT (1,1)
Command> MOD SEL CHAR SET RULE
Replaces the grave accent with a diamond character from the RULE
character set.
B–58 CCPED Commands
MODIFY SELECTED OBJECTS FONT SIZE
MODIFY SELECTED OBJECTS FONT SIZE
Changes the font size of selected text literals and fields. For the font size to be
modified, either the selected text object must be the only object on its line or
lines, or all other objects sharing the same line also must be on the selection
list so that they are modified as well. This command also modifies the size of
graphic objects.
You must select an object before you can modify its font size. No objects are
modified if the modification would cause conflicting object sizes, overlapping
fields, or objects that start in a wrong column.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Display Attribute Menu. For information on using this menu to modify font
size, see Chapter 3.
Restrictions
Objects with different font sizes cannot be on the same line.
If the panel’s viewport begins on an odd-numbered column, double-high
and double-wide objects must begin on odd-numbered columns. If the
panel’s viewport begins on an even-numbered column, double-high and
double-wide objects must begin on even-numbered columns.
Double-high objects cannot exist on the top line of the panel.
Format
MODIFY SELECTED [OBJECTS] FONT SIZE font-size
Parameter
font-size
One of the following keywords:
DOUBLE HIGH
DOUBLE WIDE
SINGLE
NORMAL
SINGLE and NORMAL are synonymous.
CCPED Commands B–59
MODIFY SELECTED OBJECTS FONT SIZE
Example
Command> MODIFY SELECTED FONT SIZE SINGLE
Changes the font size of all selected text objects to SINGLE.
B–60 CCPED Commands
MODIFY SELECTED OBJECTS LINE WIDTH
MODIFY SELECTED OBJECTS LINE WIDTH
Changes the line width of selected graphic objects. For the line width to be
modified, the selected object must be the only object on its line or lines, or all
other objects sharing the same line also must be on the selection list (so that
they are modified as well). This command also modifies the size of text objects.
You must select an object before you can modify its line width. If the
modification would cause conflicting object sizes, overlapping fields, or objects
that start in a wrong column, no objects are modified.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Display Attribute Menu. For information on using this menu to modify line
width, see Chapter 3.
Restrictions
Objects with different line widths cannot be on the same line.
If the panel’s viewport begins on an odd-numbered column, double-high
and double-wide objects must begin on odd-numbered columns. If the
panel’s viewport begins on an even-numbered column, double-high and
double-wide objects must begin on even-numbered columns.
Double-high objects cannot exist on the top line of the panel.
Format
MODIFY SELECTED [OBJECTS] LINE WIDTH line-width
Parameter
line-width
One of the following keywords:
DOUBLE HIGH
DOUBLE WIDE
SINGLE
NORMAL
SINGLE and NORMAL are synonymous.
CCPED Commands B–61
MODIFY SELECTED OBJECTS LINE WIDTH
Example
Command> MODIFY SELECTED LINE WIDTH DOUBLE HIGH
Changes the line width of all selected graphic objects to DOUBLE HIGH.
B–62 CCPED Commands
MODIFY SELECTED OBJECTS TEXT PATH
MODIFY SELECTED OBJECTS TEXT PATH
Changes the text path of selected objects to the direction specified.
You must select an object before you can modify its text path.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Display Attribute Menu. For information on using this menu to modify the
text path, see Chapter 3.
Format
MODIFY SELECTED [OBJECTS] TEXT PATH text-path
Parameter
text-path
One of the following:
HEBREW
RIGHT
Changes the text path to right-to-left.
Changes the text path to left-to-right.
Example
Command> MODIFY SELECTED TEXT PATH HEBREW
Changes the text path of all selected objects to right-to-left.
CCPED Commands B–63
MODIFY SELECTED OBJECTS VIDEO
MODIFY SELECTED OBJECTS VIDEO
Changes video attributes of selected objects. To apply video attributes to newly
created objects, use the SET VIDEO command.
You must select an object before you can modify its video attributes.
If you enter ‘‘MODIFY’’ without any parameters, CCPED displays the Modify
Display Attribute Menu. For information on using this menu to modify video
attributes, see Chapter 3.
Format
MODIFY SELECTED [OBJECTS] VIDEO attribute [attribute...]
Parameters
attribute
One of the following:
BLINKING
NO BLINKING
NOT BLINKING
Changes the BLINKING video attribute of selected
objects. The BLINKING attribute causes objects to
blink when they are displayed. NO BLINKING and
NOT BLINKING are equivalent.
BOLD
NO BOLD
NOT BOLD
Changes the BOLD video attribute of selected objects.
The BOLD attribute causes objects to appear in
boldface when they are displayed. NO BOLD and
NOT BOLD are equivalent.
NEGATIVE
NO NEGATIVE
NOT NEGATIVE
Same as REVERSE, NO REVERSE, and NOT
REVERSE.
NONE
Turns off all attributes.
B–64 CCPED Commands
MODIFY SELECTED OBJECTS VIDEO
NORMAL INTENSITY Same as NO BOLD.
REVERSE
NO REVERSE
NOT REVERSE
Changes the REVERSE video attribute of selected
objects. This attribute causes an object to be displayed
in reverse video. NO REVERSE and NOT REVERSE
are equivalent.
UNDERLINED
NO UNDERLINED
NOT UNDERLINED
Changes the UNDERLINED video attribute of
selected objects. This attribute causes an object to be
underlined when it is displayed. NO UNDERLINED
and NOT UNDERLINED are equivalent.
Examples
1.
Command> SELECT ALL; MODIFY SELECTED VIDEO BLINKING
Enables blinking on all objects in the current panel.
2.
Command> SELECT ALL; MODIFY SELECTED VIDEO NO BOLD
Turns off bolding for all objects in the current panel.
3.
Command> SELECT ALL; MODIFY SELECTED OBJECTS VIDEO REVERSE
Causes all objects in the current panel to be displayed in reverse video.
4.
Command> SELECT ALL; MODIFY SEL VIDEO NOT UNDERLINED BOLD NOT REVERSE
Removes underlining and reverse video from all objects in the current
panel, and adds bolding to them.
CCPED Commands B–65
MODIFY VIEWPORT display-attribute COLOR
MODIFY VIEWPORT display-attribute COLOR
Specifies colors for certain display attributes for all panels displayed in the
viewport. To override this command for individual panels, use the MODIFY
PANEL ~ COLOR command.
Format
8
>
<
MODIFY VIEWPORT
>
:
BACKGROUND
REVERSE FOREGROUND
BOLD FOREGROUND
FOREGROUND
9
>n
=
>
;
COLOR
COLOUR
on
color-name
rgb-specification
o
Parameters
color-name
The color for the attribute. You can use a color you have defined with the
DEFINE COLOR command or one of the following:
UNCHANGED
BLACK
BLUE
CYAN
GREEN
MAGENTA
RED
WHITE
YELLOW
rgb-specification
The RGB color specification, which has the following format:
(red-expression, green-expression, blue-expression)
The expressions must evaluate to whole numbers in the range 0 to 100. They
represent the percentage of the particular color component (red, green, or blue)
in the overall color specification. (In the IFDL source file, the values in the
RGB specification are in the range 0 to 1, inclusive.)
B–66 CCPED Commands
MODIFY VIEWPORT display-attribute COLOR
Examples
1.
Command> MODIFY VIEWPORT REVERSE FOREGROUND COLOR MAGENTA
Specifies that when panels in the viewport are displayed, objects with the
reverse attribute are magenta.
2.
Command> MODIFY VIEWPORT BACKGROUND COLOUR (90,0,10)
Specifies that when panels in the viewport are displayed, their background
color is the color indicated by the RGB expression (in this case, blue-red).
CCPED Commands B–67
MODIFY VIEWPORT TERMINAL WIDTH
MODIFY VIEWPORT TERMINAL WIDTH
Specifies the display width for the current viewport. To override this width for
a specific panel, use the MODIFY PANEL TERMINAL WIDTH command.
Format
MODIFY VIEWPORT TERMINAL WIDTH width
Parameter
width
One of the following:
80
132
UNCHANGED
Specifies that panels in the viewport are displayed in 80
columns. If the viewport is wider than 80 columns, the
panels are displayed in 132-column mode.
Specifies that panels in the viewport are displayed in 132
columns.
Specifies that panels in the viewport are displayed at the
width determined by the operator’s terminal setting.
Example
Command> MODIFY VIEWPORT TERMINAL WIDTH 132
Specifies a display width of 132 columns for panels in the current viewport.
B–68 CCPED Commands
MOVE CURRENT VIEWPORT
MOVE CURRENT VIEWPORT
Adjusts the position of the current panel’s viewport.
Format
MOVE CURRENT VIEWPORT
n
BY (l,c)
TO (l,c)
o
Parameters
BY (l,c)
Moves the current viewport the specified number of lines and columns from
the current position. A positive value l or c moves the viewport that number
of lines down or that number of columns to the right. A negative value l or c
moves the viewport that number of lines up or that number of columns to the
left.
TO (l,c)
Moves the upper-left corner of the current viewport to the specified line and
column.
Examples
1.
Command> MOVE CURRENT VIEWPORT BY (-3,5)
Moves the current panel’s viewport three lines up and five columns to the
right.
2.
Command> MOVE CURRENT VIEWPORT TO (5,10)
Moves the upper-left corner of the viewport to line 5, column 10.
CCPED Commands B–69
MOVE SELECTED OBJECTS
MOVE SELECTED OBJECTS
Adjusts the position of selected objects on the current panel.
This command does not change the order of objects in the IFDL source file.
Therefore, if another object exists at the destination for a moved object, the
moved object will be occluded by the existing object. To adjust the IFDL order
of objects, use the ORDER SELECTED OBJECTS command.
Note
You cannot use this command to move fields over other fields. You also
cannot use this command to move objects between different panels. Use
the REMOVE SELECTED OBJECTS TO CLIPBOARD and INSERT
FROM CLIPBOARD commands instead.
Format
MOVE SELECTED [OBJECTS]
n
BY (l,c)
TO (l,c)
o
Parameters
BY (l,c)
Moves each selected object the specified number of lines and columns from the
current position. A positive value l or c moves the objects that number of lines
down or that number of columns to the right. A negative value l or c moves
the objects that number of lines up or that number of columns to the left.
TO (l,c)
Moves the upper-left corner of the imaginary rectangle enclosing the selected
objects to the specified line and column. All objects within the imaginary
rectangle are adjusted by the same amount.
B–70 CCPED Commands
MOVE SELECTED OBJECTS
Examples
1.
Command> MOVE SELECTED BY (-5,3)
Moves the selected objects five lines up and three columns to the right on
the current panel.
2.
Command> MOVE SELECTED TO (10,15)
Moves the corner of the imaginary rectangle enclosing the objects to line
10, column 15.
CCPED Commands B–71
MOVE VIEWPORT
MOVE VIEWPORT
Adjusts the position of the specified viewport.
Format
MOVE VIEWPORT viewport-name
n
BY (l,c)
TO (l,c)
o
Parameters
BY (l,c)
Moves the specified viewport the designated number of lines and columns from
its original position. A positive value l or c moves the viewport that number
of lines down or that number of columns to the right. A negative value l or c
moves the viewport that number of lines up or that number of columns to the
left.
TO (l,c)
Moves the upper-left corner of the specified viewport to the specified line and
column.
Examples
1.
Command> MOVE VIEWPORT PAYROLL_VP BY (-3,5)
Moves the viewport named PAYROLL_VP three lines up and five columns
to the right.
2.
Command> MOVE VIEWPORT HELP_VP TO (5,10)
Moves the upper-left corner of the viewport HELP_VP to line 5, column 10.
B–72 CCPED Commands
ORDER SELECTED OBJECTS
ORDER SELECTED OBJECTS
Modifies the order in which the Form Manager paints all selected objects to
the order in which those objects were added to the selection list. The selected
objects must belong to the same parent; for example, you cannot reorder
selected fields that are in different groups.
The new order becomes the default activation order.
Format
ORDER SELECTED [OBJECTS]
2n
4
o 3
5
AFTER
BEFORE
[UNSELECTED]
Parameters
AFTER [UNSELECTED]
Specifies that the reordered objects be placed after any unselected panel
objects belonging to the same parent. This is the default. The keyword
UNSELECTED is optional.
BEFORE [UNSELECTED]
Specifies that the reordered objects be placed before any unselected panel
objects belonging to the same parent. If all panel objects are selected, the
entire contents of the panel are reordered; in this case, the BEFORE option
has no meaning. The keyword UNSELECTED is optional.
Examples
1.
Command> ORDER SELECTED OBJECTS BEFORE UNSELECTED
Places selected objects before any unselected objects.
2.
Command> DESELECT ALL; SELECT ALL; ORDER SELECTED
Selects all objects in the current panel and orders them in the order in
which they appear on the selection list. Because SELECT ALL places
objects on the selection list in the order in which they appear in the panel,
this particular command orders the objects from left to right and top to
bottom.
CCPED Commands B–73
POSITION HORIZONTAL
POSITION HORIZONTAL
Moves the cursor the specified number of columns to the right or left of its
current position.
Format
POSITION HORIZONTAL [n]
Parameter
n
A positive value n moves the cursor n columns to the right of its current
position. A negative value n moves the cursor n columns to the left of its
current position. If you do not specify a value, the cursor is moved one column
to the right. If you specify a value that would move the cursor outside the
current panel, CCPED displays an error message.
Examples
1.
Command> POSITION HORIZONTAL 5
Moves the cursor five columns to the right of its current position.
2.
Command> POSITION HORIZONTAL -12
Moves the cursor 12 columns to the left of its current position.
B–74 CCPED Commands
POSITION NEXT
POSITION NEXT
Moves the cursor to the next object or the next word in a text literal in the
current panel.
Format
POSITION NEXT
n
OBJECT
WORD
o
Parameters
OBJECT
Moves the cursor to the next object in the panel in left-to-right, top-to-bottom
order.
WORD
Moves the cursor to the next word within the current text literal or to the
beginning of the next object in the current panel.
Examples
1.
Command> POSITION NEXT OBJECT
Moves the cursor to the next object in the panel.
2.
Command> POSITION NEXT WORD
Moves the cursor to the next word in the current text literal.
3.
Command> CREATE TEXT "Phone Number" (1,1); POS (1,1); POS NEXT WORD
Moves the cursor to a final position at the beginning of the word ‘‘Number’’
on line 1, column 7, in the current panel.
CCPED Commands B–75
POSITION PREVIOUS
POSITION PREVIOUS
Moves the cursor to the previous object on the current panel or to the previous
word within the current text literal.
Format
POSITION PREVIOUS
n
OBJECT
WORD
o
Parameters
OBJECT
Moves the cursor to the previous object on the panel in right-to-left, bottom-totop order.
WORD
Moves the cursor to the previous word within the current text literal or to the
previous object in the current panel. If the previous object is a text literal, the
cursor moves to the last word within that literal.
Examples
1.
Command> POSITION PREVIOUS OBJECT
Moves the cursor to the previous object in the panel.
2.
Command> POSITION PREVIOUS WORD
Moves the cursor to the previous word within the current text literal.
B–76 CCPED Commands
POSITION TO
POSITION TO
Moves the cursor to a specified location within the current panel.
Format
POSITION [TO] (l,c)
Parameter
(l,c)
The line and column coordinates of the location to which you want to move the
cursor.
Example
Command> POSITION TO (18,66)
Moves the cursor to line 18, column 66, on the current panel.
CCPED Commands B–77
POSITION VERTICAL
POSITION VERTICAL
Moves the cursor the specified number of lines up or down from its current
position.
Format
POSITION VERTICAL [n]
Parameter
n
A positive value n moves the cursor n lines down from its current position.
A negative value n moves the cursor n lines up from its current position. If
you do not specify a value, the cursor is moved one line down. If you specify a
value that would move the cursor outside the current panel, CCPED displays
an error message.
Examples
1.
Command> POSITION VERTICAL 10
Moves the cursor 10 lines down from its current position.
2.
Command> POSITION VERTICAL -8
Moves the cursor eight lines up from its current position.
B–78 CCPED Commands
QUIT
QUIT
Terminates the editing session without saving any changes made to the form.
If you have made changes to the form, CCPED displays a pop-up panel asking
whether you really want to quit.
Format
QUIT [SAVE [JOURNAL]]
Parameter
SAVE [JOURNAL]
Does not delete the journal file upon terminating the editing session. The
keyword JOURNAL is optional.
Example
Command> QUIT SAVE
Terminates the editing session without saving any changes, and saves the
journal file.
CCPED Commands B–79
RECALL MESSAGE
RECALL MESSAGE
Displays the most recently signaled message in the Information Window. This
command is useful when you are unable to read the message CCPED sends
to the message panel. For example, you can use RECALL MESSAGE to see a
CCPED message that was obscured by a broadcast system message or one that
was too long to be displayed completely.
Format
RECALL MESSAGE
Parameters
None.
B–80 CCPED Commands
REFRESH
REFRESH
Restores the appearance of the CCPED screen.
Format
REFRESH
Parameters
None.
CCPED Commands B–81
REMOVE SELECTED OBJECTS TO CLIPBOARD
REMOVE SELECTED OBJECTS TO CLIPBOARD
Removes selected objects from the current panel and places them on a new
clipboard page. To place objects on a clipboard page and retain copies of them
in the panel, use the COPY SELECTED OBJECTS TO CLIPBOARD command.
For information about using the CCPED clipboard, see Chapter 3.
Note
Do not use the REMOVE command to delete objects from the panel;
use the DELETE command instead.
Format
REMOVE SELECTED [OBJECTS] TO CLIPBOARD
Parameters
None.
Example
Command> CREATE TEXT "No cash left in that account!" (10,10)
Command> SELECT AT (10,10)
Command> REMOVE SELECTED TO CLIPBOARD
Removes the selected text from the current panel and places it on the top
clipboard page.
B–82 CCPED Commands
RESIZE CURRENT VIEWPORT
RESIZE CURRENT VIEWPORT
Changes the size of the current panel’s viewport.
Format
RESIZE CURRENT VIEWPORT
n
BY
TO
o
(l,c)
Parameters
BY (l,c)
Adjusts the size of the viewport by the specified number of lines and columns.
A positive value adds lines down or columns to the right; a negative value
subtracts lines up or columns to the left.
TO (l,c)
Changes the size of the viewport by moving the lower-right corner to the
coordinates specified by l and c.
Examples
1.
Command> RESIZE CURRENT VIEWPORT BY (3,-5)
Adds three lines to and subtracts five columns from the size of the current
viewport.
2.
Command> RESIZE CURRENT VIEWPORT TO (5,10)
Changes the viewport size to five lines long and ten columns wide.
CCPED Commands B–83
RESIZE VIEWPORT
RESIZE VIEWPORT
Changes the size of the specified viewport.
Format
RESIZE VIEWPORT viewport-name
n
BY
TO
o
(l,c)
Parameters
viewport-name
The name of the viewport whose size you want to change.
BY (l,c)
Adjusts the size of the viewport by the specified number of lines and columns.
A positive value adds lines down or columns to the right; a negative value
subtracts lines up or columns to the left.
TO (l,c)
Changes the size of the viewport by moving the lower-right corner to the
coordinates specified by l and c.
Examples
1.
Command> RESIZE VIEWPORT HELP_VP BY (3,5)
Adds three lines and five columns to the size of the HELP_VP viewport.
2.
Command> RESIZE VIEWPORT ACCOUNT_VP TO (5,10)
Changes the size of the ACCOUNT_VP viewport to five lines long and ten
columns wide.
B–84 CCPED Commands
ROTATE CLIPBOARD
ROTATE CLIPBOARD
Moves the top page of the clipboard to the bottom of the clipboard page list.
The next page becomes the top page.
Format
ROTATE [CLIPBOARD]
Parameters
None.
Example
Command> ROTATE CLIPBOARD; VIEW CLIPBOARD
Makes the second page of the clipboard the top page, and displays it.
CCPED Commands B–85
SELECT ALL OBJECTS
SELECT ALL OBJECTS
Selects every object on the current panel. The objects are added to the selection
list in the order in which they appear on the panel from left to right and top to
bottom. Therefore, you can use SELECT ALL to select the entire screen and
define the order of objects as they appear on the screen.
If the current panel contains a compound object (an object made up of other
objects), the compound object—not its individual elements—is selected.
Selected objects are displayed in reverse video.
Format
SELECT ALL [OBJECTS]
Parameters
None.
B–86 CCPED Commands
SELECT AREA
SELECT AREA
Selects all objects enclosed by the rectangle specified by the position
parameters. If all elements of a compound object are enclosed by the area,
the compound object—not its individual elements—is selected. The objects are
added to the selection list in the order in which they appear on the panel from
left to right and top to bottom.
Format
SELECT AREA (l,c) (l,c)
Parameters
(l,c) (l,c)
The line and column coordinate pairs that specify the opposite corners of the
rectangle to enclose the selected area.
Example
Command> SELECT AREA (1,1) (10,10)
Selects all objects that are completely within the rectangle defined by the
coordinates (1,1) and (10,10).
CCPED Commands B–87
SELECT AT
SELECT AT
Selects the topmost unselected object that passes through the specified location,
provided that more than one object exists in the character cell. Only individual
objects are selected. To select a compound object, use one of the other SELECT
commands.
Format
SELECT [[AT] (l,c)]
Parameter
[AT] (l,c)
The line and column coordinates of a point through which the object passes.
If you do not specify coordinates, the current cursor position is used. The
keyword AT is optional.
Example
Command> CREATE POINT (21,16)
Command> POSITION TO (21,16); SELECT
Selects the point at line 21, column 16.
B–88 CCPED Commands
SELECT MARKED AREA
SELECT MARKED AREA
Selects all objects that are completely within an area defined by two marks.
If all objects of a compound object are enclosed by the area, the compound
object—not its individual elements—is selected. The objects are added to the
selection list in the order in which they appear on the panel from left to right
and top to bottom.
For information about specifying a marked area, see the description of the
MARK command.
Format
SELECT MARKED [AREA]
Parameters
None.
Example
Command> MARK (LINE$-2,COLUMN$-10)
Command> MARK
Command> SELECT MARKED
Selects all objects enclosed by the rectangle defined by the current cursor
position and a point two lines up and ten columns to the left of the current
cursor position.
CCPED Commands B–89
SELECT NAMED
SELECT NAMED
Selects the named panel elements. The elements can be individual or
compound (made up of other elements).
Format
SELECT NAMED name [,name...]
Parameter
name
The qualified name of the element to be selected. If you specify more than one
name, separate each name with a comma.
Example
Command> SELECT NAMED Flower_Garden
Command> MODIFY FONT SIZE DOUBLE HIGH
Command> DESELECT NAMED Flower_Garden
Modifies the font size of the object Flower_Garden and removes the object from
the selection list.
B–90 CCPED Commands
SET CHARACTER SET
SET CHARACTER SET
Specifies a character set attribute to apply to subsequent text objects. This
attribute does not apply to graphic literals. To change the character set of
existing text objects, use the MODIFY SELECTED OBJECTS CHARACTER
SET command.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu. For information on using this menu to set character set
attributes, see Chapter 3.
Note
Not all character sets are supported on all terminals. CCPED lets you
set the character set to whatever you want, but the panel’s appearance
depends on the display device.
Format
SET CHARACTER SET character-set-name
Parameter
character-set-name
One of the following keywords:
ASCII
ISO_8859_1
LATIN_1 (equivalent to ISO_8859_1)
RULE
UK
USER [PREFERENCE]
VT100 SET1
VT100 SET2
ISO_8859_5
ISO LATIN_5 (equivalent to ISO_8859_5)
Hebrew
Turkish
Hanyu
Hangul
Kanji
Thai
CCPED Commands B–91
SET CHARACTER SET
Katakana
MIA-Kanji
The default is USER PREFERENCE.
Example
Command> SET CHARACTER SET ASCII
Specifies that CCPED apply the ASCII character set attribute to subsequent
text objects in the current panel.
B–92 CCPED Commands
SET display-attribute COLOR
SET display-attribute COLOR
Specifies the color for the background or foreground of subsequent panel
objects.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu.
Format
SET
n
BACKGROUND
FOREGROUND
on
COLOR
COLOUR
o
color-name
Parameter
color-name
The color for the background or foreground of the selected objects. The color
can be either a user-defined color as specified with the DEFINE COLOR
command, or one of the following:
BLACK
BLUE
CYAN
GREEN
MAGENTA
RED
WHITE
YELLOW
Examples
1.
Command> SET FOREGROUND COLOR CYAN
Changes the foreground color of subsequent panel objects to cyan.
2.
Command> SET BACKGROUND COLOUR RED
Changes the background color of subsequent panel objects to red.
CCPED Commands B–93
SET ENTRY MODE
SET ENTRY MODE
Determines the text entry mode for text literals. Initially, the mode is set to
your current terminal setting. To switch between modes, use the TOGGLE
ENTRY MODE command.
If the cursor is not in an existing text literal or immediately after one when
you enter a character, CCPED creates a new text literal.
This command does not affect command-line editing. To change the text entry
mode for CCPED command lines, press to Ctrl/A or F14 while you are entering
commands.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu.
Format
SET ENTRY [MODE]
n
INSERT
OVERSTRIKE
o
Parameters
INSERT
Inserts characters you type in a text literal immediately before the character
at the current cursor position; trailing characters in that literal are shifted to
the right.
OVERSTRIKE
Replaces the character at the current cursor position with each character you
type.
Example
Command> SET ENTRY MODE INSERT
Sets the text entry mode to insert mode.
B–94 CCPED Commands
SET FONT SIZE
SET FONT SIZE
Specifies a font size to apply to subsequent text objects. To change the font size
of existing text objects, use the MODIFY SELECTED OBJECTS FONT SIZE
command.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu. For information on using this menu to set the font size, see
Chapter 3.
Restrictions
Objects with different font sizes cannot be on the same line.
If the panel’s viewport begins on an odd-numbered column, double-high
and double-wide objects must begin on odd-numbered columns. If the
panel’s viewport begins on an even-numbered column, double-high and
double-wide objects must begin on even-numbered columns.
Double-high objects cannot exist on the top line of the panel.
Format
SET FONT SIZE font-size
Parameter
font-size
One of the following keywords:
DOUBLE HIGH
DOUBLE WIDE
SINGLE
NORMAL
SINGLE and NORMAL are synonymous and are the default.
Example
Command> SET FONT SIZE DOUBLE HIGH
Specifies that a font size of DOUBLE HIGH be applied to subsequent text
objects in the current panel.
CCPED Commands B–95
SET LINE WIDTH
SET LINE WIDTH
Specifies the line width to apply to subsequent graphic objects. To change the
line width of existing objects, use the MODIFY SELECTED OBJECTS LINE
WIDTH command.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu. For information on using this menu to set the line width, see
Chapter 3.
Restrictions
Objects with different line widths cannot be on the same line.
If the panel’s viewport begins on an odd-numbered column, double-high
and double-wide objects must begin on odd-numbered columns. If the
panel’s viewport begins on an even-numbered column, double-high and
double-wide objects must begin on even-numbered columns.
Double-high objects cannot exist on the top line of the panel.
Format
SET LINE WIDTH line-width
Parameter
line-width
One of the following keywords:
DOUBLE HIGH
DOUBLE WIDE
SINGLE
NORMAL
SINGLE and NORMAL are synonymous. The default is SINGLE.
Example
Command> SET LINE WIDTH DOUBLE WIDE
Specifies a line width of DOUBLE WIDE be applied to subsequent graphic
objects in the current panel.
B–96 CCPED Commands
SET ORIGIN MODE
SET ORIGIN MODE
Determines the default navigation order of fields in a panel during panel
editing.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu.
Format
SET ORIGIN [MODE]
n
LEFT
RIGHT
o
Parameters
LEFT
Sets the default navigation to left-to-right, top-to-bottom order.
RIGHT
Sets the default navigation to right-to-left, top-to-bottom order.
Example
Command> SET ORIGIN MODE RIGHT
Sets the default navigation to right-to-left, top-to-bottom order.
CCPED Commands B–97
SET TEXT PATH
SET TEXT PATH
Specifies a text path direction to apply to subsequent objects. To change the
text path of existing objects, use the MODIFY SELECTED OBJECTS TEXT
PATH command.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu. For information on using this menu to set the text path, see
Chapter 3.
Format
SET TEXT PATH text-path
Parameter
text-path
One of the following:
HEBREW
RIGHT
Applies a right-to-left text path.
Applies a left-to-right text path.
Example
Command> SET TEXT PATH HEBREW
Specifies that characters are entered from right to left.
B–98 CCPED Commands
SET VIDEO
SET VIDEO
Applies video attributes to all subsequent objects. To change the video
attributes of existing objects, use the MODIFY SELECTED OBJECTS VIDEO
command.
If you enter ‘‘SET’’ without any parameters, CCPED displays the Set Display
Attribute Menu. For information on using this menu to set video attributes,
see Chapter 3.
Format
SET VIDEO attribute [attribute...]
Parameters
attribute
One of the following:
BLINKING
NO BLINKING
NOT BLINKING
Applies or disables the BLINKING video attribute
for subsequent objects. The BLINKING attribute
causes objects to blink when they are displayed. NO
BLINKING and NOT BLINKING are equivalent.
BOLD
NO BOLD
NOT BOLD
Applies or disables the BOLD video attribute for
subsequent objects. The BOLD attribute causes
objects to be displayed in boldface. NO BOLD and
NOT BOLD are equivalent.
NEGATIVE
NO NEGATIVE
NOT NEGATIVE
Same as REVERSE, NO REVERSE, and NOT
REVERSE.
NONE
Turns off all attributes.
NORMAL INTENSITY Same as NO BOLD.
CCPED Commands B–99
SET VIDEO
REVERSE
NO REVERSE
NOT REVERSE
Applies or disables the REVERSE video attribute for
subsequent objects. This attribute causes objects to be
displayed in reverse video. NO REVERSE and NOT
REVERSE are equivalent.
UNDERLINED
NO UNDERLINED
NOT UNDERLINED
Applies or disables the UNDERLINED video attribute
for subsequent objects. This attribute causes
objects to be underlined when they are displayed.
NO UNDERLINED and NOT UNDERLINED are
equivalent.
Examples
1.
Command> SET VIDEO BLINKING; CREATE POINT (2,3)
Creates a blinking point at line 2, column 3, and sets the blinking attribute
for subsequent objects.
2.
Command> SET VIDEO BOLD; CREATE RECTANGLE (5,5) (10,10)
Creates a bolded rectangle at the specified location and sets the bold
attribute for subsequent objects.
3.
Command> SET VIDEO REVERSE; CREATE RECTANGLE (5,5) (10,10)
Creates a rectangle in reverse video and sets the reverse video attribute for
subsequent objects.
4.
Command> SET VIDEO UNDERLINED; CREATE TEXT "Options"
Creates an underlined text literal and sets the underlined attribute for
subsequent objects.
5.
Command> SET VIDEO REVERSE BOLD NO BLINKING
Applies reverse video and bolding to subsequent objects, and turns off
blinking for subsequent objects.
B–100 CCPED Commands
SHOW KEY
SHOW KEY
Displays in the message panel the definition for a key defined with the
DEFINE KEY command.
Format
SHOW KEY key-name
Parameter
key-name
The name of the key whose definition you want to see.
Example
Command> SHOW KEY E6
Value of key E6 is "Choose Next Panel" (Terminated).
Displays the definition of key E6.
CCPED Commands B–101
SHOW KEYPAD
SHOW KEYPAD
Displays a diagram of the CCPED default keypad.
For a summary of the operations available on the default keypad, see
Appendix A.
Format
SHOW KEYPAD
Parameters
None.
B–102 CCPED Commands
SHOW PANEL VIEWPORT
SHOW PANEL VIEWPORT
Displays the name of the viewport associated with the specified or current
panel.
Format
SHOW PANEL VIEWPORT [panel-name]
Parameter
panel-name
The name of the panel for which you want to see the name of the associated
viewport. If you do not specify a panel name, CCPED displays the name of the
viewport associated with the current panel.
CCPED Commands B–103
SHOW POSITION
SHOW POSITION
Displays the line and column numbers in the message panel for the cursor’s
current location relative to the viewport.
Format
SHOW POSITION
Parameters
None.
Example
Command> SHOW POSITION
Current line: 10, current column: 2
Shows line 10 and column 2 as the cursor’s current location.
B–104 CCPED Commands
SHOW REFERENCES
SHOW REFERENCES
Shows unresolved references in an incomplete form. For example, in a
response step you might list a panel that you have not created. The SHOW
REFERENCES command displays the name of that panel in the Information
Window.
Format
SHOW REFERENCES
Parameters
None.
CCPED Commands B–105
SHOW SYMBOL
SHOW SYMBOL
Displays the definition in the Information Window for symbols defined with the
DEFINE SYMBOL command.
Format
SHOW SYMBOL symbol-name
Parameter
symbol-name
The name of the symbol whose definition you want displayed.
Example
Command> DEFINE SYMBOL ZILDJIAN 1+3; SHOW SYMBOL ZILDJIAN
Displays the definition of the symbol ZILDJIAN.
B–106 CCPED Commands
SHOW VERSION
SHOW VERSION
Displays the number of the current version of CCPED.
Format
SHOW VERSION
Parameters
None.
Example
Command> SHOW VERSION
DECforms Panel Editor V4.0
Displays the current version number of CCPED.
CCPED Commands B–107
TEST
TEST
Invokes the DECforms Test Utility, letting you check the appearance of the
current panel and test any input fields. To exit the Test Utility, press F10. For
more information about the Test Utility, see Chapter 4.
Format
TEST
Parameters
None.
B–108 CCPED Commands
TOGGLE ENTRY MODE
TOGGLE ENTRY MODE
Switches entry mode for text literals from insert to overstrike or from
overstrike to insert. For more information, see the description of the SET
ENTRY MODE command.
This command does not affect the mode set for command-line editing. To
change the text entry mode for command lines, press Ctrl/A or F14 while you
are entering commands.
Format
TOGGLE [ENTRY MODE]
Parameters
None.
CCPED Commands B–109
UNDEFINE KEY
UNDEFINE KEY
Removes the definition of a key defined by the DEFINE KEY command.
Format
UNDEFINE KEY key-name
Parameter
key-name
The name of the key whose definition you are removing. If you press a key
after you have removed its definition, CCPED displays a ‘‘key is undefined’’
message.
Example
Command> UNDEFINE KEY F20
Removes the definition you specified previously for the function key F20.
B–110 CCPED Commands
UNDELETE ALL
UNDELETE ALL
Restores all objects, panels, or viewports that were deleted during the current
editing session.
Format
(
UNDELETE ALL
OBJECTS
PANELS
VIEWPORTS
)
Parameters
OBJECTS
Restores all objects deleted from the current panel. Objects can be restored
only to the panel from which they were deleted.
PANELS
Restores all panels deleted from the current layout. Panels can be restored
only during the editing session in which they were deleted.
VIEWPORTS
Restores all viewports deleted from the current layout. Viewports can
be restored only during the editing session in which they were deleted.
UNDELETE ALL VIEWPORTS does not restore any previous association
between the viewports and any panels.
CCPED Commands B–111
UNDELETE LAST
UNDELETE LAST
Restores the object, panel, or viewport most recently deleted during the current
editing session.
Format
(
UNDELETE LAST
OBJECT
PANEL
VIEWPORT
)
Parameters
OBJECT
Restores the object most recently deleted from the current panel. Objects can
be restored only to the panel from which they were deleted.
PANEL
Restores the panel most recently deleted during the current editing session.
VIEWPORT
Restores the viewport most recently deleted during the current editing session.
UNDELETE LAST VIEWPORT does not restore any previous association
between the viewport and any panels.
Example
Command> CREATE PANEL Mannheim_Steamroller
Command> DELETE PANEL Mannheim_Steamroller
Command> UNDELETE LAST PANEL
Restores the deleted panel Mannheim_Steamroller.
B–112 CCPED Commands
UNDELETE PANEL
UNDELETE PANEL
Restores a deleted panel during the same editing session in which it was
deleted. The restored panel becomes the current panel.
Format
UNDELETE PANEL panel-name
Parameter
panel-name
The name of the panel to be restored.
Example
Command> UNDELETE PANEL Account_Data
Restores the panel Account_Data and makes it the current panel.
CCPED Commands B–113
UNDELETE VIEWPORT
UNDELETE VIEWPORT
Restores a deleted viewport during the same editing session in which it was
deleted. UNDELETE VIEWPORT does not restore any previous association
between the viewport and any panels.
Format
UNDELETE VIEWPORT viewport-name
Parameter
viewport-name
The name of the viewport to be restored.
Example
Command> UNDELETE VIEWPORT Account_VP
Restores the viewport Account_VP.
B–114 CCPED Commands
UNGROUP SELECTED OBJECTS
UNGROUP SELECTED OBJECTS
Removes selected literals from a group. This command does not apply to fields,
icons, or other groups; you cannot ungroup those objects.
Format
UNGROUP SELECTED [OBJECTS]
Parameters
None.
Example
Command>
Command>
Command>
Command>
Command>
Command>
Command>
CREATE GROUP Outer_g OCCURS 5 HORIZONTAL
CREATE GROUP Outer_g.Inner_g OCCURS 10 VERTICAL
CREATE FIELD Outer_g.Inner_g.Field_1 (2,10) TYPE CHAR(5)
CREATE TEXT " Value: " (2,2)
SELECT (2,2)
GROUP SELECTED INTO Outer_g.Inner_g
UNGROUP SELECTED
Adds the text literal ‘‘ Value: ’’ to the group and then removes it.
CCPED Commands B–115
UNMARK
UNMARK
Removes previously created marks from the current panel. If no marks
are currently defined, or if no marks exist at the specified position, CCPED
displays an error message.
If you try to unmark a mark whose removal would cause other current marks
not to be horizontal or vertical to each other (for example, if the remaining
marks would end up diagonal to each other), CCPED displays an error
message.
Format
UNMARK [position]
Parameter
position
One of the following keywords:
[AT] (l,c)
LAST
ALL
Removes the mark at the line and column coordinates.
Removes the last mark created.
Removes all marks created in the current panel.
If you do not specify a position, the mark at the current cursor position is
removed.
Example
Command> MARK (3,4); MARK (3,35); UNMARK (3,4)
Removes the mark at line 3, column 4.
B–116 CCPED Commands
VIEW CLIPBOARD
VIEW CLIPBOARD
Displays the top page of the clipboard. To stop the display, press any key. For
information about using the CCPED clipboard, see Chapter 3.
Format
VIEW [CLIPBOARD]
Parameters
None.
CCPED Commands B–117
C
Using DEC LSE with DECforms Software
The optional DEC Language-Sensitive Editor (DEC LSE) is a powerful and
flexible text editor designed specifically for software development. DEC LSE
has important features that help you produce syntactically correct code in
DECforms software.
This appendix provides an overview of DEC LSE, which can increase your
productivity as a DECforms programmer. DEC LSE is not included with the
DECforms software; it must be purchased separately. For information on how
to purchase DEC LSE, contact your HP sales representative.
This appendix describes how to:
•
Invoke and exit DEC LSE
•
Enter DECforms source code
•
Compile source code and review translation errors
•
Interpret examples of IFDL syntax expansions
For more details on advanced features of DEC LSE, see the Guide to the DEC
Language-Sensitive Editor.
C.1 Invoking and Exiting DEC LSE
To invoke DEC LSE, at the system prompt enter a command in the following
format:
LSEDIT input-file-spec
Replace input-file-spec with the name of the IFDL source file to be edited or
created. The file type must be .ifdl for DEC LSE to provide IFDL syntax
expansions.
To exit DEC LSE, enter EXIT in response to the LSE Command> prompt. DEC
LSE produces as output an updated version of the IFDL file. The default
output file has the same name and file type as the input file.
Using DEC LSE with DECforms Software C–1
C.2 Entering Source Code Using Tokens and Placeholders
DEC LSE provides the functions of a traditional text editor, plus additional
powerful features: language-specific placeholders and tokens, aliases, comment
and indentation control, and templates for subroutine libraries.
Placeholders are markers in the source code that indicate locations where
you can provide source text. Placeholders help you to supply the appropriate
syntax in a given context. Generally, you do not need to type placeholders;
rather, DEC LSE inserts them for you.
Required placeholders, which are delimited by braces ( { } ), represent places
in the source code where you must provide source text. Optional placeholders,
which are delimited by brackets ( [ ] ), represent places in the source code
where you can either provide additional constructs or delete the placeholder.
When you erase an optional placeholder, DEC LSE also deletes any associated
text before and after that placeholder.
There are three types of DEC LSE placeholders, as follows:
Type of Placeholder
Description
Terminal
Provides text that describes valid replacements for the
placeholder.
Nonterminal
Expands into additional language constructs.
Menu
Provides a list of options corresponding to the placeholder.
You can move forward or backward from placeholder to placeholder. In
addition, you can delete or expand placeholders as needed. Section C.4 shows
examples of expanding placeholders.
Tokens typically represent keywords in DECforms software. When expanded,
tokens provide additional language constructs. You can type tokens directly
into the buffer.
Generally, you use tokens to add language constructs when there are no
placeholders in existing source code. For example, typing IF and entering
the EXPAND command causes a template for an IF construct to appear on
your screen. You can also use tokens to bypass long menus in cases where
expanding a placeholder, such as {statement}, would result in a lengthy menu.
You can use tokens to insert text when editing an existing file by typing the
name for a function or keyword and entering the EXPAND command.
C–2 Using DEC LSE with DECforms Software
DEC LSE commands allow you to manipulate tokens and placeholders. These
commands and their default key bindings are summarized in Table C–1.
Table C–1 DEC LSE Commands for Tokens and Placeholders
Command
Key Binding
Function
EXPAND
Ctrl/E
Expands a placeholder.
UNEXPAND
PF1-Ctrl/E
Reverses the effect of the most
recent placeholder expansion.
GOTO PLACEHOLDER/FORWARD
Ctrl/N
Moves the cursor to the next
placeholder.
GOTO PLACEHOLDER/REVERSE
Ctrl/P
Moves the cursor to the
previous placeholder.
ERASE PLACEHOLDER/FORWARD
Ctrl/K
Erases a placeholder.
UNERASE PLACEHOLDER
PF1-Ctrl/K
Restores the most recently
erased placeholder.
None
Down arrow
Moves the indicator down
through a menu.
None
Up arrow
None
n
Moves the indicator up
through a menu.
Enter
Return
o
Selects a menu option.
You can display a list of all defined tokens and placeholders, or a particular
token or placeholder, with the DEC LSE commands SHOW TOKEN and
SHOW PLACEHOLDER.
To copy the listed information into a separate file, use the following procedure:
1. Enter the appropriate SHOW command to put the list into the $SHOW
buffer; for example:
LSE> SHOW TOKEN
2. Enter the following commands:
LSE> GOTO BUFFER $SHOW
LSE> WRITE filename
To print the file you created, enter the PRINT command at DCL level.
Using DEC LSE with DECforms Software C–3
C.3 Translating Source Code
You can use the DEC LSE commands COMPILE and REVIEW to translate
your code and review translation errors without leaving the editing session.
The COMPILE command enters a DCL command in a subprocess to invoke the
DECforms IFDL Translator.
The Translator then generates a file of diagnostic information that DEC LSE
can use to review translation errors. The diagnostic information is generated
with the /DIAGNOSTICS qualifier that DEC LSE appends to the compilation
command.
For example, if you enter the COMPILE command while in the buffer
USER.IFDL, the following DCL command executes:
$ FORMS TRANSLATE USER.IFDL/DIAGNOSTICS=USER.DIA
DEC LSE supports all the DECforms IFDL Translator’s command qualifiers as
well as user-supplied command procedures.
For example, you can invoke Oracle CDD/Repository pieces tracking by
entering the following commands:
LSE> COMPILE/REVIEW $/DEPENDENCIES
DEC LSE not only provides you with the capability of collapsing or expanding
source code; you can also expand or collapse IFDL trace files using DEC LSE.
For example, you can collapse a trace file by entering the following command:
LSE> COLLAPSE/DEPTH=ALL
Using LSE with trace files will help you find errors in your IFDL source text
more easily.
The REVIEW command displays any diagnostic messages that result from a
translation. DEC LSE displays the translation errors in one window and the
corresponding source code in a second window so that you can review your
errors while examining the associated source code. This capability shortens the
process and helps ensure that all the errors are corrected before you recompile
your program.
DEC LSE provides several commands to help you review errors and examine
your source code. These commands (and their default key bindings where
applicable) are summarized in Table C–2.
C–4 Using DEC LSE with DECforms Software
Table C–2 DEC LSE Commands for Examining Source Code
Command
Key Binding
Function
COMPILE
None
Compiles the contents of the source buffer.
You can enter this command with the
/REVIEW qualifier to put DEC LSE in review
mode immediately after the compilation.
REVIEW
None
Puts DEC LSE into review mode and
displays any errors resulting from the last
compilation.
END REVIEW
None
Removes the buffer $REVIEW from the
screen; returns the cursor to a single window
containing the source buffer.
GOTO SOURCE
Ctrl/G
Moves the cursor to the source buffer that
contains the error.
NEXT STEP
Ctrl/F
Moves the cursor to the next error in the
buffer $REVIEW.
PREVIOUS STEP
Ctrl/B
None
n
Moves the cursor to the previous error in the
buffer $REVIEW.
Down arrow
Up arrow
o
Moves the cursor within a buffer.
C.4 Examples
The following sections show examples of using some common tokens and
placeholders to write DECforms code. The examples are expanded to show the
formats and guidelines that DEC LSE provides (although not all the examples
are fully expanded).
The examples show expansions of the following IFDL syntax:
•
VIEWPORT definition
•
PANEL declaration
•
GROUP declaration
Instructions and explanations precede each example, and an arrow (
indicates the line in the code where an action has occurred.
)
Section C.2 presents the commands that manipulate tokens and placeholders.
Braces ( { } ) enclose required placeholders; brackets ( [ ] ) enclose optional
placeholders.
Using DEC LSE with DECforms Software C–5
When you use DEC LSE to create a new DECforms source file, the initial
string, {form_definition}, appears at the top of the screen.
After {form_definition} appears, to expand the FORM declaration, use the
following procedure:
1. Expand the initial placeholder. The following then appears on your screen:
Form {form_name}
[form_data]...
[form_record]...
[form_record_list]...
{form_layout}...
End Form /* [form_name] */
2. Type EXAMPLE over the placeholder {form_name}:
Form EXAMPLE
<---
[form_data]...
[form_record]...
[form_record_list]...
{form_layout}...
End Form /* EXAMPLE */
C.4.1 VIEWPORT Definition
After you have typed the form name, to expand the VIEWPORT declaration,
use the following procedure:
1. Move down to the {form_layout} placeholder, and expand it:
Form EXAMPLE
[form_data]...
[form_record]...
[form_record_list]...
{form_layout}...
End Form /* EXAMPLE */
C–6 Using DEC LSE with DECforms Software
<---
2. After you expand the {form_layout} placeholder, move down to the
[viewport_declaration] placeholder and expand it:
Form EXAMPLE
[form_data]...
[form_record]...
[form_record_list]...
Layout {form_layout_name}
{device_clause}
[frame_declaration]
[language_clause]
[layout_selection_clause]
[units_clause]
{size_clause}
[list_declaration]...
[attribute_declaration]...
[display_viewport_clause]
[viewport_declaration]...
[function_declaration]...
<---
[internal_response_declaration]...
[external_response_declaration]...
[function_response_declaration]...
[help_panel_clause]
[field_default_declaration]...
[literal_default_declaration]...
[field_default_application]
[literal_default_application]
[message_panel_declaration]
[panel_declaration]...
[help_panel_declaration]...
End Layout /* [form_layout_name] */
[form_layout]...
End Form /* EXAMPLE */
3. After expanding [viewport_declaration], position to the {form_viewport_
name} placeholder:
Using DEC LSE with DECforms Software C–7
Viewport {form_viewport_name}
<--[For Printing]
Lines {number} Thru {number}
Columns {number} Thru {number}
[display_viewport_clause]
End Viewport /* [form_viewport_name] */
4. Type USER_VIEWPORT over the required placeholder {form_viewport_
name}. The viewport name is also automatically substituted for the
optional placeholder at the end of the viewport declaration.
5. Erase the [For Printing] placeholder. Position to it, and press Ctrl/K.
6. Define this viewport with lines 1 to 24, and columns 1 to 80 by typing those
values over the {number} placeholders in the appropriate positions:
Viewport USER_VIEWPORT
Lines {number} Thru {number}
Columns {number} Thru {number}
[display_viewport_clause]
End Viewport /* USER_VIEWPORT */
<---(Step 4)
<--<---
7. Erase the [display_viewport_clause] placeholder, as it is optional. Again
position to the placeholder, and press Ctrl/K:
Viewport USER_VIEWPORT
Lines 1 Thru 24
Columns 1 Thru 80
[display_viewport_clause]
End Viewport /* USER_VIEWPORT */
<---(Step 6)
<---(Step 6)
<---
The final viewport declaration appears as follows:
Viewport USER_VIEWPORT
Lines 1 Thru 24
Columns 1 Thru 80
End Viewport /* USER_VIEWPORT */
C.4.2 PANEL Declaration
To expand the PANEL declaration, use the following procedure:
1. Position the cursor down to the [panel_declaration] placeholder and expand
it:
Form EXAMPLE
[form_data]...
[form_record]...
[form_record_list]...
Layout {form_layout_name}
C–8 Using DEC LSE with DECforms Software
{device_clause}
[frame-declaration]
[language_clause]
[language_selection_clause]
[units_clause]
{size_clause}
[list_declaration]...
[attribute_declaration]...
[display_viewport_clause]
Viewport USER_VIEWPORT
Lines 1 Thru 24
Columns 1 Thru 80
End Viewport /*USER_VIEWPORT*/
[viewport_declaration]...
[function_declaration]...
[internal_response_declaration]...
[external_response_declaration]...
[function_response_declaration]...
[help_panel_clause]
[field_default_declaration]...
[literal_default_declaration]...
[field_default_application]
[literal_default_application]
[message_panel_declaration]
[panel_declaration]...
[help_panel_declaration]
<---
End Layout /* [form_layout_name] */
[form_layout]...
End Form /* EXAMPLE */
The placeholder [panel_declaration] expands with many more placeholders.
For this panel, though, you need only declare the viewport that the panel
appears in, and some display literals.
2. Position to the {form_panel_name} placeholder and type USER_PANEL:
Panel USER_PANEL
<---
[panel_property]...
[field_default_application]
[literal_default_application]
Using DEC LSE with DECforms Software C–9
[group_declaration]...
[panel_object_declaration]...
[literal_declaration]...
End Panel /* USER_PANEL */
3. Position to the placeholder [panel_property] and expand it:
Panel USER_PANEL
[Viewport {viewport_name}]
[display_viewport_clause]
[display_clause]
[post_display_clause]
[scroll_bar_clause]
[accept_response_declaration]
[help_panel_clause]
[help_message_clause]
[field_default_application]
[literal_default_application]
[group_declaration]...
[panel_object_declaration]...
[literal_declaration]...
End Panel /* USER_PANEL */
4. Erase all placeholders in the panel declaration except [Viewport {viewport_
name}] and [literal_declaration].
5. Position to the placeholder [Viewport {viewport_name}] and expand it.
6. Type USER_VIEWPORT over the {viewport_name} placeholder:
Panel USER_PANEL
Viewport USER_VIEWPORT
[literal_declaration]...
End Panel /* USER_PANEL */
<---
7. Add a rectangle declaration. To do this, position the cursor at the [literal_
declaration] placeholder, and expand it:
Panel USER_PANEL
Viewport USER_VIEWPORT
[literal_declaration]...
End Panel /* USER_PANEL */
<---
A menu is displayed.
8. Select the RECTANGLE menu choice. As you see, the placeholder
automatically expands.
9. Position the cursor at the first {line_clause} and expand it. A menu is
displayed.
C–10 Using DEC LSE with DECforms Software
10. Select the LINE1 menu choice. The placeholder is replaced with Line
{number}.
11. Type 3 over the {number} placeholder:
Panel USER_PANEL
Viewport USER_VIEWPORT
Literal Rectangle
Line 3 {column_clause}
<--{line_clause} {column_clause}
[literal_default_application]
[display_clause]
End Literal
[literal_declaration]...
End Panel /* USER_PANEL */
12. Position to the remaining {line_clause}, and {column_clause} placeholders,
expand them, and define the rectangle to have upper-left coordinates line
3, column 5, and lower-right coordinates line 12, column 30:
Panel USER_PANEL
Viewport USER_VIEWPORT
Literal Rectangle
Line 3 Column 5
<--Line 12 Column 30
<--[literal_default_application]
[display_clause]
End Literal
[literal_declaration]...
End Panel /* USER_PANEL */
13. Erase the [literal_default_application] and [display_clause] placeholders
from the expanded rectangle declaration, and erase the [literal_
declaration]... placeholder that follows the rectangle declaration. The
final panel declaration appears as follows:
Panel USER_PANEL
Viewport USER_VIEWPORT
Literal Rectangle
Line 3 Column 5
Line 12 Column 30
End Literal
End Panel /* USER_PANEL */
Using DEC LSE with DECforms Software C–11
C.4.3 DATA GROUP Declaration
There are three different types of groups in the IFDL syntax: form data
groups, record groups, and panel groups. This example declares a form data
group. For the declaration to be valid within the IFDL syntax, this declaration
must appear in the Form Data section of the form.
To get the group declaration, use the following procedure:
1. Position to an area in the Form Data area, type GROUP, and expand it:
[form_data]...
GROUP
.
.
.
<---
A menu is displayed with the three different group types.
2. Select GROUP2, the form data group:
Buffer: Q.IFDL
GROUP1 : An IFDL Panel group declaration
GROUP2 : An IFDL Form Data Group Definition <--GROUP3 : An IFDL Form Record Group Declaration
Choose one or press the help key
3. When the GROUP declaration is displayed, position the cursor at the
{form_group_name} placeholder, and type USER_GROUP:
[form_data]....
Group USER_GROUP
<--[track_clause]
[data_occurs_clause]
[form_data_declaration]...
End Group /* USER_GROUP */
.
.
.
4. Erase the [track_clause] placeholder, and expand the [data_occurs_clause]:
[form_data]...
Group USER_GROUP
Occurs {integer_value}
[Base {integer_value}]
[Current {data_name}]
[form_data_declaration]...
End Group /* USER_GROUP */
.
.
.
C–12 Using DEC LSE with DECforms Software
5. Define the group to occur 20 times by typing 20 over the {integer_value}
placeholder in the Occurs clause.
6. Expand the [Base {integer_value}] placeholder, and type 0 (zero) over the
{integer_value} placeholder to give the group a base index of 0 (zero).
7. Erase the [Current {data_name}] placeholder:
[form_data]...
Group USER_GROUP
Occurs 20
Base 0
[form_data_declaration]...
End Group /* USER_GROUP */
.
.
.
8. Position to the [form_data_declaration] placeholder and expand it. A menu
of group element types is displayed.
9. Select the ITEM menu choice. It automatically expands another menu.
10. Select the DATA_ITEM_1 menu choice:
[form_data]...
.
.
.
Group USER_GROUP
Occurs 20
Base 0
{data_name} {data_type_declaration} [value_clause] [track_clause]
[form_data_declaration]...
End Group /* USER_GROUP */
.
.
.
End Data
11. Position to the {data_name} placeholder and type ELEM_1.
12. Position to the {data_type_declaration} placeholder and expand it. A menu
is displayed.
13. Select the DATA_TYPE_2 menu choice. This also expands to a menu listing
the various types of atomic data types available.
14. Select ‘‘Word Integer’’.
Using DEC LSE with DECforms Software C–13
15. Erase the [value_clause], [track_clause], and [form_data_declaration]
placeholders.
Form Data
.
.
.
Group USER_GROUP
Occurs 20
Base 0
ELEM_1 Word Integer
End Group /* USER_GROUP */
.
.
.
End Data
C–14 Using DEC LSE with DECforms Software
Index
A
ABS$ function (CCPED), 3–12
Applications
sample, 3–2
Attributes
based on terminal type, 3–25
character set
Character Set submenu, 3–27, 3–28
MODIFY SELECTED OBJECTS
CHARACTER SET command,
3–28, B–57
restrictions, 3–28
SET CHARACTER SET command,
3–27, B–91
color
MODIFY PANEL display-attribute
COLOR command, 3–21, B–52
MODIFY SELECTED displayattribute COLOR command,
3–21, B–56
MODIFY VIEWPORT displayattribute COLOR command,
3–21, B–66
SET display-attribute COLOR
command, 3–21, B–93
font size
Font Size submenu, 3–21, 3–22
MODIFY SELECTED OBJECTS
FONT SIZE command, 3–22,
B–59
restrictions, 3–22
SET FONT SIZE command, 3–21,
B–95
Attributes (cont’d)
line width
Line Width submenu, 3–23, 3–24
MODIFY SELECTED OBJECTS
LINE WIDTH command, 3–24,
B–61
restrictions, 3–24
SET LINE WIDTH command, 3–23,
B–96
text path
MODIFY SELECTED OBJECTS
TEXT PATH command, B–63
SET TEXT PATH command, 3–28,
B–98
Text Path submenu, 3–28, 3–29
video
MODIFY SELECTED OBJECTS
VIDEO command, B–64
SET VIDEO command, 3–19, B–99
Video Attributes submenu, 3–19,
3–20
B
Background color, 3–21
layouts
specifying in FDE, 2–12
panels
specifying in CCPED, 3–21
specifying in FDE, 2–19
Back Translator, 5–6 to 5–7
invoking, 5–6
Bell
DISABLE BELL command, B–36
ENABLE BELL command, B–39
Index–1
BLINKING attribute, 3–19
BOLD attribute, 3–19
Borders around panels
CCPED, 3–14
C
CCPED (Character-Cell Panel Editor), 3–1
character set attributes, 3–27 to 3–28
clipboard operations, 3–38 to 3–40
color attributes, 3–21
command line editing, 3–9
commands and keys, 3–8 to 3–15, B–1 to
C–1
cursor positioning, 3–16 to 3–17
default function keys, A–6
default keypad, 3–15, A–1 to A–6
definable function keys, A–6 to A–10
exiting, 3–2
expressions, 3–12
font size
attributes, 3–21 to 3–23
help windows, 3–8
Information Window, 3–6
invoking from FDE, 2–20, 3–2
journaling, 3–3
line width attributes, 3–23 to 3–25
objects
creating and deleting, 3–29 to 3–36
moving, 3–38
reordering, 3–40
restoring, 3–36
selecting and deselecting, 3–36 to
3–38
panels
creating and deleting, 3–18
creating fields, 3–32
creating groups, 3–35
field descriptions and pictures, 3–34
restoring, 3–18
selecting, 3–19
predefined symbols, 3–12
qualified names, 3–10
Repeat Key function, 3–17
requesting editing information, 3–6
Index–2
CCPED (Character-Cell Panel Editor)
(cont’d)
restrictions
character set, 3–28
copying compound objects, 3–39
font size, 3–22
key definitions, 3–13
layout display size, 3–1
line width, 3–24
screen display, 3–3 to 3–8
session recovery, 3–3
symbols, 3–12
text path attributes, 3–28 to 3–29
tutorial, 3–2
using marks, 3–30
video attributes, 3–19 to 3–21
viewports
creating and deleting, 3–18
restoring, 3–18
CENTER SELECTED OBJECTS command
(CCPED), B–2
Characters
DELETE CHARACTER command, 3–30,
B–25
Character set
attributes
See also Attributes
Character Set submenu (CCPED), 3–27,
3–28
Checkpointing, 2–21
Choose, Create menu choice
FDE
Choose Help, 2–16
Choose Layout, 2–10
Choose Panel, 2–16
Create Layout, 2–10
Create Panel, 2–17
panel level, 2–16
CHOOSE command (CCPED), 3–19, B–3
Choose Data Type menu (CCPED), 3–33
Clipboard (CCPED)
copying objects
COPY FROM CLIPBOARD command,
3–39, B–5
Clipboard (CCPED)
copying objects (cont’d)
COPY SELECTED OBJECTS TO
CLIPBOARD command, 3–39,
B–6
displaying
VIEW CLIPBOARD command, 3–39,
B–117
inserting objects
INSERT FROM CLIPBOARD
command, 3–39, B–45
removing objects
REMOVE SELECTED OBJECTS TO
CLIPBOARD command, 3–39,
B–82
rotating pages
ROTATE CLIPBOARD command,
3–39, B–85
Color
attributes
See Attributes
layouts
specifying in FDE, 2–12
panels
specifying in FDE, 2–19
symbols
DEFINE COLOR command, B–20
Command line (CCPED), 3–5
Commands
abbreviating, 1–1
descriptions, 1–3
editing (CCPED), 3–9
entering (CCPED), 3–9
error messages, 1–2
expressions (CCPED), 3–12
format, 1–1
FORMS BACK_TRANSLATE, 1–4 to 1–5
FORMS CONVERT FMS, 1–6 to 1–7
FORMS DEVELOP, 1–8 to 1–12
FORMS EDIT, 1–13 to 1–15, 3–2
FORMS EXTRACT APPEARANCES,
1–16 to 1–17
FORMS EXTRACT OBJECT, 1–18 to
1–20, 6–1
FORMS TEST APPEARANCES, 1–21 to
1–22
Commands (cont’d)
FORMS TRANSLATE, 1–23 to 1–30
macros (CCPED), 3–11
OpenVMS
FORMS BACK_TRANSLATE, 5–6
FORMS DEVELOP, 2–2
FORMS EXTRACT APPEARANCES,
6–1
FORMS TEST APPEARANCES, 4–1
FORMS TRANSLATE, 5–1
recalling (CCPED), 3–9
scripts (CCPED), 3–14
echoing
DISABLE ECHO command,
3–14, B–37
ENABLE ECHO command,
3–14, B–40
using qualified names (CCPED), 3–10
Compound objects
See Objects
Control text responses
in form testing, 2–15
COPY FROM CLIPBOARD command
(CCPED), 3–39, B–5
COPY SELECTED OBJECTS TO
CLIPBOARD command (CCPED), 3–39,
B–6
Correcting errors, 1–3
CREATE FIELD command (CCPED), 3–32,
B–7
Create Field menu (CCPED), 3–32
CREATE GROUP command (CCPED), 3–35,
B–9
CREATE ICON command (CCPED), 3–31,
B–12
CREATE MARKED OBJECT command
(CCPED), 3–30, B–13
CREATE PANEL command (CCPED), 3–18,
B–14
CREATE POINT command (CCPED), 3–30,
B–15
CREATE POLYLINE command (CCPED),
3–30, B–16
Index–3
CREATE RECTANGLE command (CCPED),
3–30, B–17
CREATE TEXT command (CCPED), 3–30,
B–18
CREATE VIEWPORT command (CCPED),
3–18, B–19
Current panel
CCPED, 3–4
Cursor positioning (CCPED)
keys, 3–16 to 3–17
POSITION HORIZONTAL command,
B–74
POSITION NEXT command, B–75
POSITION PREVIOUS command, B–76
POSITION TO command, B–77
POSITION VERTICAL command, B–78
SHOW POSITION command, B–104
D
Data entry panels
creating in FDE, 2–17
Data types
creating
CCPED
Choose Data Type menu
(CCPED), 3–33
CREATE FIELD command,
3–32, B–7
Date picture
CREATE FIELD command, B–7
MODIFY FIELD command, 3–35, B–49
DCL commands
See Commands
DEC LSE, C–1 to C–14
exiting, C–1
invoking, C–1
reviewing diagnostic messages, C–4
translating source code, C–4
usage examples, C–5
using tokens and placeholders, C–2
DEC LSE (DEC Language Sensitive Editor)
diagnostics file (IFDL Translator), 5–4
invoking
from FDE, 1–11, 2–3
Index–4
Defaults
function keys (CCPED), A–6
keypad (CCPED), 3–15, A–1 to A–6
DEFINE COLOR command (CCPED), B–20
DEFINE KEY command (CCPED), 3–13,
B–22
DEFINE SYMBOL command (CCPED),
3–12, B–24
DELETE CHARACTER command (CCPED),
3–30, B–25
DELETE NAMED command (CCPED),
3–36, B–26
DELETE PANEL command (CCPED), 3–18,
B–27
DELETE SELECTED OBJECTS command
(CCPED), 3–36, B–28
DELETE VIEWPORT command (CCPED),
3–18, B–29
DESELECT ALL OBJECTS command
(CCPED), 3–38, B–30
DESELECT AREA command (CCPED),
3–37, B–31
DESELECT AT command (CCPED), 3–37,
B–32
DESELECT LAST command (CCPED),
3–37, B–33
DESELECT MARKED AREA command
(CCPED), 3–37, B–34
DESELECT NAMED command (CCPED),
3–37, 3–38, B–35
DISABLE BELL command (CCPED), B–36
DISABLE ECHO command (CCPED), 3–14,
B–37
DISABLE HINTS command (CCPED), B–38
Display attributes
See also Attributes
Documentation
sending comments to HP, xvii
DOUBLE HIGH attribute, 3–21, 3–23
DOUBLE WIDE attribute, 3–21, 3–23
E
Echoing
command (CCPED), 3–14
Edit Data menu choice (FDE), 2–8
Edit IFDL menu choice (FDE), 2–9
layout level, 2–16
panel level, 2–20
Editing
existing forms
from FDE, 2–6
form data
from FDE, 2–8
form record declarations
from FDE, 2–7
IFDL source files
from FDE form level, 2–7
from FDE layout level, 2–16
from FDE panel level, 2–20
new forms
from FDE, 2–5
Editor command format
for specifying starting position, 2–3
Editors
See also Text editors
DEC LSE, C–1 to C–14
panel editors
CCPED, 3–1 to 3–41
Edit Records menu choice (FDE), 2–7
ENABLE BELL command (CCPED), B–39
ENABLE ECHO command (CCPED), 3–14,
B–40
ENABLE HINTS command (CCPED), 3–5,
3–8, B–41
Enable response
using for form testing
in FDE, 2–15
Entry mode (CCPED)
SET ENTRY MODE command, B–94
TOGGLE ENTRY MODE command,
3–30, B–109
Error messages, 1–2
format, 1–2
printing, 1–2
Errors
correcting, 1–3
during translation, 2–9, 2–16, 2–20, 5–5
EXIT command (CCPED), 3–2, B–42
Exiting
CCPED, 3–2
EXIT command, 3–2, B–42
QUIT command, 3–2, B–79
DEC LSE, C–1
FDE, 2–20
Expressions
in CCPED commands, 3–12
defining symbols for, 3–12
predefined symbols, 3–12
Extract Appearances Utility
for producing text output, 2–7
invoking, 6–1
Extract Object Utility
invoking, 6–1
producing object modules, 2–7
with vectors, 2–7
F
FDE (Form Development Environment)
checkpointing, 2–21
Choose, Create menu choice, 2–10
panel level, 2–16
Edit Data menu choice, 2–8
Edit IFDL menu choice
form level, 2–9
layout level, 2–16
panel level, 2–20
Edit Records menu choice, 2–7
exiting, 2–20
Extract Appearances Utility, 2–7
Extract Object Utility, 2–7
File menu choice, 2–6
file output options, 2–6
form development tasks, 2–1
function keys, 2–5
invoking, 2–2
text editors, 2–7
layouts
choosing, 2–10
Index–5
FDE (Form Development Environment)
layouts (cont’d)
creating, 2–10
modifying, 2–13
message panels, 2–11
Modify Form menu choice, 2–7
Modify Layout menu choice, 2–13
Modify Panel menu choice, 2–20
Panel Editor menu choice, 2–20
panels
choosing, 2–16
creating, 2–17
modifying, 2–20
testing, 2–14
quitting, 2–20
Test menu choice, 2–13
text editors
specifying, 2–3
Feedback on documentation
sending comments to HP, xvii
File menu
FDE
FORM only, 2–6
IFDL, FORM, 2–6
IFDL only, 2–6
Object of Form, 2–7
Object Vectors, 2–7
Panel Images, 2–6
Font size attributes
See Attributes
Font Size submenu (CCPED), 3–21, 3–22
Foreground color, 3–21
layouts
specifying in FDE, 2–12
panels
specifying in CCPED, 3–21
specifying in FDE, 2–19
Form data
editing
from FDE, 2–8
Form Development Environment
See FDE
Form development utilities
Back Translator, 5–6 to 5–7
Extract Appearances, 2–7, 6–1 to 6–2
Index–6
Form development utilities (cont’d)
Extract Object, 2–7, 6–1
IFDL Translator, 2–9, 5–1 to 5–5
Panel Editors
CCPED, 2–20, 3–1 to 3–41
Test, 2–14, 4–1 to 4–4
Form files
specifying
when invoking FDE, 2–2
translating
from IFDL source file, 5–1
to IFDL source file, 5–6
Form records
declarations
editing from FDE, 2–7
Forms
commands
See Commands
creating, 2–5
editing, 2–6
enabling for testing
in FDE, 2–14
extracting
to object modules, 2–7
to text file, 2–7
extracting to object modules
with vectors, 2–7
renaming
FDE, 2–7
testing
in FDE, 2–13, 2–14
FORMS$EDIT_INIT logical name, 1–13,
3–14
FORMS$LANGUAGE logical name, 2–12
FORMS$TEXT_EDITOR logical name, 1–11
FORMS BACK_TRANSLATE command, 1–4
to 1–5, 5–6
Forms commands
See individual commands
FORMS CONVERT FMS command, 1–6 to
1–7
FORMS DEVELOP command, 1–8 to 1–12,
2–2
FORMS EDIT command, 1–13 to 1–15
FORMS EXTRACT APPEARANCES
command, 1–16 to 1–17, 6–1
FORMS EXTRACT OBJECT command,
1–18 to 1–20, 6–1
FORMS OBJECT command, 6–1
FORMS TEST APPEARANCES command,
1–21 to 1–22, 4–1
FORMS TRANSLATE command, 1–23 to
1–30, 5–1
Fully qualified names
See Qualified names
Function keys
CCPED
available for defining, A–6 to A–10
default, A–6
defining
DEFINE KEY command, 3–13,
B–22
UNDEFINE KEY command,
3–13, B–110
displaying definitions
SHOW KEY command, B–101
restrictions, 3–13
G
Graphic objects
creating
CCPED
CREATE MARKED OBJECT
command, 3–30, B–13
CREATE POINT command,
3–30, B–15
CREATE POLYLINE command,
3–30, B–16
CREATE RECTANGLE
command, 3–30, B–17
using marks (CCPED)
MARK command, 3–30, B–48
GROUP SELECTED OBJECTS command
(CCPED), 3–35, B–43
H
Help
CCPED, 3–8
HELP command, 3–8, B–44
for panels
specifying in FDE, 2–18
HELP command (CCPED), 3–8, B–44
Help messages
testing, 4–2
Help panels
choosing at panel level
in FDE, 2–16
creating
in FDE, 2–17
specifying in FDE, 2–11, 2–18
Hints
CCPED
DISABLE HINTS command, B–38
ENABLE HINTS command, 3–5,
B–41
RECALL MESSAGE command, 3–5,
B–80
I
Icons
creating
CREATE ICON command, 3–31,
B–12
deleting
DELETE NAMED command, 3–36,
B–26
restoring
UNDELETE ALL command, 3–36,
B–111
UNDELETE LAST command, 3–36,
B–112
selecting and deselecting, 3–36
DESELECT ALL OBJECTS
command, 3–38, B–30
DESELECT AT command, B–32
DESELECT LAST command, B–33
DESELECT MARKED AREA
command, B–34
Index–7
Icons
selecting and deselecting (cont’d)
DESELECT NAMED command,
3–37, 3–38, B–35
SELECT ALL OBJECTS command,
3–37
SELECT AREA command, 3–37
SELECT AT command, 3–37
SELECT MARKED AREA command,
3–37
SELECT NAMED command, 3–37,
B–90
use in menus, 3–31
IFDL (Independent Form Description
Language)
IFDL Translator, 5–1 to 5–4
invoking, 5–1
output, 5–2
DEC LSE diagnostics file, 5–4
form file, 5–2
listing file, 5–3
source files
back translating
from form file, 5–6
correcting translation errors, 2–9,
2–16, 2–20, 5–5
editing
at FDE layout level, 2–16
at FDE panel level, 2–20
from FDE form level, 2–7
guidelines for creating, 5–4
specifying
when invoking FDE, 2–2
specifying editor in FDE, 2–3
translating
to form file, 5–1
translation differences, 5–6
Independent Form Description Language
See IFDL
Information Window (CCPED), 3–6
INSERT FROM CLIPBOARD command
(CCPED), 3–39, B–45
Invoking
Back Translator Utility, 5–6
Index–8
Invoking (cont’d)
Character-Cell Panel Editor (CCPED),
3–2
DEC LSE, C–1
Extract Appearances Utility, 6–1
Extract Object Utility, 6–1
FDE, 2–2
IFDL Translator, 5–1
Test Utility, 4–1
J
Journal file
See Journaling
Journaling
Character-Cell Panel Editor (CCPED),
3–3
K
Key definitions
CCPED functions
See Function keys (CCPED)
FDE function keys, 2–5
Keypad (CCPED), 3–15
figure, A–1
SHOW KEYPAD command, B–102
summary, A–2 to A–6
Keypad mode
specifying in FDE, 2–19
L
Language-Sensitive Editor
See DEC LSE
Layouts
attributes
modifying in FDE, 2–13
specifying in FDE, 2–10
choosing, 2–10
color
specifying in FDE, 2–12
comments
specifying in FDE, 2–11
creating
Layouts
creating (cont’d)
FDE, 2–10
devices
specifying in FDE, 2–12
display size restriction (CCPED), 3–1
modifying in FDE, 2–13
naming in FDE, 2–10
natural language
determining in FDE, 2–12
size
specifying in FDE, 2–11
terminal width
specifying in FDE, 2–12
types
specifying in FDE, 2–10
Leaving
See Exiting
Line width
attributes
See Attributes
Line Width submenu (CCPED), 3–23, 3–24
Listing file (IFDL Translator), 5–3
LIST PANELS command (CCPED), 3–6,
3–19, B–46
LIST VIEWPORTS command (CCPED),
3–6, 3–18, B–47
Literals
text
See Text objects
M
MARK command (CCPED), 3–30, B–48
Marks (CCPED)
CREATE MARKED OBJECT command,
3–30, B–13
MARK command, 3–30, B–48
UNMARK command, B–116
Menus
CCPED
creating icon-based menu panels,
3–31
using, 3–6
FDE
Menus
FDE (cont’d)
function keys for menu choices, 2–5
Message panels
CCPED, 3–5
viewport size for
overriding in FDE, 2–11
Messages
See also Error messages
operator
See Hints
Modify Display Attribute Menu (CCPED)
Character Set, 3–28
Font Size, 3–23
Line Width, 3–24
Text Path, 3–29
Video Attributes, 3–20
MODIFY FIELD command (CCPED), 3–34,
3–35, B–49
Modify Field Description menu (CCPED),
3–35
Modify Form menu choice (FDE), 2–7
MODIFY GROUP command (CCPED), 3–35,
B–51
Modify Layout menu choice (FDE), 2–13
MODIFY PANEL display-attribute COLOR
command (CCPED), 3–21, B–52
Modify Panel menu choice (FDE), 2–20
MODIFY PANEL TERMINAL WIDTH
command (CCPED), 3–19, B–54
MODIFY PANEL VIEWPORT command
(CCPED), 3–19, B–55
MODIFY SELECTED display-attribute
COLOR command (CCPED), 3–21, B–56
MODIFY SELECTED OBJECTS
CHARACTER SET command (CCPED),
3–28, B–57
MODIFY SELECTED OBJECTS FONT SIZE
command (CCPED), 3–22, B–59
MODIFY SELECTED OBJECTS LINE
WIDTH command (CCPED), 3–24, B–61
MODIFY SELECTED OBJECTS TEXT
PATH command (CCPED), 3–29, B–63
Index–9
MODIFY SELECTED OBJECTS VIDEO
command (CCPED), 3–20, B–64
MODIFY VIEWPORT display-attribute
COLOR command (CCPED), 3–21, B–66
MODIFY VIEWPORT TERMINAL WIDTH
command (CCPED), 3–18, B–68
MOVE CURRENT VIEWPORT command
(CCPED), 3–18, B–69
MOVE SELECTED OBJECTS command
(CCPED), 3–38, B–70
MOVE VIEWPORT command (CCPED),
3–18, B–72
N
Navigation
panel field order
SET ORIGIN MODE command,
B–97
O
Object modules
producing using FDE, 2–7
with vectors, 2–7
Objects
centering
CCPED
CENTER SELECTED OBJECTS
command, B–2
changing attributes
CCPED
MODIFY SELECTED displayattribute COLOR command,
B–56
MODIFY SELECTED OBJECTS
CHARACTER SET command,
3–28, B–57
MODIFY SELECTED OBJECTS
FONT SIZE command, 3–22,
B–59
MODIFY SELECTED OBJECTS
LINE WIDTH command,
3–24, B–61
Index–10
Objects
changing attributes
CCPED (cont’d)
MODIFY SELECTED OBJECTS
TEXT PATH command,
3–29, B–63
MODIFY SELECTED OBJECTS
VIDEO command, 3–20,
B–64
SET CHARACTER SET
command, 3–27, B–91
SET display-attribute COLOR
command, B–93
SET FONT SIZE command,
3–21, B–95
SET LINE WIDTH command,
3–23, B–96
SET TEXT PATH command,
3–28, B–98
SET VIDEO command, 3–19,
B–99
clipboard operations
CCPED
COPY FROM CLIPBOARD
command, 3–39, B–5
COPY SELECTED OBJECTS
TO CLIPBOARD command,
3–39, B–6
INSERT FROM CLIPBOARD
command, 3–39, B–45
REMOVE SELECTED OBJECTS
TO CLIPBOARD command,
3–39, B–82
compound
copying
CCPED, 3–39
selecting and deselecting
CCPED, 3–37
copying
See Clipboard
creating
CCPED, 3–19, 3–30
creating and editing text
See Text objects
deleting
Objects
deleting (cont’d)
CCPED
DELETE NAMED command,
3–36, B–26
DELETE SELECTED OBJECTS
command, 3–36, B–28
moving
See Clipboard
CCPED
MOVE SELECTED OBJECTS
command, 3–38, B–70
reordering
CCPED, 3–40
ORDER SELECTED OBJECTS
command, B–73
restoring
CCPED
UNDELETE ALL command,
3–36, B–111
UNDELETE LAST command,
3–36, B–112
selecting and deselecting
CCPED, 3–36 to 3–38
DESELECT ALL OBJECTS
command, 3–37, 3–38, B–30
DESELECT AREA command,
3–37, B–31
DESELECT AT command, 3–37,
B–32
DESELECT LAST command,
3–37, B–33
DESELECT MARKED AREA
command, 3–37, B–34
DESELECT NAMED command,
3–37, 3–38, B–35
SELECT ALL OBJECTS
command, 3–37, B–86
SELECT AREA command, 3–37,
B–87
SELECT AT command, 3–37,
B–88
SELECT MARKED AREA
command, 3–37, B–89
Objects
selecting and deselecting
CCPED (cont’d)
SELECT NAMED command,
3–37, B–90
Object vectors, 2–7
Operands
using in CCPED expressions, 3–12
Operators
using in CCPED expressions, 3–12
Oracle CDD/Repository software
pieces tracking, C–4
from DEC LSE, C–4
records
extracted during translation, 5–6
ORDER SELECTED OBJECTS command
(CCPED), 3–40, B–73
Output options
FDE, 2–6
P
Panel Editor menu choice (FDE), 2–20
Panel editors
See CCPED
Panel fields
creating and deleting
CCPED
CREATE FIELD command,
3–32, B–7
DELETE NAMED command,
3–36, B–26
matching form data items
CCPED, 3–34
navigation order
CCPED
SET ORIGIN MODE command,
B–97
pictures and descriptions
CCPED
CREATE FIELD command, B–7
MODIFY FIELD command,
3–35, B–49
restoring
CCPED
Index–11
Panel fields
restoring
CCPED (cont’d)
UNDELETE ALL command,
3–36, B–111
UNDELETE LAST command,
3–36, B–112
selecting and deselecting
CCPED, 3–36
DESELECT ALL OBJECTS
command, B–30
DESELECT AT command, B–32
DESELECT LAST command,
B–33
DESELECT MARKED AREA
command, B–34
DESELECT NAMED command,
3–37, B–35
SELECT NAMED command,
B–90
Panel groups
adding and removing literals
CCPED, 3–35
GROUP SELECTED OBJECTS
command, B–43
UNGROUP SELECTED
OBJECTS command, 3–35,
B–115
controlling scrolling
CCPED
CREATE GROUP command,
B–10
MODIFY GROUP command,
3–35, B–51
creating and deleting
CCPED
CREATE GROUP command,
3–35, B–9
DELETE NAMED command,
B–26
horizontal and vertical display
CCPED
MODIFY GROUP command,
3–35, B–51
restoring
CCPED
Index–12
Panel groups
restoring
CCPED (cont’d)
UNDELETE ALL command,
3–36, B–111
UNDELETE LAST command,
3–36, B–112
selecting and deselecting
CCPED, 3–36
DESELECT ALL OBJECTS
command, 3–38, B–30
DESELECT AT command, B–32
DESELECT LAST command,
B–33
DESELECT MARKED AREA
command, B–34
DESELECT NAMED command,
3–37, 3–38, B–35
SELECT ALL OBJECTS
command, 3–37
SELECT AREA command, 3–37
SELECT AT command, 3–37
SELECT MARKED AREA
command, 3–37
SELECT NAMED command,
3–37, B–90
Panel images
extracting, 2–7
Panel objects
modifying color
CCPED
MODIFY SELECTED displayattribute COLOR command,
3–21, B–56
setting color
CCPED
SET display-attribute COLOR
command, 3–21, B–93
Panels
associated viewport
CCPED
MODIFY PANEL VIEWPORT
command, B–55
SHOW PANEL VIEWPORT
command, B–103
Panels (cont’d)
associating viewports with
in FDE, 2–17
attributes
modifying in FDE, 2–20
specifying in FDE, 2–17
checking appearance
CCPED
TEST command, 3–41, B–108
choosing
CCPED
CHOOSE command, 3–19, B–3
in FDE, 2–16
color
specifying in FDE, 2–19
comments
specifying in FDE, 2–17
creating
in FDE, 2–17
creating and deleting
CCPED
CREATE PANEL command,
3–18, B–14
DELETE PANEL command,
3–18, B–27
creating borders around
CCPED, 3–14
display width
CCPED
MODIFY PANEL TERMINAL
WIDTH command, B–54
extracting
FDE, 2–7
help
specifying in FDE, 2–18
keypad mode
specifying in FDE, 2–19
listing
CCPED
LIST PANELS command, 3–6,
3–19, B–46
modifying color
CCPED, 3–21
Panels
modifying color
CCPED (cont’d)
MODIFY PANEL displayattribute COLOR command,
3–21, B–52
MODIFY VIEWPORT displayattribute COLOR command,
3–21, B–66
modifying in FDE, 2–20
naming
in FDE, 2–17
removing after exit
in FDE, 2–18
restoring
CCPED
UNDELETE ALL command,
3–18, B–111
UNDELETE LAST command,
3–18, B–112
UNDELETE PANEL command,
3–18, B–113
terminal width
specifying in FDE, 2–19
type
specifying in FDE, 2–17
Picture fields
modifying
CCPED
MODIFY FIELD command,
3–35, B–49
specifying
CCPED
CREATE FIELD command, B–7
Placeholders (DEC LSE), C–2
POSITION HORIZONTAL command
(CCPED), 3–17, B–74
Positioning cursor
See Cursor positioning
POSITION NEXT command (CCPED), 3–17,
B–75
POSITION PREVIOUS command (CCPED),
3–17, B–76
Index–13
POSITION TO command (CCPED), 3–17,
B–77
POSITION VERTICAL command (CCPED),
3–17, B–78
Predefined symbols (CCPED), 3–12
Printing
panels
using the Extract Appearances
Utility, 2–7
Q
Qualified names
CCPED commands, 3–10
QUIT command (CCPED), 3–2, B–79
R
RECALL MESSAGE command (CCPED),
3–5, 3–6, B–80
Recovering
See Journaling, Checkpointing
References
SHOW REFERENCES command, 3–6,
B–105
REFRESH command (CCPED), B–81
REMOVE SELECTED OBJECTS TO
CLIPBOARD command (CCPED), 3–39,
B–82
Renaming a form
FDE, 2–7
Repeat Key function (CCPED), 3–17
RESIZE CURRENT VIEWPORT command
(CCPED), 3–18, B–83
RESIZE VIEWPORT command (CCPED),
3–18, B–84
Responses
uses in form testing, 2–15
REVERSE VIDEO attribute, 3–19
ROTATE CLIPBOARD command (CCPED),
3–39, B–85
Index–14
S
Sample applications, 3–2
Screen display (CCPED), 3–3 to 3–8
command line, 3–5
current panel, 3–4
help windows, 3–8
Information Window, 3–6
menus, 3–6
message panel, 3–5
refreshing
REFRESH command, B–81
status line, 3–5
viewport boundary markers, 3–5
Scrolling
panel groups
CCPED
CREATE GROUP command,
B–10
MODIFY GROUP command,
3–35, B–51
SELECT ALL OBJECTS command (CCPED),
3–36, 3–37, B–86
SELECT AREA command (CCPED), 3–36,
3–37, B–87
SELECT AT command (CCPED), 3–36,
3–37, B–88
Selecting objects
See Objects
Selection list, 3–37
Select key
CCPED, 3–36
SELECT MARKED AREA command
(CCPED), 3–36, 3–37, B–89
SELECT NAMED command (CCPED),
3–36, 3–37, B–90
SET CHARACTER SET command (CCPED),
3–27, B–91
SET display-attribute COLOR command
(CCPED), B–93
Set Display Attribute Menu (CCPED)
Character Set, 3–27
Font Size, 3–21
Line Width, 3–23
Set Display Attribute Menu (CCPED) (cont’d)
Text Path, 3–28
Video Attributes, 3–19
SET ENTRY MODE command (CCPED),
B–94
SET FONT SIZE command (CCPED), 3–21,
B–95
SET LINE WIDTH command (CCPED),
3–23, B–96
SET ORIGIN MODE command (CCPED),
B–97
SET SELECTED display-attribute COLOR
command (CCPED), 3–21
SET TEXT PATH command (CCPED), 3–28,
B–98
SET VIDEO command (CCPED), 3–19,
B–99
SHOW KEY command (CCPED), B–101
SHOW KEYPAD command (CCPED), 3–15,
B–102
SHOW PANEL VIEWPORT command
(CCPED), 3–19, B–103
SHOW POSITION command (CCPED),
3–17, B–104
SHOW REFERENCES command (CCPED),
3–6, B–105
SHOW SYMBOL command (CCPED),
B–106
SHOW VERSION command (CCPED),
B–107
SINGLE HIGH attribute, 3–21, 3–23
Status line (CCPED), 3–5
Symbols
color
DEFINE COLOR command, B–20
in CCPED expressions
DEFINE SYMBOL command, 3–12,
B–24
predefined, 3–12
SHOW SYMBOL command, B–106
T
Terminal width
for layout
specifying in FDE, 2–12
MODIFY PANEL TERMINAL WIDTH
command, B–54
MODIFY VIEWPORT TERMINAL
WIDTH command, B–68
specifying
for panel, 2–19
TEST command (CCPED), 3–41, B–108
Testing
forms in FDE, 2–14
Test menu choice (FDE)
Test All, 2–14
Test Enable, 2–14
Test Panel, 2–14
Test Utility
enabling a form
in FDE, 2–14
invoking, 4–1
CCPED
TEST command, 3–41, B–108
in FDE, 2–13
purpose, 2–13
testing panels
in FDE, 2–14
using
in FDE, 2–14
Text editors
invoking from FDE, 2–7
specifying for FDE, 2–3
Text entry mode (CCPED)
SET ENTRY MODE command, B–94
TOGGLE ENTRY MODE command,
3–30, B–109
Text literals
See Text objects
Text objects
creating
CCPED
CREATE TEXT command, 3–30
editing
Index–15
Text objects
editing (cont’d)
CCPED, 3–30
DELETE CHARACTER
command, B–25
Text path
attributes
See Attributes
Text Path submenu (CCPED), 3–28, 3–29
Text strings
See Text objects
TOGGLE ENTRY MODE command
(CCPED), 3–30, B–109
Tokens (DEC LSE), C–2
Translation errors
correcting, 5–5
FDE, 2–9, 2–20
in FDE, 2–16
U
UNDEFINE KEY command (CCPED), 3–13,
B–110
UNDELETE ALL command (CCPED), 3–18,
B–111
UNDELETE ALL OBJECTS command
(CCPED), 3–36
UNDELETE LAST command (CCPED),
3–18, B–112
UNDELETE LAST OBJECT command
(CCPED), 3–36
UNDELETE PANEL command (CCPED),
3–18, B–113
UNDELETE VIEWPORT (CCPED), 3–18
UNDELETE VIEWPORT command
(CCPED), B–114
UNDERLINED attribute, 3–19
UNGROUP SELECTED OBJECTS command
(CCPED), 3–35, B–115
UNMARK command (CCPED), B–116
Index–16
V
Vectors, 2–7
Video attributes
See Attributes
Video Attributes submenu (CCPED), 3–19,
3–20
VIEW CLIPBOARD command (CCPED),
3–39, B–117
Viewports
associating with panels
CCPED
MODIFY PANEL VIEWPORT
command, B–55
in FDE, 2–17
boundary markers
CCPED, 3–5
color
CCPED
MODIFY VIEWPORT displayattribute COLOR command,
3–21, B–66
creating
in FDE, 2–17
creating and deleting
CCPED
CREATE VIEWPORT command,
B–19
DELETE VIEWPORT command,
3–18, B–29
listing
CCPED
LIST VIEWPORTS command,
3–6, 3–18, B–47
moving
CCPED
MOVE CURRENT VIEWPORT
command, B–69
MOVE VIEWPORT command,
B–72
name
CCPED
SHOW PANEL VIEWPORT
command, B–103
Viewports (cont’d)
resizing
CCPED
RESIZE CURRENT VIEWPORT
command, B–83
RESIZE VIEWPORT command,
B–84
restoring
CCPED
UNDELETE ALL command,
3–18, B–111
UNDELETE LAST command,
3–18, B–112
UNDELETE VIEWPORT
command, 3–18, B–114
size
specifying in FDE, 2–18
terminal width
CCPED
MODIFY VIEWPORT
TERMINAL WIDTH
command, B–68
type
specifying in FDE, 2–18
Index–17
Download PDF
Similar pages