The  Display  Time  Zone  command  allows  you   to  display  the  time
difference between  major cities throughout  the world.   This provides
a  simple solution for  determining the local time  in a different part
of the world.

Note that this  tool was  written before the  system time zone  support
and you may prefer the WRKTIMZON option for display.

Before  you use  DSPTIMZON, you  must change  an Application  Value for
your  system to  describe the  offset from  Greenwich Mean  Time (GMT).
See the later discussion.

The DSPTIMZON command has no parameters and would be entered as:

            DSPTIMZON

An interactive display would appear.

  **   The default  From location  is *CURRENT  or  the current  system
       location.   You may enter  a major city name  or press F4  for a
       list.

  **   The default  From time is the current time  of your system.  The
       value may be  changed to  any valid HHMMSS  military time  value
       such as 140000 is 2:00 PM.

  **   The To  location must  be entered.   It  must be a  city in  the
       supplied  list or  one of  the special  values such  as *EASTERN
       meaning  the Eastern time  zone in the  USA.  You  may use F4 to
       select from a list of the supplied cities.

When the  Enter key  is  pressed, the  display re-appears  with the  To
location local time and date.

Daylight  saving time  is not  considered.   If both  locations  are on
daylight saving time, the correct time difference will be shown.

Setting the TIMZON Application Value for your system
----------------------------------------------------

        ****************************************************
        *                                                  *
        *    Note that the system supports time zones      *
        *     (V5R3), but these are not used by the        *
        *     DSPTIMZON tool because the system is         *
        *     aware of daylight savings time at the        *
        *     current location.                            *
        *                                                  *
        *   DSPTIMZON must have consistent offsets         *
        *     throughout the world to be able to           *
        *     calculate the difference between your        *
        *     location and another city.                   *
        *                                                  *
        *   Follow the instructions for setting the        *
        *     Application Value regardless of what         *
        *     your current QUTCOFFSET value is.            *
        *                                                  *
        ****************************************************

Before  using  the DSPTIMZON  command,  a user  with  *ALLOBJ authority
must set the TIMZON  Application Value with the  offset of your  system
location  from  Greenwich mean  time.    The  time  should be  set  for
standard time (not daylight savings time).

The major offsets in the US are:

          Eastern time   -05
          Central time   -06
          Mountain time  -07
          Pacific time   -08

If you need to determine your offset do the following:

             PRTTIMZON

A  listing  will be  produced  of the  major  cities in  world  and the
offsets from Greenwich mean time.

For example:
  **   If your system is  in the same time  zone as Zurich  Switzerland
       your  offset is  +01.   If  you are  in  Sydney Australia,  your
       offset is +10.

As an *ALLOBJ user, enter the command:

             EDTAPPVAL APPVAL(TAASECURE/TIMZON)

An interactive display will appear with two fields:

  **   Enter a  '+' or '-' into  the first field based  on your offset.

  **   Enter  a two  digit number into  the second field  based on your
       offset.

The Application  Value  needs to  be  changed only  once for  the  same
offset regardless  of how many  versions of the TAA  Productivity Tools
you install.

Security considerations
-----------------------

An  *ALLOBJ user must use EDTAPPVAL to  change the values in the TIMZON
Application Value (a  *USRSPC object) in the  TAASECURE library.   This
library is secured from general use.

To allow  the DSPTIMZON function to  access the Application  Value, the
TAATIMNC11  program  is used  which  adopts the  authority  of QSECOFR.
This is a  retrieve only function  and the program  is considered  safe
to use.

Adding cities to be internal array
----------------------------------

You may  add other cities to  the array of  data used by  the DSPTIMZON
function.  See the discussion with the PRTTIMZON tool.

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

None.

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

Only selected major cities are supported.

Daylight  saving time  is not  considered.   If  both locations  are on
daylight saving time, the correct time difference will be shown.

Time zone changes of less than 60 minutes are not shown.

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

The following TAA Tools must be on your system:

     ADDDAT          Add date
     ADJVAR          Adjust variable
     APPVAL          Application value
     FILEFDBCK       File feedback
     PRTTIMZON       Print time zone
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   DSPTIMZON     *CMD                   TAATIMN       QATTCMD
   TAATIMNC      *PGM       CLP         TAATIMNC      QATTCL
   TAATIMNC10    *PGM       CLP         TAATIMNC10    QATTCL
   TAATIMNC11    *PGM       CLP         TAATIMNC11    QATTCL
   TAATIMNR      *PGM       RPG         TAATIMNR      QATTRPG
   TAATIMNR2     *PGM       RPG         TAATIMNR2     QATTRPG
   TAATIMND      *FILE      DSPF        TAATIMND      QATTDDS
   TAATIMNE      *FILE      DSPF        TAATIMNE      QATTDDS
   TIMZON        *USRSPC

The TIMZON User Space is in the TAASECURE library.

Structure
---------

PRTTIMZON   Cmd
   TAATIMNC   CL pgm
     TAATIMNR   RPG Pgm
       TAATIMND  Dsp file
       TAATIMNC10   CL pgm for new date
       TAATIMNR2  RPG pgm for F4 select
          TAATIMNE  Dsp file