HP 3000 Manuals

RESEQUENCE [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation


DICTIONARY 3000

RESEQUENCE 

Resequences a data element within an association established with the ADD
command.

Syntax 

     [option] RESEQUENCE subcommand 
              RES

Use the RESEQUENCE command to change a data element's position within an
entity's list of associations which was established by the ADD command.
A complete list of entities for which data elements can be resequenced is
given below under Subcommands.

The subcommand identifies the type of entity for which a resequencing is
to occur.  For example, RESEQUENCE FILE changes the position of a data
element in the list of elements associated with that file.

The name of the element before which the resequenced element is to be
placed is entered in response to the NEW POSITION prompt.  Pressing
[[RETURN]] in response to this prompt places the resequenced element at
the end of the association list for the entity.  To see the current list
of associations and current positions, use the SHOW command.

Subcommands 

Any of the following subcommands can be used with the RESEQUENCE command:

CATEGORY                  resequences a data element within a category

CLASS                     resequences a data element within a security
                          class

FILE                      resequences a data element within a file

GROUP                     resequences a data element within an HP Inform
                          group

PROCEDURE                 resequences a data element within a procedure

Example 

     >RESEQUENCE FILE
                      FILE> Customer        <    The file's name.
      PRIMARY/SECONDARY(P/S)?               <    Indicates element is in the
                                                 Primary format.
                   ELEMENT> Last-name       <    Element to be resequenced.
              NEW POSITION> Street-addr     <    New position is before
                                                 this element.
                   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

     RESEQUENCE CATEGORY       * CATEGORY
                              **   ELEMENT
                                   NEW POSITION

     RESEQUENCE CLASS          * CLASS
                              **   ELEMENT
                                   NEW POSITION

     RESEQUENCE FILE           * FILE
                                   PRIMARY/SECONDARY(P/S)?  Issued only if file
                                                          type is KSAM, MPEF, or
                                                          MPER.
                              **   ELEMENT
                                   NEW POSITION

     RESEQUENCE GROUP          * GROUP
                              **   ELEMENT
                                   NEW POSITION

     RESEQUENCE PROCEDURE      * PROCEDURE
                              **   ELEMENT
                                   NEW POSITION

Prompts 

Depending on the subcommand used, one or more of the following prompts is
issued:

CATEGORY                  Enter the name of an existing category in which
                          a data element is to be resequenced (20
                          characters maximum).

CLASS                     Enter the numeric value which identifies an
                          existing security class in which a data element
                          is to be resequenced (0 to 9999).

ELEMENT                   Enter the name of the existing data element
                          which is to be repositioned within the
                          association list (20 characters maximum).

FILE                      Enter the name of an existing file in which a
                          data element is to be resequenced (20
                          characters maximum).

GROUP                     Enter the name of an existing HP Inform group
                          in which a data element is to be resequenced
                          (20 characters maximum).

NEW POSITION              Enter the name of the data element before which
                          the resequenced data element is to be placed.
                          DEFAULT: Pressing [[RETURN]] in response to
                          this prompt places the resequenced data element
                          at the end of the association list.

PRIMARY/SECONDARY (P/S)?  Enter P (or press [[RETURN]]) if the element to
                          be resequenced is in the primary format for the
                          file.  Enter S if the element is in the
                          secondary format.  (See the discussion of the
                          ADD command for more information on primary and
                          secondary formats.)  DEFAULT is P.

PROCEDURE                 Enter the name of an existing procedure in
                          which a data element is to be resequenced (20
                          characters maximum).


MPE/iX 5.0 Documentation