APIs in Category: timezone
 API version 3.8

 
timezone-get-defaults
timezone-list-info-iter-end
timezone-list-info-iter-next
timezone-list-info-iter-start
timezone-validate
The DataFabric Manager server allows administrators to specify the time zone where portions of datasets are physically located. This allows the internal scheduling processes to adjust backup times appropriately for storage in different locations.

The time zone specifications here are the same as in Data ONTAP. Timezone specifications can be in one of several formats:

  • Using a location string specified in Arthur David Olsen's public domain time zone database. This format identifies locations by continent or ocean and then by the name of the location, which is typically the largest city within the region. For example, "America/New_York" represents most of the eastern time zone; "America/Phoenix" represents most of Arizona, which uses mountain time without daylight savings time.
  • A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US eastern zone, or "PST8PDT" for the pacific zone, or "GMT-2" for two hours east of GMT.
  • A full POSIX time zone specification, specifying names for the standard and daylight times, and the rules for switching between them. For example, Brian's Time might be "BST8BDT,M4.1.0,M10.5.0".

This family of APIs provides interfaces for listing the time zones in the server's database, and for validating that a user-supplied time zone specification is valid. Note that there are many ways of forming a valid time zone specification, so the output of the timezone-list-info iterators is not a complete list of valid time zones.

NetApp Manage ONTAP
 
timezone-get-defaults [top]

Retrieves the default time zone settings, including the time zone in which the server runs and the time zone to use for objects that don't specify their own time zone.
Output Name Range Type Description
timezone-defaults timezone-defaults
The default time zone settings.

 
timezone-list-info-iter-end [top]
Ends iteration to list time zones.
Input Name Range Type Description
tag string
Tag from a previous timezone-list-info-iter-start.
 Errno  Description
 EINVALIDTAG

 
timezone-list-info-iter-next [top]
Get the next few records in the iteration started by timezone-list-info-iter-start.
Input Name Range Type Description
maximum integer
The maximum number of entries to retrieve.
tag string
Tag from a previous timezone-list-info-iter-start.
 
Output Name Range Type Description
records integer
The number of records actually returned.
timezones timezone-info[]
List of time zones from the built-in zoneinfo database.
 Errno  Description
 EINVALIDTAG

 
timezone-list-info-iter-start [top]
Starts iteration to list time zones from the internal database of time zone information.
Output Name Range Type Description
records integer
Number which tells you how many items have been saved for future retrieval with timezone-list-info-iter-next.
tag string
Tag to be used in subsequent calls to timezone-list-info-iter-next.

 
timezone-validate [top]
Determines if a time zone specification is valid. The specification may be the name of timezone returned from timezone-list-info-iter-next(), or can be a POSIX-style time zone specification.
Input Name Range Type Description
timezone string
Proposed time zone string.
 
Output Name Range Type Description
utc-offset integer
Current offset, in seconds, between this time zone and UTC. Range: -43200 to 50400. Negative values are west of UTC; positive values are east of UTC.
 Errno  Description
 EINVALIDTIMEZONE

 
Element definition: timezone-defaults [top]
The default time zone settings.
Name Range Type Description
default-timezone string
Name of the time zone to use for objects that do not specify a time zone. This may be empty, meaning that objects use the server's time zone by default. Set this value with the "dfm option set timezone={new-value}" command.
server-timezone-description string
Description of the time zone in which this DFM server is located. If the "default-timezone" is empty, objects without an explicit time zone setting will use the server's time zone. Example values:
  • "Pacific Standard Time (GMT -8:00)"
  • "US/Eastern (GMT -4:00)"
  • "SGT (GMT +6:00)"
  • "UTC (GMT +0:00)"

 
Element definition: timezone-info [top]
Information about a time zone.
Name Range Type Description
timezone-name string
Name of time zone.