Microsoft WINS Server MIB
The WINS server MIB contains object-types that are used to monitor the network
traffic between remote hosts and the WINS server.
WINS-MIB DEFINITIONS ::= BEGIN
IMPORTS
enterprises,
OBJECT-TYPE
FROM RFC1155-SMI
DisplayString
FROM RFC1213-MIB;
microsoft OBJECT IDENTIFIER ::= { enterprises 311 }
software OBJECT IDENTIFIER ::= { microsoft 1 }
wins OBJECT IDENTIFIER ::= { software 2 }
par OBJECT IDENTIFIER ::= { wins 1 }
pull OBJECT IDENTIFIER ::= { wins 2 }
push OBJECT IDENTIFIER ::= { wins 3 }
datafiles OBJECT IDENTIFIER ::= { wins 4 }
cmd OBJECT IDENTIFIER ::= { wins 5 }
-- WINS MIB
-- Parameters (Prefix Par)
parWinsStartTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"WINS start time"
::= { par 1 }
parLastPScvTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which planned scavenging
took place. Planned scavenging happens at intervals
specified in the registry. Scavenging involves
changing owned non-refreshed entries to the released
state. Further, replicas may be changed to tombstones,
tombstones may be deleted, and revalidation of old
replicas may take place"
::= { par 2 }
parLastATScvTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which scavenging as a
result of administrative action took place"
::= { par 3 }
parLastTombScvTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which replica tombstone
scavenging took place"
::= { par 4 }
parLastVerifyScvTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which revalidation of
old active replicas took place"
::= { par 5 }
parLastPRplTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which planned replication
took place. Planned replication happens at intervals
specified in the registry"
::= { par 6 }
parLastATRplTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which administrator-
triggered replication took place."
::= { par 7 }
parLastNTRplTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which network-triggered
replication took place. Network-triggered replication
happens as a result of an update notification message
from a remote WINS"
::= { par 8 }
parLastACTRplTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which address change-
triggered replication took place. Address change-
triggered replication happens when the address of
an owned name changes due to a new registration"
::= { par 9 }
parLastInitDbTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which the local database
was populated statically from one or more data files"
::= { par 10 }
parLastCounterResetTime OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..30))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Most recent date and time at which the local counters
were initialized to zero"
::= { par 11 }
parWinsTotalNoOfReg OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
registrations received"
::= { par 12 }
parWinsTotalNoOfQueries OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
queries received"
::= { par 13 }
parWinsTotalNoOfRel OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
releases received"
::= { par 14 }
parWinsTotalNoOfSuccRel OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
releases that succeeded"
::= { par 15 }
parWinsTotalNoOfFailRel OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
releases that failed"
::= { par 16 }
parWinsTotalNoOfSuccQueries OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
queries that succeeded"
::= { par 17 }
parWinsTotalNoOfFailQueries OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This variable indicates the number of
queries that failed"
::= { par 18 }
parRefreshInterval OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the refresh interval.
Unit is in milliseconds"
::= { par 19 }
parTombstoneInterval OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the tombstone interval.
Unit is in milliseconds"
::= { par 20 }
parTombstoneTimeout OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the tombstone timeout.
Unit is in milliseconds"
::= { par 21 }
parVerifyInterval OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the verify interval.
Unit is in milliseconds."
::= { par 22 }
parVersCounterStartValLowWord OBJECT-TYPE
SYNTAX Counter
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the low word of the
version counter that WINS should start with"
::= { par 23 }
parVersCounterStartValHighWord OBJECT-TYPE
SYNTAX Counter
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the high word of the
version counter that WINS should start with"
::= { par 24 }
parRplOnlyWCnfPnrs OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates whether or not
replication should be done with non-configured partners. If not
set to zero, replication will be done only with partners listed in the
registry (except when an update notification comes in)"
::= { par 25 }
parStaticDataInit OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates whether static data should
be read in at initialization and reconfiguration time.
Update of any MIB variable in the parameters group constitutes
reconfiguration"
::= { par 26 }
parLogFlag OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates whether logging should be
done. Default behavior is to do logging"
::= { par 27 }
parLogFileName OBJECT-TYPE
SYNTAX DisplayString
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable gives the path to the log file"
::= { par 28 }
parBackupDirPath OBJECT-TYPE
SYNTAX DisplayString
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable gives the path to the backup directory"
::= { par 29 }
parDoBackupOnTerm OBJECT-TYPE
SYNTAX INTEGER {
no(0),
yes(1)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable specifies whether WINS should do
backup on termination. Setting it to 1 holds no
meaning unless parBackupDirPath is set also"
::= { par 30 }
parMigrateOn OBJECT-TYPE
SYNTAX INTEGER {
no(0),
yes(1)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable specifies whether static records
in the WINS database should be treated as
dynamic records during conflicts with new
dynamic registrations"
::= { par 31 }
-- datafiles group (Prefix df)
dfDatafilesTable OBJECT-TYPE
SYNTAX SEQUENCE OF DFDatafileEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION
"A list of datafiles specified under the Datafiles
key in the registry. These files are used for
static initialization of the WINS database"
::= { datafiles 1 }
dfDatafileEntry OBJECT-TYPE
SYNTAX DFDatafileEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION
"data file name"
INDEX { dfDatafileIndex }
::= { dfDatafilesTable 1 }
DFDatafileEntry ::= SEQUENCE {
dfDatafileIndex
INTEGER,
dfDatafileName
DisplayString
}
dfDatafileIndex OBJECT-TYPE
SYNTAX INTEGER
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
"Used for indexing entries in the datafiles table.
It has no other use"
::= { dfDatafileEntry 1 }
dfDatafileName OBJECT-TYPE
SYNTAX DisplayString
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Name of the datafile to use for static initialization"
::= { dfDatafileEntry 2 }
-- pull group (Prefix pull)
pullInitTime OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates whether pull should be
done at WINS invocation and at reconfiguration.
If any pull group's MIB variable is set, that
constitutes reconfiguration"
::= { pull 1 }
pullCommRetryCount OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable gives the retry count in
case of communication failure when doing pull replication.
This is the maximum number of retries that will be
done at the interval specified for the partner
before WINS will stop for a certain number (canned) of
replication time intervals before starting again."
::= { pull 2 }
pullPnrTable OBJECT-TYPE
SYNTAX SEQUENCE OF PullPnrEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION
"A list of partners with which pull replication needs
to be done"
::= { pull 3 }
pPullPnrEntry OBJECT-TYPE
SYNTAX PullPnrEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This is the row corresponding to a partner"
INDEX { pullPnrAdd }
::= { pullPnrTable 1 }
PullPnrEntry ::= SEQUENCE {
pullPnrAdd
IpAddress,
pullPnrSpTime
DisplayString,
pullPnrTimeInterval
INTEGER,
pullPnrMemberPrec
Counter,
pullPnrNoOfSuccRpls
Counter,
pullPnrNoOfCommFails
Counter
}
pullPnrAdd OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This is the address of the remote WINS partner"
::= { pPullPnrEntry 1 }
pullPnrSpTime OBJECT-TYPE
SYNTAX DisplayString
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable gives the specific time at which
pull replication should occur"
::= { pPullPnrEntry 2 }
pullPnrTimeInterval OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable gives the time interval for
pull replication"
::= { pPullPnrEntry 3 }
pullPnrMemberPrec OBJECT-TYPE
SYNTAX INTEGER {
low(0),
high(1)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This is the precedence to be given to members of
the special group pulled from the WINS. Note:
the precedence of locally registered members of a
special group is more than any replicas pulled in"
::= { pPullPnrEntry 4 }
pullPnrNoOfSuccRpls OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The number of times replication was successful with
the WINS after invocation or reset of counters"
::= { pPullPnrEntry 5 }
pullPnrNoOfCommFails OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The number of times replication was unsuccessful with
the WINS due to communication. failure (after invocation or reset of counters)"
::= { pPullPnrEntry 6 }
pullPnrVersNoLowWord OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The low word of the highest version number found in records owned by this WINS."
::= { pPullPnrEntry 7 }
pullPnrVersNoHighWord OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The high word of the highest version number found in records owned by this WINS."
::= { pPullPnrEntry 8 }
-- push group (Prefix - push)
pushInitTime OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates whether a push (that is, a
notification message) should be done at invocation."
::= { push 1 }
pushRplOnAddChg OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates whether a notification
message should be sent when an address changes"
::= { push 2 }
pushPnrTable OBJECT-TYPE
SYNTAX SEQUENCE OF PushPnrEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION
"A list of WINS partners with which push
replication is to be initiated"
::= { push 3 }
pushPnrEntry OBJECT-TYPE
SYNTAX PushPnrEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This is the row corresponding to the WINS partner"
INDEX { pushPnrAdd }
::= { pushPnrTable 1 }
PushPnrEntry ::= SEQUENCE {
pushPnrAdd
INTEGER,
pushPnrUpdateCount
INTEGER
}
pushPnrAdd OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Address of the WINS partner"
::= { pushPnrEntry 1 }
pushPnrUpdateCount OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable indicates the number of updates that
should result in a push message"
::= { pushPnrEntry 2 }
-- cmd group (Prefix - cmd)
cmdPullTrigger OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable, when set, will cause the WINS to
pull from the remote WINS identified by the IpAddress"
::= { cmd 1 }
cmdPushTrigger OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable, when set, will cause the WINS to
push a notification message to the remote WINS
identified by the IpAddress"
::= { cmd 2 }
cmdDeleteWins OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable, when set, will cause all information
pertaining to a WINS (data records, context
information) to be deleted from the local WINS.
Use this only when owner-address mapping table is
getting to near capacity. Note: Deletion of all
information pertaining to the managed WINS is not
permitted"
::= { cmd 3 }
cmdDoScavenging OBJECT-TYPE
SYNTAX INTEGER {
no(0),
yes(1)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable, when set, will cause WINS to do
scavenging."
::= { cmd 4 }
cmdDoStaticInit OBJECT-TYPE
SYNTAX DisplayString
ACCESS read-write
STATUS mandatory
DESCRIPTION
"When this variable is set, WINS will do static
initialization using the file specified as the value.
If 0 is specified, WINS will do static initialization using the
files specified in the registry (can be read-written using Datafile table"
::= { cmd 5 }
cmdNoOfWrkThds OBJECT-TYPE
SYNTAX INTEGER (1..4)
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Sets the number of worker threads in WINS"
::= { cmd 6 }
cmdPriorityClass OBJECT-TYPE
SYNTAX INTEGER {
normal(0),
high(1)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Sets the priority class of WINS to normal or high"
::= { cmd 7 }
cmdResetCounters OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Resets the counters. Value is ignored"
::= { cmd 8 }
cmdDeleteDbRecs OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable, when set, will cause all data records
pertaining to a WINS to be deleted from the local WINS.
Note: Only data records are deleted."
::= { cmd 9 }
cmdDRPopulateTable OBJECT-TYPE
SYNTAX IpAddress
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This variable can be set to retrieve records of
a WINS whose Ip address is provided. When set,
the table is populated immediately"
::= { cmd 10 }
cmdDRDataRecordsTable OBJECT-TYPE
SYNTAX SEQUENCE OF CmdDRRecordEntry
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This is the table that stores the data records.
The records are sorted by name.
Note: the table is cached (to save on overhead on WINS).
To repopulate the table, set cmdDRDataRecordsTable mib var"
::= { cmd 11 }
cmdDRRecordEntry OBJECT-TYPE
SYNTAX CmdDRRecordEntry
ACCESS read-write
STATUS mandatory
DESCRIPTION "Data record owned by WINS whose address
was specified when CmdDRRecordsTable was
set"
INDEX { cmdDRRecordName }
::= { cmdDRDataRecordsTable 1 }
CmdDRRecordEntry ::= SEQUENCE {
cmdDRRecordName
DisplayString,
cmdDRRecordAddress
OCTET STRING,
cmdDRRecordType
INTEGER,
cmdDRRecordPersistenceType
INTEGER,
cmdDRRecordState
INTEGER
}
cmdDRRecordName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(1..255))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Name in the record"
::= { cmdDRRecordEntry 1 }
cmdDRRecordAddress OBJECT-TYPE
SYNTAX OCTET STRING
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Address(es) of the record. If the record is
a multihomed record or a special group, the
addresses are returned sequentially in pairs.
Each pair is comprised of the address of the
owner WINS followed by the address of the
machine (multihomed)/member (special group).
Note: Following SNMP's convention, the records
are always returned in network byte order"
::= { cmdDRRecordEntry 2 }
cmdDRRecordType OBJECT-TYPE
SYNTAX INTEGER {
unique(0),
normalgroup(1),
specialgroup(2),
multihomed(3)
}
Note: The preceding order should not be disturbed. It is the same as-- in winsintf.h (WINSINTF_RECTYPE_E)
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Type of the record"
::= {cmdDRRecordEntry 3 }
cmdDRRecordPersistenceType OBJECT-TYPE
SYNTAX INTEGER {
static(0),
dynamic(1)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
"Persistence type of the record"
::= { cmdDRRecordEntry 4 }
cmdDRRecordState OBJECT-TYPE
SYNTAX INTEGER {
active(0),
released(1),
tombstone(2),
deleted(3)
}
-- Note: The preceding order should not be disturbed. It is the same as
-- in winsintf.h (WINSINTF_STATE_E)
-- for a SET operation only released and deleted values are
-- allowed
ACCESS read-only
STATUS mandatory
DESCRIPTION
"State of the record."
::= { cmdDRRecordEntry 5 }
cmdWinsVersNoLowWord OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The low word of the version number counter of the WINS"
::= { cmd 12 }
cmdWinsVersNoHighWord OBJECT-TYPE
SYNTAX INTEGER
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The high word of the version number counter of the WINS"
::= { cmd 13 }
END