CHKBIT CHECK BIT TAACLTM |
The Check Bit command checks one or more bits in a byte for an on or
off value ('1' or '0'). The bit positions are labeled 1-8 with 1
being the high order bit. TAA9892 is sent if the bits do not match
the requested values.
A typical command would be:
CHKBIT BYTE(&BYTE) BIT1(*ON) BIT3(*OFF)
If Bit 1 is not '1' or Bit 3 is not '0', the TAA9892 escape message
is sent. Preceding diagnostic message describe each bit that is not
set as requested. The bits that are not described default to *ANY
meaning they may have any value.
If all bits are set as requested, the command completes normally
without any messages.
CHKBIT escape messages you can monitor for
-------------------------------------------
TAA9892 The bits do match as requested.
Escape messages from based on functions will be re-sent.
CHKBIT Command parameters *CMD
-------------------------
BYTE A required *CHAR LEN(1) value for the byte to be
checked. A variable may be used. When command
prompting is used, you can expand the length of the
input field by entering & and pressing Enter.
BIT1 The value to be matched for Bit 1 (high order).
*ANY is the default meaning the value may be '1' or
'0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT2 The value to be matched for Bit 2. *ANY is the
default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT3 The value to be matched for Bit 3. *ANY is the
default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT4 The value to be matched for Bit 4. *ANY is the
default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT5 The value to be matched for Bit 5. *ANY is the
default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT6 The value to be matched for Bit 6. *ANY is the
default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT7 The value to be matched for Bit 7. *ANY is the
default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
BIT8 The value to be matched for Bit 8 (low order). *ANY
is the default meaning the value may be '1' or '0'.
*ON may be specified to check for '1'.
*OFF may be specified to check for '0'.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CVTBYTBIT Convert byte to bits
SNDDIAGMSG Send diagnostic message
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
------ ---- --------- ---------- ----------
CHKBIT *CMD TAACLTM QATTCMD
TAACLTMC *PGM CLP TAACLTMC QATTCL
|
Added to TAA Productivity tools January 15, 2011