Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

DEC C Run-Time Library Utilities Reference Manual


Previous Contents Index

Note

When an environment variable that affects the setting of the current locale points to an invalid locale, the "C" locale is set.

Other valid keywords that are not displayed by default as part of any category include:


Qualifiers

/CATEGORY

Optional. Default: No display of category name.

Displays the category name before each keyword.

/KEYWORD

Optional. Default: No display of keyword name.

Displays the keyword name before the value of a keyword.


Description

The LOCALE SHOW VALUE command displays the value of one or more keywords from the current international environment.

errors

%LOCALE-E-NOKEYFND, no keyword keyword-name found

The keyword-name you specified is not valid. Specify only the keywords listed in Table 4-4.


Examples

#1

$ LOCALE SHOW VALUE NOEXPR
"^[nN][[:alpha:]]*" 
      

Issuing LOCALE SHOW VALUE without qualifiers displays the value of the NOEXPR string.

#2

$ LOCALE SHOW VALUE /CATEGORY NOEXPR
LC_MESSAGES 
"^[nN][[:alpha:]]*" 
      

Specifying /CATEGORY displays the category name (LC_MESSAGES) before the value of the NOEXPR string.

#3

$ LOCALE SHOW VALUE /KEYWORD NOEXPR
noexpr= "^[nN][[:alpha:]]*" 
      

Specifying /KEYWORD displays the keyword name before its value.

#4

$ LOCALE SHOW VALUE /KEYWORD /CATEGORY NOEXPR
LC_MESSAGES 
noexpr= "^[nN][[:alpha:]]*" 
      

Specifying /KEYWORD and /CATEGORY displays the category and keyword name before the keyword value.


zic

Using the data in the specified time zone source file, creates binary files containing time zone conversion information.


Format

zic [--v] ["--L" leapseconds] [--d directory] [--y yearistype] infile


Parameters

infile

Required.

Source file that zic reads.


Qualifiers

--v

Optional.

Flags if a year that appears in a data file is outside the range of years representable by time values.

"--L"

Optional.

Reads leap second information from the file with the given name. If this option is not used, no leap second information appears in the output files.

--d

Optional.

Creates time conversion information files in the named directory rather than in the standard directory.

--y

Optional.

Uses the given command file rather than yearistype when checking year types.


Description

The zic command allows the ZIC compiler to read text from the files named on the command line, and then creates the time conversion information files specified with this input.

If a file name is - , the standard input is read.

Input lines consist of fields. Any number of white space characters separate the fields. Leading and trailing white spaces on input lines are ignored. An unquoted number sign (#), the sharp character, in the input line introduces a comment that extends to the end of the line where this sign appears. White space characters and sharp characters can be enclosed in double quotation marks (" ") if they are to be used as part of a field. Any line that is blank after comment stripping is ignored.

Non-blank lines are expected to be one of three types:


Examples

#1

$ zic -v  "-L" leapseco -d [-] myafrica
 
      

The ZIC compiler compiles the time zone source file myafrica. Based on the specified parameters, ZIC does the following:

  1. Flags years outside the representable range
  2. Builds an output file with leapsecond corrections applied
  3. Puts the result in the current directory

For more information about date/time functions, see the DEC C Run-Time Library Reference Manual for OpenVMS Systems.


Index Contents

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6494PRO_006.HTML