HP 3000 Manuals HP 3000 Manuals
Product Data and Languages Division VIRTUOSO CODE GENERATOR Reference Manual HP Part No. 30422-90001 Printed May 1988 Printed in U.S.A. Edition U1089
NOTICE The information contained in this document is subject to change without notice. HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard. This document contains proprietary information which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Hewlett-Packard Company. Copyright Æ 1988, 1989 by Hewlett-Packard Company Printing History New editions are complete revisions of the manual. Update packages, which are issued between editions, contain additional and replacement pages to be merged into the manual by the customer. The dates on the title page change only when a new edition or a new update is published. No information is incorporated into a reprinting unless it appears as a prior update; the edition does not change when an update is incorporated. The software code printed alongside the date indicates the version level of the software product at the time the manual or update was issued. Many product updates and fixes do not require manual changes and, conversely, manual corrections may be done without accompanying product changes. Therefore, do not expect a one to one correspondence between product updates and manual updates. First Edition May 1988 30422A.00.00 Update #1 Oct 1989 30422A.02.01 List of Effective Pages The List of Effective Pages gives the date of the current edition and of any pages changed in updates to that edition. Within the manual, any pages changed since the last edition is indicated by printing the date the changes were made on the bottom of the page. Changes are marked with a vertical bar in the margin. If an update is incorporated when an edition is reprinted, these bars are removed but the dates remain. No information is incorporated into a reprinting unless it appears as a prior update. To verify that your manual contains the most current information, check that the date printed at the bottom of the page matches the date listed below for that page. Effective Pages Date All May 1988 1 to 12 Oct 1989 2-5 to 2-6 Oct 1989 Chapter 3 Oct 1989 4-7 to 4-10 Oct 1989 5-1 to 5-8 Oct 1989 Appendix A Oct 1989 Preface This document is the reference manual for the Virtuoso Code Generator (VG), a tool which constructs application code from reusable components. You can use the generator to create your own high-level programming language which generates industry-standard source code. This manual is intended for programmers with knowledge of the HP 3000 operating and file systems, a programming language, and HP System Dictionary. In order to use the Virtuoso Code Generator effectively, you should have some knowledge of COBOL II and System Dictionary. The manuals in the following list contain information you might need as a supplement to this manual: Manual Part Number Virtuoso COBOL Sample Library Reference Manual 30426-90001 HP System Dictionary/V SDMAIN Reference Manual 32254-90001 HP System Dictionary/V COBOL Definition Extractor Reference 32255-90001 Manual HP System Dictionary/V Utilities Reference Manual 32254-90003 HP System Dictionary/V General Reference Manual, Volume 1 32254-90004 HP System Dictionary/V General Reference Manual, Volume 2 32254-90005 HP System Dictionary/V Intrinsics Reference Manual 32254-90002 HP System Dictionary Self-Paced Customer Training 32254-91001 MPE Quick Reference Guide 32033-90023 COBOL II/3000 Reference Manual 32233-90001 The following manuals should be used for the MPE/XL system: Manual Part Number Virtuoso COBOL Sample Library Reference Manual 30426-90001 HP System Dictionary SDMAIN Reference Manual 32256-90001 HP System Dictionary COBOL Definition Extractor Reference Manual 32257-90001 HP System Dictionary Utilities Reference Manual 32256-90003 HP System Dictionary General Reference Manual, Volume 1 32256-90004 HP System Dictionary General Reference Manual, Volume 2 32256-90005 HP System Dictionary Intrinsics Reference Manual 32256-90002 HP System Dictionary Self-Paced Customer Training 32254-91001 MPE Quick Reference Guide 32033-90023 COBOL II/3000 Reference Manual 32233-90001 Using This Manual This manual focuses on the use of the (VG). Other products are discussed in this manual only in relation to Virtuoso program development and maintenance. See the Virtuoso COBOL Sample Library Reference Manual (30426-90001) for more information on macros and models. The manual is organized as follows: Chapter 1 presents information on the Virtuoso Programming Package products. This chapter also introduces terminology and concepts for the and the Virtuoso COBOL Sample Library. Chapter 2 presents basic concepts necessary to understand and use the Virtuoso Code Generator. Chapter 3 provides information on each of the generator constructs (the commands which instruct the generator). This information will prove helpful when creating your own macros and models. Chapter 4 provides information on creating and using macros. Chapter 5 provides information on how to run the generator and what steps to follow after code generation. Chapter 6 provides information on how to create a Virtuoso model. Appendix A provides error messages, causes, and actions for errors which pertain to the . Appendix B contains a glossary of Virtuoso terms. Conventions NOTATION DESCRIPTION NONITALICS In a syntax statement, words that are not in italics can be entered in upper or lowercase characters. Punctuation characters other than brackets, braces, and ellipses must be entered exactly as shown. For example: COMMAND italics In a syntax statement, words that are in italics are parameters which you must replace with a user-supplied variable. For example: COMMANDFileName [ ] An element inside brackets in a syntax statement is optional. When several elements are stacked inside brackets, you can select on or none of the elements. For example: [OPTIONA] [OPTIONB] You can select A or B or neither. { } An element inside braces in syntax statement is required. When several elements are stacked within braces, you must select one of the elements. For example: {OPTIONA} {OPTIONB} You must select A or B or C {OPTIONC} [...] In a syntax statement, horizontal ellipses within brackets indicate that the element(s) within the immediately preceding pair of brackets or braces can be repeated. A punctuation character with horizontal ellipses indicates that repeated elements must be separated by the punctuation character. For example: [ {OPTIONA}] [Parameter {OPTIONB}] [,...] means that the elements within the brackets can be repeated using a comma between repetitions. |...| In a syntax statement, horizontal ellipses within vertical parallel lines indicate that you can select more than one element within the immediately preceding pair of brackets or braces. However, each element can be selected only one time. For example: [OPTIONA] [OPTIONB] |...| You can select A or B, A and B, or neither. A punctuation character with horizontal ellipses indicates that elements must be separated by the punctuation character. : Within an example, vertical ellipses indicate that a portion of the example has been omitted. Ellipses that appear at the bottom of one page and at the top of the next page indicate that the example is continued, but no portions are omitted. , In a syntax statement, a shaded delimiter preceding a parameter indicates that the delimiter must be used whenever (a) that parameter is included or (b) that parameter is omitted but a following parameter is included. For example: ParameterA[,ParameterB][,ParameterC] means that the following are allowed: ParameterA ParameterA,ParameterB ParameterA,ParameterB,ParameterC ParameterA,,ParameterC Å When necessary for clarity, the symbol Å is used in a syntax statement to indicate a required blank or an exact number of blanks. For example: COMMAND (ParameterA)Å(ParameterB) underlining User input is underlined. For example: PROMPT? response In a syntax statement, brackets, braces or ellipses are underlined is you must enter them. For example: COMMAND [[ParameterA]] = ParameterB shading Shading represents inverse video on your terminal screen. In addition, shading represents user input, such as a password, that is not echoed to your terminal screen. The symbol may be used to indicate a key on the terminal keyboard. For example, return represents the carriage return key. controlchar Control characters are indicated by control followed by the character. For example, controlY means that you press the control key and the character Y simultaneously. Control characters are also indicated by ^ in HP-UX examples.