TAA Tools
CVTPRTSTS       CONVERT PRINTER STATUS                 TAAPRTJ

The  Convert Printer  Status command  converts  the status  information
for all  or generic printers to  an outfile.  This  includes the output
queue  associated with  the printer and  the status of  both the writer
and the  output queue.   The outfile  is always PRTSTSP  with a  format
name of  PRTSTSR.   The model file  is TAAPRTJP.   The API  QGYRPRTL is
used along with the TAA Tool RTVDEVPRT.

You must have *JOBCTL special authority to use CVTPRTSTS.

A typical command would be:

             CVTPRTSTS    OUTLIB(QTEMP)

One  record would  be written  for each printer  device to  the PRTSTSP
file in QTEMP.

CVTPRTSTS escape messages you can monitor for
---------------------------------------------

      TAA9893    No printer exists for the specified PRTDEV parm.

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

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

   PRTDEV        The  name  or  generic  name  of  the  printer  to  be
                 converted.  *ALL is the default for all printers.

   OUTLIB        The  library  to output  the  PRTSTSP  file to.    The
                 default  is  *LIBL  which  may  only  be used  if  the
                 PRTSTSP file may  be found  on the library  list.   If
                 the file does not exist, a library must be named.

   OUTMBR        The  member  to  be  written  to.     The  default  is
                 PRTSTSP.

   REPLACE       A *YES/*NO  parameter for whether to  replace the data
                 in  the outfile.   The  default is  *YES.  *NO  may be
                 specified to add to the existing data.


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

You must have *JOBCTL special authority to use CVTPRTSTS.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RTVDEVPRT       Retrieve device printer
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CVTPRTSTS     *CMD                   TAAPRTJ       QATTCMD
   TAAPRTJC      *PGM       CLP         TAAPRTJC      QATTCL
   TAAPRTJC2     *PGM       CLP         TAAPRTJC2     QATTCL
   TAAPRTJR      *PGM       RPG         TAAPRTJR      QATTRPG
   TAAPRTJP      *FILE      PF          TAAPRTJP      QATTDDS
					

Added to TAA Productivity tools October 15, 2008


Home Page Up to Top