Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)

Fabric OS Command Reference Manual 2-711
Publication Number: 53-1000240-01
tsTimeZone
2
Note: Enter commands in lowercase only; mixed case is for readability.
tsTimeZone
Displays or sets the system time zone.
Synopsis tstimezone --interactive
tstimezone timezonename
tstimezone [--old][hourOffset [, minuteOffset]]
Description Use this command to display or set the system time zone.
All switches maintain the current time zone setup in nonvolatile memory. Changing the time zone on a
switch updates the local time zone setup and is reflected in local time calculations.
All switches are by default in the 0,0 time zone: that is, GMT. If all switches in a fabric are in one time
zone, it is possible to leave the time zone setup at the default.
Time zone is used only in computing local time, which is used for error reporting and logging. An
incorrect time zone setup does not affect the switch operation in any way.
System services started during the switch boot reflect time-zone change only at the next reboot.
The time zone can be specified either by name or an older hours and minutes format.
The older format is specified with the --old option. It only allows a subset of values for the hours and
minutes to avoid errors.
The newer format uses the zoneinfo database, which is capable of adjusting for Daylight Saving Time
automatically.
The switch is originally in the old mode, with zero offsets, i.e. in GMT. Use tsTimeZone timezonename
to place the switch in the new format.
Enter this command with no parameters to display the time zone setup. With the valid parameters, it sets
the time zone for an individual switch.
When the time zone is set using the old format, a subsequent tsTimeZone command with no paramaters
will display the time zone setup in the old format. When the time zone is set using the new format, a
subsequent tsTimeZone command will display the time zone setup in the new format.
Negative houroffset values mean that the local time is behind GMT; for example, -8,0 is GMT-08:00
Positive houroffset values mean the that local time is ahead of GMT; for example, 3,0 is GMT+03:00
N
ote
In systems where multiple switches are housed in one chassis, the time zone of switch 0 will be the
system time zone if the time is in the old format. If the time is set to a named format, then the entire
chassis is set to this format.
Operands This command has the following operands:
hourOffset Specify the number of hours relative to GMT. This operand must be specified as
an integer. Valid values are -12 through 12. This operand is optional.
minuteOffset Specify the number of minutes relative to houroffset. This operand must be
specified as an integer. Valid values are -30, 0, or 30. This operand is optional.
The hourOffset can be specified without a minuteOffset which will then default to
zero. These operands are only valid with the --old action.