HP 3000 Manuals HP 3000 Manuals
CREATE
Creates a new entity.
Syntax
[option] CREATE subcommand
C
Use the CREATE command to define a new entity in the Dictionary. A
complete list of entities that can be created in the Dictionary is given
below under Subcommands. The subcommand identifies the type of entity to
be defined. For example, CREATE GROUP creates a new HP Inform group and
CREATE ELEMENT creates a new element entry in the Dictionary.
An entity must be CREATED before it can be used with any other command.
Subcommands
Any of the following subcommands can be used with the CREATE command:
CATEGORY creates a new category entry
CLASS creates a new user security class entry
ELEMENT creates a new data element entry
FILE creates a new file entry
GROUP creates a new HP Inform group entry
LOCATION creates a new physical location entry
PROCEDURE creates a new procedure entry
Example
>CREATE GROUP
GROUP> Customer Information< HP Inform group.
LONG NAME> Customer Information-Marketing <
TYPE> MRKT< User defined type.
RESPONSIBILITY> Order Processing <
DESCRIPTION> This group will contain detail <
> information about Marketing's customers. <
> <
[[RETURN]] to end
command.
New command prompt.
>
Subcommand Prompts
For the prompts shown with an asterisk (*), you must enter a response
other than [[RETURN]] in order to implement the command string.
You enter: You are prompted for:
COMMAND SUBCOMMAND PROMPT
CREATE CATEGORY * CATEGORY
LONG NAME
TYPE
RESPONSIBILITY
DESCRIPTION
CREATE CLASS * CLASS
NAME
TYPE
PASSWORD
RESPONSIBILITY
RESTRICT CLASS TO A FILE (N/Y) Issued only if CLASS
type is not INFO.
FILE * If Yes to RESTRICT CLASS;
file type must be BASE.
DESCRIPTION
CREATE ELEMENT * ELEMENT
LONG NAME
TYPE
SIGN POSITION Issued only if TYPE Z.
* ELEMENT REFERENCE Issued only if TYPE "*".
* SIZE Issued only if TYPE specified
and TYPE is not B or "*".
DECIMAL Issued only if TYPE specified
and TYPE is numeric.
STORAGE LENGTH(n) Issued only if TYPE specified
and TYPE is not "*", B or S.
COUNT(1) Issued only if TYPE specified.
HEADING TEXT
ENTRY TEXT
EDIT MASK
MEASUREMENT UNITS
BLANK WHEN ZERO(N/Y)? Issued only if TYPE Z or 9.
RIGHT JUSTIFY(N/Y)? Issued only if TYPE X or U.
SYNCHRONIZED(N/Y)? Issued only if TYPE I, J,
or K.
RESPONSIBILITY
DESCRIPTION
CREATE FILE * FILE
LONG NAME
* TYPE
RESPONSIBILITY
DESCRIPTION
ADDITIONAL FILE ATTRIBUTES(N/Y)? Issued if file
type is KSAM, MPEF or MPER.
RECORD FORMAT(F/V/U/S)? Issued only if file type
is KSAM, MPEF or MPER.
MINIMUM RECORD SIZE Issued only if file type is
KSAM, MPEF or MPER and RECORD
FORMAT is V or U.
MAXIMUM RECORD SIZE Issued only if file type is
KSAM, MPEF or MPER.
BLOCKING(N/Y)? Issued only if file type is
KSAM, MPEF or MPER.
UNIT(R/C)? Issued if YES to BLOCKING.
MINIMUM BLOCKING Issued if YES to BLOCKING.
MAXIMUM BLOCKING Issued if YES to BLOCKING.
RECORDING MODE(A/B)? Issued only if file type is
MPEF or MPER.
DATA STORAGE TYPE(A/E)? Issued only if file type
is MPEF.
CCTL(N/Y)? Issued only if file type is
MPEF.
DEVICE Issued only if file type is
MPEF.
DEVICE CLASS(DA/UR/UT)? Issued only if file type is
MPEF.
CREATE GROUP * GROUP
LONG NAME
TYPE
RESPONSIBILITY
DESCRIPTION
CREATE LOCATION * LOCATION
LONG NAME
GROUP
ACCOUNT
CPU
DESCRIPTION
CREATE PROCEDURE * PROCEDURE
LONG NAME
TYPE
LANGUAGE
RESPONSIBILITY
DESCRIPTION
Prompts
Depending on the subcommand used, one or more of the following prompts is
issued:
ACCOUNT Enter the name for the MPE account associated
with the location (8 characters maximum).
ADDITIONAL FILE Enter Y or Yes to generate additional prompts
ATTRIBUTES(N/Y)? which allow you to specify additional
attributes for this file. These prompts
generate data that will be used by the DICTCDE
utility. DEFAULT is No.
BLANK WHEN ZERO(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y if the element is
to be displayed as a blank when its value is
equal to 0. DEFAULT is No.
BLOCKING(N/Y)? This prompt generates data that can be used by
the DICTCDE utility. Enter Y to specify the
blocking factor of the file. DEFAULT is No.
CATEGORY Enter the name for a new category (20
characters maximum).
CCTL(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y if the carriage
control option for an output file is to be
specified. DEFAULT is No.
CLASS Enter a numeric value for the identity of a new
security class (0 to 9999).
COUNT(1) Enter the sub-element count if the data element
is a compound element (1 to 9999). DEFAULT is
1.
CPU Enter the identity of the machine associated
with the location (8 characters maximum).
DATA STORAGE TYPE (A/E)? This prompt generates data that will be used by
the DICTCDE utility. Enter the following to
specify the character code that represents how
data is stored in the file:
A ASCII character codes
E EBCDIC character codes
DEFAULT is A.
DECIMAL Enter the integer value for the number of
digits to the right of the decimal point (0 to
9999). Do not include a position for the
decimal point itself. The largest value for
each element type is as follows:
For types Z, P, and 9, the largest value is 27
digits.
For types I, J, and K, the largest value is 28
decimal digits.
For types E and R, the largest value is 27
digits without a decimal and 28 digits with a
decimal.
This prompt is only issued for numeric type
data elements. Note if the maximum value for
SIZE is entered, a decimal value is required.
DEFAULT is 0.
DESCRIPTION Enter a textual description which describes the
entity (50 characters per description line
allowed, unlimited lines).
DEVICE This prompt generates data that will be used by
the DICTCDE utility. Enter the type of
user-specified device in which the file resides
(8 characters maximum). If [[RETURN]] is
pressed in response to this prompt, then the
MPE default device will be assumed.
DEVICE CLASS (DA/UR/UT)? This prompt generates data that will be used
for the DICTCDE utility. Enter the class of
device on which the file resides as follows:
DA mass storage device
UT utility device (such as a tape drive)
UR unit record device (such as a card
reader)
DEFAULT is DA.
EDIT MASK Enter a textual edit mask to be used by HP
Inform, Report, and Transact to edit values
when displayed for the data element (30
characters maximum). (Refer to Using Edit
Masks in Section III.)
ELEMENT Enter the name for a new data element (20
characters maximum).
ELEMENT REFERENCE This prompt generates data that will be used by
the DICTCDE and DICTPDE utilities. Enter the
name of an existing element which is to be used
as a back-reference. The new element to be
created will have the same type, size, storage
length, and sub-element count (if it is a
compound element) as this element. If this
element is a numeric type, the new element will
also have the same number of digits to the
right of the decimal.
ENTRY TEXT Enter textual information to be used by HP
Inform, Report, and Transact as a prompt for
input. Otherwise, the primary name is used in
the prompt (30 characters maximum).
Note that the primary name will be used in HP
Inform's and Report's SELECTION CRITERIA prompt
unless an ENTRY TEXT has been specified.
FILE If the subcommand is:
FILE enter the name for a new file (20
characters maximum). CAUTION: A
base name can be up to 20
characters in the Dictionary.
Dictionary accepts the full name
such as BASE.GROUP.ACCOUNT as a
valid name. DICTDBC, however,
always uses the first 6
characters of the name as the
base name. When DICTDBC
encounters a base name in
the Dictionary such as
BASE.GROUP.ACCOUNT, your base
name is created as "BASE.G" which
is an invalid base name. To
specify the physical location of
the file, use the CREATE LOCATION
and the ADD FILE-LOCATION
commands.
CLASS enter the name of an existing
file of type BASE (20 characters
maximum).
GROUP If the subcommand is:
GROUP enter the name for a new HP
Inform group (20 characters
maximum).
LOCATION enter the name of the MPE group
associated with the location (8
characters maximum).
HEADING TEXT Enter a textual heading to be used by HP
Inform, Report, and Transact for reports.
Otherwise the primary name is used in the
heading (30 characters maximum).
Note that the primary name will be used in the
report heading by HP Inform and Report unless a
HEADING TEXT has been specified.
LANGUAGE Enter the name of the implementation language
for the procedure (10 characters maximum).
LOCATION Enter the name of a physical location that
identifies the MPE file group and account, and
the machine where files and procedures reside
(20 characters maximum).
LONG NAME Enter a full textual description for the entity
(50 characters maximum).
MAXIMUM BLOCKING This prompt generates data that will be used by
the DICTCDE utility. Enter the maximum
blocking factor for the file. DEFAULT: is 0.
MAXIMUM RECORD SIZE This prompt generates data that will be used by
the DICTCDE utility. Enter the maximum number
of characters in the record. DEFAULT is 0.
MEASUREMENT UNITS Enter the type of measurement units (such as
feet, dollars) used for the data element's
value (10 characters maximum).
MINIMUM BLOCKING This prompt generates data that will be used by
the DICTCDE utility. Enter the minimum
blocking factor for the file. DEFAULT is 0.
MINIMUM RECORD SIZE This prompt generates data that will be used by
the DICTCDE utility. Enter the minimum number
of characters in the record. DEFAULT is 0.
NAME Enter a textual name for the new security class
(50 characters maximum).
PASSWORD Enter a password for the new security class (8
characters maximum).
PROCEDURE Enter the name for a new procedure (20
characters maximum).
RECORD FORMAT (F/V/U/S) This prompt generates data that will be used by
the DICTCDE utility. RECORD FORMAT specifies
how the logical records are contained in the
file. Enter:
F for fixed length logical records
V for variable length logical records
U for undefined length logical records
S for the multirecord or "multiblock"
option
RECORDING MODE(A/B)? This prompt generates data that will be used by
the DICTCDE utility. Enter A if the recording
mode of the file is ASCII. Enter B if the
recording mode of the file is BINARY. DEFAULT
is A.
RESPONSIBILITY Enter the name of the person, department, or
area responsible for the integrity of the new
entity (20 characters maximum).
RESTRICT CLASS TO A FILE Enter a Y if the scope of the class is to be
(N/Y) restricted to one file. A security class can
be restricted to files of type BASE.
RIGHT JUSTIFY(N/Y)? This prompt generates data that can be used by
the DICTCDE utility. Enter Y or Yes to right
justify alphabetic or alphanumeric data
elements. DEFAULT is No.
SIGN POSITION This prompt generates data that will be used by
the DICTCDE utility. Enter the position of the
sign for a signed numeric data element as
follows:
LO leading overpunched
LS leading separate
TO trailing overpunched
TS trailing separate
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates that there is no sign.
SIZE Enter an integer value required to display an
element (1 to 9999). Include a position for a
decimal point if there is one, but do not
include one for a sign. The largest value for
each element type is as follows:
For type Z, P, and 9, the largest value is 28
digits.
For type I, J, and k, the largest value is 29
digits.
For type E and R, the largest value is 27
digits without a decimal and 28 digits with a
decimal.
For type X and U, the largest value is 9999
digits.
STORAGE LENGTH (n) The system calculates the storage length in
bytes and displays it as "n". An over-ride
value may be entered (1 to 9999), otherwise "n"
is used.
SYNCHRONIZED(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y or Yes to align
data elements in order to facilitate arithmetic
operations. DEFAULT is No.
TYPE If the subcommand is:
ELEMENT - enter one of the following values:
U upper case ASCII
X upper or lower case ASCII
9 numeric ASCII
Z zoned decimal
P packed decimal
I integer binary
J integer binary (COBOL)
K logical
R floating point (commercial)
E floating point (E format)
B boolean (PASCAL)
S string (PASCAL)
* back reference to an existing
element (PASCAL)
If the type is numeric, a plus character (+)
may immediately follow it to indicate that the
data element can have only positive values. If
a plus character is entered with a type other
than numeric, it is ignored. Pressing
[[RETURN]] in response to this prompt indicates
that the data element does not have a type
assigned.
FILE - enter one of the following values:
BASE IMAGE database
MAST IMAGE manual master data set
AUTO IMAGE automatic master data set
DETL IMAGE detail data set
KSAM KSAM file
MPEF MPE sequential file
MPER MPE relative file
VPLS VPLUS forms file
FORM VPLUS form
CATEGORY, CLASS, GROUP, or PROCEDURE - enter up
to four characters meaningful to you. Or, if
this is a CLASS to be used for INFORM security,
enter INFO as the class type.
UNIT(R/C)? This prompt generates data that will be used by
the DICTCDE utility. Specify the unit used to
determine the blocking factor with: R for
RECORDS or C for CHARACTERS. DEFAULT is R.