TAA Tools
EDTUSRSPC       EDIT USER SPACE                        TAASPCV

The Edit User Space command  allows data to be written or  changed in a
user space.   An option on  the command allows editing  in character or
hex  mode.    EDTUSRSPC provides  a  convenient method  of  storing and
maintaining data in  a user  space object or  making changes when  data
is written to a user space by another function.

A typical command would be:

             EDTUSRSPC  USRSPC(xxx)

By default,  a display would appear  in 'character' mode.   There would
be  16 lines  of 60  bytes each.   Each line  is considered  a separate
field  on the  display.    Only  displayable  characters  would  appear
(non-displayable will appear as blanks).

A 'start position' may  be named to position the  display to a specific
location.    The offset  shown  will  be one  less  than  the requested
position.  The bar will describe the exact location.

For  example,  when  the  display  first  appears  after  entering  the
command, the  first offset is 0.   The first  position shown is  byte 1
of the  user space.   The bar describes  positions 1-60.   To determine
the  exact location of a  byte you see, add the  offset to the position
on the bar.

A scan  may occur  by entering  a scan  value and  using F16.   If  the
value  is  found,  the  display  will  be positioned  to  the  60  byte
boundary where  the value exists.  The data  will be on the first line,
but may not  begin in position 1.   If another  scan is requested,  the
scan begins on the next 60 byte boundary.

Hex mode
--------

Hex mode is described by entering the command as:

             EDTUSRSPC  USRSPC(xxx) TYPE(*HEX)

The display appears with  16 lines of 20 bytes.  EBCDIC  values will be
on the  left and the hex values on the right.   Only the hex values may
be changed.  The EBCDIC values will display if valid.

Valid hex data (0-9, A-F) may be  entered.  When Enter is pressed,  the
display re-appears with updated values.

As with  *CHAR  mode, a  start position  may  be entered.   The  offset
shown will  be one less  than the requested  position.  The  offset bar
will describe the exact location.

A  scan may  occur by  entering a  scan value  and using  F16.   If the
value  is  found, the  display  will  be  positioned  to  the  20  byte
boundary where the  value exists.  The data will be  on the first line,
but  may not begin  in position 1.   If another scan  is requested, the
scan begins on the next 20 byte boundary.

EDTUSRSPC escape messages you can monitor for
---------------------------------------------

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

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

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

   TYPE          The  type of editing  to be  performed.  *CHAR  is the
                 default to edit in character mode.

                 *HEX may be entered to edit in hex mode.


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

None.

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

The following TAA Tools must be on your system:

     CHGUSRSPC       Change user space
     CHKHEX          Check hex
     CHKOBJ3         Check object 3
     CVTDSPDTA       Convert display data
     CVTFRMHEX       Convert from hex
     CVTHEX          Convert hex
     DSPHEX          Display hex
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVUSRSPCA      Retrieve user space attributes
     SNDCOMPMSG      Send completion message
     SCNUSRSPC       Scan user space
     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
   ------        ----    ---------      ----------    ----------

   EDTUSRSPC     *CMD                   TAASPCV       QATTCMD
   TAASPCVC      *PGM       CLP         TAASPCVC      QATTCL
   TAASPCVD      *FILE      DSPF        TAASPCVD      QATTDDS
					

Added to TAA Productivity tools July 15, 2011


Home Page Up to Top