The Retrieve  Printer Override  command retrieves  the override  values
assigned to  a printer file.   The OVRPRTF command is passed  back in a
large variable.  Restrictions exist.

RTVPRTOVR  reads  the  spooled file  created  by DSPOVR.    The command
requires an upper/lower case English language system.

A typical series of commands would be:

             DCL           &CMD *CHAR LEN(3000)
              .
             RTVPRTOVR     FILE(xxx) TOFILE(yyy) CMD(&CMD)
             CALL          QCMDEXC PARM(&CMD 3000)

Note that the  &CMD value  being returned is  an OVRPRTF command  ready
to  be run  using QCMDEXC.   This  allows you  to make  changes  in the
command string before executing the command.

Non-supported OVRPRTF parameters
--------------------------------

        CHANNEL
        FNTCHRSET
        CDEFNT
        PAGDFN
        FORMDF
        AFPCHARS
        FRONTOVL
        BACKOVL
        USRRSCLIBL
        EDGESTITCH
        SADLSTITCH
        USRDFNOPT     (first value is supported)
        USRDFNDTA     (first 36 characters are retrieved)
        IGCCDEFNT

RTVPRTOVR escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   FILE          The  name  of the  printer file  to  retrieve override
                 values for.

   TOFILE        The qualified name  of the  To file  to be  overridden
                 to.     The  library  qualifier  defaults   to  *LIBL.
                 *CURLIB or a specific library may be named.

   MRGOVR        A  *YES/*NO  value  for  whether  to merge  overrides.
                 *YES is  the default.   For  a full  explanation,  see
                 the same parameter on DSPOVR.

   LVL           The call level  to be considered.   * is  the default.
                 *JOB may  be specified.   For a full  explanation, see
                 the same parameter on DSPOVR.

   ACTGRP        The  activation  group to  be  considered.   *  is the
                 default.   A specific activation  group may be  named.
                 For  a full  explanation,  see the  same parameter  on
                 DSPOVR.

   CMD           The  command to be  returned.  This  must be specified
                 as *CHAR LEN(3000).

Restrictions
------------

See the section on 'Non-supported parameters'.

RTVPRTOVR reads  the  spooled file  created  by  DSPOVR.   The  command
requires an upper/lower case English language system.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKAPOST        Check apostrophe
     RSNLSTMSG       Resend last message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RTVPRTOVR     *CMD                   TAAPRTH       QATTCMD
   TAAPRTHC      *PGM       CLP         TAAPRTHC      QATTCL