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
|