DOCS-PNM-MIB :: docsPnmCmtsUsHistFileName

MIB Reference — IPNetwork Monitor · Updated October 05, 2026

All MIBs › DOCS-PNM-MIB › docsPnmCmtsUsHistFileName

docsPnmCmtsUsHistFileName

Module: DOCS-PNM-MIB

OID (symbolic): DOCS-PNM-MIB::docsPnmCmtsUsHistFileName

OID (numeric): 1.3.6.1.4.1.4491.2.1.27.1.3.5.1.4

Node type: OBJECT-TYPE

Type: SnmpAdminString

Access: read-write

Description: This object is the name of the file at the CCAP which is to be transferred to the PNM server. The data is stored as 32 bit integers for the hit and dwell count values. This value can only be changed while a test is not in progress. An attempt to set this value while the value of 'docsPnmCmtsUsHistMeasStatus' is 'busy' will return 'inconsistentValue'. If the value of this object is the DEFVAL (empty string), then a default filename value will be used. Otherwise the value set will be used as the filename. If a default filename is generated, then that value will be returned in this object and will represent the filename that was used for the test. All subsequent tests should set this object to a meaningful value or to an 'empty string' value (to generate a new default filename) before starting a new test. If a default filename value is used, it is generated as the test name plus a unique CCAP identifier (either a loopback address (IPv4 or IPv6) or FQDN), plus the 'epoch time'. The epoch time (also known as 'unix time') is defined as the number of seconds that have elapsed since midnight Coordinated Universal Time (UTC), Thursday, 1 January 1970. Hence, the format would be: PNMCcapHist__ For example: PNMCcapHist_ccap1.boulder.cablelabs.com_1403405123 The data file is comprised of a header plus the Histogram Data. The header is comprised of ordered fixed-length fields. Unless otherwise specified, the header fields contain hex values that are right-justified within the field. If necessary the field is left-padded with zero values. Syntax of the file is as follows: File Type set to '504E4D68' (without the quotes) 4 bytes Capture Time 4 bytes ifIndex 4 bytes Unique CCAP ID 256 bytes Symmetry 4 bytes Length in bytes of Dwell Count values that follows 4 bytes DwellCount Values (1-4096)*4 bytes each Length in bytes of HitCount values that follow 4 bytes HitCount Values (1-4096)*4 bytes each

What is docsPnmCmtsUsHistFileName?

The filename at the CCAP holding the 32-bit hit/dwell-count upstream histogram data awaiting TFTP download; defaults to an auto-generated 'PNMCcapHist_<CCAP ID>_<epoch>' name if left empty. An admin sets a meaningful name before repeated tests, or leaves it blank for a fresh auto-generated name each run.

Examples

Walk all instances (SNMPv2c):

snmpwalk -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.3.5.1.4
snmpwalk -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmtsUsHistFileName

Get a specific instance (index 1):

snmpget -v2c -c public <target> 1.3.6.1.4.1.4491.2.1.27.1.3.5.1.4.1
snmpget -v2c -c public <target> DOCS-PNM-MIB::docsPnmCmtsUsHistFileName.1

Set instance 1 (SNMPv2c):

snmpset -v2c -c private <target> 1.3.6.1.4.1.4491.2.1.27.1.3.5.1.4.1 s <value>

Start monitoring DOCSIS 3.1 cable modem/CMTS (Proactive Network Maintenance, vendor-neutral CableLabs standard) with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the DOCS-PNM-MIB::docsPnmCmtsUsHistFileName OID value, configure state conditions and alerts, and monitor any DOCSIS 3.1 cable modem/CMTS (Proactive Network Maintenance, vendor-neutral CableLabs standard) from a single console.

OID Breakdown

Upper-level ancestors (9 from the standard OID tree / other modules)
Numeric OIDNameModule
1isoLANART-AGENT
1.3orgAirPair-MIB
1.3.6dodAirPair-MIB
1.3.6.1internetAirPair-MIB
1.3.6.1.4privateAirPair-MIB
1.3.6.1.4.1enterprisesAirPair-MIB
1.3.6.1.4.1.4491cableLabsCLAB-DEF-MIB
1.3.6.1.4.1.4491.2clabProjectCLAB-DEF-MIB
1.3.6.1.4.1.4491.2.1clabProjDocsisCLAB-DEF-MIB
Numeric OIDNameModule
1.3.6.1.4.1.4491.2.1.27docsPnmMIBDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1docsPnmMibObjectsDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3docsPnmCmtsObjectsDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3.5docsPnmCmtsUsHistTableDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3.5.1docsPnmCmtsUsHistEntryDOCS-PNM-MIB
1.3.6.1.4.1.4491.2.1.27.1.3.5.1.4docsPnmCmtsUsHistFileNameDOCS-PNM-MIB