CBL_AND

CBL_AND performs a binary, bitwise "and" operation on a series of bytes.

Usage

CALL "CBL_AND"
    USING SOURCE, DEST, LENGTH
    GIVING STATUS

Parameters

SOURCE PIC X(n) The source bytes for the operation.
DEST PIC X(n) The destination bytes for the operation.
LENGTH Numeric parameter (optional)    The number of bytes to combine. If omitted, then CBL_AND uses the minimum of the size of SOURCE and the size of DEST.
STATUS Any numeric data item The return status of the operation. Returns 0 if successful, 1 if not. This routine always succeeds, so STATUS always contains a zero.

Description

For LENGTH bytes, each byte of SOURCE is combined with the corresponding byte of DEST. The result is stored back into DEST. The bytes are combined by performing an "and" operation between each bit of the bytes. The "and" operation uses the following table to determine the result:

And    0    1   
0 0 0
1 0 1