[Digital logo]
[HR]

OpenVMS System Manager's Manual


Previous | Contents

To set the TDF, answer the following questions:

  1. Select option 2 to display the TDF the system has calculated for you:
     
        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
    

    The system displays information like the following:
     
        SYSTEM TIME DIFFERENTIAL FACTOR = -4:00  (-14400 seconds). 
        LOCAL SYSTEM TIME               = 22-SEP-1996 10:49:45.20. 
    
  2. Select option 1 to verify the TDF displayed or to enter a new one:
        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 system then displays the following information:
        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.). 
    

    The system displays the following question only if you set the time zone as well. However, some time zones do not have daylight saving time; if they do not, the system also does not display this question.
  3. Answer Yes or No to the following question:
    Is Daylight Savings time in effect? (Yes/No): 
    
  4. After the following prompt, either press Return to accept the displayed default or enter the correct TDF. (If you have not set the time zone, the system does not display a default TDF value.)
    Enter the Time Differential Factor [-4:00]: 
    

    The system then explains the need to modify the system time as well for season time changes:
        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. 
    
  5. To the following question, answer Yes if you need to modify the local system time or No if you do not:
    Do you wish to modify the local system time [N]: 
    

    If you answer Yes, the system will lead you through a dialogue similar to the one in Section 5.8.4.
    If you answer No, the system next displays the new TDF:
        NEW SYSTEM TIME DIFFERENTIAL FACTOR = -4:00. 
    
  6. Answer Yes to confirm the displayed TDF or No if it is incorrect:
    Is this correct? [Y]: 
    

    If you answer No, the system returns to step 1 in this section.
    If you answer Yes, the system displays both the TDF and the local system time.
        SYSTEM TIME DIFFERENTIAL FACTOR = -4:00  (-14400 seconds). 
        LOCAL SYSTEM TIME               = 22-SEP-1996 10:52:37.36. 
    

5.8.4 Adjusting for Daylight Saving Time and Standard Time

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 

5.8.5 Setting Time in an OpenVMS Cluster Environment

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

  1. The following example changes the TDF clusterwide by +1:00 to 11:00 and also moves the local time ahead by 1 hour, as you would do if you were changing from standard time to daylight saving time. The initial TDF value is +10:00, and the local date and time are 12-MAR-1996:15:20.
    $  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
    
  2. The following example displays the TDF for each node in the cluster:
    $  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
    

    The system will display the TDF and the local time on each node in the cluster.
  3. The following command procedure can be submitted as a batch job to run at a future time to do the following:
    $! 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 
    

    Note: Because UTC$CONFIGURE_TDF.COM accepts time in minutes, -4:30 is expressed as -((4 x 60) + 30) or -270; -1:00 is expressed as -60.
    The following command submits this command procedure as a batch job to run at 23-JAN1996:02:00:
    $ SUBMIT/AFTER=23-JAN1996:02:00 TO_STANDARD_TIME.COM
    

    5.9 Setting Time Using the Battery-Backed Watch (BBW) (Alpha Only)

    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.

    5.10 Choosing Languages, and Date and Time Formats

    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.

    1. Define the logical name SYS$LANGUAGES (plural) to specify the list of languages the users on your system might want to use. (If the language is English, skip this step.)
    2. Invoke the command procedure SYS$MANAGER:LIB$DT_STARTUP.COM, which:
      • Defines output formats you can use to customize the display of dates and times
      • Loads support for languages other than English that you define with the SYS$LANGUAGES logical
    3. Define date and time formats for the system using either:
      • User-defined formats
      • Predefined formats

      5.10.1 Specifying Languages Other Than English

      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.

      Table 5-5 Available Languages
      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.

      5.10.2 Invoking LIB$DT_STARTUP.COM

      The SYS$MANAGER:LIB$DT_STARTUP.COM command procedure defines the possible choices for the following logicals:

      • SYS$LANGUAGES
        The system loads the languages you have selected using the SYS$LANGUAGES (plural) logical.
        Users can later select their own choice of languages by defining the SYS$LANGUAGE (singular) logical, as explained in Section 5.10.4.
      • LIB$DT_FORMAT
        The system loads output formats that you can then use to specify default system formats.
        Users can later define their own formats, as explained in Section 5.10.4.

      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.

      5.10.3 Defining System Default Date and Time Formats

      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:

      • LIB$DATE_FORMAT_nnn, where nnn ranges from 001 to 040
      • LIB$TIME_FORMAT_nnn, where nnn ranges from 001 to 020

      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.

      5.10.3.1 Defining Your Own Format

      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.

      Table 5-6 Format Mnemonics
      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

      5.10.3.2 Using Predefined Formats

      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.

      Table 5-7 Predefined Output Date Formats
      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.

      Table 5-8 Predefined Output Time 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

      5.10.4 User Definitions of Language, and Date and Time Formats

      A user can specify a choice of language by defining the SYS$LANGUAGE logical. For example:

      $ DEFINE SYS$LANGUAGE FRENCH 
      


      Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

      [HR]

        6017P013.HTM
        OSSG Documentation
        22-NOV-1996 14:21:34.86
      

      Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

      Legal