The Check  Active User command  returns variables with  a count of  how
many interactive  and batch jobs are active for  a user.  The qualified
job information for the oldest job of each type is also available.

If no jobs are active, CPF9898 is sent as an escape message.

A typical series of commands would be:

          DCL          &INTJOBS *DEC LEN(5 0)
           .
          CHKACTUSR    USER(xxx) INTJOBS(&INTJOBS)
          MONMSG       MSGID(CPF9898) EXEC(DO) /* None active */
           .
           .               /* Processing for no jobs active */
           .
          ENDDO        /* None active */
          IF           (&INTJOBS *GT 0) DO /* Interactive active */
           .
           .               /* Processing for at least one active */
           .
          ENDDO        /* Interactive active */

If  you do not have  *JOBCTL special authority, you  can only check the
status of your own USER name.

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

   USER          The user name to be checked for active jobs.

   INTJOBS       An optional  return  variable  that will  contain  the
                 number  of interactive  active jobs.   This  means the
                 user  is signed on to some  device.  If specified, the
                 variable must be declared as *DEC LEN(5 0).

                 Group Jobs and System Request Jobs also count.

   BCHJOBS       An optional  return  variable that  will  contain  the
                 number  of  batch  active  jobs.   If  specified,  the
                 variable must be declared as *DEC LEN(5 0).

   FSTINTJOB     An  optional  return variable  that  will  contain the
                 name of the  oldest active interactive  job name.   If
                 specified,  the variable  must  be declared  as  *CHAR
                 LEN(10).

   FSTINTJOBN    An  optional  return variable  that  will contain  the
                 name  of  the  oldest active  interactive  job number.
                 If specified, the  variable must be declared  as *CHAR
                 LEN(6).

   FSTBCHJOB     An  optional return  variable  that  will contain  the
                 name  of  the  oldest  active  batch  job  name.    If
                 specified, the  variable  must be  declared  as  *CHAR
                 LEN(10).

   FSTBCHJOBN    An  optional return  variable  that  will contain  the
                 name  of  the  oldest active  batch  job  number.   If
                 specified, the  variable  must be  declared  as  *CHAR
                 LEN(6).

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

If you do  not have *JOBCTL special  authority, you can only  check the
status of your own user name.

Because  the command returns  variables, it  can only  be used in  a CL
program.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check job control
     CVTWRKUSR       Convert work user

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

None, the tool is ready to use.

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

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

   CHKACTUSR     *CMD                   TAAJOBZ       QATTCMD
   TAAJOBZC      *PGM       CLP         TAAJOBZC      QATTCL