TAA Tools
CHKJOBENDS      CHECK JOB END STATUS                   TAATIMX

The Check Job  End Status command is  intended for batch jobs  that are
waiting for a  delay time and periodically need to  check if an End Job
or   End   Subsystem  command   has  issued   a  controlled   cancel  -
OPTION(*CNTRLD).   CHKJOBENDS allows  a  periodic wakeup  with a  total
time specified.   The  escape message TAA9891  is sent if  a controlled
cancel has been requested.

A typical series of commands would be:

             CHKJOBENDS TOTTIM(300) FREQ(20)
             MONMSG     MSGID(TAA9891) EXEC(DO)
                        /*                                     */
                        /* Your code for a controlled cancel   */
                        /*                                     */
             ENDDO

CHKJOBENDS  would wakeup  every 20 seconds  and check  for a controlled
cancel.

If a controlled  cancel did not occur,  the command completes  normally
after 300 seconds.

If a controlled  cancel did occur, TAA9891  would be sent as  an escape
message.

CHKJOBENDS escape messages you can monitor for
----------------------------------------------

      TAA9891    A controlled cancel has been issued

Escape messages from based on functions will be re-sent.

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

   TOTTIM        The total  time in seconds to  wait before the command
                 completes normally  if  a controlled  cancel  has  not
                 been issued.

   FREQ          The  frequency  in seconds  that  the  command  should
                 check   to   determine   if   an  ENDJOB   or   ENDSBS
                 OPTION(*CNTRLD) has been specified.

                 It  is  not a  requirement that  the  FREQ be  an even
                 multiple  of  the  TOTTIM  value.    For  example,  if
                 TOTTIM is  50 seconds and  FREQ is 30, there  would be
                 a  delay  of 30  seconds before  checking  and another
                 delay of 20 seconds.

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

None.

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

The following TAA Tools must be on your system:

     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
   ------        ----    ---------      ----------    ----------

   CHKJOBENDS    *CMD                   TAATIMX       QATTCMD
   TAATIMXC      *PGM       CLP         TAATIMXC      QATTCL
					

Added to TAA Productivity tools March 26, 2007


Home Page Up to Top