gtpo1m1eOperations

ZATIM-Alter Time

Use this command to:

Requirements and Restrictions

Format




timebase
is the time base specified in hours (hh) and minutes (mm).
Note:
Enter the ZDTIM command to determine the time base.

SET
changes the subsystem LST clock.
Note:
You can specify this parameter only when cycling is enabled. Enter the ZPSMS command to enable cycling.

ADD
adds the specified hours and minutes to the LST clock.

hhmmss
is the hours, minutes, and seconds.

mmddyy
is the month (mm), day (dd), and year (yy).
Note:
Years ending in 00 through 41 are considered to be in the 21st century. Therefore, you can specify dates from January 1, 1942 through December 31, 2041.

All the processors in a loosely-coupled complex have the same format of days, months, and years.

ddmmmyy
is the alternate date format with day (dd), month (mmm), and year (yy). Specify the month as one of the following:

JAN
specifies January

FEB
specifies February

MAR
specifies March

APR
specifies April

MAY
specifies May

JUN
specifies June

JUL
specifies July

AUG
specifies August

SEP
specifies September

OCT
specifies October

NOV
specifies November

DEC
specifies December.

TOD
changes the time-of-day clock for the specified date.

The TOD parameter is valid only for the basic subsystem (BSS). It changes all the subsystem clocks when the subsystem is cycled above 1052 state.

Note:
Enter the ZDTIM TOD or ZDTIM STR command to determine the time base for this command.

GOOD
indicates that the current value of the TOD clock is acceptable and the value will not be changed.

If you specify this parameter with the STR parameter, the TOD clock is synchronized to the Sysplex Timer. This command is transparent to all other central processor complexes (CPCs) in the complex.

STR
specifies that the time source is the Sysplex Timer.

ALTPORT
specifies that the time source is the Sysplex Timer on the alternate port.

This parameter is valid only when each port of a CPC goes to a different Sysplex Timer and these Sysplex Timers are uncoupled.

Note:
You cannot specify this parameter when running under Processor Resource/Systems Manager (shared PR/SM).

STRNM-name
indicates that TOD synchronization compatibility (TSC) hardware is being used on the CPC and the Sysplex Timer should be used as the synchronization source, where strname is the 1- to 4-character name of the Sysplex Timer.
Note:
TSC hardware is required when there are TOD RPQ CPCs and Sysplex Timer CPCs in the same loosely coupled complex.

BP
makes the TOD clock for the current processor the master TOD clock in a loosely coupled complex.
Note:
You can specify this parameter only in a loosely coupled complex.

Additional Information

Examples

The basic subsystem (BSS) LST clock is changed to 11 a.m. in the following example. The time difference between the system clock and the BSS clock is updated as well.

+--------------------------------------------------------------------------------+
|User:   ZDTIM                                                                   |
|                                                                                |
|System: DTIM0003I 11.26.32 SUBSYSTEM BSS  CLOCKS ARE NOT RUNNING                |
|                                                                                |
|User:   ZATIM 1126 SET 1100                                                     |
|                                                                                |
|System: ATIM0001I 11.00.32 SUBSYSTEM BSS  LOCAL STANDARD TIME                   |
+--------------------------------------------------------------------------------+

In the following example, the TOD clock is set to the time and date that is given by the Sysplex Timer. (You can enter the ZDTIM STR command to determine the time and date of the Sysplex Timer.)

+--------------------------------------------------------------------------------+
|User:   ZDTIM TOD                                                               |
|                                                                                |
|System: CLKS0010I 11.00.32 TIME OF DAY CLOCK LOCAL STANDARD TIME                |
|                           TIME: 14.56.54  DATE: 05/24/94                       |
|        CLKS0081I 11.00.32 SOURCE: MASTER  STATUS: CONFIRMED                    |
|                           MASTER- CPUID: B  SERIAL: 020410  MODEL: 3090        |
|                                                                                |
|User:   ZATIM 1456 TOD STR                                                      |
|                                                                                |
|System: CLKS0010I 11.00.32 TIME OF DAY CLOCK LOCAL STANDARD TIME                |
|                           TIME: 14.57.10  DATE: 05/24/94                       |
|        ATIM0002I 11.00.32 TIME OF DAY CLOCK SET                                |
+--------------------------------------------------------------------------------+

Related Information

See TPF Main Supervisor Reference and TPF System Generation for more information about the system clocks.