Note: From  a  performance viewpoint,  you are  better off  to use  the
%BIN  function in a  CL program.   The ADDBIN4  command is left  in the
TAA Tools for compatibility reasons.

The  Add Binary 4 command allows you to  add to binary 4 numbers into a
3rd value.  All variables must be defined as *CHAR LEN(4).

A typical command is entered as:

        ADDBIN4       BIN1(&BIN1) BIN2(&BIN2) RESULT(&BIN3)

The command  is designed  to work  with the  APIs that  work with  user
spaces.

Command parameters                                    *CMD
------------------

   BIN1          The  first binary variable.   It  must be  declared as
                 *CHAR LEN(4).

   BIN2          The  second binary variable.   It must  be declared as
                 *CHAR LEN(4).

   RESULT        The result binary  variable.  It  must be declared  as
                 *CHAR LEN(4).   It  can be a  unique variable  name or
                 one  of the  same names  as used by  the BIN1  or BIN2
                 parameters.

   SETLR         This is an *ON/*OFF value  that defaults to *OFF.   It
                 controls  the  setting  of  LR   when  the  processing
                 program  returns.    The  *ON  value causes  a  normal
                 completion  where  the  program is  deactivated.   The
                 *OFF setting is  used as the  default as most uses  of
                 ADDBIN4  are often  repeated  and  this allows  faster
                 results.

                 When  the processing program is  no longer needed, the
                 SETLR(*ON) value should be specified or RCLRSC.

                 When  SETLR(*YES)  is  specified,  the  program   will
                 perform  the   ADDBIN4  function  and  then   end  the
                 program with LR on.

Restrictions
------------

Because  ADDBIN4 has a  return variable, it  can only be  executed in a
CL program.

Prerequisites
-------------

None.

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type        Attribute      Src member    Src file
   ------        ----        ---------      ----------    ----------

   ADDBIN4       *CMD                       TAABINE       QATTCMD
   TAABINER      *PGM           RPG         TAABINER      QATTRPG

Note that there  is no CL program.   The RPGLE  program is the  command
processing program.