CHANGE [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation
DICTIONARY 3000
CHANGE
Changes the description of a relationship established with the RELATE
command.
Syntax
[option] CHANGE subcommand
CHG
Use the CHANGE command to change the description of a relationship or to
change the attributes of a child entity in the relationship established
with the RELATE command. A complete list of attributes which can be
changed is given below under Subcommands.
The subcommands are used to identify the type of parent entity that
defines the relationship. For example, CHANGE ELEMENT can change the
starting position of a child element within the parent element and/or
edit the textual description of the relationship.
Subcommands
Any of the following subcommands can be used with the CHANGE command:
CATEGORY changes a category to category description
CLASS changes a class to class description
ELEMENT changes an element to element entry and/or
description
FILE changes a file to file entry and/or description
GROUP changes an HP Inform group to group description
PROCEDURE changes a procedure to procedure description
Example
>CHANGE ELEMENT
PARENT ELEMENT> Name < Enter the parent's name.
CHILD ELEMENT> First-name < The child to be changed.
EDIT DESCRIPTION(Y/N)? N N to go directly to
attributes.
CHILD ALIAS: POSITION: Existing attribute information.
STOCK1 1
CHILD ALIAS> Stock2 < Identifies new element alias.
START POSITION> 4 < Identifies new position of
child within parent's list.
CHILD ELEMENT> < [[RETURN]] to terminate 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. Two
asterisks (**) next to a prompt indicate that this prompt and those which
follow are repeated until [[RETURN]] is pressed in response to this
prompt.
You enter: You are prompted for:
SUB-
COMMAND COMMAND PROMPT
CHANGE CATEGORY * PARENT CATEGORY
** CHILD CATEGORY
* EDIT COMMAND>>
CHANGE CLASS * PARENT CLASS
** CHILD CLASS
* EDIT COMMAND>>
CHANGE ELEMENT * PARENT ELEMENT
** CHILD ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
CHILD ALIAS
START POSITION
CHANGE FILE * PARENT FILE
** CHILD FILE
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
CHILD ALIAS
CAPACITY Issued if PARENT file type is
BASE.
BLOCKMAX Issued if PARENT file type is
BASE.
CHANGE GROUP * PARENT GROUP
** CHILD GROUP
* EDIT COMMAND>>
CHANGE PROCEDURE * PARENT PROCEDURE
** CHILD PROCEDURE
* EDIT COMMAND>>
Prompts
Depending on the subcommand used, one or more of the following prompts is
issued:
BLOCKMAX Enter a new maximum physical block length value
(in words) for the child file within the parent
file (128 to 2048). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
CAPACITY Enter a new value for the maximum number of
entries for the child file (1 to 999999999).
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
CHILD ALIAS When the subcommand ELEMENT is used, enter a
new element alias (16 characters maximum).
This is the name by which this element is known
within the child-to-parent element
relationship. The child alias will be used by
the DICTCDE and DICTPDE utilities. This prompt
allows data items within records to have the
same name but different types or definitions.
When the subcommand FILE is used, enter a new
file alias (16 characters maximum) for the
child file. DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
CHILD CATEGORY Enter the name of an existing category (20
characters maximum) that is the child category
in the entry.
CHILD CLASS Enter a numeric value which is the identifying
number (0 to 9999) of an existing security
class, which is not an INFO CLASS.
CHILD ELEMENT Enter the name of an existing data element (20
characters maximum) that is the child in the
entry.
CHILD FILE Enter the name of an existing file (20
characters maximum) that is the child in the
entry.
CHILD GROUP Enter the name of an existing HP Inform group
that is the child in the entry (20 characters
maximum).
CHILD PROCEDURE Enter the name of an existing procedure that is
the child in the entry (20 characters maximum).
EDIT ATTRIBUTES(Y/N) Enter an N if no prompts for attributes are to
be generated. (see Subcommand Prompts for
which attributes can be changed).
EDIT COMMAND>> Enter one of the EDIT COMMANDS described in
Section III.
EDIT DESCRIPTION(Y/N) Enter an N if editing is not to be done for the
textual description of the relationship.
PARENT CATEGORY Enter the name of an existing parent category
(20 characters maximum).
PARENT CLASS Enter a numeric value which is the identifying
number of an existing INFO type security class
(0 to 9999).
PARENT ELEMENT Enter the name of an existing element that is
the parent in the entry (20 characters
maximum).
PARENT FILE Enter the name of an existing file that is the
parent in the entry (20 characters maximum).
PARENT GROUP Enter the name of an existing HP Inform group
that is the parent in the entry (20 characters
maximum). Note that the HP Inform group $MENU
can not be changed.
PARENT PROCEDURE Enter the name of an existing procedure that is
the parent in the entry (20 characters
maximum).
START POSITION Enter a positive integer which is the new byte
position of the start of the child element's
data field within the parent element (1 to
9999). DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
MPE/iX 5.0 Documentation