To set the TDF, answer the following questions:
Configuring the Time Differential Factor (TDF) Enter ? anytime for help [0] Exit [1] Set the Time Differential Factor [2] Display the Time Differential Factor
Please pick an option number [2]: 2
SYSTEM TIME DIFFERENTIAL FACTOR = -4:00 (-14400 seconds). LOCAL SYSTEM TIME = 22-SEP-1996 10:49:45.20.
Configuring the Time Differential Factor (TDF) Enter ? anytime for help [0] Exit [1] Set the Time Differential Factor [2] Display the Time Differential Factor
Please pick an option number [2]: 1
The Time Differential Factor (TDF) is the difference between your system time and Coordinated Universal Time (UTC). UTC is similar in most repects to Greenwich Mean Time (GMT). The TDF is expressed as hours and minutes, and should be entered in the hh:mm format. TDFs for the Americas will be negative (-3:00, -4:00, etc.); TDFs for Europe, Africa, Asia and Australia will be positive (1:00, 2:00, etc.).
Is Daylight Savings time in effect? (Yes/No):
Enter the Time Differential Factor [-4:00]:
If this is a seasonal time change, it may also be necessary to modify the system time. Generally, seasonal time changes result in adding 1:00 hour, or adding -1:00 hour to the system time.
Do you wish to modify the local system time [N]:
NEW SYSTEM TIME DIFFERENTIAL FACTOR = -4:00.
Is this correct? [Y]:
SYSTEM TIME DIFFERENTIAL FACTOR = -4:00 (-14400 seconds). LOCAL SYSTEM TIME = 22-SEP-1996 10:52:37.36.
To adjust the local time to daylight saving or standard time, you can invoke the command procedure SYS$EXAMPLES:DAYLIGHT_SAVINGS.COM to do both of the following:
DAYLIGHT_SAVINGS.COM allows you to do either of the following:
The following example of DAYLIGHT_SAVINGS.COM shows answers that cause the procedure to queue a batch job, DST_CHANGE, which will execute when the time changes from standard time to daylight saving time. Many of the questions are similar to those explained in Section 5.8.3.2.
In the example, the initial TDF value is -5:00. The local date and time are any time from the date in 1993 when the change to standard time was made, until 23-APR-1996:02:00, when the change to daylight saving time will be made.
$ SYS$EXAMPLES:DAYLIGHT_SAVINGS This procedure queues a batch job that changes the system time and system time differential around a daylight saving time change. Press the question mark (?) key at any time for help; hit Control-C to exit. The Time Differential Factor (TDF) is the difference between your system time and Coordinated Universal Time (UTC). The difference is expressed in hh:mm format. The Americas have negative offsets from UTC, while Europe, Africa, Asia and Australia have positive offsets from UTC. * Enter the Time Differential Factor: -4:00 [Return] If this is a seasonal time change, it may also be necessary to modify the system time. Generally, seasonal time changes result in adding 1:00 hour, or adding -1:00 hour to the local time. * Do you wish to modify the local system time [N]: Y [Return] Enter the time value you would like to add to the local time. The value can be a positive or a negative (-hh:mm) value. * Enter the time value: +1:00 [Return] The process to modify your time zone offset and local time (if supplied) can occur now or in the future. Press Return to run the job now. * Enter the run time in the DD-MMM-YYYY:HH:MM:SS format: 23-apr-1996:02:00 [Return] NEW SYSTEM TIME DIFFERENTIAL FACTOR = -4:00. ADDING 1:00 TO THE LOCAL TIME. JOB RUN TIME : 23-APR-1996:02:00 * Continue? [Y]: Y [Return] Job DST_CHANGE (queue SYS$BATCH, entry 2) holding until 23-APR-1996 02:00 Batch Job DST_CHANGE scheduled to run at 23-APR-1996:02:00 $ $!!The batch job DST_CHANGE will run on 23-Apr-1996 at 02:00
The TDF and the local time must be the same on all nodes in an OpenVMS Cluster environment. You can use the System Management utility (SYSMAN) DO command to invoke the command procedure UTC$CONFIGURE_TDF.COM on one node in a cluster to do the following for one or more nodes in the cluster:
Note that UTC$CONFIGURE_TDF.COM is normally run by UTC$TIME_SETUP.COM when you select the TDF or BOTH option.
You specify the function SET or SHOW, the TDF value, and the local time modification as command procedure parameters. Note that you must express the TDF and the change to the local time in minutes format, not in hours and minutes hh:mm format, as you do if you use the command procedure interactively. For example, for +2:00, you would enter +120 or 120.
Examples
$ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER
%SYSMAN-I-ENV, Current command environment: Clusterwide on local cluster Username SMITH will be used on nonlocal nodes
SYSMAN> DO @SYS$MANAGER:UTC$CONFIGURE_TDF SET +660 +60
$ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER
%SYSMAN-I-ENV, Current command environment: Clusterwide on local cluster Username SMITH will be used on nonlocal nodes
SYSMAN> DO @SYS$MANAGER:UTC$CONFIGURE_TDF SHOW
$! TO_STANDARD_TIME.COM $! Command procedure to change the TDF by -1:00 and also modify local time $ RUN SYS$SYSTEM:SYSMAN SET ENVIRONMENT/CLUSTER DO @SYS$MANAGER:UTC$CONFIGURE_TDF SET -270 -60 EXIT
$ SUBMIT/AFTER=23-JAN1996:02:00 TO_STANDARD_TIME.COM
The OpenVMS Alpha architecture maintains the current date and time in the Battery-Backed Watch (BBW) across power failures and system downtime. The BBW is functionally equivalent to the Time of Day Register (TODR) that the VAX architecture uses. One difference, however, is the BBW's constraint on the date range.
The BBW provides sufficient storage capability for only a century. The OpenVMS Alpha system date range has been redefined as 1957 to 2056 to maintain correct leap-year processing and to provide for the millennial transition.
In addition, the OpenVMS Alpha timing mechanisms have been changed to allow 2-digit year support in the $ASCTIM system service and the DCL command SET TIME. (Prior to this change, only 4-digit year fields were allowed.) With 2-digit support, you need to enter only the last 2 digits of a year. The century associated with the year field is derived from the placement of the 2 digits in the 1957-2056 date range. For example:
$ SET TIME = 1-NOV-96
In this example, 96 is the equivalent of 1996.
$ SET TIME = 1-NOV-05
In this example, 05 is the equivalent of 2005.
You can specify languages other than English. From the list that the system manager defines, users can later select a language that they want to display.
You can also select the time and date formats for many SHOW commands from a predefined list or define new time and date formats.
Note
The SHOW TIME command does not include this feature because the SHOW TIME command is processed completely by DCL, which does not have access to the LIB$ routines necessary to format the output.In addition, the SHOW commands for batch and print operations were modified to include, in the default time-stamp, seconds as well as hours and minutes. These new features were not previously documented.
For example, rather than 15-JAN-1996 10:16:25.14, you can use a different format, such as the following:
$ SHOW USERS OpenVMS User Processes at JANUARY 15, 1996 10:16 AM Total number of users = 7, number of processes = 11 Username Node Interactive Subprocess Batch MCDERMOT ARD26B 1 PASTERNAK ARD26B - 2 1 . . .
Later, users can override the system defaults set up by the system manager and select their own date and time formats.
Steps to Change Languages, and Dates and Times
For languages other than English or date/time formats other than the defaults, you must complete these steps.
Note
Digital recommends that you include these steps within the command procedure SYS$MANAGER:SYSTARTUP_VMS.COM.
Use the SYS$LANGUAGES (plural) logical to define a list of languages other than English. (From this list, users can later select a language to be displayed on their processes, as explained in Section 5.10.4.)
Because English is the default language and must therefore always be available, English spellings are not taken from logical name translations; rather, they are looked up in an internal table.
The available languages and their logical names are shown in Table 5-5.
Language | Equivalence String for SYS$LANGUAGES |
---|---|
Austrian | AUSTRIAN |
Danish | DANISH |
Dutch | DUTCH |
Finnish | FINNISH |
French | FRENCH |
French Canadian | CANADIAN |
German | GERMAN |
Hebrew | HEBREW |
Italian | ITALIAN |
Norwegian | NORWEGIAN |
Portuguese | PORTUGUESE |
Spanish | SPANISH |
Swedish | SWEDISH |
Swiss French | SWISS_FRENCH |
Swiss German | SWISS_GERMAN |
For example, to specify the French, German, and Italian languages, you must define SYS$LANGUAGES:
$ DEFINE SYS$LANGUAGES FRENCH, GERMAN, ITALIAN
To add another language, for example, FINNISH, you must add FINNISH to the definition of SYS$LANGUAGES and execute the command procedure again.
The SYS$MANAGER:LIB$DT_STARTUP.COM command procedure defines the possible choices for the following logicals:
To invoke the command procedure, enter the following command:
$ @SYS$MANAGER:LIB$DT_STARTUP
If the translation of SYS$LANGUAGES fails, then English is used. If the translation of LIB$DT_FORMAT or any logical name relating to format fails, the OpenVMS standard ($ASCTIM) representation of the date and time is used, that is, dd-mmm-yyyy hh:mm:ss.cc.
To define default date and time formats, you can use either user-defined formats, which are shown in Table 5-6, or predefined formats, which are shown in Table 5-7 and Table 5-8.
To select a format for a date, time, or both, you must define the LIB$DT_FORMAT logical name using the following logicals:
The order in which these logical names appear in the definition of LIB$DT_FORMAT determines the order in which they are output. A single space is inserted into the output string between the two elements if the definition specifies that both are output. For example, to define systemwide formats:
$ DEFINE/SYSTEM LIB$DT_FORMAT LIB$DATE_FORMAT_006, LIB$TIME_FORMAT_012
This definition causes the date to be displayed systemwide in the specified format, followed by a space and the time in the specified format. For example:
13 JAN 96 9:13 AM
Section 5.10.4 explains how users can select their own date and time formats to be displayed for their process.
To define your own format, define LIB$DATE_FORMAT_nnn and LIB$TIME_FORMAT_nnn, using the mnemonics shown in Table 5-6. Replace nnn with a number of your choice.
Note
For user-defined formats, Digital recommends that you use values of _500 and above for _nnn.
Date | Explanation |
---|---|
!D0 | Day, Zero-Filled |
!DD | Day, No Fill |
!DB | Day, Blank-Filled |
!WU | Weekday, Uppercase |
!WAU | Weekday, Abbreviated, Uppercase |
!WC | Weekday, Capitalized |
!WAC | Weekday, Abbreviated, Capitalized |
!WL | Weekday, Lowercase |
!WAL | Weekday, Abbreviated, Lowercase |
!MAU | Month, Alphabetic, Uppercase |
!MAAU | Month, Alphabetic, Abbreviated, Uppercase |
!MAC | Month, Alphabetic, Capitalized |
!MAAC | Month, Alphabetic, Abbreviated, Capitalized |
!MAL | Month, Alphabetic, Lowercase |
!MAAL | Month, Alphabetic, Abbreviated, Lowercase |
!MN0 | Month, Numeric, Zero-Filled |
!MNM | Month, Numeric, No Fill |
!MNB | Month, Numeric, Blank-Filled |
!Y4 | Year, 4 Digits |
!Y3 | Year, 3 Digits |
!Y2 | Year, 2 Digits |
!Y1 | Year, 1 Digit |
Time | Explanation |
!H04 | Hours, Zero-Filled, 24-Hour Clock |
!HH4 | Hours, No Fill, 24-Hour Clock |
!HB4 | Hours, Blank-Filled, 24-Hour Clock |
!H02 | Hours, Zero-Filled, 12-Hour Clock |
!HH2 | Hours, No Fill, 12-Hour Clock |
!HB2 | Hours, Blank-Filled, 12-Hour Clock |
!M0 | Minutes, Zero-Filled |
!MM | Minutes, No Fill |
!MB | Minutes, Blank-Filled |
!S0 | Seconds, Zero-Filled |
!SS | Seconds, No Fill |
!SB | Seconds, Blank-Filled |
!C7 | Fractional Seconds, 7 Digits |
!C6 | Fractional Seconds, 6 Digits |
!C5 | Fractional Seconds, 5 Digits |
!C4 | Fractional Seconds, 4 Digits |
!C3 | Fractional Seconds, 3 Digits |
!C2 | Fractional Seconds, 2 Digits |
!C1 | Fractional Seconds, 1 Digit |
!MIU | Meridiem Indicator, Uppercase |
!MIC | Meridiem Indicator, Capitalized (mixed case) |
!MIL | Meridiem Indicator, Lowercase |
Table 5-7 lists all predefined date format logical names, their formats, and examples of the output generated using those formats. The mnemonics used to specify the formats are listed in Table 5-6.
Date Format Logical | Format | Example |
---|---|---|
LIB$DATE_FORMAT_001 | !DB-!MAAU-!Y4 | 13-JAN-1996 |
LIB$DATE_FORMAT_002 | !DB !MAU !Y4 | 13 JANUARY 1996 |
LIB$DATE_FORMAT_003 | !DB.!MAU !Y4 | 13.JANUARY 1996 |
LIB$DATE_FORMAT_004 | !DB.!MAU.!Y4 | 13.JANUARY.1996 |
LIB$DATE_FORMAT_005 | !DB !MAU !Y2 | 13 JANUARY 96 |
LIB$DATE_FORMAT_006 | !DB !MAAU !Y2 | 13 JAN 96 |
LIB$DATE_FORMAT_007 | !DB.!MAAU !Y2 | 13.JAN 96 |
LIB$DATE_FORMAT_008 | !DB.!MAAU.!Y2 | 13.JAN.96 |
LIB$DATE_FORMAT_009 | !DB !MAAU !Y4 | 13 JAN 1996 |
LIB$DATE_FORMAT_010 | !DB.!MAAU !Y4 | 13.JAN 1996 |
LIB$DATE_FORMAT_011 | !DB.!MAAU.!Y4 | 13.JAN.1996 |
LIB$DATE_FORMAT_012 | !MAU !DD, !Y4 | JANUARY 13, 1996 |
LIB$DATE_FORMAT_013 | !MN0/!D0/!Y2 | 01/13/96 |
LIB$DATE_FORMAT_014 | !MN0-!D0-!Y2 | 01-13-96 |
LIB$DATE_FORMAT_015 | !MN0.!D0.!Y2 | 01.13.96 |
LIB$DATE_FORMAT_016 | !MN0 !D0 !Y2 | 01 13 96 |
LIB$DATE_FORMAT_017 | !D0/!MN0/!Y2 | 13/01/96 |
LIB$DATE_FORMAT_018 | !D0/!MN0-!Y2 | 13/01-96 |
LIB$DATE_FORMAT_019 | !D0-!MN0-!Y2 | 13-01-96 |
LIB$DATE_FORMAT_020 | !D0.!MN0.!Y2 | 13.01.96 |
LIB$DATE_FORMAT_021 | !D0 !MN0 !Y2 | 13 01 96 |
LIB$DATE_FORMAT_022 | !Y2/!MN0/!D0 | 96/01/13 |
LIB$DATE_FORMAT_023 | !Y2-!MN0-!D0 | 96-01-13 |
LIB$DATE_FORMAT_024 | !Y2.!MN0.!D0 | 96.01.13 |
LIB$DATE_FORMAT_025 | !Y2 !MN0 !D0 | 96 01 13 |
LIB$DATE_FORMAT_026 | !Y2!MN0!D0 | 960113 |
LIB$DATE_FORMAT_027 | /!Y2.!MN0.!D0 | /96.01.13 |
LIB$DATE_FORMAT_028 | !MN0/!D0/!Y4 | 01/13/1996 |
LIB$DATE_FORMAT_029 | !MN0-!D0-!Y4 | 01-13-1996 |
LIB$DATE_FORMAT_030 | !MN0.!D0.!Y4 | 01.13.1996 |
LIB$DATE_FORMAT_031 | !MN0 !D0 !Y4 | 01 13 1996 |
LIB$DATE_FORMAT_032 | !D0/!MN0/!Y4 | 13/01/1996 |
LIB$DATE_FORMAT_033 | !D0-!MN0-!Y4 | 13-01-1996 |
LIB$DATE_FORMAT_034 | !D0.!MN0.!Y4 | 13.01.1996 |
LIB$DATE_FORMAT_035 | !D0 !MN0 !Y4 | 13 01 1996 |
LIB$DATE_FORMAT_036 | !Y4/!MN0/!D0 | 1996/01/13 |
LIB$DATE_FORMAT_037 | !Y4-!MN0-!D0 | 1996-01-13 |
LIB$DATE_FORMAT_038 | !Y4.!MN0.!D0 | 1996.01.13 |
LIB$DATE_FORMAT_039 | !Y4 !MN0 !D0 | 1996 01 13 |
LIB$DATE_FORMAT_040 | !Y4!MN0!D0 | 19960113 |
Table 5-8 lists all predefined time format logical names, their formats, and examples of the output generated using those formats.
Time Format Logical | Format | Example |
---|---|---|
LIB$TIME_FORMAT_001 | !H04:!M0:!S0.!C2 | 09:13:25.14 |
LIB$TIME_FORMAT_002 | !H04:!M0:!S0 | 09:13:25 |
LIB$TIME_FORMAT_003 | !H04.!M0.!S0 | 09.13.25 |
LIB$TIME_FORMAT_004 | !H04 !M0 !S0 | 09 13 25 |
LIB$TIME_FORMAT_005 | !H04:!M0 | 09:13 |
LIB$TIME_FORMAT_006 | !H04.!M0 | 09.13 |
LIB$TIME_FORMAT_007 | !H04 !M0 | 09 13 |
LIB$TIME_FORMAT_008 | !HH4:!M0 | 9:13 |
LIB$TIME_FORMAT_009 | !HH4.!M0 | 9.13 |
LIB$TIME_FORMAT_010 | !HH4 !M0 | 9 13 |
LIB$TIME_FORMAT_011 | !H02:!M0 !MIU | 09:13 AM |
LIB$TIME_FORMAT_012 | !HH2:!M0 !MIU | 9:13 AM |
LIB$TIME_FORMAT_013 | !H04!M0 | 0913 |
LIB$TIME_FORMAT_014 | !H04H!M0m | 09H13m |
LIB$TIME_FORMAT_015 | kl !H04.!M0 | kl 09.13 |
LIB$TIME_FORMAT_016 | !H04H!M0' | 09H13' |
LIB$TIME_FORMAT_017 | !H04.!M0 h | 09.13 h |
LIB$TIME_FORMAT_018 | h !H04.!M0 | h 09.13 |
LIB$TIME_FORMAT_019 | !HH4 h !MM | 9 h 13 |
LIB$TIME_FORMAT_020 | !HH4 h !MM min !SS s | 9 h 13 min 25 s |
A user can specify a choice of language by defining the SYS$LANGUAGE logical. For example:
$ DEFINE SYS$LANGUAGE FRENCH
6017P013.HTM OSSG Documentation 22-NOV-1996 14:21:34.86
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.