The Display User Space  command is a debugging aid that  is useful when
working with  the API functions  that operate with user  spaces or your
own application needs.

The  command is also  helpful when attempting  to understand the makeup
of user spaces.

A typical command is entered as:

        DSPUSRSPC     USRSPC(QTEMP/SPACE1)

Each display shows  320 bytes.   Rollup and  rolldown are supported  as
well as a  start position and scan value.  The  maximum size User Space
is supported.

Use  the offset  plus  the position  within the  data to  determine the
byte location in the user space.

If the User Space contains a list  (from a list type API), the F11  key
may be used  to display information about  the list.  Entering  a value
of *NXTENT  into the scan value and using F16  to scan will position to
the next entry in the list.

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

   USRSPC        The  qualified   name  of   the  user   space  to   be
                 displayed.  The library defaults to *LIBL.

   STRPOS        The position in  the user space to begin  the display.
                 The default  is 1.   The value may also  be entered on
                 the interactive display.

   OUTPUT        Whether  to  display or  print the  value.   *  is the
                 default which causes a  display if the command  is run
                 interactively.

                 *PRINT may be used to cause printed output.

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

None.

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

The following TAA Tools must be on your system:

     CVTDSPDTA    Convert display data
     CVTHEX       Convert hex
     SCNUSRSPC    Scan user space

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

None, the tool is ready to use.

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

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

   DSPUSRSPC     *CMD                       TAASPCD       QATTCMD
   TAASPCDC      *PGM           CLP         TAASPCDC      QATTCL
   TAASPCDD      *FILE          DSPF        TAASPCDD      QATTDDS