QUERY TIMEZONES
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
- To define new time zones or to change existing time zone characteristics, use the DEFINE TIMEZONE command. For more information, see DEFINE TIMEZONE.
- To select a new active time zone, use the SET TIMEZONE command. For more information, see SET TIMEZONE.
- 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:
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:
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
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