OpenEdge Deployment: Managing ABL Applications

326 Pages·2013·1.52 MB·English

by  Progress Software Corp.

PROGRESS
®
OPENEDGE
®
OpenEdge Deployment:
®
Managing ABL Applications
© 2013 Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.
These materials and all Progress® software products are copyrighted and all rights are reserved by Progress Software Corporation. The
information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors
that may appear therein. The references in these materials to specific platforms supported are subject to change.
Apama, Business Empowerment, Business Making Progress, Corticon, Corticon (and design), DataDirect (and design), DataDirect Connect,
DataDirect Connect64, DataDirect XML Converters, DataDirect XQuery, Empowerment Center, Fathom, Making Software Work Together,
OpenEdge, Powered by Progress, PowerTier, Progress, Progress Control Tower, Progress Dynamics, Progress Business Empowerment,
Progress Empowerment Center, Progress Empowerment Program, Progress OpenEdge, Progress Profiles, Progress Results, Progress
RPM, Progress Software Business Making Progress, Progress Software Developers Network, ProVision, PS Select, RulesCloud,
RulesWorld, SequeLink, SpeedScript, Stylus Studio, Technical Empowerment, WebSpeed, Xcalia (and design), and Your Software, Our
Technology–Experience the Connection are registered trademarks of Progress Software Corporation or one of its affiliates or subsidiaries in
the U.S. and/or other countries. AccelEvent, Apama Dashboard Studio, Apama Event Manager, Apama Event Modeler, Apama Event Store,
Apama Risk Firewall, AppsAlive, AppServer, BusinessEdge, Cache-Forward, DataDirect Cloud, DataDirect Spy, DataDirect SupportLink,
Future Proof, High Performance Integration, OpenAccess, ProDataSet, Progress Arcade, Progress ESP Event Manager, Progress ESP Event
Modeler, Progress Event Engine, Progress RFID, Progress Responsive Process Management, Progress Software, PSE Pro, SectorAlliance,
SeeThinkAct, SmartBrowser, SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder,
SmartFrame, SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, WebClient, and Who Makes Progress are trademarks or
service marks of Progress Software Corporation and/or its subsidiaries or affiliates in the U.S. and other countries. Java is a registered
trademark of Oracle and/or its affiliates. Any other marks contained herein may be trademarks of their respective owners.
Third party acknowledgements — See the table of contents for the "Third Party Acknowledgements" appendix.
July 2013
Last updated with new content: Release 11.3.0 Product Code: 4496; R11.3.0
For the latest documentation updates see OpenEdge Product Documentation on PSDN (http://communities.progress.com/pcom/
docs/DOC-16074).
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Part 1 ABL and R-code Deployment and Management
1. ABL Client Deployment Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Client deployment process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Client deployment and administration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Additional deployment documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2. Managing Client Access to Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Connecting clients to databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Logical database names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Connection modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Connection parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Connection techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Connecting to a non-OpenEdge database . . . . . . . . . . . . . . . . . . . . . . . . 37
Connection denials when the user count is exceeded . . . . . . . . . . . . . . . 38
Reducing connection times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Starting clients without connecting to a database . . . . . . . . . . . . . . . . . . . 40
Selecting a working database for client use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Selecting a database with the Data Dictionary . . . . . . . . . . . . . . . . . . . . . 41
Selecting a database with the Data Administration tool . . . . . . . . . . . . . . 41
Disconnecting databases for clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Using the Data Dictionary to disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Using the Data Administration tool to disconnect. . . . . . . . . . . . . . . . . . . . 43
3. Maintaining Application Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Database table- and field-level security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Specifying run-time permissions checking. . . . . . . . . . . . . . . . . . . . . . . . . 48
Setting table and field permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Determining the privileges of the blank user ID . . . . . . . . . . . . . . . . . . . . . 53
OpenEdge® Deployment: Managing ABL Applications 3
Contents
Compile-time security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Run-time security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Application support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
OpenEdge support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Operating system security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Designating a security administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
ABL security administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Auditing administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Transparent data encryption administration . . . . . . . . . . . . . . . . . . . . . . . . 60
4. Maintaining User Environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Maintaining the Windows user environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Using the INI2REG utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Searching progress.ini and the Registry at startup. . . . . . . . . . . . . . . . . . . 65
Maintaining the progress.ini file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Windows icons for running OpenEdge . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Starting the OpenEdge client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Modifying client icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Windows manifest file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Environments with OpenEdge GUI for .NET applications. . . . . . . . . . . . . . 95
Maintaining the UNIX user environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Maintaining the buildenv script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Maintaining the PROTERMCAP file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
PROTERMCAP syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Terminal name entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Terminal capabilities entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Vermont Views key function capabilities. . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Pointer to key functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Specifying colors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Specifying the cursor motion capability. . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Specifying keyboard mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Extended character support entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Creating a PROTERMCAP entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Testing terminal entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Setting up the terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Setting the terminal type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Setting the PROTERMCAP environment variable . . . . . . . . . . . . . . . . . . . 122
Reverting to the default PROTERMCAP file. . . . . . . . . . . . . . . . . . . . . . . . 122
Copying an existing terminal entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
5. Managing Client Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Procedure loading and execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Using procedure libraries to improve r-code performance . . . . . . . . . . . . . 126
R-code execution environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Monitoring r-code activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Distributing OpenEdge files on a network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Distributing OpenEdge system files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Distributing application files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Distributing temporary files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Distributing log files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Temporary file I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Sorting I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
6. Managing Procedure Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Library overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Loading r-code from a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
4 OpenEdge® Deployment: Managing ABL Applications
Contents
Loading r-code from a standard library . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Loading r-code from a memory-mapped library . . . . . . . . . . . . . . . . . . . . 143
Setting up a library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Running members from a library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Using an absolute pathname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Using a relative pathname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Related functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Libraries and PROPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Memory and network considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Using the PROLIB utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Using wild cards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Creating a standard library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Generating a memory-mapped library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Adding files to a standard library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Replacing files in a standard library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Deleting files from a standard library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Listing the contents of a library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Extracting files from a standard library. . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Extracting files to your current directory. . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Compressing a standard library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
PROLIB command examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Code page compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
7. Managing Print Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Printing in OpenEdge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
OUTPUT TO statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
OUTPUT THROUGH statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Printing in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Setting up output-routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Using a startup procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Using an output-routing table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Using interactive output-routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Printing on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Configuring a printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Creating a printer-control table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Part 2 Deployment Considerations
8. Choosing a Code Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Unencrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Development product requirements for unencrypted source. . . . . . . . . . . 176
User product requirements for unencrypted source. . . . . . . . . . . . . . . . . . 176
Advantages of unencrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Possible drawbacks of unencrypted source. . . . . . . . . . . . . . . . . . . . . . . . 177
Encrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Development product requirements for encrypted source. . . . . . . . . . . . . 178
User product requirements for encrypted source. . . . . . . . . . . . . . . . . . . . 178
Advantages of encrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Possible drawbacks of encrypted source. . . . . . . . . . . . . . . . . . . . . . . . . . 179
R-code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Developer product requirements and r-code portability . . . . . . . . . . . . . . 180
User product requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Advantages of r-code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Possible drawbacks of r-code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
OpenEdge® Deployment: Managing ABL Applications 5
Contents
9. Initial Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Deploying database structures and application files . . . . . . . . . . . . . . . . . . . . . . . . . 184
Unencrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Encrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
CRC r-code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Time-stamp r-code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Deploying OpenEdge GUI for .NET applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Installing .NET Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Creating an assemblies directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Deploying application source code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
10. Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Deploying upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Modifying the application procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Unencrypted source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Encrypted source files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Time-stamp-based r-code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
CRC-based r-code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Modifying the application database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Upgrading with updated .df and encrypted source . . . . . . . . . . . . . . . . . . 203
Upgrading with updated .df and CRC-based r-code . . . . . . . . . . . . . . . . . 206
Upgrading with time-stamp-based r-code files . . . . . . . . . . . . . . . . . . . . . . 207
OpenEdge product upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
11. Deployment Topics and Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Encrypting source code procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
XCODE utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Preparing to use XCODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Compilation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Using the BUNDLE utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
The bundle.c program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
The unbundle.c program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Examples using BUNDLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Dumping and loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MKDUMP utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Using your dump/reload facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Restricting database access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Part 3 Appendices
A. Building OpenEdge Executables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Building executables on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Preparing the UNIX software environment. . . . . . . . . . . . . . . . . . . . . . . . . 227
Building a customized executable on UNIX . . . . . . . . . . . . . . . . . . . . . . . . 227
Using the customized UNIX executable . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Building and running the HLC examples for UNIX . . . . . . . . . . . . . . . . . . . 230
Building executables in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Preparing the Windows software environment. . . . . . . . . . . . . . . . . . . . . . 231
Building a customized executable in Windows . . . . . . . . . . . . . . . . . . . . . 232
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
B. R-code Features and Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
R-code structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
6 OpenEdge® Deployment: Managing ABL Applications
Contents
Factors that affect r-code size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
R-code file segment layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Procedure libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Procedure Libraries and PROPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
R-code execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Standard r-code execution environment . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Memory-mapped r-code execution environment . . . . . . . . . . . . . . . . . . . . 244
R-code directory management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
R-code execution environment statistics . . . . . . . . . . . . . . . . . . . . . . . . . 247
R-code portability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Display architectures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Database types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
R-code version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
R-code portability and operating system-specific statements . . . . . . . . . . 251
Byte order of integers in R-code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Examples of portable and nonportable r-code. . . . . . . . . . . . . . . . . . . . . . 251
Code page compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Database CRCs and time stamps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Time stamp validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
CRC validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
CRC calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
CRC versus time stamp validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
R-code CRCs and procedure integrity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Assigning CRCs to schema triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Validating CRCs for schema triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
RCODE–INFO handle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
C. OpenEdge Application Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Input/output limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Sorting limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Name limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Compiler limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
D. Deployment Utilities and Scripts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Utilities summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
DBRSTRCT utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
MKDUMP utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
XCODE utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
_tlr Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
E. Third Party Acknowledgements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
OpenEdge® Deployment: Managing ABL Applications 7
Contents
Tables
Table 1: Deployment information in OpenEdge manuals . . . . . . . . . . . . . . . . . . . . . . . 26
Table 2: Table and field security permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Table 3: Basic expressions for table and field permissions . . . . . . . . . . . . . . . . . . . . . 51
Table 4: Table and field permissions using fully qualified user IDs . . . . . . . . . . . . . . . 52
Table 5: Image button border drawing behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Table 6: User-definable key bindings in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Table 7: Static key bindings in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Table 8: User-definable key bindings in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Table 9: Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Table 10: Windows-installed icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Table 11: Syntax for specifying string values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Table 12: Alphabetical listing of capability mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . 105
Table 13: Data types and operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Table 14: Vermont Views key function mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Table 15: Syntax for specifying cursor motion string value (value) . . . . . . . . . . . . . . . . 112
Table 16: OpenEdge PROTERMCAP key functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Table 17: Setting the terminal type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Table 18: Setting the PROTERMCAP environment variable . . . . . . . . . . . . . . . . . . . . . 122
Table 19: Reverting to the default PROTERMCAP file . . . . . . . . . . . . . . . . . . . . . . . . . 122
Table 20: Startup parameters for tuning the execution environment . . . . . . . . . . . . . . . 128
Table 21: Startup parameters for tuning procedure libraries . . . . . . . . . . . . . . . . . . . . . 129
Table 22: Startup parameters for monitoring r-code activity . . . . . . . . . . . . . . . . . . . . . 129
Table 23: Temporary client session files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Table 24: Startup parameters for tuning sort performance . . . . . . . . . . . . . . . . . . . . . . 137
Table 25: PROLIB utility parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Table 26: List (-list) parameter library information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Table 27: List (-list) parameter file information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Table 28: Standard printer control sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Table 29: R-code segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Table 30: Metaschema fields in CRC calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Table 31: Input/output limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Table 32: Sorting limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Table 33: Name limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Table 34: Compiler limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Table 35: Deployment utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
8 OpenEdge® Deployment: Managing ABL Applications
Contents
Figures
Figure 1: Connection denial when the user count is exceeded . . . . . . . . . . . . . . . . . . 38
Figure 2: Windows environment information search path . . . . . . . . . . . . . . . . . . . . . . 66
Figure 3: Sample OpenEdge initialization file in Windows . . . . . . . . . . . . . . . . . . . . . 68
Figure 4: Sample buildenv script on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Figure 5: Parts of a PROTERMCAP entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Figure 6: Sample statistics (-y) output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Figure 7: Sample segment statistics (-yd) output . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Figure 8: Loading r-code from a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Figure 9: Loading r-code from a standard library . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Figure 10: Loading r-code from a memory-mapped library . . . . . . . . . . . . . . . . . . . . . . 143
Figure 11: Sample application startup procedure (UNIX) . . . . . . . . . . . . . . . . . . . . . . . 166
Figure 12: Sample application startup procedure (Windows) . . . . . . . . . . . . . . . . . . . . 167
Figure 13: Sample output-routing table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Figure 14: Sample printer-control table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Figure 15: Deploying database structures and application files . . . . . . . . . . . . . . . . . . 184
Figure 16: Deploying upgraded database structure and application procedures . . . . . 200
Figure 17: Output of mkdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Figure 18: R-code file segment layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Figure 19: Standard r-code execution environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Figure 20: Memory-mapped r-code execution environment . . . . . . . . . . . . . . . . . . . . . 245
Figure 21: OpenEdge client startup options for –yd . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Figure 22: Execution buffer map for –yd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Figure 23: Accessing the r-code swap file for –yd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Figure 24: Procedure segment information for –yd (Part 1) . . . . . . . . . . . . . . . . . . . . . 248
Figure 25: Procedure segment information for –yd (Part 2) . . . . . . . . . . . . . . . . . . . . . 249
Figure 26: Database Restriction Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
OpenEdge® Deployment: Managing ABL Applications 9
Contents
10 OpenEdge® Deployment: Managing ABL Applications