TAA Tools
CHKUSRSPC       CHECK USER SPACE                       TAASPCE

The Check User  Space command is intended  to be used after a  list API
writes  data  into a  user  space.   CHKUSRSPC  checks the  Information
Status  byte to  ensure that  the data  is completely  contained within
the user space.  This is  intended for CL programs that use a  list API
which  may write more  than 16  MB of  data and is  not handled  by the
program.

Prior  to the  use of CHKUSRSPC,  you would  have created  a user space
and used  an  API  such  as  QUSLSPL  to fill  the  user  space.    The
Information Status placed  in the user space will  describe whether the
information is complete.  A typical CHKUSRSPC command would be:

             CHKUSRSPC    USRSPC(xxx)

  **   If   the  Information  Status  is   C  (Complete),  the  command
       completes normally.

  **   If the Information  Status is  P (Partial), TAA9893  is sent  as
       an escape message.

  **   If the  Information Status  is I  (Incomplete), TAA9894 is  sent
       as an escape message.

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

   USRSPC        The  qualified name of  the user  space.   The library
                 value  defaults to *LIBL.   *CURLIB may  also be used.

   ERRTXT        The error text  to be sent  if the Information  Status
                 is not  a 'C'.  The  default is *STD which  means that
                 standard text is sent explaining the error.

   TAAUSE        A  *YES/*NO value  for whether  the command  is called
                 as a sub tool from another TAA command.

                 *NO is the  default and  should be  used when  invoked
                 directly or by a user program.

                 *YES may  be specified when  another TAA  Tool command
                 is the high level interface.

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

None.

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

The following TAA Tools must be on your system:

     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CHKUSRSPC     *CMD                   TAASPCE       QATTCMD
   TAASPCEC      *PGM       CLP         TAASPCEC      QATTCL
					

Added to TAA Productivity tools November 1, 1997


Home Page Up to Top