HP 3000 Manuals

OUTPUT= [ QUERY/V Reference Manual ] MPE/iX 5.0 Documentation


QUERY/V Reference Manual

OUTPUT= 

Selects the output device for the FORM, HELP, DISPLAY, LIST, REPORT, and
VERSION commands.

Syntax 

          {TERM}
O[UTPUT]= {LP  }

For example:

     >OUTPUT=LP

     >O=TERM

Options 

TERM                   indicates that output is to be displayed on the
                       device specified as $STDLIST. ($STDLIST is
                       normally a terminal in session mode and a line
                       printer in job mode).

LP                     indicates that output is to be sent to the file
                       designated as QSLIST. QSLIST is equated to the MPE
                       device class LP (line printer) unless you use an
                       MPE :FILE command to specify otherwise.

Discussion 

The default output device for the commands listed above is $STDLIST
unless you use this command to change it.  You can also use this command
to change the output device back to $STDLIST at any time after setting it
to QSLIST.

If you want to change the device associated with QSLIST while operating
QUERY in session mode, you can use the BREAK key or terminate QUERY to
enter the MPE :FILE command, or you can enter the :FILE command before
running QUERY.

If you are operating in job mode, you can place a :FILE command in your
job preceding the :RUN QUERY command.

All error messages and QUERY prompts are always sent through the $STDLIST
device, regardless of whether OUTPUT=TERM or OUTPUT=LP.

Using the MPE FILE Command 

If you want to associate the QSLIST file with a device other than the
line printer, you must use the MPE :FILE command and then set OUTPUT=LP.
For example:

     :FILE QSLIST;DEV=device type 

Device type is a name referring to a class of devices or a specific
device.  The different device classes and names are set up by the system
manager at the time the MPE operating system is configured.  You must ask
the system manager which name to use for the device you want to associate
with QSLIST.

QUERY will not output a record longer than 136 bytes (characters) even
though the maximum record length for the device may exceed this limit.

The following :FILE command is used to send the output to a magnetic
tape.  In this case, TAPE is the name of the class of devices known as
magnetic tapes.

     :FILE QSLIST;DEV=TAPE

To send output to a disc file, follow the instructions below.

 *  If QSLIST is not a permanent file, you can specify the following file
    command:

         :FILE QSLIST;DEV=DISC

    QUERY will build the new file as an ASCII file with variable length
    records of 136 bytes.  The first byte contains carriage control for
    the file.  If you want to override these defaults you must specify
    what you want in the file equation.  For example, the following will
    create an ASCII file named QSLIST with carriage control and fixed
    length records of 80 bytes.

         :FILE QSLIST;DEV=DISC;REC=-80,,F,ASCII;CCTL

 *  If QSLIST is already a permanent file or you want to send the output
    to a file with a different name, you can specify the following :FILE
    command.  fname is the name of the file you want to create:

         :FILE QSLIST=fname,NEW;DEV=DISC

    If you use the NEW option in a :FILE command and the file already
    exists, QUERY prints the following message:

         QSLIST ALREADY EXISTS, PURGE OLD FILE?

    If you respond with "Y", QUERY overwrites the existing file.  If you
    respond with "N", a file system error message is returned and OUTPUT
    is reset to TERM.

    If you want QUERY to append to an existing file, you must use the
    APPEND option, as shown below.

         :FILE QSLIST=fname,OLD;DEV=DISC;ACC=APPEND

Refer to the MPE Commands Reference Manual for information on using the
FILE command.

Examples 

Example 1 

In this example, QUERY is running in session mode.  QSLIST is equated to
a terminal initially.  When the output device to QSLIST is changed to LP,
the INVENTORY data set is listed on the line printer.  When the output
device is set to the terminal again, the INVENTORY data set is listed on
the terminal.

     >OUTPUT=LP 
     >LIST INVENTORY 
     >O=TERM 
     >LIST INVENTORY 

     STOCK#        ONHANDQTY    SUPPLIER         UNIT-COS    LASTSH   BIN

     6650D22S           5306    ACME WIDGET          1427    120385    3
     2457A11C       11001345    ACME WIDGET          5031    120185    1
     3586T14Y            144    CARDINAL MILLS        249    112085    2

Example 2 

The next example illustrates the method for sending output to a tape
device.  In this case, a procedure from the Proc-file is listed first on
the terminal and then on a tape.  The BREAK key is used to return to MPE.
QSLIST is equated to a magnetic tape device.  QUERY execution is resumed
and the output device is changed to QSLIST. The procedure is written to
the QSLIST device and the output device is set to the terminal again.

     >DISPLAY FNAMES 

     PROCEDURE: FNAMES

     001   FIND LAST-NAME="" END

     >BREAK 
     :FILE QSLIST;DEV=TAPE 
     :RESUME 
     READ pending
     RETURN 
     >OUTPUT=LP 
     >DISPLAY FNAMES 
     >OUTPUT=TERM 

Example 3 

In this example, one entry is retrieved with the FIND command, and is
displayed with the REPORT ALL command.  Next, the BREAK key is used to
temporarily return to the operating system.  The FILE command redirects
QSLIST to a disc file named SAVER which QUERY creates.  QUERY execution
is resumed.  Finally, the OUTPUT=LP and REPORT ALL commands are used to
write data to the SAVER file.

     >FIND CUSTOMER.LAST-NAME IS CORCORAN END 
     USING SERIAL READ
     1  ENTRIES QUALIFIED
     >REPORT ALL 

     ACCOUNT         =54283540
     LAST-NAME       =CORCORAN
     FIRST-NAME      =CLIFFORD
     INITIAL         =C
     STREET-ADDRESS  =6105 VALLEY GREEN DR.
     CITY            =CARMEL
     STATE           =CA
     ZIP             =93921
     CREDIT-RATING   = 7.10000

     >BREAK 
     :FILE QSLIST=SAVER,NEW;DEV=DISC 
     :RESUME 
     READ pending
     RETURN 
     >OUTPUT=LP 
     >REPORT ALL 
     >



MPE/iX 5.0 Documentation