HP Software Product Description ___________________________________________________________________ PRODUCT NAME: HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 DESCRIPTION This document addresses HP DECforms Version 4.0 for OpenVMS Alpha Sys- tems and HP DECforms Version 4.0 for OpenVMS Industry Standard 64 (I64) for Integrity Servers. HP DECforms for OpenVMS (DECforms) is a software product for the de- velopment and deployment of forms-based user interfaces for interac- tive applications running on OpenVMS systems. DECforms is a complete User Interface Management System (UIMS), providing applications with not only the look and feel of a forms interface, but also a robust set of dialog management and validation functions to control the user in- terface at application execution time. DECforms offers application programmers a set of form development tools for creating forms-based user interfaces for the following end-user environments: o VT-based character-cell terminals o PostScript printers DECforms embodies the following fundamental principles: o True separation of form and function o Efficient distribution of forms processing o Ease of use o Flexibility of user interface control January 2006 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 o Programming language independence One of the most powerful principles reflected in the DECforms archi- tecture is complete separation of form and function. User interface processing is completely removed from the application program and to- tally isolated within the form itself. In DECforms, a form is not sim- ply a collection of fields and background text describing the form's appearance. A DECforms form includes not just elements related to ap- pearance, but also data and procedural elements that control the pro- cessing of the user's interaction with the form. The application pro- gram is only concerned with the processing of data, not with the gath- ering and display of data at the user interface. This makes applica- tion programs much simpler to develop and easier to maintain. Forms comprise one or more panels that can be of any width and height (for VTs, panels must be no larger than the size of the physical dis- play device). If the data required to satisfy an application program's request cannot be physically or aesthetically fit onto a single screen, multiple panels can be defined within a single form to contain all the necessary fields and background text. Thus, a form can be as large as needed. When panels are displayed on the screen, they are displayed in view- ports (windows) that can be located on any place on the screen. DEC- forms provides a complete windowing system to manage these viewports. The viewports are static-they cannot be moved by the user. DECforms automatically displays and removes viewports with their associated pan- els to gather and display all the data required by the application pro- gram. A form is described by the Independent Form Description Language (IFDL). The IFDL, although primarily declarational, includes procedural con- structs as well. Field level control, screen navigation, panel man- agement, and cross field and relational validations are among the many form processing activities that can be performed by the IFDL without the need to return to the application program. 2 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 DECforms allows a single application to support multiple types of users with interfaces tailored to their particular end-user environments, where those environments are differentiated by such factors as desk- top device and natural language. This tailoring is accomplished by uti- lizing another DECforms structure called a layout. Sets of panels tai- lored for a particular environment can be grouped together in a lay- out. A form can consist of multiple layouts. At run-time, DECforms chooses the one layout from within the form appropriate for the end-user en- vironment. Features The application program interacts with DECforms through a very sim- ple, six-call record-level interface. Either single or multiple records can be transferred in a single request. All field-level processing is performed by the DECforms Run-Time Sys- tem, not by the application program. The DECforms Run-Time System pro- vides a wide variety of form, panel, and field-level control and pro- cessing capabilities, including: o Multiline text fields o Simple arithmetic operations within the form o Scrolled regions with the following characteristics: - Vertical or horizontal scrolling - Containing one- or two-dimensional arrays - Partial or full-line scrolling - Multiple lines per scrolled entry o Conditionally protecting, highlighting, and concealing fields o Changing video attributes dynamically based on real-time events o Highlighting fields when the cursor is present o Color support on VT241 and VT340 terminals via mapping to video at- tributes 3 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 o Format validations: - Character type - Entry required - Minimum length - Full field - No data input o Content validations: - Range check - List check o Context validations: - Against a general expression - Cross-field validations o Calling a user-defined routine (procedural escape routine) to per- form more complex validations, including file lookups o Built-in flexible field navigation capabilities on VTs allowing the operator to move among fields in any manner desired o Timeouts on field entries on character-cell terminals o Toggling between insert/overstrike mode on character-cell termi- nals DECforms also provides an extremely flexible mechanism for defining functions and redefining keyboards to suit the operator environment. This includes support for multikey function definitions. DECforms supports most OpenVMS data types, which means that data type conversion does NOT have to be performed by the application program in most cases. DECforms can be used with HP DATATRIEVE to provide powerful, window- like forms interfaces for queries and reports on data stored in RMS, Oracle Rdb, and Oracle CODASYL DBMS files. 4 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 Internationalization Features DECforms includes numerous internationalization features, allowing ap- plications to support user interfaces in multilingual environments. These features include: o Multiple natural language layouts per form o International date formats o Numeric data formatting, including replacing decimal point with comma o Multiple character currency signs o Multiple character sets o Flexible positioning of fields and literals to allow for transla- tion o OpenVMS Message Files to allow for translation o Integrated support for Hebrew language form development and pro- cessing, including right-to-left text path on character-cell ter- minals Printing Support Through the use of the printing layout, DECforms provides the capa- bility for rendering high-quality, bitmap hardcopy forms for print- ing on PostScript printers. The printing layout contains the specification of a user interface that is output only and specifies its output device as a file, rather than a physical device. This file can serve as input to other DDIF-capable applications, for ultimate printing or inclusion in compound documents. Through the use of the printing layout, DECforms also supports the con- cept of "batch printing" in which applications can use DECforms for high-volume forms printing without the need for a physical display de- vice. Components Form Manager 5 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 The Form Manager is the interface between an application program and a display device. It is a run-time system that controls form display and operator input on terminals. The Form Manager provides six requests for communication between the form and the application. These requests (routines in the Form Manager) allow the application to enable the form for use, send data to the form, receive data from it (separately or in one call), disable the form at the end of a session, or asynchronously cancel a request. The Form Manager is included with the DECforms Development System and is also offered separately in the optional DECforms Run-Time System. The only DECforms component available in this latter option is the Form Manager. The Run-Time System allows the execution of applications us- ing DECforms on a machine other than the one used to develop the ap- plication. Form Development Environment (FDE) The FDE allows a form designer to create a form interactively. The FDE provides menus that help the designer step through various tasks of form creation and modification. The FDE is used with the VT-based Panel Editor to create the appearance of the form. The FDE also provides ac- cess to text editors, including the Language Sensitive Editor (LSE), part of HP DECset for OpenVMS Systems, to allow a designer to write statements in the Independent Form Description Language (IFDL) that describes a DECforms form. Independent Form Description Language (IFDL) The IFDL is a semi-procedural language that completely describes a DECforms form. It allows the form designer to create a form (noninteractively), specifying its appearance and functions. While the appearance of a form can be entirely created by the panel editors, procedural aspects of the form, such as specialized responses to function keys and special- ized data validation, must be specified directly with IFDL statements. An IFDL source file is a text file that can be created or modified with any text editor. 6 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 LSE templates are available for the IFDL language to aid in the cre- ation and maintenance of IFDL source code. DECforms also supports the Compile and Review capabilities of the LSE. The IFDL also includes a COPY statement that provides for the copy- ing of record and field definitions from the Oracle CDD/Repository. DECforms supports Oracle CDD/Repository pieces tracking by deposit- ing information in the dictionary indicating that a particular form has used a certain record. DECforms can also use Oracle CDD/Repository records defined with the BASED ON attribute and those referenced through RDB$RELATIONS. IFDL Translator The IFDL translator compiles an IFDL source file into a binary form file. This form file is then ready for use with its application. Its appearance can be tested on a terminal screen or printed. The binary form file may be analyzed by other DECforms utilities, or edited in the FDE or the appropriate panel editor. Back Translator The Back Translator converts a binary form file into an IFDL source file. Essentially, it performs the reverse function of the IFDL Trans- lator. As a result, it provides a method of editing the IFDL source for a form created or modified by the FDE or panel editor. The IFDL source statements that the Back Translator produces also provide a com- plete textual description of the form. Panel Editors The VT-based Panel Editor allow the user to create graphic form el- ements in an interactive, "What You See Is What You Get" (WYSIWYG) fash- ion. The panel editors support the interactive creation of the visual elements of a form's panels: background text and graphics, and the lo- cations, sizes and attributes of fields. Extract Utility 7 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 The Extract Utility performs three functions: o Produces a printable representation of a form's panels from a form file. o Creates object modules containing a form. These object modules can then be linked in an executable image with a program as a memory- resident form for use by the same program in a single session or in multiple sessions. The modules can also be linked in shareable images for use by multiple sessions from multiple processes. o Produces an object module that contains pointers, or vectors, to procedural escape routines named in the form file. Escape routines are calls from the form to user-supplied subroutines created to do additional processing outside the form. Test Utility The Test Utility allows certain aspects of the form to be tested sep- arately from its application program. It allows a form designer to check the appearance of a form's panels without having to first write a pro- gram. Sample Applications and Demonstration Forms The sample applications show how a form and an application program can interact. One of the samples includes a simple form with a few pan- els and a simple application program that makes requests of the form through the Form Manager. This introductory sample application is avail- able only in FORTRAN and C. The more complex sample application includes a form with many panels and many responses to various events, as well as an application pro- gram that makes several requests of the form. This application is avail- able in Ada, BASIC, C, COBOL, FORTRAN, Pascal, and PL/I. In addition to the sample applications, the DECforms development kit contains a package of demonstration forms, their sources, and a demon- stration guide illustrating a number of key features of DECforms. FMS Converter 8 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 The FMS Converter is a migration tool that converts forms or form li- braries created with HP FMS for OpenVMS (Forms Management System) into a DECforms IFDL source file. This process converts the appearance of the FMS forms into a similar appearance described by the DECforms IFDL. The converter does NOT convert the application program or the User Ac- tion Routines (UAR) associated with the FMS forms. The FMS Converter works with forms created with FMS V2.0 or later. The FMS Converter is available only on Alpha. Developing Forms for IBM 3270 Terminals A special version of DECforms V1.4, shipped exclusively as part of the HP SNA 3270 Application Services software, allows remote SNA-networked IBM 3270 terminal and PC users to access forms-oriented VAX and Alpha applications. This special version of DECforms provides users with ad- ditional features in the OpenVMS VAX development tools to develop and maintain forms for display on 3270 class devices and Run-Time Systems on both OpenVMS VAX and OpenVMS Alpha that can generate and interpret a 3270 data stream. This version of DECforms is not available as a stan- dalone product and can only be used in conjunction with HP SNA 3270 Application Services software and the HP SNA Domain Gateway. The me- dia and documentation for this version of DECforms are available as part of the HP SNA 3270 Application Services product; however, a stan- dard DECforms development license is required to use this version. Re- fer to the HP SNA 3270 Application Services Software Product Descrip- tion (38.70.xx) for more details. Documentation The DECforms documentation set is available with the DECforms devel- opment option and is available separately. It is not available with the DECforms run-time only option. The documentation set consists of: o Guide to Developing an Application o Guide to Commands and Utilities o Programmer's Reference Manual o IFDL Reference Manual o Style Guide for Character-Cell Devices 9 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 o Guide to Converting FMS Applications o Installation Guide for OpenVMS Systems o Release Notes HARDWARE REQUIREMENTS Hardware Configurations DECforms for OpenVMS is supported on all hardware configurations ref- erenced in the OpenVMS Operating System for Alpha and I64, Software Product Description (SPD 25.01.xx). Terminals Supported ________1__________________________________________________________ Terminal__________________________Notes____________________________ VT100, VT100 w/AVO VT101, VT102, VT103, VT125 VT131 2 VT220, VT240, VT241 VT320, VT330, VT340 3 VT420 4 VT510, VT520, VT525 4 VT1200, VT1300 VXT2000 IBM_3270_compatible_______________5________________________________ 1. DECforms also supports the Hebrew versions of the VT100, VT200, and VT300 series terminals. 2. The VT131 is supported in VT102 mode only. 3. DECforms does not support the use of the 25th status line nor the use of the locator device on VT300-series terminals. 10 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 4. DECforms panels of up to 72 lines may be defined for VT420 and VT500 series terminals. These terminals can display 24, 36, or 48 lines on a single screen. Panels consisting of a number of lines greater than the screen size can be panned under local hardware control by the terminal. DECforms does not support access to the F1-F5 func- tion keys or to the ALTERNATE key. The COMPOSE key is supported when configured for LOCAL COMPOSE. 5. DECforms supports display of forms on directly connected IBM 3270- class terminals only when those terminals are connected to the CXM04 3270 Terminal Option Card of a DECserver 550. This option card makes the IBM 3270-compatible device appear as a VT220 to the applica- tion. Terminal Emulators Terminal emulators on workstations and personal computers are supported only to the extent that the emulator conforms to the environment it is emulating. Printers DECforms printing layouts can be converted to PostScript files that can then be printed on any device compatible for printing PostScript files. DECforms character-cell panels and forms can be printed on any printer. Video attributes are not printed and lines are drawn using the char- acters "-", "+", " " rather than the line-drawing character set. Disk Space Requirements (Block Cluster Size = 1) These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. 11 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 ___________________________________________________________________ DECforms_Kit_______Alpha________I64________________________________ Development 41,000 80,000 blocks Installation blocks 20.5 MB 40 MB Development 40,000 75,000 blocks Permanent blocks 20.0 MB 37.5 MB Run-Time In- 5,400 25,000 blocks stallation blocks 2.7 MB 12.5 MB Run-Time Perma- 4,900 23,000 blocks nent blocks ___________________2.5_MB_______11.5_MB____________________________ SOFTWARE REQUIREMENTS For Systems Using Terminals o HP OpenVMS Operating System Alpha, V7.3-2 without support for Or- acle CDD/Repository and V8.2 with support for Oracle CDD/Repository o HP OpenVMS Operating System I64, V8.2 without support for Oracle CDD/Repository and V8.2-1 with support for Oracle CDD/Repository o HP C Compiler V7.1 and V7.2 for OpenVMS I64 OPTIONAL SOFTWARE o Oracle CDD/Repository for OpenVMS, V7.2 or later o HP DECset for OpenVMS Systems, Release 12.6 or later o Any programming language that conforms to the OpenVMS calling stan- dard. SOFTWARE LICENSING This software is furnished only under a license. For more information about HP's licensing terms and policies, contact your local HP office. LICENSE MANAGEMENT FACILITY (LMF) 12 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 DECforms for OpenVMS Alpha This layered product supports the OpenVMS License Management Facil- ity. License units for the Development System are allocated on an Capac- ity Basis by hardware tier or a Personal Use basis. Each Personal Use license allows one identified individual to use the layered product. License units for the Run-Time System are allocated on an Capacity Ba- sis by hardware tier or a Concurrent Use basis. Each Concurrent Use license allows any one individual at a time to use the layered prod- uct. Some number of concurrent use licenses must be purchased to sup- port the concurrent number of users. For more information on the License Management Facility, refer to the OpenVMS Operating System Software Product Description (SPD 25.01.xx) or the License Management Facility manual of the OpenVMS Operating Sys- tem documentation set. DECforms for OpenVMS I64 DECforms for OpenVMS I64 software product licenses are sold on a per- processor core license (PCL) basis.This layered product supports the OpenVMS License Management Facility of HP. DECforms products are PCL licensed with one license required for each active physical processor core in the system of hard partition. If ad- ditional processors are later added to the system of hard partition, each requires an additional PCL. For more information on the OpenVMS License Management Facility, re- fer to the OpenVMS Operating Software Product Description (SPD 25.01.xx and 82.35.xx) or documentation. CLUSTER ENVIRONMENT This layered product is fully supported when installed on any valid and licensed VMScluster configuration without restrictions. The Hard- ware Requirements section of this Software Product Description details any special hardware required by this product. 13 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 VMScluster configurations are fully described in the VMScluster Soft- ware Product Description (SPD 29.78.xx) and include CI, Ethernet and Mixed Interconnect configurations. DISTRIBUTION MEDIA DECforms for OpenVMS Alpha is available on the OpenVMS Alpha Software Product Library Package. The library package includes media and doc- umentation on CD-ROM. DECforms for OpenVMS I64 is available on the OpenVMS Layered Product Library. The library package includes media and documentation on CD- ROM. Updates for DECforms OpenVMS I64 are delivered through Software Up- date Services. The Layered Products Library is included in the orig- inal Operating Environment Media purchase, but is not separately or- derable. ORDERING INFORMATION ___________________________________________________________________ OpenVMS_Alpha________________Part_Number___________________________ Development License, QL-0J8A*-AA Unlimited Use Development License, QL-VCHAA-2B Personal Use Development Software QT-0J8A*-** Product Services Run-Time License, Unlim- QL-0J9A*-AA ited Use Run-Time License, Concur- QL-VNSAA-2B rent Use Run-Time Software Product QT-0J9A*-** Services 14 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 ___________________________________________________________________ OpenVMS_Alpha________________Part_Number___________________________ Media and Documentation QA-03XAA-H8 (OpenVMS Alpha Software Product Library) Hardcopy_Documentation_______QA-VCHAA-GZ___________________________ * Denotes variant fields. For additional information on available li- censes, services and media, refer to the appropriate price book. OpenVMS I64 Part Number o HP DECforms Development VMS I64 PCL LTU: BA356AC o HP DECforms Development VMS I64 Media: BA356AA* o HP DECforms Runtime VMS I64 PCL LTU: BA357AC o HP DECforms Runtime VMS I64 Media: BA356AA* o HP DECforms Documentation Kit: BA356MN * Include in any order where Software Updates Services are planned. SOFTWARE PRODUCT SERVICES A variety of service options are available from HP. For more infor- mation, contact your local HP office. GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. SOFTWARE WARRANTY This software is provided by HP with a 90 day conformance warranty in accordance with the HP warranty terms applicable to the license pur- chase. 15 HP DECforms for OpenVMS, Version 4.0 SPD 29.90.13 The above information is valid at time of release. Please contact your local HP office for the most up-to-date information. © Copyright 2006 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for pos- session, use or copying. Consistent with FAR 12.211 and 12.212, Com- mercial Computer Software, Computer Software Documentation, and Tech- nical Data for Commercial Items are licensed to the U.S. Government under vendor's 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 war- ranty. HP shall not be liable for technical or editorial errors or omis- sions contained herein. 16