CHKUSRSPC CHECK USER SPACE TAASPCE |
The Check User Space command is intended to be used after a list API
writes data into a user space. CHKUSRSPC checks the Information
Status byte to ensure that the data is completely contained within
the user space. This is intended for CL programs that use a list API
which may write more than 16 MB of data and is not handled by the
program.
Prior to the use of CHKUSRSPC, you would have created a user space
and used an API such as QUSLSPL to fill the user space. The
Information Status placed in the user space will describe whether the
information is complete. A typical CHKUSRSPC command would be:
CHKUSRSPC USRSPC(xxx)
** If the Information Status is C (Complete), the command
completes normally.
** If the Information Status is P (Partial), TAA9893 is sent as
an escape message.
** If the Information Status is I (Incomplete), TAA9894 is sent
as an escape message.
Command parameters *CMD
------------------
USRSPC The qualified name of the user space. The library
value defaults to *LIBL. *CURLIB may also be used.
ERRTXT The error text to be sent if the Information Status
is not a 'C'. The default is *STD which means that
standard text is sent explaining the error.
TAAUSE A *YES/*NO value for whether the command is called
as a sub tool from another TAA command.
*NO is the default and should be used when invoked
directly or by a user program.
*YES may be specified when another TAA Tool command
is the high level interface.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
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
------ ---- --------- ---------- ----------
CHKUSRSPC *CMD TAASPCE QATTCMD
TAASPCEC *PGM CLP TAASPCEC QATTCL
|
Added to TAA Productivity tools November 1, 1997