DSPTIMADJ -- Display Time Adjustment

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

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