The Retrieve  Spooled File Information  command provides a  fast method
of determining the  number of spooled files for one  or all users.  The
QSPSPLI API is used.

You must have *ALLOBJ special authority to use RTVSPLFINF.

A typical series of commands would be:

             DCL         &NBRSPLFS *DEC LEN(9 0)
              .
             RTVSPLFINF  USER(aaa) NBRSPLFS(&NBRSPLFS)

The  number of  spooled files  that exist for  the named  user would be
retrieved.

RTVSPLFINF escape messages you can monitor for
----------------------------------------------

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

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

   USER          The user  to retrieve  spooled  file information  for.
                 A specific  user name must  be entered or  the special
                 values *CURRENT or *ALL.

   ASP           The  name  of  the  Auxiliary  Storage  pool  group to
                 retrieve information  for.   *SYSBAS is  the  default.
                 *CURASPGRP may be entered.

   NBRSPLFS      The number of  spooled files that exist  for the named
                 user.   This is a required  return parameter that must
                 be specified as *DEC LEN(9 0).


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

Because RTVSPLFINF returns  a variable,  the command may  only be  used
in a CL program.

You must have *ALLOBJ special authority to use RTVSPLFINF.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     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
   ------        ----    ---------      ----------    ----------

   RTVSPLFINF    *CMD                   TAASPPK       QATTCMD
   TAASPPKC      *PGM       CLP         TAASPPKC      QATTCL