The Display  Time  Zone Time  command displays  or lists  the date  and
time for  a specified time zone.   The time zone must be  one of a list
of  special values or found in the WRKTIMZON  display.  The day of week
and offset from  GMT are also  shown.  Daylight  savings time (DST)  is
considered if the  time zone supports DST and  the current date/time is
within the DST start and end date/time.

A typical command would be:

              DSPTIMZONT   TIMZON(*HAWAIIAN)

The time zone for the Hawaiian islands would be displayed.

DSPTIMZONT escape messages you can monitor for
----------------------------------------------

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

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

   TIMZON        The  time zone to retrieve the date  and time for.  It
                 must be  one of  the special  values or  a  name of  a
                 time zone as seen with WRKTIMZON.

                 The  following special  values  exist  along with  the
                 time zone that will be used:

                   *SYSVAL      The QTIMZON system value
                   *GMT         Q0000GMT
                   *BRITISH     Q0000GMT2
                   *UTC         Q0000UTC
                   *ATLANTIC    QN0400AST2
                   *EASTERN     QN0500EST3
                   *CENTRAL     QN0600CST2
                   *MOUNTAIN    QN0700MST2
                   *PHOENIX     QN0800PST3
                   *PACIFIC     QN0800PST2
                   *ALASKA      QN0900AST2
                   *HAWAIIAN    QN1000HAS2
                   *NEWZEALAN   QP1200NZS3
                   *EAUSTRAL    QP1000AES3
                   *CAUSTRAL    QP0930ACS3
                   *WAUSTRAL    QP0800AWS3
                   *JAPAN       QP0900JST
                   *KOREA       QP0900KST
                   *BEIJING     QP0800BST
                   *MOSCOW      QP0300MSK

                   *INDIA       QP0530IST
                   *EEUROPE     QP0200EET3
                   *CEUROPE     QP0100CET4

   OUTPUT        How  to  output the  results.   *  is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.  The  spooled file is deleted  after it
                 is displayed.

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


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

None.

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

The following TAA Tools must be on your system:

     CVTTIM          Convert time
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     RTVTIMZONT      Retrieve time zone time
     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
   ------        ----    ---------      ----------    ----------

   DSPTIMZONT    *CMD                   TAATINS       QATTCMD
   TAATINSC      *PGM       CLP         TAATINSC      QATTCL
   TAATINSR      *PGM       RPG         TAATINSR      QATTRPG