QUERY TIMEZONES

Read syntax diagramSkip visual syntax diagram Query TIMEZONEs zoneid

Authorization

Privilege Class: G

Purpose

Use QUERY TIMEZONES to display the list of active and inactive time zone definitions on your system.

Operands

zoneid
specifies the time zone ID definition that you wish to display. The time zone ID is a 1- to 3-character identifier that has been defined with either a TIMEZONE_DEFINITION statement in the system configuration file or a DEFINE TIMEZONE command. When zoneid is omitted, CP displays information about all defined time zones.

Usage Notes

  1. To define new time zones or to change existing time zone characteristics, use the DEFINE TIMEZONE command. For more information, see DEFINE TIMEZONE.
  2. To select a new active time zone, use the SET TIMEZONE command. For more information, see SET TIMEZONE.
  3. You can also define time zones and set the active time zone in the system configuration file by using the TIMEZONE_DEFINITION Statement and TIMEZONE_BOUNDARY Statement. For more information, see z/VM: CP Planning and Administration.

Responses

Response 1:

The QUERY TIMEZONES command provides this type of response:
Zone  Direction   Offset   Status
GMT     ----     00.00.00  Inactive
UTC     ----     00.00.00  Inactive
EDT     West     04.00.00  Active
EST     West     05.00.00  Inactive
PDT     West     07.00.00  Inactive
PST     West     08.00.00  Inactive
CET     East     01.00.00  Inactive
CDT     West     05.00.00  Inactive

The first column shows the time zone ID (zoneid). This identifier can be used in a SET TIMEZONE command. CP automatically defines the Greenwich Mean Time (GMT) and Coordinated Universal Time (UTC) time zones.

The second column shows the geographical direction of this time zone from longitude 0. If you define a time zone with an offset of 00.00.00, CP does not display a direction.

The third column shows the offset (expressed in hours, minutes, and seconds) between the time zone and the UTC time zone.

The fourth column tells whether the time zone is currently active. Only one time zone can be active at one time.

Response 2:

When in an STP environment that derives time zone information from the STP server, the QUERY TIMEZONES command lists only the time zones provided by STP as well as the default GMT/UTC. The format of the boundary output is dependent on the issuing user's dateformat setting. The response looks like the following:
Zone  Direction   Offset   Status          Boundary
GMT     ----     00.00.00  Inactive
UTC     ----     00.00.00  Inactive
EDT     West     04.00.00  Active-(STP)
EST     West     05.00.00  Inactive-(STP)  10/31/09 02:00:00
If the Adjust Time Zone panel on the HMC is configured to MANUAL, and no boundary has been configured then the boundary output defaults to 'Not Scheduled' as shown in the following:
Zone  Direction   Offset   Status          Boundary
GMT     ----     00.00.00  Inactive
UTC     ----     00.00.00  Inactive
EDT     West     04.00.00  Active-(STP)
EST     West     05.00.00  Inactive-(STP)  Not Scheduled

Messages

  • HCP003E Invalid option - command contains extra option(s) starting with operand
  • HCP6706E Invalid time zone - zoneid