HP 3000 Manuals HP 3000 Manuals
HP System Dictionary/XL Intrinsics Printed in U.S.A. HP AdvanceNet HP Part No. 32256-90002 Edition E1287 U10588 Printed Dec 1987
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 Æ 1987, 1988 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 date on the title page and back cover of the manual changes only when a new edition is published. When an edition is reprinted, all the prior updates to the edition are incorporated. 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 edition 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 December 1987 32256A.00.02 Update Package No. 1 May 1988 32256A.01.01 Documentation Map The following documentation map is intended only as a general guide to the manuals available for HP System Dictionary/XL. Specific users may need information from one or all of the manuals listed here and in the section under "Resources" in the preface of this manual.Preface Manual Organization This manual is the standard reference manual for users of HP System Dictionary/XL intrinsics. It will include all information necessary for you to programmatically access them, and provides examples and other aids as needed to define and clarify the use and operation of each intrinsic. You are assumed to have a working knowledge of the 900 Series HP 3000 computer system, and a good understanding of the architecture and operation of System Dictionary. An understanding of the TurboIMAGE/V subsystem is helpful, but not required. The manual is organized as follows: Chapter 1 INTRODUCTION Provides a brief description of HP System Dictionary/XL, the operating environment it requires, and information on the programming languages and subsystems it supports. Chapter 2 PROGRAMMING INFORMATION Includes information on prepping programs, improving program performance, locking the dictionary, transaction locking, and accessing a compiled dictionary. Chapter 3 PARAMETER TYPES This section provides a description of the parameter types used in HP System Dictionary/XL intrinsics, in each of three programming languages supported in Native Mode on the 900 Series HP 3000. Chapter 4 DICTIONARY INTRINSICS This chapter provides an alphabetically ordered, complete description of each intrinsic. Appendix A INTRINSIC ERROR MESSAGES Provides a listing of the HP System Dictionary/XL error messages that are returned on an intrinsic error, one or more probable causes of each error, and an action for each listed cause. Appendix B INTRINSIC QUICK REFERENCE TABLES Provides tables listing the HP System Dictionary/XL intrinsics by functional group, the purpose of each intrinsic, and a brief listing of their restrictions. Appendix C MIGRATION Provides reference information on using programs written for HP System Dictionary/V on the 900 Series HP 3000, and tells how to convert them for use in Native Mode. It also includes a description of the parameter types used with the SPL programming language, and a set of programming examples written in SPL. Appendix D PROGRAMMING EXAMPLES Provides parallel program examples in each of three languages supported in Native Mode on the 900 Series HP 3000. Each example is designed to accomplish the same set of tasks and uses the same set of intrinsics. Glossary Provides definitions of common terms used with HP System Dictionary/XL. Audience Intended users of this manual are those who will programmatically access the HP System Dictionary/XL intrinsics, including: * Dictionary Administrators * Programmers * Systems Analysts * Applications Developers Because System Dictionary/XL intrinsics require the use of a host programming language, you must be familiar with at least one of the four programming languages available on the 900 Series HP 3000 computer: Pascal/XL, COBOL II/XL, FORTRAN/XL, or SPL (Compatibility Mode only). You will also find knowledge of the MPE XL operating and file systems useful. Knowledge of the HP 3000 TurboIMAGE Database Management System Many also be valuable, as System Dictionary/XL is built on a TurboIMAGE database. Resources In addition to this manual, you may need to consult the following manuals: Manual Part Number Managing Your Information Network: A Data Dictionary Primer 5958-8527 HP System Dictionary/XL SDMAIN Reference Manual 32256-90001 HP System Dictionary/XL Utilities Reference Manual 32256-90003 HP System Dictionary/XL General Reference Manual, Volume 1 32256-90004 HP System Dictionary/XL General Reference Manual, Volume 2 32256-90005 HP System Dictionary/XL COBOL Definition Extractor Reference 32257-90001 Manual TurboIMAGE/XL Reference Manual 30391-90001 SQL Reference Manual 32216-90002 HP SQL Database Administration Guide 32216-90005 VPLUS Reference Manual 36216-90003 QUERY/XL Reference Manual 30000-90042 KSAM Reference Manual 30000-90079 Transact/V Reference Manual 32209-90001 HP 3000 General Information Manual 5953-7553 MPE XL Commands Reference Manual 32247-90001 MPE XL Intrinsics Reference Manual 32650-90003 Program Design and Optimization 32650-90028 Programmer's Utilities and Tools 32650-90010 Native Language Support Reference Manual 32650-90011 EDIT/V Reference Manual 32650-90022 Pascal/XL Reference Manual 03000-90012 Pascal/XL Programmer's Guide 31502-90001 COBOL II/XL Reference Manual 31502-90002 COBOL II/XL Programmer's Guide 31500-90001 HP FORTRAN 77 Reference Manual 31500-90002 HP FORTRAN 77/XL Reference Manual Supplement 5957-4685 HP FORTRAN 77 Programmer's Guide 31501-90001 HP FORTRAN 77/XL Programmer's Guide Supplement 5957-4686 SPL Reference Manual 31501-90002 30000-90024 Other Intrinsics
CAUTION The integrity of System Dictionary/XL can be destroyed by accessing the dictionary database via intrinsics other than those described in this manual, or via any user interface which uses intrinsics other than those described in this manual.
Future Upgrades
NOTE In the future, Hewlett Packard will prefix all names of objects it adds to the core set with "HP" . To avoid potential name conflicts, do not create any entity types, relationship classes, attributes, scopes, domains, or versions prefixed with "HP" .
Conventions NOTATION DESCRIPTION nonitalics Words in syntax statements which are not in italics must be entered exactly as shown. Punctuation characters other than brackets, braces, and ellipses must be entered exactly as shown. For example: EXIT; italics Words in syntax statements which are in italics denote a parameter which must be replaced by a user-supplied variable. For example: CLOSE filename [ ] An element inside brackets in a syntax statement is optional. Several elements stacked inside brackets means the user may select one or none of the elements. For example: [A] [B] User may select A or B or neither. { } When several elements are stacked within braces in a syntax statement, the user must select one of the elements. For example: {OPTIONA} {OPTIONB} User must select A or B or C. {OPTIONC} ... A horizontal ellipses in a syntax statement indicates that a previous element may be repeated. For example: [,itemname ] [,...]; In addition, vertical and horizontal ellipses may be used in examples to indicate that portions of the example have been omitted. , A shaded delimiter preceding a parameter in a syntax statement indicates that the delimiter must be supplied whenever (a) that parameter is included or (b) that parameter is omitted and any other parameter which follows is included. For example: itema[,itemb][,itemc] means that the following are allowed: itema itema,itemb itema,itemb,itemc itema,itemc Å 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: SET (modifier)Å(variable) underlining Brackets, braces or ellipses appearing in syntax or format statements which must be entered as shown will be underlined. For example: LET var[[subscript]] = value Output and input/output parameters are underlined. A notation in the description of each parameter distinguishes input/output from output parameters. For example: CREATE (parm1,parm2,flags,error) shading Shading represents inverse video on the terminal's screen. In addition, shading is used to emphasize key portions of an example. [[ ]] The symbol [[ ]] may be used to indicate a key on the terminal's keyboard. For example, [[RETURN]] represents the carriage return key. [[CONTROL]]char Control characters are indicated by [[CONTROL]] followed by the character. For example, [[CONTROL]] Y means the user presses the control key and the character Y simultaneously.
![[]](../../pic3k/M010477/MAP3c50.gif)