TAA Tools
DLYHLDSPLF      DELAY HOLD SPOOLED FILE                TAASPOW

The Delay Hold  Spooled File command  submits a batch job  to QSYSNOMAX
to run  HLDSPLF after a  delay time of  a specified number  of seconds.
This  allows  a  processing  program  to  perform  functions  while the
spooled file is the READY status.

The spooled file must be in the READY status.

A typical command would be:

             DLYHLDSPLF    SPLF(xxx) DLY(20)

The named spooled file  in the current job  would be held by the  batch
job after a wait of 20 seconds.

If the  spooled file  is not in  the ready status  when the  command is
run,  the  TAA9891 escape  message is  sent.   If  the spooled  file is
non-existent or not in the ready  status when the time delay ends,  the
batch job will fail.

DLYHLDSPLF escape messages you can monitor for
----------------------------------------------

      TAA9891    The spooled file is not in the ready status
      TAA9892    Multiple jobs exist for the requested job
      TAA9895    The job could not be found
      CPF3C40    The spooled file does not exist

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

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

   SPLF          The spooled file name to be held.

   JOB           The  qualified job  name.   An  * is  the default  and
                 means the current job.

   SPLNBR        The  spooled  file  number.    *ONLY  is the  default.
                 *LAST may  be specified  or  a specific  spooled  file
                 number in the range of 000001 - 999999.

   DLY           The delay  time in  seconds.   The default is  60.   A
                 number in the range of 1 to 99999 may be entered.

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

The spooled file must be in the READY status.

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

The following TAA Tools must be on your system:

     ADDTIM          Add time
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVJOBSTS       Retrieve job status
     RTVSPLFA2       Retrieve spooled file attributes 2
     SNDCOMPMSG      Send completion 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
   ------        ----    ---------      ----------    ----------

   DLYHLDSPLF    *CMD                   TAASPOW       QATTCMD
   TAASPOWC      *PGM       CLP         TAASPOWC      QATTCL
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top