show(1m)show(1m)NAMEshow - Displays current information about the DTS entity
SYNOPSIS
dtscp show attribute-group | attribute-name
ARGUMENTS
The name of an attribute group or individual attribute to be displayed.
The following values are valid: all all characteristics all counters
all status global servers local servers The name of a specific
attribute from the characteristics, counters, or status group. The
attribute specifiers global servers and local servers do not contain
any other attributes.
DESCRIPTION
The show command displays the names and values of the specified
attributes or attribute groups. For attribute groups, if you do not
supply a group name with the all argument, all characteristics and
their values are displayed. The following sections list names of indi‐
vidual attributes, categorized by group.
Note that the attributes displayed by the show command might be differ‐
ent, depending upon whether you have requested information about a
server or a clerk.
Characteristics
Characteristic arguments can contain a maximum of 80 characters and are
recalculated to a normalized date format. For example:
Input value: 0-0025:10:99.99999999 Result: 1-01:11:39.990
Specifies whether a backup courier is currently functioning as a
courier. If the role is noncourier, the node is not attempting to syn‐
chronize with global servers. This characteristic is shown only for
servers.
Default: noncourier Value: courier or noncourier
Specifies whether automatic changes to the time differential factor are
enabled or disabled; the value is determined by the operating system.
Default: true Value: true/false
Specifies the amount of time between checks for faulty servers. Appli‐
cable only to servers that have external time providers. This charac‐
teristic is shown only for servers.
Default: 0-01:30:00.00 Value: 0-00:00:30.000 - 10675199-02:48:05.478
Specifies the rate at which the DTS server or clerk entity adjusts the
node's clock during a synchronization.
Specifies the amount of time between system clock ticks. The value is
determined by the operating system.
Specifies a server's interaction with the set of global servers. This
characteristic is shown only for servers. The local server becomes a
courier if none are available on the LAN. The local server synchro‐
nizes with the global set of servers. The local server does not syn‐
chronize with the global set of servers.
Default: noncourier
Specifies the DTS software version installed on the node.
Specifies the server's epoch number. The change command modifies this
characteristic. This characteristic is shown only for servers.
Default: 0 Value: 0-255
Specifies the maximum separation allowed between the local clock and
the computed time before synchronizations become abrupt rather than
gradual (monotonic).
Default: 0-00:10:00.000 Value: 0-00:00:00.500 - 10675199-02:48:05.478
Specifies the amount of time the node waits for a response to a WAN
synchronization request before sending another request or declaring a
global server to be unavailable. The number of attempts made to reach
the server is controlled by the query attemps characteristic.
Default: 0-00:00:15.000 Value: 0-00:00:00.000 - 0-00:10:00.000
Specifies the amount of time the node waits for a response to a syn‐
chronization request before sending another request or declaring a
server to be unavailable. The number of attempts made to reach the
server is controlled by the query attemps characteristic.
Default: 0-00:00:05.000 Value: 0-00:00:00.000 - 0-00:10:00.000
Specifies the Time Differential Factor (TDF), which is the amount of
time the server varies from Greenwich mean time (GMT) or Coordinated
Universal Time (UTC).
Default: 0-00:00:00.000 Value: -13-00:00:00 - 13-00:00:00 Specifies the
worst-case drift rate of the node's clock, in nanoseconds per second,
as determined by the manufacturer's specifications.
Specifies the inaccuracy limit for the node. When the node exceeds the
maximum inaccuracy setting, it attempts to synchronize.
Default: 0-00:00:00.100 Value: 0-00:00:00.0 - 10675199-02:48:05.478
Specifies the future time at which the time differential factor is
automatically changed. The value is determined by the operating system.
Specifies the number of attempts that a node makes to contact a server
before the node considers the server unavailable.
Default: 3 Value: 1-10
Specifies a server's ACL entry name; <hostname> represents the name of
the system or node that is the server's client. The default setting is
the recommended value. This characteristic is shown only for servers.
Default: /.:/hosts/<hostname>/dts-entity Specifies the security group
name for the time servers within the cell.
Default: /.:/subsys/dce/dts-servers
Specifies a server's principal name for authentication purposes; <host‐
name> represents the name of the system or node that is the server's
client. The default setting is the recommended value. This characteris‐
tic is shown only for servers.
Default: /.:/hosts/<hostname>/self
Specifies the minimum number of servers required for a synchronization.
Settings of 1 or 2 may cause unreliable computed times.
Default: 3 Value: 1-10
Specifies the interval a node must wait to synchronize. Also specifies
synchronization frequency when a node reaches the value specified by
the maximum inaccuracy characteristic.
Clerks:
Default: 0-00:10:00.0 Value: 0-00:00:30.0 - 01 00:00:00.00
Servers:
Default: 0-00:02.00.0 Value: 0-00:00:30.0 - 01 00:00:00.00
Specifies whether or not the entity used an external time provider at
the last successful synchronization. This attribute applies to servers
only.
Specifies the timestamp format used by the node.
Specifies whether the node is a DTS server or clerk. The create command
modifies this characteristic.
Counters
Specifies the number of times the node clock has been set nonmonotoni‐
cally (abruptly).
Specifies the time at which the DTS entity was created and the counters
were initialized.
Specifies the number of times the node received time response messages
from servers or clerks that had epoch numbers different from its own.
This counter is shown only for servers.
Specifies the number of times the DTS has been disabled.
Specifies the number of times the DTS has been enabled.
Specifies the number of times the server's epoch has changed.
Specifies the number of times the node has been unable to allocate vir‐
tual memory.
Specifies the number of times that a local server was contacted, but it
was not in the dts security group.
Specifies the number of times the node's time interval failed to inter‐
sect with the computed interval of the servers.
Specifies the number of times the courier server could not contact any
global servers. This counter is shown only for servers.
Specifies the number of times the local node failed to process a
received message containing an incompatible protocol version.
Specifies the number of times that a non-local server was contacted,
but it was not in the dts security group. This counter is shown only
for servers.
Specifies the number of times the courier server could not contact a
specific global server. This counter is shown only for servers.
Specifies the number of times a server has detected faulty servers
(other than itself). This counter is shown only for servers.
Specifies the number of times the node successfully synchronized.
Specifies the number of times a DTS operation detected a system error.
Specifies the number of times the external time provider signaled a
failure or the node was unable to access the time provider.
Specifies the number of times a dtsd server process initiated contact
with a time provider and did not receive the initial response within
the interval specified by local set timeout (the default interval is 5
seconds). This counter is shown only for servers.
Specifies the number of times the local node failed to process a
received message containing an incompatible timestamp format.
Specifies the number of times a node failed to synchronize because it
could not contact the required minimum number of servers.
Specifies the number of times a server has attempted to update its
clock. This counter is shown only for servers.
Status
Specifies the current time on the node.
Specifies the set of global servers known by the node.
Specifies the computed time at the last attempted synchronization.
Specifies the set of local servers known by the node.
Specifies the state of the DTS entity. The DTS entity is disabled.
The DTS entity is enabled. The DTS entity is synchronizing. The DTS
entity is updating the time.
Specifies the entity's unique identifier, which is generated when the
entity is created. This attribute is shown only for servers.
Privilege Required
You must have read permission on the ACL associated with the DTS entity
in order to execute the command.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and may
not be provided in future releases of DCE.
EXAMPLES
The following command shows how to display the current time:
dtscp> show current time Current Time =
1990-11-30-12:11:41.718-05:00I0.359 EST The following command shows how
to display all of the entity's characteristic attribute settings:
dtscp> show all Check Interval = +0-01:30:00.000I----- Epoch
Number = 0 Error Tolerance =
+0-00:10:00.000I----- Local Time Differential Factor =
-0-04:00:00.000I----- Maximum Inaccuracy = +0-00:00:00.100I-----
Servers Required = 3 Query Attempts = 3 Local Set
Timeout = +0-00:00:05.000I----- Global Set Timeout =
+0-00:00:15.000I----- Synchronization Hold Down = +0-00:02:00.000I-----
Type = Server Courier Role = Non‐
Courier Acting Courier Role = NonCourier Clock Adjustment Rate
= 40000000 nsec/sec Maximum Clock Drift Rate = 1000000 nsec/sec
Clock Resolution = 10000000 nsec DTS Version =
V1.0.1 Time Representation Version = V1.0.0 Time Provider Present =
FALSE Automatic TDF Change = FALSE Next TDF Change =
1993-10-31-06:00:00.000+00:00I0.000 Server Principal Name =
hosts/system1/self Server Entry Name = hosts/system1/dts-entity
Server Group Name = subsys/dce/dts-servers The following com‐
mand displays the current values of all characteristic attributes:
dtscp> show all characteristics
This command produces the same output as does the show all command.
Check Interval = +0-01:30:00.000I----- Epoch Number
= 0 Error Tolerance = +0-00:10:00.000I----- Local Time Dif‐
ferential Factor = -0-04:00:00.000I----- Maximum Inaccuracy =
+0-00:00:00.100I----- Servers Required = 3 Query Attempts
= 3 Local Set Timeout = +0-00:00:05.000I----- Global Set Time‐
out = +0-00:00:15.000I----- Synchronization Hold Down =
+0-00:02:00.000I----- Type = Server Courier Role
= NonCourier Acting Courier Role = NonCourier Clock Adjustment
Rate = 40000000 nsec/sec Maximum Clock Drift Rate = 1000000
nsec/sec Clock Resolution = 10000000 nsec DTS Version
= V1.0.1 Time Representation Version = V1.0.0 Time Provider Present
= FALSE Automatic TDF Change = FALSE Next TDF Change =
1993-10-31-06:00:00.000+00:00I0.000 Server Principal Name =
hosts/system1/self Server Entry Name = hosts/system1/dts-entity
Server Group Name = subsys/dce/dts-servers The following com‐
mand shows how to display all of the local servers known to the entity:
dtscp> show local servers Known Servers
============================================================
Local /.../sisyphus.osf.org/hosts/system2/self
Last Time Polled = 1993-10-15-21:01:46.124+00:00I0.809
Last Observed Time = 1993-10-15-21:03:09.041+00:00I-----
Last Observed Skew = +0-00:01:22.917I-----
Used in Last Synchronization = TRUE
Transport Type = RPC
Local /.../sisyphus.osf.org/hosts/system3/self
Last Time Polled = 1993-10-15-21:01:46.124+00:00I0.809
Last Observed Time = 1993-10-15-21:01:46.143+00:00I0.817
Last Observed Skew = +0-00:00:00.019I1.625
Used in Last Synchronization = TRUE
Transport Type = RPC The following command displays
the current values of all counter attributes:
dtscp> show all counters Creation Time =
1993-10-14-16:23:57.801+00:00I0.767 Local Times Not Intersecting = 0
Server Times Not Intersecting = 0 Different Epochs Detected = 0 Too Few
Servers Detected = 0 Time Provider Timeouts Detected = 1 Protocol Mis‐
matches Detected = 0 Time Representation Mismatches Detected = 0 No
Global Servers Detected = 0 Servers Not Responding = 0 Clock Set‐
tings = 0 Epoch Changes Completed = 0 System Errors
Detected = 0 Synchronizations Completed = 865 Updates Initiated
= 0 Enable Directives Completed = 1 Disable Directives Completed = 0
Insufficient Resources Detected = 0 Time Provider Failures Detected = 0
Local server not in group = 0 Servers not in group = 0 The follow‐
ing command displays the current values of all status attributes:
dtscp> show all status UID =
00004e34-5e1c-2c87-8500-08005a0d4582 Last Synchronization =
1993-10-15-21:05:43.023+00:00I----- State = On The
following command displays the current value of the courier role
attribute:
dtscp> show courier role Courier Role = NonCourier The
following command displays the server entry name for this server:
dtscp> show server entry name Server Entry Name = hosts/sys‐
tem1/dts-entity The following command displays the current state of the
Time Service entity:
dtscp> show state State = On The following command
displays the current value of the check interval attribute:
dtscp> show check interval Check Interval =
+0-01:30:00.000I----- The following command displays the current value
of the servers times not intersecting counter:
dtscp> show servers times not intersecting Server Times Not Intersect‐
ing = 0
RELATED INFORMATION
Commands: set(1m)show(1m)