HP 3000 Manuals

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