The Change User Space command allows you to change the contents of a
user space. A maximum of 5000 bytes can be changed on a single
command. A start position must be named and an optional length.
A typical command would be:
CHGUSRSPC USRSPC(xxx) VALUE(...)
The default for the position to start the change is 1.
The default for the length is *LASTNONBLK which means that the last
non-blank is found in the VALUE and this determines the length of the
change.
If a length is specified, it must be equal to or greater than the
number of bytes defined by the last non-blank in the data. For
example, if VALUE(ABCDEGH) is specified, you cannot specify
LENGTH(4). The length would have to be 7 or greater.
If the length specified exceeds the length of the value (as defined
by the last non-blank), the excess bytes will be set to blanks in the
User Space.
You may optionally initialize the remaining bytes following the
change to the initial value specified when the user space was created
(the value may be changed by an API). You may see the initial value
with the DSPUSRSPCA TAA command.
If the following command was run:
CHGUSRSPC USRSPC(xxx) VALUE('TAA Tools are great')
The command would cause a change beginning in position 1 through
position 19 (the length of the VALUE data as defined by the last
non-blank). By default, no other bytes in the User Space would be
changed.
Using the PAD parameter as:
CHGUSRSPC USRSPC(xxx) VALUE('TAA Tools are great')
PAD(*YES)
would cause positions 1 - 19 to be changed to the VALUE data.
Positions 20 through the end of the User Space would be changed to
the initial value as defined for the User Space.
If the following command was run:
CHGUSRSPC USRSPC(xxx) VALUE('TAA Tools are great')
LENGTH(25) PAD(*YES)
Bytes 1 - 19 would contain the VALUE data. Bytes 20 - 25 would be
set to blanks. Positions 26 through the end of the User Space would
be set to the initial value as defined for the User Space.
Command parameters *CMD
------------------
USRSPC The qualified name of the User Space. The library
value defaults to *LIBL. *CURLIB may also be used.
VALUE The data to be placed into the User Space. Up to
5000 bytes may be entered.
The length of the data is determined by the last-non
blank found. This length cannot exceed the length
specified for the LENGTH parameter.
If the value specified for the LENGTH parameter
exceeds the length of the data, the remaining bytes
of the length will be set to blanks.
STRPOS The position to begin the change in the User Space.
The default is 1.
The length to be changed cannot exceed the internal
size of the User Space.
LENGTH The length of the data to be changed. The default
is *LASTNONBLK which means the VALUE data is
searched from the right for the last non-blank
character. This determines the number of bytes that
will be changed in the User Space.
A specific value may be entered. See the discussion
with the VALUE parameter.
PAD A *YES/*NO value for whether to pad out the
remainder of the User Space with the initial value
as defined for the User Space. This value can be
displayed with the DSPUSRSPCA TAA command.
The default is *NO which means that only the bytes
defined by the LENGTH parameter will be changed in
the User Space.
*YES may be specified to pad out the remainder of
the User Space with the initial value. This occurs
for the bytes after those changed by the LENGTH
parameter.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
EDTVAR Edit variable
RTVUSRSPCA Retrieve user space attributes
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
------ ---- --------- ---------- ----------
CHGUSRSPC *CMD TAASPCI QATTCMD
TAASPCIC *PGM CLP TAASPCIC QATTCL
|
