HP 3000 Manuals

PERFORM COMMANDS [ DBChange Plus User's Guide ] MPE/iX 5.0 Documentation


DBChange Plus User's Guide

PERFORM COMMANDS 

Invokes the DBAPLUS program to copy, restructure, check, or maintain the
database depending on the commands stored in the current change file.

Syntax 

     PE[RFORM] COM[MANDS] [JOB] [ ParmValue]

Parameters 

JOB                   creates a job file ( DatabaseNameJJ) to enable
                      running the DBAPLUS program at a later time.

                      For batch mode, this parameter is required.  In
                      session mode, if you omit this option, DBChange
                      asks you if changes should be performed online or
                      if a job stream file should be created.

ParmValue             is a parameter value from 0 to 15 that provides
                      instructions to DBAPLUS during execution.  This
                      option is required for batch mode or if the JOB
                      parameter is used.  In session mode, if you omit
                      this option, you are prompted for any necessary Y
                      or N responses.

                      PARM values can be determined by adding them
                      together.  For example, if you want both PARM=1 and
                      PARM=4 to take effect, add them together and
                      specify PARM=5.  Table 10-4 lists the questions
                      DBAPLUS may need answers to about parameter values.

Description 

Use PERFORM COMMANDS to invoke DBAPLUS to copy, restructure, check, or
maintain the database according to the deferred commands stored in the
current change file.  PERFORM COMMANDS should be the last command used
before the EXIT command or before the next BASE command if multiple
databases are being restructured.

In session mode, DBChange asks if changes should be performed online or
if a job stream file should be created.  If you request a job stream file
to be created, DBChange creates FileNameJJ, which you can later modify
and stream.  Note that the larger the database, the longer DBAPLUS takes
to perform the restructure.  Therefore, depending on the size of the
database, you may want to create a batch job.

In batch mode, PERFORM COMMANDS only takes effect if the change file has
no errors.  If errors are encountered since the most recent BASE command,
a message stating that the commands cannot be performed because previous
errors were encountered is displayed.

Refer to chapter 9, "Applying Changes to the Database Structure," for
more information about the DBAPLUS program.

          Table 10-4.  DBAPLUS Parameters 

---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|  PARM  | You do not have enough   | The database    | Your root file is   | The change file is  |
| Value  | disk space to build all  | has been        | not in normal       | normally purged     |
|        | necessary temporary data | modified since  | DBSCHEMA format.    | after successful    |
|        | sets before beginning    | the last        | Do you want DBAPLUS | completion of       |
|        | the restructure.  Do you | DBSTORE. Do you | to fix it and       | DBAPLUS. Do you     |
|        | want DBAPLUS to continue | wish to         | continue with the   | want to save the    |
|        | with the restructure     | continue?       | restructure?        | change file?        |
|        | using an alternative     |                 |                     |                     |
|        | restructuring method?    |                 |                     |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   1    |                          |                 |                     |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   2    |                          |                 |          Y          |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   3    |                          |                 |          Y          |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   4    |                          |        Y        |                     |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   5    |                          |        Y        |                     |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   6    |                          |        Y        |          Y          |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   7    |                          |        Y        |          Y          |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   8    |            Y             |                 |                     |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   9    |            Y             |                 |                     |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   10   |            Y             |                 |          Y          |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   11   |            Y             |                 |          Y          |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   12   |            Y             |        Y        |                     |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   13   |            Y             |        Y        |                     |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   14   |            Y             |        Y        |          Y          |                     |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------
|        |                          |                 |                     |                     |
|   15   |            Y             |        Y        |          Y          |          Y          |
|        |                          |                 |                     |                     |
---------------------------------------------------------------------------------------------------

Example 

     >base orders 

     >fix base 
      Fix Base (Fix Root, Fix Set and Fix Path) issued for 6 set(s).

     >perform commands 

      PERFORM COMMANDS now or create job file [job/y/N]? y 

      Please wait ...
     HP36386 (A.00.00) DBALTER  (c) COPYRIGHT Hewlett-Packard Co. 1985
     THU, JAN 18, 1990,  7:15 AM

     Database has been modified since last DBSTORE (DBA 220).
     Continue [y/N] ? y 

     HP36386 (X.00.02) DBCHANGE  (c) COPYRIGHT Hewlett-Packard Co. 1985

     >

In this example, the BASE command is issued for the ORDERS database.  The
FIX BASE command is issued, followed by PERFORM COMMANDS. DBChange asks
if changes should be performed online or if a job stream file should be
created.  Because the database has been modified since the last DBSTORE,
DBAPLUS asks if you want to continue.  When the database has been
successfully fixed, the DBChange prompt is returned.



MPE/iX 5.0 Documentation