HP 3000 Manuals

Using IMAGE/SQL Utility Command Files [ Getting Started with HP IMAGE/SQL ] MPE/iX 5.0 Documentation


Getting Started with HP IMAGE/SQL

Using IMAGE/SQL Utility Command Files 

This task describes how to execute an IMAGE/SQL utility command file in
interactive or batch mode.

Getting Ready 

An IMAGE/SQL utility command file can be created with a text editor or
can be produced as part of the logging process (see Task Reference).  If
you create or edit this file with an editor, note that it must be kept
unnumbered.

In the following examples, the file UPDATYPE contains the following
commands:
_____________________________________________________
|                                                   |
|     SET TURBODB MUSIC.PUB.TURBONM                 |
|     SET SQLDBE MUSICDBE.PUB.TURBONM               |
|     UPDATE TYPE IN ALBUMS.DATERECORDED to CHAR(20)|
|     EXIT                                          |
_____________________________________________________

            

Note that the commands in this command file assume the TurboIMAGE/XL
database is already attached to the DBEnvironment.

If you wish to see commands and comments as the command file is executed,
make sure the ECHO option is on (see Task Reference).

Performing the Task 

The XEQ command allows you to specify a file containing IMAGE/SQL utility
commands as its parameter.  To interactively execute commands listed in a
command file, run the IMAGE/SQL utility by typing RUN IMAGESQL.PUB.SYS 
and then issue the XEQ command.  Note that in this example ECHO is off.
______________________________________________________________________________________
|                                                                                    |
|     :RUN IMAGESQL.PUB.SYS                                                          |
|                                                                                    |
|     HP36385 B.F0.10            IMAGE/SQL Utility        FRI, DEC 18, 1992, 11:30 AM|
|     (C) COPYRIGHT HEWLETT-PACKARD COMPANY 1992                                     |
|                                                                                    |
|     >>XEQ UPDATYPE                                                                 |
|     Updated information in table ALBUMS.                                           |
|     :                                                                              |
______________________________________________________________________________________

            

The MUSIC database, previously attached to the MusicDBE DBEnvironment,
and data type mapping information has been updated for the
ALBUMS.DATERECORDED column of the ALBUMS table.

You can also issue XEQ commands in batch mode.  The following job stream
file contains XEQ commands that execute the commands in the UPDATYPE
file.
________________________________________________________________________________
|                                                                              |
|     !job JIMAGESQL,USER2/KEVIN.ATC/MGR,PUB/ALL                               |
|     !comment**************************************************************   |
|     !comment*      This job executes an IMAGE/SQL command file.              |
|     !comment**************************************************************   |
|     !                                                                        |
|     !tell USER2.ATC;   /-->Start JIMAGESQL for MUSIC                         |
|     !                                                                        |
|     !run IMAGESQL.PUB.SYS                                                    |
|     !                                                                        |
|     !comment**************************************************************   |
|     !comment*      The UPDATYPE command file contains commands that SET      |
|     !comment*      the MUSIC database and the MusicDBE DBEnvironment.        |
|     !comment*      It then specifies alternative data type mapping for source|
|     !comment*      data set fields and exits the IMAGE/SQL Utility.          |
|     !comment**************************************************************   |
|     !                                                                        |
|     XEQ UPDATYPE                                                             |
|     !                                                                        |
|     !tell USER2.ATC;   /-->End JIMAGESQL for MUSIC                           |
|     !                                                                        |
|     !eoj                                                                     |
________________________________________________________________________________

            

Note that in batch mode, if an error occurs, the job terminates.  The
remaining commands are flushed.

Task Reference 

   *   An IMAGE/SQL command file is an unnumbered file containing a list
       of IMAGE/SQL commands.  If commands span more than one line, use
       an ampersand (&) to continue the command to the next line.

   *   The section "Logging IMAGE/SQL Utility Commands" shows how to use
       the IMAGE/SQL utility logging facility to create and save files
       containing often-issued IMAGE/SQL utility commands.

   *   For the syntax of the ECHO command, refer to the HP IMAGE/SQL 
       Administration Guide.



MPE/iX 5.0 Documentation