TAA Tools
DSPTIMADJ       DISPLAY TIME ADJUSTMENT                TAATINW

The  Display   Time   Adjustment  command   displays  the   information
regarding a  time adjustment.  See the TAA  command ADJTIM for a method
of  changing  the time  of  day clock  forward  or backward  n seconds.
DSPTIMADJ displays the  information of whether  an adjustment is  being
made and  if so  how much  time is needed  to complete  the adjustment.
The RTVTIMADJ command is also included which uses the QWCRTVTM API.

When  a  time  adjustment  is  made,  the  system  performs the  action
gradually  over  a   time  period   rather  than   changing  the   time
immediately as would be done by changing the QTIME system value.

A typical DSPTIMADJ command would be:

             DSPTIMADJ

If a time adjustment  is in process, the display  will describe that it
is  *ACTIVE, the  direction of  the adjustment  (*PLUS or  *MINUS), the
number of  seconds of  the adjustment,  and the  time to  complete  the
adjustment.   Both  the number  of seconds  of the  adjustment and  the
time  to  complete  the  adjustment  change  as  the  system  gradually
adjusts  the time (the original information  used to adjust the time is
not  displayed).   The  F5  command key  may  be  used to  refresh  the
information so you can see the progress.

Retrieve Time Adjustment
------------------------

Also included in  the DSPTIMADJ tool is the  RTVTIMADJ command which is
used by DSPTIMADJ.  RTVTIMADJ may be used in a user application.

A typical series of commands would be:

             DCL        &ADJSTS *CHAR LEN(10)
              .
             RTVTIMADJ  ADJSTS(&ADJSTS)

The &ADJSTS return variable will contain *ACTIVE or *NOTACTIVE.

DSPTIMADJ escape messages you can monitor for
---------------------------------------------

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

RTVTIMADJ escape messages you can monitor for
---------------------------------------------

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

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

   OUTPUT        How  to  output the  results.    * is  the  default to
                 display  the  time   adjustment  information  if   the
                 command is entered interactively.

                 If  the  command is  entered  in  batch or  *PRINT  is
                 specified, a spooled file is output.


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

   ADJSTS        An optional  return variable that describes  if a time
                 adjustment  is  in   process.     If  specified,   the
                 variable must be  declared as *CHAR LEN(10).   A value
                 of *ACTIVE or *NOTACTIVE will be returned.

   ADJDIRECTN    An  optional  return variable  that  describes whether
                 the   time  is  being  increased  or  decreased.    If
                 specified, the  variable  must  be declared  as  *CHAR
                 LEN(6).     A  value  of  *PLUS  or   *MINUS  will  be
                 returned.

   ADJAMT        An   optional  return  variable   that  describes  the
                 number of  seconds  remaining  to  be  adjusted.    If
                 specified,  the  variable  must be  declared  as  *DEC
                 LEN(9   0).      The  value   will   be   returned  in
                 microseconds.    If  2  seconds  remain,  a  value  of
                 2000000 would be returned.

   ADJDURATN     An  optional   return  variable  that   describes  the
                 number of  seconds remaining that the  system will use
                 to  adjust the time.   If specified, the variable must
                 be declared  as  *DEC LEN(9  0).   The  value will  be
                 returned in microseconds.

   ADJSUPPORT    An optional  return variable that  describes whether a
                 time  adjustment can be made.   Some hardware does not
                 support such a function.   If specified, the  variable
                 must  be  declared   as  *CHAR  LEN(4).     The  value
                 returned will be *YES or *NO.

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

Because  RTVTIMADJ returns variables, the  command may only  be used in
a CL program.

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

The following TAA Tools must be on your system:

     CVTBIN8         Convert binary 8
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

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

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

   RTVTIMADJ     *CMD                   TAATINW       QATTCMD
   DSPTIMADJ     *CMD                   TAATINW2      QATTCMD
   TAATINWC      *PGM       CLP         TAATINWC      QATTCL
   TAATINWC2     *PGM       CLP         TAATINWC2     QATTCL
   TAATINWR2     *PGM       RPG         TAATINWR2     QATTRPG
   TAATINWD      *FILE      DSPF        TAATINWD      QATTDDS

Structure
---------

RTVTIMADJ   Cmd
   TAATINWC   CL pgm

DSPTIMADJ   Cmd
   TAATINWC2   CL pgm
     TAATINWR2   RPG Pgm
     TAATINWD      Display file
					

Added to TAA Productivity tools April 15, 2012


Home Page Up to Top