The  Compare  User  Space command  allows  a  comparison  of  two  user
spaces.    The first  position  where a  difference  occurs causes  the
command  to end with an error message.   A start position may be named.
Different length  user spaces may  be compared,  but the difference  in
lengths is noted.

A typical command would be:

             CMPUSRSPC  NEWUSRSPC(xxx) OLDUSRSPC(yyy)

If the  data in the user spaces  is identical and the  user spaces have
the same length, a completion message occurs.

If  the data differs, the  first position where  a difference exists is
described in an error message.

If the  length  of  the  two  user spaces  differs,  the  data  to  the
shortest length is  compared.  An error message is  sent describing the
length difference.

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

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

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

   STRPOS        The   start  position  where   the  comparison  should
                 begin.  The default is 1.

                 Using  a  start position  may  be  helpful  to  bypass
                 known differences at a specific location.

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

None.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RTVUSRSPC       Retrieve user space
     RTVUSRSPCA      Retrieve user space attributes
     SNDCOMPMSG      Send completion message
     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
   ------        ----    ---------      ----------    ----------

   CMPUSRSPC     *CMD                   TAASPCM       QATTCMD
   TAASPCMC      *PGM       CLP         TAASPCMC      QATTCL