Cisco IOS Bulkstat and Data Collection Manager Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)

match (Bulkstat)

To configure a filter set for an object in the Bulkstat Simple Network Management Protocol (SNMP) data set during collection, use the match command in Bulkstat filter configuration mode. To remove a filter set from the data set, use the no form of this command.

match object-name { eq | start | not | { eq | start } } { line }

no match object-name

Syntax Description

object-name	Object name for which the filter is applied. The name must match the name of the object configured in the bulkstat data command.
eq	Matches numeric and string values defined in the object.
start	Matches only the string value defined in the object. If there is a numeric data type in the object, this may result in the filter not operating.
not	Performs a logical NOT operation on the conditions set.
line	Comma-separated value list. If the list is a string, specify the string in quotation marks.

Command Default

By default, a filter set is not configured in the Bulkstat SNMP data set.

Command Modes

Bulkstat filter configuration (config-bs-filter)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

More than one value can be specified for an object and more than one object can have match values. Currently this configuration is supported only for SNMP objects.

Note

The object for which a filter is applied, should be a name configured with the bulkstat data command.

Examples

The following example shows how to configure a Bulkstat filter set for an object:

Device> enable
Device# configure terminal
Device(config)# bulkstat filter ifType 
Device(config-bs-filter)# match ifType eq 131,132,100

Related Commands

Command	Description
bulkstat data	Configures a Bulkstat data set for command, expression, and Simple Network Management Protocol (SNMP) elements.
bulkstat filter	Configures a Bulkstat filter set.

object (Bulkstat data-group)

To process a Bulkstat data-group object and configure object specific parameters, use object command. To remove object specific parameters, use the no form of this command.

object object-name sample { absolute | delta }

no object object-name

Syntax Description

object-name	Name of the object
sample	Specifies whether the processing is done on absolute or delta values.
absolute	Processes absolute values for this object.
delta	Processes delta values for this object.

Command Default

By default, object specific parameters of a Bulkstat data-group are not configured.

Command Modes

Bulkstat data group process configuration (config-bs-dg-proc)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Examples

The following example shows how to process absolute values for the Bulkstat data-group object:

Device> enable
Device# configure terminal
Device# bulkstat data-group dg-name        
Device(config-bs-dg)# process
Device(config-bs-dg-proc)# object BSObject sample absolute

object (Bulkstat expression)

To configure Bulkstat expression objects, use the object command in Bulkstat data set expression configuration mode. To remove the configuration, use the no form of this command.

object object-number

no object object-number

Syntax Description

object-number

Object number in a Bulkstat expression.

Note

If the expression is “$1+$2”, then object 1 refers to the object at $1. If an object is specified with a number that is not mentioned in the expression, the configuration succeeds, but the object is not used in the evaluation of the expression type.

Command Default

By default, Bulkstat expression objects are not configured.

Command Modes

Bulkstat data set expression configuration (config-bs-ds-expr)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

If the object command is used and the object is already configured, the execution results in setting the context to the existing object, and the command mode switches to the Bulkstat data set expression object configuration mode.

Examples

The following example shows how to configure an object for a Bulkstat expression using the object command:

Device> enable
Device# configure terminal
Device(config)# bulkstat data interface-util type expression
Device(config-bs-ds-expr)# object 1

Related Commands

Command	Description
bulkstat data	Configures a Bulkstat data set for command, expression, and SNMP type of elements.

object (Bulkstat SNMP)

To add an object inside a Bulkstat Simple Network Management Protocol (SNMP) data set, use the object command in Bulkstat data set SNMP configuration mode. To remove an object from a Bulkstat SNMP data set, use the no form of this command.

object oid [ alias alias-name ]

no object oid

Syntax Description

oid

The object identifier. Dotted notation OID format is always expected to be understood by the agent if the object is supported. If the specified object is not understood by the agent, then this command will not be accepted.

The object is defined by cdcDGBaseObjectSubtree.

alias alias-name

(Optional) Specifies an optional name to be associated with the object. Specify an alias-name, if the agent can only understand the dotted notation OID. This name is used to represent the object in the file containing the collected data.

Command Default

By default, an object in the SNMP data set is not configured.

Command Modes

Bulkstat data set snmp configuration (config-bs-ds-snmp)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

If the object is already present in the data set, execution of the object command in Bulkstat data set SNMP configuration mode replaces the old object configuration with the new configuration.

Examples

Device> enable
Device# configure terminal
Device(config)# bulkstat data interface-stats type snmp
Device(config-bs-ds-snmp)# object 1.3.6.1.2.1.2.2.1.10 alias ifInOctets

Related Commands

Command	Description
bulkstat data	Configures a Bulkstat data set.

process

To configure process-related parameters for a Bulkstat data group, use the process command in Bulkstat data group configuration mode. To remove process-related parameters, use the no form of this command.

process

no process

Syntax Description

This command has no keywords or arguments.

Command Default

By default, process-related parameters are not configured for a Bulkstat data group.

Command Modes

Bulkstat data group configuration (config-bs-dg)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

Execution of the process command results in a configuration change and replaces any existing configuration.

Examples

The following example shows how to configure process–related parameters for a Bulkstat data group:

Device> enable
Device# configure terminal
Device# bulkstat data-group dg-name        
Device(config-bs-dg)# process

Related Commands

Command	Description
collect	Configures collection parameters for a Bulkstat data group.
context	Configures the context for a Bulkstat data group.
discard	Discards raw data for a Bulkstat data group.
interval	Configures interval parameters for a Bulkstat data group.

profile

To schedule data collection on Bulkstat profiles, use the profile command in Bulkstat schedule configuration mode. To stop data collection, use the no form of this command.

profile bulkstat-profile-name { start { oneshot | recurring } | stop }

no profile bulkstat-profile-name

Syntax Description

bulkstat-profile-name	Bulkstat profile name, which is created using the bulkstat profile command.
start	Specifies that data collection should start for a particular Bulkstat profile.
oneshot	Specifies that data collection occurs only once.
recurring	Specifies that data collection occurs repeatedly according to the conditions set.
stop	Specifies that data collection should stop for a particular Bulkstat profile.

Command Default

By default, data collection is not enabled on Bulkstat profiles.

Command Modes

Bulkstat schedule configuration (config-bs-schedule)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

Use the profile command to start scheduled data collection for specific Bulkstat profiles. You can enable multiple profiles for data collection.

Examples

The following example shows how to start and stop data collection on multiple Bulkstat profiles using the profile command:

Device> enable
Device# configure terminal
Device(config)# bulkstat schedule mycal at 08:00 feb 05 oneshot
Device(config-bs-schedule)# profile snmp_profile start recurring  
Device(config-bs-schedule)# profile cli_profile start recurring
Device(config-bs-schedule)# profile exp_profile start recurring

Device(config)# bulkstat schedule mycal at 22:00 feb 05 oneshot
Device(config-bs-schedule)# profile snmp_profile stop  
Device(config-bs-schedule)# profile cli_profile stop
Device(config-bs-schedule)# profile exp_profile stop

Related Commands

Command	Description
bulkstat profile	Configures a Bulkstat profile.
bulkstat schedule	Configures a Bulkstat calendar scheduler to enable data collection.

range

To configure a range instance for a Bulkstat Simple Network Management Protocol (SNMP) instance set, use the range command in the Bulkstat Simple Network Management Protocol (SNMP) instance set configuration mode. To remove a range instance from Bulkstat SNMP instance set, use the no form of this command.

range start oid end oid

no range start oid end oid

Syntax Description

start oid

Specifies the start of a range instance.

Object identifier. This object is defined by cdcDGInstanceOid (Cisco Data Collection Data Group Instance Oid).

end oid

Specifies the end of a range instance.

Object identifier. This object is defined by cdcDGInstanceOid (Cisco Data Collection Data Group Instance Oid).

Command Default

By default, a range instance is not configured for a Bulkstat SNMP instance set.

Command Modes

Bulkstat instance snmp configuration (config-bs-is-snmp)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

You can configure multiple of ranges in the same instance set. However, overlapping instances should be avoided because the system will not check for overlapping instance configurations and all instances within the range, including the start and end will be collected.

Examples

The following example shows how to configure a range instance using the range command:

Device> enable
Device# configure treminal
Device(config)# bulkstat instance exact type snmp
Device(bs-is-snmp)# range start 1.2.3.4 end 1.2.3.6

Related Commands

Command	Description
bulkstat data	Configures a Bulkstat data set for SNMP.
exact	Configures an exact instance in a Bulkstat SNMP instance set.
wildcard	Configures a wildcard instance in a Bulkstat SNMP instance set.

repetition

To configure a repetition instance for a Bulkstat Simple Network Management Protocol (SNMP) instance set, use the repetition command in Bulkstat instance SNMP configuration mode. To remove the repetition instance, use the no form of this command.

repetition oid oid max max_repetition_value

no repetition oid oid

Syntax Description

oid oid

Specifies an object identifier (OID) in dotted decimal notation. The object is defined by cdcDGInstanceOid..

max max_repetition_value

Specifies the maximum number of repetitions.

Maximum repetition value. The range is from 1 to 2147483647. This object is defined by cdcDGInstanceNumRepititions.

Command Default

By default, repetition instance values are not configured.

Command Modes

Bulkstat instance snmp configuration (config-bs-is-snmp)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

You can configure multiple repetitions of the same instance set, but they should be avoided because the system will not check for overlapping instance configurations.

Examples

The following example shows how to configure a repetition instance using the repetition command:

Device> enable
Device# configure terminal
Device(config)# bulkstat instance exact type snmp
Device(config-bs-is-snmp)# repetition oid 1.2.3.4 max 12

Related Commands

Command	Description
exact	Configures an exact instance in an instance set.
range	Configures a range instance in an instance set.
wildcard	Configures a wildcard instance in an instance set.

sample (Bulkstat)

To configure an object value to be used in evaluating expression MIB output, use the sample command in Bulkstat data set expression object configuration mode. To remove the configuration, use the no form of this command.

sample { absolute | changed | delta }

no sample

Syntax Description

sample	Specifies the sampling type—absolute or changed or delta. Object is defined by expObjectSampleType in RFC 2982, Distributed Management Expression MIB.
absolute	Returns a value of the MIB object at the time it is sampled.
changed	Returns a Boolean value that indicates whether the object has changed value since the last sampling.
delta	Returns a difference in value from one sampling to the next sampling.

Command Default

This command has no default behavior.

Command Modes

Bulkstat data set expression object configuration (config-bs-ds-expr-obj)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Examples

The following example shows how to configure object value to be used in evaluating expression output MIB using the sample command:

Device> enable
Device# configure terminal
Device(config)# bulkstat data-set expression
Device(config-bs-ds-expr)# object 1
Device(config-bs-ds-expr-obj)# sample delta

Related Commands

Command	Description
conditional object	Configures conditional evaluation of a data set of expression output.
discontinuity object	Configures discontinuity behaviors for Bulkstat data set expression output.
id	Configures an object ID for expression output.
wildcard	Computes the expression for all instances of an object.

show bulkstat data-group

To display the details of the Data Collection Manager (DCM) data-group configured by the user, use the show bulkstat data-group command in privileged EXEC mode.

Syntax Description

data-group-name	Specifies the name of the data-group.
process	Displays processing data.
object object-name	Displays processed data of the specified object.
index index-value	Displays processed data of the specified object's index or instance.
distribution	Displays distribution data.
summary	Displays summary data.
percentile value	Displays percentile data and percentile value for a specified number.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Examples

The following example shows the results of the show bulkstat data-group command for the data-group BSDataGroup configured by the user:

Device> enable
Device#  show bulkstat data-group BSDataGroup process distribution

Data-Group BSDataGroup Process data

Objectname       : 1.3.6.1.2.1.2.2.1.16

Number of samples: 9

Distribution Data:
* Buckets with no data are not shown

Instance     Number of    Range               Range
             buckets      start               end
-------------------------------------------------------
436752384      250          0               4294967295

Bucket     Bucket         Bucket              Count
Index      Start          End
------------------------------------------------------
1          0.000        17179869.180            9

The table below describes the significant fields shown in the output.

Table 1 show bulkstat data-group Field Descriptions
Field	Description
Objectname	Indicates the name of the object configured in DCM.
Number of samples	Indicates the number of samples polled.
Instance	Indicates the object instance for the above object name.
Number of buckets	Indicates the number of buckets configured in which the values of the object are saved when distribution or percentile processing is performed.
Range start	Indicates the start range in which the objects value can lie.
Range end	Indicates the end range in which the objects value can lie.
Bucket Index	Indicates the bucket number.
Bucket Start	Indicates the start range of the bucket.
Bucket End	Indicates the end range of the bucket.
Count	Indicates the number of samples in the bucket.

Related Commands

Command	Description
bulkstat profile	Enables or disables the profile collection and transfer from privileged EXEC mode.
show bulkstat pre-defined	Displays the details of pre-defined data-sets, data-groups, and instance-sets in DCM
show bulkstat profile	Displays the details of user-created profiles in DCM.

show bulkstat pre-defined

To display the details of the Data Collection Manager (DCM) predefined data-sets, data-groups, and instance-sets, use the show bulkstat pre-defined command in privileged EXEC mode.

show bulkstat pre-defined [ data data-set-name | data-group data-group-name | instance instance-set-name ]

Syntax Description

data data-set-name	Specifies the name of the data-set.
data-group data-group-name	Specifies the name of the data-group.
instance instance-set-name	Specifies the name of the instance set.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
Cisco IOS XE Release 3.3SE	This command was introduced.

Examples

The following is sample output from the show bulkstat predefined command. The output is self-explanatory.

Device> enable
Device# show bulkstat predefined

bulkstat data _pd_ClientDS type snmp
  object cldcClientWlanProfileName
  object cldcClientProtocol
  object cldcClientWgbStatus
  object cldcClientWgbMacAddress
  object cldcClientCurrentTxRateSet
  object cldcClientLoginTime
  object cldcClientDataRetries
  object cldcClientRtsRetries
bulkstat data _pd_MobileStationDS type snmp
  object bsnMobileStationMacAddress
  object bsnMobileStationIpAddress
  object bsnMobileStationUserName
  object bsnMobileStationAPMacAddr
  object bsnMobileStationAPIfSlotId
  object bsnMobileStationEssIndex
  object bsnMobileStationSsid
  object bsnMobileStationAID
  object bsnMobileStationStatus
  object bsnMobileStationReasonCode
  object bsnMobileStationStatusCode
  object bsnMobileStationMobilityStatus
  object bsnMobileStationAnchorAddress
  object bsnMobileStationAuthenticationAlgorithm
  object bsnMobileStationDeleteAction
  object bsnMobileStationPolicyManagerState
  object bsnMobileStationSecurityPolicyStatus
  object bsnMobileStationInterface
  object bsnMobileStationWepState
  object bsnMobileStationVlanId
  object bsnMobileStationPolicyType
  object bsnMobileStationEncryptionCypher
  object bsnMobileStationEapType
bulkstat data _pd_MobileStationStatsDS type snmp
  object bsnMobileStationRSSI
  object bsnMobileStationSnr
  object bsnMobileStationBytesSent
  object bsnMobileStationBytesReceived
  object bsnMobileStationPacketsSent
  object bsnMobileStationPacketsReceived
bulkstat instance _pd_wildcardIS type snmp
  wildcard
bulkstat data-group _pd_ClientDG
  collect type snmp data _pd_ClientDS instance _pd_wildcardIS
  interval polling 300
bulkstat data-group _pd_MobileStationDG
  collect type snmp data _pd_MobileStationDS instance _pd_wildcardIS
  interval polling 300
bulkstat data-group _pd_MobileStationStatsDG
  collect type snmp data _pd_MobileStationStatsDS instance _pd_wildcardIS
  interval polling 300

Related Commands

Command	Description
show bulkstat data-group	Displays the details of user-created data-groups in DCM.
show bulkstat profile	Displays the details of user-created profiles in DCM.

show bulkstat profile

To display the details of the Data Collection Manager (DCM) profile configured by the user, use the show bulkstat profile command in privileged EXEC mode.

show bulkstat profile [ file | name bulkstat-profile-name ]

Syntax Description

file	Specifies that the details of the file are to be displayed.
name bulkstat-profile-name	Specifies the name of the profile.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Examples

The following example displays the details of the profile pf2 created by the user:

Device> enable
Device# show bulkstat profile

Profile Name  : pf2
Admin Status  : Enabled
Enable Reason : Config
Oper Status   : Active

Data-group's in profile:
Name                            Oper State     Repetitions Left
--------------------------------------------------------------------
_pd_MobileStationStatsDG        Active         -

The following example displays the file details of the profile pf2 created by the user:

Device> enable
Device# show bulkstat profile file name pf2

Profile Name                           : pf2
Curr file size                         : 436(bytes)
Time left for raw data transfer        : 66(secs)

The table below describes the significant fields shown in the output.

Table 2 show bulkstat profile Field Descriptions
Field	Description
Profile Name	Indicates the name of the profile
Admin Status	Indicates the administrative status of the profile.
Enable Reason	Indicates if the profile is enabled from global configuration mode or privileged EXEC mode.
Oper Status	Indicates the operating status of the profile created by the user.
Name	Indicates the name of the profile
Repetitions Left	Indicates the number of repetitive collections left when you enable the Bulkstat profile using the bulkstat profile command from privileged EXEC mode with repeat option.
Curr file size	Indicates the size of the file.
Time left for raw data transfer	Indicates the time left for file transfer.

Related Commands

Command	Description
bulkstat profile	Enables or disables the profile collection and transfer from privileged EXEC mode.
show bulkstat data-group	Displays the details of user-created data-groups in DCM.
show bulkstat pre-defined	Displays the details of pre-defined data-sets, data-groups, and instance-sets in DCM.

snmp-server enable

To enable notifications for Bulkstat, use the snmp-server enable command in global configuration mode. To remove notification configurations, use the no form of this command.

snmp-server enable [ collection | transfer ]

Syntax Description

collection	Enables the cdcVFileCollectionErrorEnable object for all profiles.
transfer	Enables the cdcFileXferConfSuccessEnable and cdcFileXferConfFailureEnable objects for all profiles.

Command Default

Notifications are not enabled.

Command Modes

Global configuration (config)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Examples

The following example shows how to configure notifications for Bulkstat configuration:

Device# configure terminal
Device(config)# snmp-server enable traps bulkstat collection transfer
Device(config)# snmp-server enable traps bulkstat transfer

value type

To specify the type of bulkstat expression to use during object sampling, use the value type command in Bulkstat expression configuration mode. To disable the specified value type, use the no form of this command.

no value type

Syntax Description

counter32	(Optional) Specifies a counter32 value. Counter32 specifies a value that represents a count. The value ranges from 0 to 4,29,49,67,295.
unsigned32	(Optional) Specifies an unsigned integer value. Unsigned32 specifies a value that includes only non-negative integers. The value ranges from 0 to 4294967295.
timeticks	(Optional) Specifies a value based on timeticks. Timeticks represents a non-negative integer value that specifies the elapsed time between two events, in units of hundredth of a second. When objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1), the description of the object type identifies this reference period.
integer32	(Optional) Specifies an integer32 value. The Integer32 represents 32-bit signed integer values for the Simple Network Management Protocol (SNMP). The value range includes both negative and positive numbers.
ipaddress	(Optional) Specifies a value based on the IP address. The IP address is a string of four octets. The IP address value type is generally an IPv4 address. This value is encoded as four bytes in the network byte order.
octetstring	(Optional) Specifies a value based on octetstring. The octetstring specifies octets of binary or textual information. The octet string length ranges from 0 to 65535 octets.
objectid	(Optional) Specifies a value based on the object identifier of an object. Each object type in a MIB is identified by an object identifier value assigned by the administrator. The object identifier identifies the value type that has an assigned object identifier value.
counter64	(Optional) Specifies a counter64 value that represents a count. However, the counter64 value ranges from 0 to 18446744073709551615. This value type is used when a 32-bit counter rollover occurs in less than an hour.

Command Default

By default, the value type is not configured.

Command Modes

expression configuration (config-expression)

Bulkstat data set expression configuration (config-bs-ds-expr)

Command History

Release	Modification
12.4(20)T	This command was introduced.
12.2(33)SRE	This command was integrated into Cisco IOS Release 12.2(33)SRE.
12.2(50)SY	This command was integrated into Cisco IOS Release 12.2(50)SY.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS Release XE 3.8S	This command was integrated into Cisco IOS Release XE 3.8S.

Usage Guidelines

The value type command specifies a value for expression evaluation.

Examples

The following example shows how to specify the counter32 value type:

Device> enable
Device# configure terminal
Device(config)# snmp mib expression owner owner1 name ExpressionA
Device(config-expression)# value type counter32

The following example shows how to specify the counter32 value type for Bulkstat expression data set:

Device> enable
Device# configure terminal
Device(config)# bulkstat data interface-util type expression
Device(config-bs-ds-expr)# expression 100*$1+$2
Device(config-bs-ds-expr)# value type counter32

Related Commands

Command	Description
snmp mib expression owner	Specifies the owner for an expression.
bulkstat data	Configures Bulkstat data set for expression type.

wildcard

To configure a wildcard instance, use the wildcard command in Bulkstat instance SNMP configuration mode. To remove a wildcard instance, use the no form of this command.

wildcard [ oid oid | interface interface-id [ sub-if ] ]

no wildcard [ oid oid | interface interface-id [ sub-if ] ]

Syntax Description

oid oid

Wildcard instance identifier in object identifier format. Object defined by cdcDGInstanceOid.

interface interface-id

Specifies the interface name.

Choose the interface ID from the list of interface names provided.

Use this option only if the objects being retrieved are indexed by ifIndex. This option is provided so that the user need not worry about the persistence of an ifindex value for an interface.

sub-if

(Optional) Specifies that the sub-interfaces under the specified main interface are also included.

Command Default

By default, wildcard instances are not configured for a Bulkstat SNMP data set.

Command Modes

Bulkstat instance snmp configuration (config-bs-is-snmp)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

Execution of the wildcard command results in the addition of an instance to an existing instance set.

Examples

The following example shows how to specify a wildcard instance for an Ethernet interface:

Device> enable
Device# configure terminal
Device(config)# bulkstat instance exact type snmp
Device(config-bs-is-snmp)# wildcard interface Ethernet0/0 sub-if

Related Commands

Command	Description
bulkstat data	Configures a Bulkstat data set.

wildcard (Bulkstat expression)

To configure wildcard instances of a Bulkstat expression object, use the wildcard command in Bulkstat expression data set configuration mode. To remove the command, use the no form of this command.

wildcard

no wildcard

Syntax Description

This command has no keywords or arguments.

Command Default

This command is enabled by default.

Command Modes

Bulkstat data set expression object configuration (config-bs-ds-expr-obj)

Command History

Release	Modification
15.3(1)T	This command was introduced.
15.3(1)S	This command was integrated into Cisco IOS Release 15.3(1)S.
Cisco IOS XE Release 3.8S	This command was integrated into Cisco IOS XE Release 3.8S.

Examples

The following example shows how to configure a wildcard instance using the wildcard command:

Device> enable
Device# configure terminal
Device(config)# bulkstat data interface-util type expression
Device(config-bs-ds-expr)# object 2
Device(config-bs-ds-expr-obj)# wildcard

Related Commands

Command	Description
conditional object	Defines a conditional object when evaluating an expression.
discontinuity object	Configures the discontinuity properties for evaluation of a Bulkstat object.
id	Configures the OID for an expression MIB output.
sample	Configures an object value to be used in evaluating an expression MIB output.

Bias-Free Language

Results

Chapter: match through wildcard

match though wildcard

match (Bulkstat)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

object (Bulkstat data-group)

Syntax Description

Command Default

Command Modes

Command History

Examples

object (Bulkstat expression)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

object (Bulkstat SNMP)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

process

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

profile

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

range

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

repetition

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Examples

Related Commands

sample (Bulkstat)

Syntax Description

Command Default

Command Modes

Command History

Examples

Related Commands

show bulkstat data-group

Syntax Description

Command Modes

Command History

Examples

Related Commands