HP 3000 Manuals HP 3000 Manuals
Appendix C DICTIONARY/3000
INITIALIZATION PROCEDURE
OVERVIEW
Once Dictionary/3000 software has been installed on your system, you must
execute the program DICTINIT to create and initialize a data dictionary.
This program allows you to customize the dictionary for your application
and to define the security for the dictionary. It also allows you to
re-initialize an existing dictionary when you want to change the
passwords for access or to change the capacities of the data sets in the
dictionary.
The dictionary is created in the MPE group and account from which the
DICTINIT program is run. The dictionary maintenance program (DICTDBM)
and the dictionary utility programs all assume the dictionary exists in
the PUB group of the log-on account. If you create a dictionary in a
different group and/or account, you will first have to identify these
before running DICTDBM or the utilities. You do this by issuing a file
equation as follows:
FILE DICT.PUB=DICT.group.account
When running DICTINIT, you can define five levels of access to the
dictionary. You do this by assigning a password to each level. The
access levels are hierarchical - that is, each level is given the
capability for its level and all levels below. The topmost level of
MANAGER has complete and total access to the dictionary. The mid-level
of INFORM has access for INFORM as well as for DOCUMENTATION and REPORT,
and so forth.
Entries that pertain to security, such as security class numbers and
passwords, can only be created and modified by someone using the password
assigned to MANAGER. A description of each possible level and the access
capability given to each follows:
---------------------------------------------------------------------------------------
LEVEL ACCESS CAPABILITY WHO SHOULD USE
MANAGER Total access. The person responsible for the
data dictionary.
PROGRAMMER Can modify entries except security Anyone who needs to create and
entries; can read security maintain files and elements in the
entries. dictionary for application
development.
INFORM Can modify HP Inform/3000 group Anyone responsible for the
entries and all entries below; maintenance of the HP Inform/3000
cannot read/modify security program.
entries.
DOCUMENTATION Can modify documentation entries Anyone responsible for maintaining
and all entries below; cannot documentation entries in the
read/modify security entries. dictionary (PROCEDURES, LOCATIONS,
or CATEGORIES).
REPORT Can modify NO entries; can read Anyone who needs to write can read
all entries except security all entries except reports about
entries. the contents of the dictionary.
Once passwords for the various levels are assigned, there is no way for
you to see them within Dictionary/3000. If you are the database creator,
you can run DBUTIL and see the passwords. (Refer to the IMAGE/3000
Reference Manual for a description of the DBUTIL utility.) If not, you
can run the DICTINIT program again and use the RE-INITIALIZATION option
to assign new passwords. If you do not specify a password for a
particular level, that security level is deleted - there is no access at
that level. The MANAGER level cannot be deleted; you must specify a
password for the MANAGER level.
There are two phases to the DICTINIT program. During the first phase
(initialization), information provided by the Dictionary/3000 software is
used to create a temporary dictionary which is automatically purged at
the end of phase two. To create this temporary dictionary, a special
stream job is automatically invoked by DICTINIT. If you use passwords at
either the user, account, or group level when you log on, the stream job
prompts you to enter them before it begins. You should monitor the
status of the stream job to be sure no errors are encountered. If
the job was able to complete, a message informing you to run
DICTINIT.PUB.SYS,UPDATE for phase two is displayed. If the job aborts,
the line printer listing will tell you why. After correcting the
problem, you can begin again.
Phase two (customization) allows you to customize your dictionary or use
the defaults, and to assign passwords for the levels of access. At the
end of phase two another stream job is invoked. This job builds your
permanent data dictionary. If the job in phase two completes
successfully, you are informed that DICTINIT IS COMPLETE. If you do not
receive this message, but the job has finished, check the line
printer listing for the errors. After correcting them, rerun
DICTINIT.PUB.SYS,UPDATE.
You can terminate DICTINIT by entering a CNTL-Y at any time. If you
enter a CNTL-Y while running phase two, any changes that have been
verified are accepted and become the defaults when phase two is run
again. A complete list of all error messages, including what to do to
recover, is given following the examples.
Example
To initialize a new data dictionary using the default capacities provided
by HP, simply follow the process below - substituting your responses for
the ones shown where appropriate. The first step is to log on to the
group and account in which you want the dictionary to appear. Then
follow the following example:
:RUN DICTINIT.PUB.SYS How to start initialization
process.
<The Dictionary/3000 initialization program banner appears here.>
Initialization/Re-initialization (I/R) >i Select "I" to build a new
dictionary.
USER PASSWORD > If logon passwords were used, enter
them in response to these prompts.
ACCOUNT PASSWORD >LOCKIT They are used by the batch job that
installs a temporary dictionary.
GROUP PASSWORD >
#J33 Number of the STREAMed job which
performs step one (initialization).
END OF PROGRAM End of step one.
:
FROM/<your account>/PLEASE RUN DICTINIT.PUB.SYS,UPDATE
This message informs you that the
job is complete, and you are to
perform step two (customization).
:RUN DICTINIT.PUB.SYS,UPDATE Performing step two.
<The Dictionary/3000 initialization program banner goes here.>
Initialization/Re-initialization (I/R) >i Again - new dictionary.
Dictionary capacities: Default or Provided (D/P) >d Use the default
capacities.
DATA-ELEMENT will have capacity 1001 Listing of the capacities
DATA-FILE will have capacity 503 for your examination.
DATA-PROCEDURE will have capacity 203
DATA-CATEGORY will have capacity 203
DATA-GROUP will have capacity 503
DATA-CLASS will have capacity 203
DATA-LOCATION will have capacity 203
LINK-FILE will have capacity 401
LINK-ELEMENT will have capacity 401
LINK-DESCRIPTION will have capacity 2003
DATA-REPORTLOC will have capacity 503
ELEMENT-REFTYPE will have capacity 500
ELEMENT-ELEMENT will have capacity 500
FILE-FILE will have capacity 250
PROCEDURE-PROCED will have capacity 100
CATEGORY-CATEGOR will have capacity 100
GROUP-GROUP will have capacity 250
FILE-ELEMENT will have capacity 2000
FILE-EL-SECOND will have capacity 100
FILE-PATH will have capacity 400
FILE-SORT will have capacity 400
PROCEDURE-ELEMEN will have capacity 500
CATEGORY-ELEMENT will have capacity 500
Press RETURN to continue > Press RETURN to see the rest
of the display; it fills more
than one screen in this case.
GROUP-ELEMENT will have capacity 1000
CLASS-CLASS will have capacity 500
CLASS-ELEMENT will have capacity 3000
CLASS-FILE will have capacity 500
CLASS-GROUP will have capacity 500
FILE-LOCATION will have capacity 500
PROCEDURE-LOCATI will have capacity 200
DESCRIPTION-TEXT will have capacity 5000
REPORT-LIST will have capacity 500
Are the capacities correct? (Y/N) >y This prompt gives you a
chance to answer "N" and
change them; here we say yes.
Password for MANAGER access >DICTMGR These prompts allow you to
specify the security levels
Password for PROGRAMMER access >DICPRG and their passwords; you can
respond with a password or
Password for INFORM access >DICINF simply press RETURN for no
access at that level.
Password for DOCUMENTATION access >
Password for REPORT access >DICRPT
Password for MANAGER access will be DICTMGR Program lists the
Password for PROGRAMMER access will be DICPRG passwords assigned.
Password for INFORM access will be DICINF
There will be no DOCUMENTATION access allowed RETURN was pressed,
nullifying that level.
Password for REPORT access will be DICRPT
Are the passwords correct? (Y/N) >y You can change the passwords
by responding "N" .
USER PASSWORD > Again - any log-on passwords
are needed to start the final
ACCOUNT PASSWORD >LOCKIT initialization job which
actually
creates the new dictionary.
GROUP PASSWORD >
#J34 Number of the final job.
END OF PROGRAM End of customization step.
FROM/<your account>/DICTINIT IS COMPLETE The program is complete; your
dictionary is initialized.
This example demonstrates how to enter your own capacities and change
them after they are displayed. As before, log on to the group and
account in which you want the dictionary before starting.
:RUN DICTINIT.PUB.SYS How to execute the program.
<The Dictionary/3000 initialization program banner appears here>
Initialization/Re-initialization (I/R) >i Select "I" to build a new
dictionary.
USER PASSWORD >
ACCOUNT PASSWORD >LOCKIT If a user, account, or group
password is required, enter
GROUP PASSWORD > it in response to these
prompts.
#J35
END OF PROGRAM
:
FROM/<your account>/PLEASE RUN DICTINIT.PUB.SYS,UPDATE Informs you
to run step
two.
:RUN DICTINIT.PUB.SYS,UPDATE
<The Dictionary/3000 initialization program banner appears here.>
Initialization/Re-initialization (I/R) >i Select "I" to build a new
dictionary.
Dictionary capacities: Default or Provided (D/P) >p Select "P" to
enter new
capacities;
old ones are
displayed.
DATA-ELEMENT has capacity 1001
New capacity for DATA-ELEMENT > 1002
DATA-FILE has capacity 503
New capacity for DATA-FILE > 504
DATA-PROCEDURE has capacity 203
New capacity for DATA-PROCEDURE > 204
DATA-CATEGORY has capacity 203
New capacity for DATA-CATEGORY > 204
DATA-GROUP has capacity 503
New capacity for DATA-GROUP > 504
DATA-CLASS has capacity 203
New capacity for DATA-CLASS > 204
DATA-LOCATION has capacity 203
New capacity for DATA-LOCATION > Pressing RETURN keeps the old
capacity.
LINK-FILE has capacity 401
New capacity for LINK-FILE > 402
LINK-ELEMENT has capacity 401
New capacity for LINK-ELEMENT > 402
LINK-DESCRIPTION has capacity 2003
New capacity for LINK-DESCRIPTION > 2004
DATA-REPORTLOC has capacity 503
New capacity for DATA-REPORTLOC > 504
ELEMENT-REFTYPE has capacity 500
New capacity for ELEMENT-REFTYPE > 501
ELEMENT-ELEMENT has capacity 500
New capacity for ELEMENT-ELEMENT > 501
FILE-FILE has capacity 250
New capacity for FILE-FILE > 251
PROCEDURE-PROCED has capacity 100
New capacity for PROCEDURE-PROCED > 101
CATEGORY-CATEGOR has capacity 100
New capacity for CATEGORY-CATEGOR > 101
GROUP-GROUP has capacity 250
New capacity for GROUP-GROUP > 251
FILE-ELEMENT has capacity 2000
New capacity for FILE-ELEMENT >
FILE-EL-SECOND has capacity 100
New capacity for FILE-EL-SECOND > 101
FILE-PATH has capacity 400
New capacity for FILE-PATH > 401
FILE-SORT has capacity 400
New capacity for FILE-SORT > 401
PROCEDURE-ELEMEN has capacity 500
New capacity for PROCEDURE-ELEMEN > 501
CATEGORY-ELEMENT has capacity 500
New capacity for CATEGORY-ELEMENT > 501
GROUP-ELEMENT has capacity 1000
New capacity for GROUP-ELEMENT > 1001
CLASS-CLASS has capacity 500
New capacity for CLASS-CLASS > 501
CLASS-ELEMENT has capacity 3000
New capacity for CLASS-ELEMENT > 3001
CLASS-FILE has capacity 500
New capacity for CLASS-FILE > 501
CLASS-GROUP has capacity 500
New capacity for CLASS-GROUP > 501
FILE-LOCATION has capacity 500
New capacity for FILE-LOCATION > 501
PROCEDURE-LOCATI has capacity 200
New capacity for PROCEDURE-LOCATI > 201
DESCRIPTION-TEXT has capacity 5000
New capacity for DESCRIPTION-TEXT > 5001
REPORT-LIST has capacity 500
New capacity for REPORT-LIST > 501
DATA-ELEMENT will have capacity 1002 Listing of capacities.
DATA-FILE will have capacity 504
DATA-PROCEDURE will have capacity 204
DATA-CATEGORY will have capacity 204
DATA-GROUP will have capacity 504
DATA-CLASS will have capacity 204
DATA-LOCATION will have capacity 203
LINK-FILE will have capacity 402
LINK-ELEMENT will have capacity 402
LINK-DESCRIPTION will have capacity 2004
DATA-REPORTLOC will have capacity 504
ELEMENT-REFTYPE will have capacity 501
ELEMENT-ELEMENT will have capacity 501
FILE-FILE will have capacity 251
PROCEDURE-PROCED will have capacity 101
CATEGORY-CATEGOR will have capacity 101
GROUP-GROUP will have capacity 251
FILE-ELEMENT will have capacity 2000
FILE-EL-SECOND will have capacity 101
FILE-PATH will have capacity 401
FILE-SORT will have capacity 401
Press RETURN to continue >
PROCEDURE-ELEMEN will have capacity 501
CATEGORY-ELEMENT will have capacity 501
GROUP-ELEMENT will have capacity 1001
CLASS-CLASS will have capacity 501
CLASS-ELEMENT will have capacity 3001
CLASS-FILE will have capacity 501
CLASS-GROUP will have capacity 501
FILE-LOCATION will have capacity 501
PROCEDURE-LOCATI will have capacity 201
DESCRIPTION-TEXT will have capacity 5001
REPORT-LIST will have capacity 501
Are the capacities correct? (Y/N) >n Enter "N" to change
values.
Data-set name (DONE/ALL/name) >report-list Change capacity of data
set REPORT-LIST.
REPORT-LIST has capacity 501
New capacity for REPORT-LIST > 200
Data-set name (DONE/ALL/name) >description-text
DESCRIPTION-TEXT has capacity 5001
New capacity for DESCRIPTION-TEXT > 5000
Data-set name (DONE/ALL/name) >done Enter DONE to stop
changing capacities.
DATA-ELEMENT will have capacity 1002 Listing of capacities.
.
.
.
Press RETURN to continue >
.
.
.
DESCRIPTION-TEXT will have capacity 5000
REPORT-LIST will have capacity 200
Are the capacities correct? (Y/N) >y
Password for MANAGER access >DICTMGR
Password for PROGRAMMER access > Entering RETURN indicates
that there will be
Password for INFORM access > no access to the
dictionary at
Password for DOCUMENTATION access > these levels.
Password for REPORT access >
Password for MANAGER access will be DICTMGR Listing of passwords
There will be no PROGRAMMER access allowed assigned.
There will be no INFORM access allowed
There will be no DOCUMENTATION access allowed
There will be no REPORT access allowed
Are the passwords correct? (Y/N) >y
USER PASSWORD >
ACCOUNT PASSWORD >LOCKIT
GROUP PASSWORD >
#J36
END OF PROGRAM
:
FROM/<your account>/DICTINIT IS COMPLETE Program is complete; your
dictionary is initialized.
This example shows a dictionary re-initialization. That is, there is
already a data-dictionary in your group, and you want to resize it and/or
change the passwords to access it.
:RUN DICTINIT.PUB.SYS How to execute the program.
<The Dictionary/3000 initialization program banner appears here>
Initialization/Re-initialization (I/R) Select "R" to re-initialize an
>r
existing dictionary.
USER PASSWORD > If logon passwords were used,
enter them in response to these
prompts.
ACCOUNT PASSWORD >
GROUP PASSWORD >
Dictionary store file on Tape or Disk(T/D) >d
The present contents of the
dictionary will be stored by
DICTINIT, to be recovered into the
new dictionary when it is created.
This store file may be quite large,
and you may not have the disk space
to hold it. In this case, you may
store it to tape. Otherwise,
request DICTINIT to use a disk
file, as in this example.
#J46
END OF PROGRAM
:
FROM/<your account>/PLEASE RUN DICTINIT.PUB.SYS,UPDATE End of step one.
:RUN DICTINIT.PUB.SYS,UPDATE Execute step two.
<The Dictionary/3000 initialization program banner appears here>
Initialization/Re-initialization (I/R) >r Select R to re-initialize.
Dictionary capacities: Default or Provided (D/P) >d Use defaults.
DATA-ELEMENT will have capacity 1001 Listing of capacities.
.
.
.
CATEGORY-ELEMENT will have capacity 500
Press RETURN to continue >
GROUP-ELEMENT will have capacity 1000
.
.
.
REPORT-LIST will have capacity 500
Are the capacities correct? (Y/N) >y
Password for MANAGER access >DICTMGR Enter passwords for the various
security levels.
Password for PROGRAMMER access >
Password for INFORM access >DICINF
Password for DOCUMENTATION access >
Password for REPORT access >DICRPT
Password for MANAGER access will be DICTMGR Listing of
There will be no PROGRAMMER access allowed passwords.
Password for INFORM access will be DICINF
There will be no DOCUMENTATION access allowed
Password for REPORT access will be DICRPT
Are the passwords correct? (Y/N) >y
USER PASSWORD > If log-on passwords were used,
enter them in response to these
ACCOUNT PASSWORD > prompts.
GROUP PASSWORD >
Dictionary store file on Tape or Disk(T/D) Indicates a disk file; must
>d be answered as in step one.
#J50
END OF PROGRAM
:
FROM/<your account>/DICTINIT IS COMPLETE The program is complete;
your dictionary is now
re-initialized.