DICTIONARY 3000 : COPYRIGHT NOTICE [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation
DICTIONARY 3000
DICTIONARY/3000
Printed in U.S.A.
HP 3000 Computer Systems
HP Part No. 32244-90001
Edition E1287
Printed Dec 1987
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 Æ 1981, 1982, 1984, 1987 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 Jan 1981 32244A.00.00
Second Edition Jul 1982 32244A.00.00
Update #1 Nov 1982 32244A.01.00
Third Edition Jan 1984 32244A.02.00
Update #1 Apr 1984 32244A.02.01
Update #2 Dec 1984 32244A.02.01
Third Edition (Updates Dec 1987 32244A.02.01
1,2 incorp.)
PREFACE
This manual describes the Dictionary/3000 software system that operates
on HP 3000 computers. It is the reference document for all persons
involved in creating and maintaining a dictionary database and an
IMAGE/3000 data base. It assumes a working knowledge of the HP 3000
computer system, including the IMAGE/3000 subsystem.
This edition of the manual has been expanded to include the new
Dictionary extract utilities for COBOL II/3000 and PASCAL/3000 data
declarations, and for the new VPLUS forms file definition utility. In
order to use these utilities, the manual assumes a working knowledge of
COBOL II/3000, PASCAL/3000, and VPLUS/3000. Also included in this manual
is information for the Inform Security feature.
In addition, use of the Dictionary audit, load, and unload utilities can
improve IMAGE/3000 response and allows faster application run time and
increased throughput. Each utility provides benefits which are not
included in IMAGE. For example, the primary benefit of the load and
unload utilities, DICTDBL and DICTDBU, is that they allow selective
loading and unloading of the data sets within a database. These can be
used as tool to maintain the primary path sequence of the data in detail
data sets. (DICTDBU and DICTDBL do not, however, provide a dynamic
restructuring capability.) For full database loads and unloads, the
DBLOAD and DBUNLOAD facilities provided with IMAGE are more efficient.
DICTDBA, the audit utility, gives you a quick way to find out the synonym
chain count and average chain length. By maintaining chain counts as low
as possible, database performance is improved.
In addition to this manual, you may need to consult the following manuals
and self-paced courses:
Manual and Manual Part Number
MPE Command Reference Manual 30000-90009
MPE Error Messages and Recovery Manual 30000-90102
Using Files 30000-90015
IMAGE/3000 Reference Manual 32215-90003
VPLUS/3000 Reference Manual 32209-90001
KSAM/3000 Reference Manual 30000-90079
Transact/3000 Reference Manual 32247-90001
HP Inform/3000 User's Guide 32246-90001
PASCAL/3000 Reference Manual 32106-90001
COBOL II/3000 Reference Manual 32233-90001
Self-Paced Course and Course Product Number
Programming in Transact/3000 22842A
Using Dictionary/3000 22843B
WARNING The Data Dictionary integrity can be destroyed by using a
utility that is not listed below. Therefore, only the following
utilities will be supported by Hewlett-Packard when used against
the Data Dictionary:
DICTINIT
DICTDBM
DICTDBM,UTIL
DICTDBD
DICTDBA
DICTDBC
DICTVPD
DICTCDE
DICTPDE
DBSTORE/DBRESTOR
*STORE/RESTORE
*SYSDUMP
Hewlett-Packard will investigate and attempt to resolve problems
resulting from the use of utilities that do not appear on the
above list. This service is not provided under HP's standard
support agreements, but is available on a time and material
basis.
HEWLETT-PACKARD IS NOT RESPONSIBLE FOR ANY LOSS OR DAMAGE
RESULTING FROM CUSTOMER'S USE OF THE DATA DICTIONARY WITH
UTILITIES NOT LISTED ABOVE.
*Please note that STORE/RESTORE and SYSDUMP will be supported
only when used on the Data Dictionary in its entirety (e.g., the
root file and all the data sets).
CONVENTIONS USED IN THIS MANUAL
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 denote
a parameter which you must replace with a user-supplied
variable. For example:
COMMAND FileName
[ ] An element inside brackets in a syntax statement is
optional. When several elements are stacked inside
brackets, you can select one or none of the elements.
For example:
[Option A]
[Option B] You can select A or B or neither.
{ } An element inside braces in a syntax statement is
required. When several elements are stacked within
braces, you must select one of the elements. For
example:
{Option A}
{Option B} You must select A or B or C.
{Option C}
... In a syntax statement, horizontal ellipsis indicate that
the element(s) within the immediately preceding pair of
brackets or braces can be repeated. For example:
[ {OPTIONA}]
[Parameter {OPTIONB}] ...
means that the elements within the brackets can be
repeated.
[,...] In a syntax statement, a punctuation character with
horizontal ellipses indicates that the elements within
the immediately preceding pair of brackets or braces can
be repeated and 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.
: 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 if you must enter them. Fore 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.
[[CONTROL]]char Control characters are indicated by [[CONTROL]] followed
by the character. For example, [[CONTROL]]Y means that
you press the control key and the character Y
simultaneously.
MPE/iX 5.0 Documentation