> Bulk Statistics Configuration Mode Commands
> The Bulk Statistics Configuration Mode is used to manage the system statistics options for collection and delivery as well as for the format of data delivered to remote nodes.
> Refer to the Common Syntax Options section in this chapter for information about formatting bulk statistics output.
> Important: Unless otherwise indicated, all statistics are counters. For statistics with the Int32 data type, the roll-over to zero limit is 4,294,967,295. For statistics with the Int64 data type, the roll-over to zero limit is 18,446,744,073,709,551,615.
> Common Syntax Options
> The following defines common syntax block options. These options appear in similar commands and are detailed here for easy reference.
> Schema Format String Syntax
> The schema format string is used to define the structure of generated bulk statistics data. The string may contain static text, dynamic content, and bulk statistic variables, or any combination.
> Static text includes any ASCII characters that are of a fixed value. Static text may also include control characters by using escape character sequences.
> Escape character shortcuts are supported are “\n” for new line and “\t” for tab.
> Variables within the format string must be enclosed within “%”, for example “%var%”. The actual variables supported are command-dependent and are described in the Statistics and Counters Reference.
> Common Statistics
> For a list of the statistics that are common to all schema, refer to the Statistics and Counters Reference.
> apn schema
> This command configures APN bulk statistics schema.
> Product
> GGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> apn schema schema_name format format_string
> no apn schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for APN bulk statistics collection. Multiple APN schemas can be created to further categorize APN-level bulk statistics. All of the schemas are processed at each collection interval. To create multiple APN schemas, re-issue the apn schema command using a different schema name.
> Example
> The following command creates a schema called apn1stats1 that records the number of sessions currently facilitated by the APN:
> apn schema apn1stats1 format “%sess-curr%”
> asngw schema
> This command configures ASN-GW bulk statistics schema.
> Product
> ASN GW
> Privilege
> Security Administrator, Administrator
> Syntax
> asngw schema schema_name format format_string
> no asngw schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for ASN-GW bulk statistics collection. Multiple ASN-GW service schemas can be created to further categorize ASN-GW service bulk statistics. All of the schemas are processed at each collection interval. To create multiple ASN-GW service schemas, re-issue the asngw schema command using a different schema name.
> Example
> To create an ASN-GW schema called asngw_statistics that specifies a schema format of:

> • | VPN context name: vpnname

> • | VPN Context Identifier: vpnid

> • | ASN-GW Service name: servname

> • | ASN-GW Service identifier: servid

> • | Peer IP address: peeripaddr

> Use the following command:
> asngw schema asngw_statistics format “VPN name: %vpnname%\nVPN ID: %vpnid%\nASN-GW Service Name: %servname%\nASN-GW Service Identifier: %servid%\nPeer IP Address: %peeripaddr%”
> bcmcs schema
> This command configures BCMCS bulk statistics schema.
> Product
> PDSN
> Privilege
> Security Administrator, Administrator
> Syntax
> bcmcs schema schema_name format format_string
> no bcmcs schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for BCMCS bulk statistics collection. Multiple BCMCS schemas can be created to further categorize BCMCS-level bulk statistics. All of the schemas are processed at each collection interval. To create multiple BCMCS schemas, re-issue the bcmcs schema command using a different schema name.
> Example
> The following command creates a schema named bcmcs1stats1 that records the number of sessions currently facilitated by BCMCS:
> bcmcs schema bcmcs1stats1 format “%sess-curr%”
> card schema
> This command configures card bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> card schema schema_name format format_string
> no card schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for card bulk statistics collection. Multiple card schemas can be created to categorize card-level bulk statistics. All of the schemas are processed at each collection interval. To create multiple card schemas, re-issue the card schema command using a different schema name.
> Important: Not supported on all platforms
> Example
> The following command creates a schema called card1stats1 that records the number of processes for all installed cards:
> card schema card1stats1 format “%slot%-%numproc%”
> To create a card-level schema called cardresourcestats that specifies a schema format of:
> Chassis slot number: slot
> Available Memory: memtotal Memory Used (%): memused
> Available CPU (%): cpuidle
> Use the following command:
> card schema cardresourcestats format “Chassis slot number: %slot%\nAvailable Memory: %memtotal%\tMemory Used (%): %memused%\nAvailable CPU (%): %cpuidle%”
> context schema
> This command configures Firewall bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> context schema schema_name format format_string
> no context schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3600 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For the complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for Context bulk statistics collection. Multiple context schemas can be created to categorize context statistics. All of the schemas are processed at each collection interval. To create multiple context schemas, re-issue the context schema command using a different schema name.
> Example
> To create a context schema called sfw_context_stats1 that specifies a schema format of:

> • | Total packets received by firewall: sfw-total-rxpackets

> • | Total packets sent by firewall: sfw-total-txpackets

> • | Total ICMP packets discarded by firewall: fw-icmp-discardpackets

> Use the following command:
> context schema sfw_context_stats1 format “Packets received Rx: %sfw-total-rxpackets%\nPackets Sent Tx:: %sfw-total-txpackets%\nICMP Packets discarded: %fw-icmp-discardpackets%”
> cscf schema
> This command configures CSCF bulk statistics schema.
> Product
> SCM
> Privilege
> Security Administrator, Administrator
> Syntax
> cscf schema schema_name format format_string
> no cscf schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for CSCF bulk statistics collection. Multiple CSCF-service schemas can be created to categorize CSCF-service bulk statistics. All of the schemas are processed at each collection interval. To create multiple CSCF-service schemas, re-issue the cscf schema command using a different schema name.
> Example
> To create a CSCF schema called cscf_statistics that specifies a schema format of:

> • | Call attempts received: callattrx

> • | Call attempts transmitted: callatttx

> • | Call successes received: callsuccrx

> • | Call successes transmitted: callsucctx

> • | Call failures received: callfailrx

> • | Call failures transmitted: callfailtx

> Use the following command:
> cscf schema cscf_statistics format “Call Attempts Rx: %callattrx%\nCall Attempts Tx: %callatttx%\nCall Successes Rx: %callsuccrx%\nCall Successes Tx: %callsucctx%\nCall Failures Rx: %callfailrx%\nCall Failures Tx: %callfailtx%”
> dcca schema
> This command configures Diameter Credit Control Application (DCCA) bulk statistics schema. This command is available only in StarOS 9.0 and later releases.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> dcca schema schema_name format format_string
> no dcca schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for DCCA bulk statistics collection.
> default
> Restores the system default for the option specified.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> default { limit | receiver mode | remotefileformat | sample-interval | transfer-interval }
> limit
> Restores the memory utilization limit system default: 1000 kilobytes.
> receiver mode
> Restores the behavior for sending files to the receivers to the default value.
> Default: secondary-on-failure
> remotefile format
> Restores the format of remote bulkstats file names to the default value.
> Default: “%date%-%time%”
> sample-interval
> Restores the system default for the local polling interval for statistic sampling.
> Default: 15 minutes
> transfer-interval
> Restores the system default for the time between transfer of data files to receivers.
> Default: 480 minutes
> Usage
> Restore the default values when troubleshooting the system. Setting values to the system defaults places them in well known states as starting points for monitoring for problems.
> Example
> default limit
> default transfer-interval
> dpca schema
> This command configures Diameter Policy Control Application (DPCA) bulk statistics schema. This command is available only in StarOS 9.0 and later releases.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> dpca schema schema_name format format_string
> no dpca schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for DPCA bulk statistics collection.
> ecs schema
> This command configures Enhanced Charging Service (ECS) bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> ecs schema schema_name format format_string
> no ecs schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for ECS bulk statistics collection. Multiple ECS schemas can be created to categorize ECS bulk statistics. All of the schemas are processed at each collection interval. To create multiple ECS schemas, re-issue the ecs schema command using a different schema name.
> egtpc schema
> Configures the enhanced GTP-C statistics schema for naming conventions of data files.
> Product
> P-GW, S-GW
> Privilege
> Administrator
> Syntax
> egtpc schema schema_name format format_string
> no egtpc schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for enhanced GTP-C bulk statistics collection. Multiple eGTP-C service schemas can be created to categorize eGTP-C service bulk statistics. All of the schemas are processed at each collection interval. To create multiple eGTP-C service schemas, re-issue the egtpc schema command using a different schema name.
> Example
> For an eGTP-C-level schema called egtpcservicestats that specifies a schema format of:
> Tunnel - Create Session Request Sent: tun-sent-cresess
> Tunnel - Create Session Request Received: tun-recv-cresess
> Use the following command:
> egtpc schema egtpcservicestats format “Number of GTP Tunnel Requests Sent: %tun-sent-cresess%\n Number of GTP Tunnel Requests Received: %tun-recv-cresess%\n”
> end
> Exits the bulk statistics configuration mode and returns to the Exec mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> end
> Usage
> Change the mode back to the Exec mode.
> exit
> Exits the bulk statistics configuration mode and returns to the global configuration mode.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> exit
> Usage
> Return to the global configuration mode.
> fa schema
> This command configures Foreign Agent (FA) bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> fa schema schema_name format format_string
> no fa schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for FA bulk statistics collection. Multiple FA service schemas can be created to categorize FA service bulk statistics. All of the schemas are processed at each collection interval. To create multiple FA service schemas, re-issue the fa schema command using a different schema name.
> Example
> To create a FA-level schema named faservicestats that separates the date, time, and vpnname by tabs, enter the following command:
> fa schema faservicestats format %date%\t%time%\t%vpnname%
> The schema format appears as follows:
> date time vpnname
> file
> Enters the Bulk Statistics File Configuration mode which supports the configuration of “files” used for grouping bulk statistic configuration information.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [ no ] file number
> no
> Removes a previously configured bulk statistic file.
> number
> Specifies the a number for the bulkstatistics file. This number is how the file is recognized by the system.
> number must be an integer value from 1 to 4.
> Usage
> Bulk statistics “files” are used to group bulk statistic schema, delivery options, and receiver configuration. Because multiple “files” can be configured, this functionality provides greater flexibility in that it allows you to configure different schemas to go to different receivers. A Maximum of 4 files can be assigned for bulk statistics collection.
> Executing this command allows you to enter the Bulk Statistics File Configuration Mode. This mode supports all of the commands from the Bulk Statistics Configuration mode except limit, local-directory, sample-interval, and transfer-interval (these commands are configured globally for all “files”).
> Important: Use of bulk statistics “files” is optional. If you do not wish to configure bulk statistic “files”, you can perform a standard configuration using the commands in the Bulk Statistic Configuration Mode. Note, however, that the system logically assigns “file 1” to the standard configuration. Therefore, if you wish to configure bulk statistics “files” at a later time, “file 1” will already be used.
> Caution: If the Web Element Manager application is used to collect and process (XML parsing, graphing, etc.) bulk statistics data, “file 1” is used by the Web Element Manager’s default bulk statistics collection information and schemas. To avoid errors in processing by the Web Element Manager, do not configure "file 1" via the CLI. However, it is possible to configure files 1 through 4 using the system’s CLI, regardless of whether or not the Web Element Manager is configured as a receiver. In this case, the bulk statistics data is written to the server but not processed by the Web Element Manager application.
> Example
> The following command creates a bulk statistics file numbered 2 and enter the Bulk Statistics File Configuration Mode:
> file 2
> footer
> Configures the footer string placed in the end of the generated bulk statistics data files.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> footer format format_string
> no footer format
> no
> Clears the footer format string which results in the default file footer being used in generated data files.
> format format_string
> Default: ““ (an empty footer)
> Specifies the footer format string for use in generated data files. format_string must be from 1 to 2047 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described in the Schema Format String Syntax section.
> The following variables are supported:
> footer Command Format String Variables

> Variable | Description | Data Type
> date | The date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. | String
> host | The system hostname that created the file | String
> ipaddr | The default management (local context) IP address in ###.###.###.### format. An empty string is inserted if no address is available. | String
> sysuptime | The uptime (in seconds) of the system that created the file. | 32-bit signed
> time | The time that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. | String

> ‌
> Usage
> Define a unique footer in data files which allows for easy identification of which system generated the data file or any other useful information. The use of the variables is suggested so as to allow for a uniform footer across all systems. The hostname variable should be used to identify the source of the data in the footer and all remaining items can be formatted consistently across all chassis.
> Example
> Following command can be used to define different header formats:
> footer format northStreet
> footer format “Created on: %date%-%time% by %host%”
> no footer format
> gather-on-standby
> This command controls whether or not statistics are gathered when a system is in the standby state.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> [ no | default ] gather-on-standby
> no
> Do not gather bulk statistics when the system is in the standby state.
> default
> Reset this command to its default action of gathering bulk statistics when the system is in the standby state.
> Usage
> Use this command to configure a system to either gather or not gather statistics when the system is in the standby state. This is useful for HA or GGSN systems configured for Interchassis Session Recovery. See the System Administration Guide for more details on this feature.
> If a chassis transitions to standby state and it has accumulated but not yet transferred bulk statistics data, the previously accumulated data is transferred at the first opportunity, but no additional statistics gathering takes place.
> Example
> The following command disables gathering statistics when the system is in the standby state:
> no gather-on-standby
> The following command enables the gathering of statistics when the system is in the standby state:
> gather-on-standby
> gprs schema
> This command configures GPRS bulk statistics schema.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> gprs schema schema_name format format_string
> no gprs schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> gtpc schema
> This command configures GPRS Tunneling Protocol-Control (GTPC) message statistics schema.
> Product
> GGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> gtpc schema gtpc_schema_name format gtpc_schema_format
> no gtpc schema gtpc_schema_name
> no
> Removes the specified schema.
> gtpc_schema_name
> Specifies the schema name.
> gtpc_schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format gtpc_schema_format
> Specifies the schema format.
> gtpc_schema_format must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for GTPC bulk statistics collection. Multiple GTPC schemas can be created to categorize GTPC bulk statistics. All of the schemas are processed at each collection interval. To create multiple GTPC schemas, re-issue the gtpc schema command using a different schema name.
> Example
> To create a GTPC-level schema named gtpc_stats that specifies a schema format of:
> Context Name: vpnname
> GGSN Service Name: servname
> Total PDP Contexts Processed: setup-total
> Use the following command:
> gtpc schema gtpc_stats format “Context Name: %vpnname%\nGGSN Service Name: %servname%\nTotal PDP Contexts Processed: %setup-total%\n”
> gtpp schema
> This command configures GPRS Tunneling Protocol-Prime (GTPP) statistics schema.
> Product
> GGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> gtpp schema gtpp_schema_name format gtpp_schema_format
> no gtpp schema gtpp_schema_name
> no
> Removes the specified schema.
> gtpp_schema_name
> Specifies the schema name.
> gtpp_schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format gtpp_schema_format
> Specifies the schema format.
> gtpp_schema_format must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for GTPP bulk statistics collection. Multiple GTPP schemas can be created to categorize GTPP bulk statistics. All of the schemas are processed at each collection interval. To create multiple GTPP schemas, re-issue the gtpp schema command using a different schema name.
> Example
> To create a GTPP schema named gtpp_statistics that specifies a schema format of:
> Time: time Total Redirection Requests Received: redir-rcvd
> Use the following command:
> gtpp schema gtpp_statistics format “Time: %time%\tTotal Redirection Requests Received: %redir-rcvd%\n”
> ha schema
> This command configures Home Agent (HA) bulk statistics schema.
> Product
> HA
> Privilege
> Security Administrator, Administrator
> Syntax
> ha schema schema_name format format_string
> no ha schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for HA bulk statistics collection. Multiple HA service schemas can be created to categorize HA service bulk statistics. All of the schemas are processed at each collection interval. To create multiple HA service schemas, re-issue the ha schema command using a different schema name.
> Example
> For an HA schema named haservicestats that specifies a schema format of:
> Number of HA authentication failures: reply-haauthfail
> Number of Mobile Node authentication failures: reply-mnauthfail
> Use the following command:
> ha schema haservicestats format “Number of HA authentication failures: %reply-haauthfail%\nNumber of Mobile Node authentication failures: %reply-mnauthfail%\n”
> header
> Configures the header string placed in the beginning of the generated bulk statistics data files.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> header format format_string
> no header format
> no
> Clears the header format string which results in the default file header being used in generated data files.
> format format_string
> Default: ““ (an empty header)
> Specifies the header format string for use in generated data files. format_string must be from 1 to 2047 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described in the Schema Format String Syntax section.
> The following variables are supported:
> header Command Format String Variables

> Variable | Description | Data Type
> date | The UTC date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. | String
> date3 | The UTC date that the collection file was created in YYMMDD format where YY represents the year, MM represents the month and DD represents the day. | String
> host | The system hostname that created the file | String
> ipaddr | The default management (local context) IP address in ###.###.###.### format. An empty string is inserted if no address is available. | String
> sysuptime | The uptime (in seconds) of the system that created the file. | 32-bit signed
> time | The time that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. | String

> ‌
> Usage
> Define a unique header in data files which allows for easy identification of which system generated the data file or any other useful information.
> The use of the variables is suggested so as to allow for a uniform header across all systems. The hostname variable should be used to identify the source of the data in the header and all remaining items can be formatted consistently across all chassis.
> Example
> Following command can be used to define different header formats:
> header format northStreet
> header format “Created on: %date%-%time% by %host%”
> no header format
> ippool schema
> This command configures IP pool bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> ippool schema schema_name format format_string
> no ippool schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for IP pool bulk statistics collection. Multiple IP pool schemas can be created to further IP pool bulk statistics. All of the schemas are processed at each collection interval. To create multiple IP pool schemas, re-issue the ippool schema command using a different schema name.
> Example
> To create an IP pool schema named ippoolstats that specifies a schema format of:
> Number of IP addresses on hold: hold
> Number of free IP addresses: free
> Use the following command:
> ippool schema ippoolstats format “Number of IP addresses on hold: %hold%\nNumber of free IP addresses: %free%\n”
> ipsg schema
> This command configures IP Services Gateway (IPSG) bulk statistics schema.
> Product
> IPSG
> Privilege
> Security Administrator, Administrator
> Syntax
> ipsg schema schema_name format format_string
> no ipsg schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define the schemas used for IPSG bulk statistics collection. Multiple IPSG schemas can be created to categorize IPSG bulk statistics. All of the schemas are processed at each collection interval. To create multiple schemas, re-issue the ipsg schema command using a different schema name.
> Example
> To create an IPSG schema named ipsgstats that specifies a schema format of:
> Context name: vpnname
> Service name: servname
> Total responses sent: total-rsp-sent
> Use the following command:
> ipsg schema ippoolstats format “Context name: %vpnname%\nService name: %servname%\nTotal responses sent: %total-rsp-sent%\n”
> lac schema
> This command configures LAC bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> lac schema schema_name format format_string
> no lac schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see TSchema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for LAC bulk statistics collection. Multiple LAC schemas can be created to categorize LAC bulk statistics. All of the schemas are processed at each collection interval. To create multiple schemas, re-issue the lac schema command using a different schema name.
> Example
> The following command creates a schema called lac1stats1 that records the number of active subscriber sessions and the number of sessions that failed or were disconnected due to the maximum tunnel limit being reached:
> lac schema lac1stats1 format “%sess-curactive%-%sess-maxtunnel%”
> To create a schema called lacresourcestats that specifies a schema format of:
> Number of Successful Session Connections: sess-successful
> Number of Session Attempts That Failed: sess-failed
> Number of Sessions Currently Active: sess-curative
> Use the following command:
> lac schema lacresourcestats format “Number of Successful Session Connections: %sess-successful%\nNumber of Session Attempts That Failed: %sess-failed%\nNumber of Sessions Currently Active: %sess-curative%”
> limit
> Configures the maximum amount of system memory bulk statistics may utilize.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> limit kilobytes
> kilobytes
> Specifies the maximum amount of memory, in kilobytes, that may be used for bulk statistics. kilobytes must be a value in the range from 1 to 32000.
> Usage
> Adjust bulk statics memory usage when considering the sampling interval adjustments.
> The system is shipped from the factory with the limit set to 1000.
> Caution: Bulk statistics are stored in Random Access Memory (RAM) on the SMC. In the event of power loss or system failure, the statistics will be lost. If the maximum storage limit has been reached before the system's configured transfer-interval is reached, the oldest information stored in the collection will be overwritten.
> Example
> limit 2048
> lma schema
> Configures the Local Mobility Anchor (LMA) statistics schema for naming conventions of data files.
> Product
> P-GW
> Privilege
> Administrator
> Syntax
> lma schema schema_name format format_string
> no lma schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for LMA bulk statistics collection. Multiple LMA service schemas can be created to categorize LMA service bulk statistics. All of the schemas are processed at each collection interval. To create multiple LMA service schemas, re-issue the lma schema command using a different schema name.
> Example
> For an LMA-level schema called lmaservicestats that specifies a schema format of:
> Binding Update Received: bindupd
> Binding Update Received - Denied: bindupd-denied
> Use the following command:
> lma schema lmaservicestats format “Number of Binding Updates Received: %bindupd%\n Number of Binding Updates Received and Denied: %bindupd-denied%\n”
> local-directory
> Sets the local directory for storing bulkstats collection files
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> local-directory pathname
> nolocal-directory
> no
> Delete the setting for local-directory.
> pathname
> The local path of the directory in which to store bulkstats collection files. This must be an alpha and/or numeric string of 1 to 127 characters. Pathnames are case sensitive.
> Usage
> Use this command to designate a directory on a local file system in which collection files with bulkstats information are stored. The directory specified must already exist. Use the Exec Mode command mkdir to create a directory.
> Example
> To specify that bulkstats collection files are stored in the local directory /flash/bulkstats, enter the following command:
> local-directory /flash/bulkstats
> mag schema
> Configures the Mobile Access Gateway (MAG) statistics schema for naming conventions of data files.
> Product
> HSGW, S-GW
> Privilege
> Administrator
> Syntax
> mag schema schema_name format format_string
> no mag schema schema_name
> no
> Removes the specified schema from MAG bulk statistics generation.
> schema_name
> Specifies the name to use to refer to the schema and associated format string.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for MAG bulk statistics collection. Multiple MAG service schemas can be created to categorize MAG service bulk statistics. All of the schemas are processed at each collection interval. To create multiple MAG service schemas, re-issue the mag schema command using a different schema name.
> Example
> For a MAG-level schema called magservicestats that specifies a schema format of:
> Binding Update Sent: bindupd
> Binding Acknowledgement Received: bindack
> Use the following command:
> mag schema magservicestats format “Number of Binding Updates Sent: %bindupd%\n Number of Binding Acknowledgements Received: %bindack%\n”
> mipv6ha schema
> This command configures MIPv6 HA bulk statistics schema.
> Product
> HA
> Privilege
> Security Administrator, Administrator
> Syntax
> mipv6ha schema schema_name format format_string
> no mipv6ha schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for MIPv6 HA bulk statistics collection. Multiple MIPv6 HA bulk statistics schemas can be created to categorize MIPv6 HA bulk statistics. All of the schemas are processed at each collection interval. To create multiple MIPv6 HA service schemas, re-issue the mipv6ha schema command using a different schema name.
> Example
> The following command creates a schema called mipv6haservicestats that records the number of authorization attempt failures due to access rejects from AAA:
> mipv6ha schema mipv6haservicestats format “%aaa-actauthfail%”
> nat-realm schema
> This command creates and configures Network Address Translation (NAT) realm statistics schema.
> Product
> NAT
> Privilege
> Security Administrator, Administrator
> Syntax
> nat-realm schema schema_name format format_string
> no nat-realm schema schema_name
> schema_name
> Specifies the NAT realm bulk statistics schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for NAT Realm bulk statistics collection. Multiple NAT realm schemas can be created to further categorize NAT realm level bulk statistics. All of the schemas are processed at each collection interval. To create multiple NAT Realm schemas, re-issue the nat-realm schema command using a different schema name.
> Example
> The following command creates a NAT realm schema with the VPN name, realm name, and flows information:
> nat-realm schema relam1 format “%vpnname% %realmname% %nat-rlm-flows%”
> pdif schema
> This command configures PDIF bulk statistics schema.
> Product
> PDIF
> Privilege
> Security Administrator, Administrator
> Syntax
> pdif schema schema_name format format_string
> no pdif schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3600 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for PDIF bulk statistics collection. Multiple PDIF schemas can be created to categorize PDIF bulk statistics. All of the schemas are processed at each collection interval. To create multiple schemas, re-issue the pdif schema command using a different schema name.
> Example
> The following command creates a schema called pdifschema1 for the category current active ipv4 sessions:
> pdif schema pdifschema1 format %sess-curactip4%
> port schema
> This command configures port bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> port schema schema_name format format_string
> no port schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for port bulk statistics collection. Multiple port schemas can be created to categorize port-level bulk statistics. All of the schemas are processed at each collection interval. To create multiple port schemas, re-issue the port schema command using a different schema name.
> Important: The card variable in the Port schema is not supported on all platforms
> Example
> To create a port-level schema named portstats1 that separates the card/port, bcast_inpackets, and bcast-outpackets variables by hyphens (“-”), enter the following command:
> port schema portstats1 format “%card%/%port% - %bcast_inpackets% - %bcast_outpackets%”
> ppp schema
> This command configures point-to-point protocol bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> ppp schema schema_name format format_string
> no ppp schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for point-to-point protocol bulk statistics collection. Multiple PPP-service schemas can be created to categorize PPP-service bulk statistics. All of the schemas are processed at each collection interval. To create multiple PPP-service schemas, re-issue the ppp schema command using a different schema name.
> Example
> To create a ppp-level schema named pppstats that specifies a schema format of:
> CHAP:
> Auth. Attempts: auth-attempt-chapAuth. Successes: auth-success-chap
> PAP:
> Auth. Attempts: auth-attempt-papAuth. Successes: auth-success-pap
> Use the following command:
> ppp schema pppstats format “CHAP:\nAuth. Attempts: %auth-attempt-chap%\tAuth. Successes: %auth-success-chap%\nPAP:\nAuth. Attempts: %auth-attempt-pap%\tAuth. Successes: %auth-success-pap%\n”
> radius schema
> This command configures RADIUS bulk statistics schema.
> Product
> PDSN, GGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> radius schema schema_name format format_string
> no radius schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length and is case sensitive.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for RADIUS bulk statistics collection. Multiple RADIUS schemas can be created to categorize RADIUS bulk statistics. All of the schemas are processed at each collection interval. To create multiple RADIUS schemas, re-issue the radius schema command using a different schema name.
> Example
> To create a RADIUS schema named radius_statistics that specifies a schema format of:

> • | Server: ipaddr

> • | Authentication Requests Sent: auth-req-sent

> • | Accounting Requests Sent: acc-req-sent

> Use the following command:
> radius schema radius_statistics format “Server: %ipaddr%\nAuthentication Requests Sent: %auth-req-sent%\nAccounting Requests Sent: %acc-req-sent%”
> receiver
> Configures host system to receive bulkstats information through TFTP transfer.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> receiver { mode { redundant | secondary-on-failure } | ip_address { primary | secondary } [ mechanism { { { ftp | sftp } login user_name [ encrypted ] password pwd } | tftp } } ] }
> no receiver ip_address
> no
> Removes the receiver specified from the list of receivers where data files are sent.
> mode { redundant | secondary-on-failure }
> Determines how bulkstats are delivered to the primary and secondary receivers.
> Default: secondary-on-failure
> redundant: Files are transferred to both the primary and secondary receivers. If either transfer isn't possible, the file is transferred when possible. The system continues to hold in memory as much data as possible until the data has been successfully transferred to both receivers. Data is only discarded if the in-memory data reaches the configured limit. Refer to the limit command.
> secondary-on-failure: Files are transferred to the secondary receiver if the primary receiver fails. In-memory data is erased once the data is transferred to either the primary or secondary receiver. This is the default behavior.
> ip_address
> Specifies the IP address of the receiver of interest. ip_address must be specified using the standard IPv4 dotted decimal notation.
> primary | secondary
> Primary and secondary are used to indicate the order in which receivers are connected. The secondary is used when the primary is unreachable.
> primary: indicates the receiver is the primary receiver of data.
> secondary: indicates the receiver is the secondary receiver of data.
> mechanism { { { ftp | sftp } login user_name [ encrypted ] password pwd } | tftp } }
> Specifies the method by which data is transferred to the receiver.
> ftp login user_name [ encrypted ] password pwd: the FTP protocol shall be used for data file transfer. user_name specifies the user to provide for remote system secure logins and must be an alpha and/or numeric string of 1 through 31 characters in length. The password to use for remote system authentication is specified as pwd and must be from 1 to 31 alpha and/or numeric characters or 1 to 64 alpha and/or numeric characters if the encrypted keyword is also specified.
> sftp login user_name [ encrypted ] password pwd: the SFTP protocol shall be used for data file transfer. user_name specifies the user to provide for remote system secure logins and must be an alpha and/or numeric string of 1 through 31 characters in length. The password to use for remote system authentication is specified as pwd and must be from 1 to 31 alpha and/or numeric characters or 1 to 64 alpha and/or numeric characters if the encrypted keyword is also specified.
> tftp: the TFTP protocol is to be used to transfer files.
> The encrypted keyword is intended only for use by the system while saving configuration scripts. The system displays the encrypted keyword in the configuration file as a flag that the variable following the password keyword is the encrypted version of the plain text password. Only the encrypted password is saved as part of the configuration file.
> Usage
> Use TFTP methods to reduce transfer times if excessive system resources are being used across the network for transfer of data.
> FTP transfer method allows for login which then provides system logging within the enabled FTP logs.
> The initially connection is attempted to the primary. If the primary is unreachable for any reason the secondary is used. If the secondary is also unreachable the system retrys after a delay period where it again attempts to connect to the primary followed by the secondary as necessary.
> Important: For redundant receivers, configuration changes to the receivers are applied to all existing and all subsequent data sets pending transfer. If no receiver is configured, bulk statistics will be collected and stored on the system until the maximum amount of memory is used; they will not be transferred to the receiver(s). When the storage limit has been reached the oldest information is overwritten. When a receiver is configured for the primary and secondary target, this command will use both receivers as default if no receiver is specified.
> Example
> receiver 1.2.3.4 primary mechanism tftpreceiver 1.2.3.5 secondaryno receiver 1.2.3.4
> remotefile
> Configures the naming convention with support for multiple file format to multiple receivers when storing the data files on the remote receiver/s.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> remotefile format format_string[ both-receivers | primary-receiver | secondary-receiver ]
> no remotefile format
> no
> Resets the remote file naming convention to the system default.
> format format_string
> Default: “%date%-%time%”
> Specifies the naming convention format to use. format_string must be from 1 to 127 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described in the Schema Format String Syntax section.
> Important: The remote file naming format should only use static text and bulk statistic variables to avoid any possible file creation issues on the receivers.
> The following variables are supported:
> remote file Command Naming Format Variables

> Variable | Description | Data Type
> date | The UTC date that the collection file was created in YYYYMMDD format where YYYY represents the year, MM represents the month and DD represents the day. | String
> date3 | The UTC date that the collection file was created in YYMMDD format where YY represents the year, MM represents the month and DD represents the day. | String
> host | The system hostname that created the file | String
> sysuptime | The uptime (in seconds) of the system that created the file. | 32-bit signed
> time | The time that the collection file was created in HHMMSS format where HH represents the hours, MM represents the minutes, and SS represents the seconds. | String

> ‌
> both-receivers | primary-receiver | secondary-receiver
> Set the remote file creation target to both receivers, primary receiver or secondary receiver.
> Default: Both receivers.
> Usage
> Set the remote file naming format to ensure consistent data file naming across a network or adjusting a single system’s format for easy identification.
> This command specify whether the format should be used in conjunction with both receivers, only the primary receiver, or only the secondary receiver.
> Important: For redundant receivers, the filenames for the output data files are applied when the information is first gathered. If the name format is modified, the change takes effect for the next data set. The current data set name remains unchanged. even if has not yet been transferred.
> Example
> remotefile format simpleFormat remotefile format “%host%-%date%-%time%”remotefile format “%host%-%date%-%time%” [both-receivers]remotefile format “%host%-%date%” [primary-receiver]no remotefile format
> rp schema
> This command configures R-P bulk statistics schema.
> Product
> PDSN
> Privilege
> Security Administrator, Administrator
> Syntax
> rp schema schema_name format format_string
> no rp schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for R-P bulk statistics collection. Multiple PDSN service schemas can be created to categorize PDSN service bulk statistics. All of the schemas are processed at each collection interval. To create multiple PDSN service schemas, re-issue the rp schema command using a different schema name.
> Example
> To create an PDSN-level schema called pdsnservicestats that specifies a schema format of:
> Date: date
> Time: time
> Number of Authentication Denials: deny-auth
> Use the following command:
> rp schema rpservicestats format “Date: %date%\nTime: %time%\nNumber of Authentication Denials: %deny-auth%\n”
> sample-interval
> This command configures the time interval between collecting local statistics.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> sample-interval minutes
> minutes
> Specifies the frequency of polling for local statistics.
> minutes must be an integer from 1 through 1440.
> Usage
> Adjust the sampling interval to tune the system response as shorter periods can cause undue system overhead whereas longer periods have less of a statistical importance when analyzing data.
> The system is shipped from the factory with the sampling interval set to 15 minutes.
> Example
> sample-interval 120
> sccp schema
> This command configures the statistics collection schema for the Signalling Connection Control Part function (SCCP).
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sccp schema schema_name format format_string
> no sccp schema schema_name
> no
> Removes the specified SCCP schema from statistics collection.
> schema_name
> Specifies the name to use to refer to the schema and associated format string. schema_name must be from 1 to 31 alpha and/or numeric characters.
> format format_string
> Specifies the naming convention format to use. format_string must be from 1 to 3599 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described by Schema Format String Syntax .
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> schema
> This command configures the system-level bulk statistics schema.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> schema schema_name format format_string
> no schema schema_name
> no
> Removes the specified schema.
> schema_name
> Specifies the schema name.
> schema_name must be an alpha and/or numeric string of 1 through 31 characters in length.
> format format_string
> Specifies the schema format.
> format_string must be an alpha and/or numeric string of 1 through 3599 characters in length, and cannot include spaces or must be a quoted string. For syntax details, see Schema Format String Syntax section.
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> Usage
> Use this command to define schemas for system-level bulk statistics collection. Multiple schemas can be created to categorize system-level bulk statistics. All of the schemas are processed at each collection interval. To create multiple system schemas, re-issue the schema command using a different schema name.
> Example
> The following command creates a schema called systemstats1 that records the number of current Simple IP and the number of current Mobile IP sessions:
> schema systemstats1 format “%sess-cursipconn% - %sess-curmipconn%”
> To create a system-level schema called bulksysstats that specifies a schema format of:
> Number of currently active sessions: sess-curactcall
> Number of currently dormant sessions: sess-curdormcall
> Use the following command:
> schema bulksysstats format “Number of currently active sessions: %sess-curactcall%\nNumber of currently dormant sessions: %sess-curdormcall%\n”
> sgsn schema
> This command configures the statistics collection schema for the SGSN services.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sgsn schema schema_name format format_string
> no sgsn schema schema_name
> no
> Removes the specified SGSN schema from statistics collection.
> schema_name
> Specifies the name to use to refer to the schema and associated format string. schema_name must be from 1 to 31 alpha and/or numeric characters.
> format format_string
> Specifies the naming convention format to use. format_string must be from 1 to 3599 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described by Schema Format String Syntax .
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> sgtp schema
> This command configures the statistics collection schema for the SGSN’s GTP-C and GTP-U activity.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> sgtp schema schema_name format format_string
> no sgtp schema schema_name
> no
> Removes the specified SGTP schema from statistics collection.
> schema_name
> Specifies the name to use to refer to the schema and associated format string. schema_name must be from 1 to 31 alpha and/or numeric characters.
> format format_string
> Specifies the naming convention format to use. format_string must be from 1 to 3599 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described by Schema Format String Syntax .
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> ss7link schema
> This command configures the collection schema for the SS7 Link services statistics.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> ss7link schema schema_name format format_string
> no ss7link schema schema_name
> no
> Removes the specified SS7 Link schema from statistics collection.
> schema_name
> Specifies the name to use to refer to the schema and associated format string. schema_name must be from 1 to 31 alpha and/or numeric characters.
> format format_string
> Specifies the naming convention format to use. format_string must be from 1 to 3599 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described by Schema Format String Syntax .
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> ss7rd schema
> This command configures the collection schema for the SS7 Routing Domain services statistics which include the statistics for Stream Control Transmission Protocol (SCTP) activities, the statistics for MTP3, and M3UA data activity.
> Product
> SGSN
> Privilege
> Security Administrator, Administrator
> Syntax
> ss7rd schema schema_name format format_string
> no ss7rd schema schema_name
> no
> Removes the specified SS7 routing domain schema from statistics collection.
> schema_name
> Specifies the name to use to refer to the schema and associated format string. schema_name must be from 1 to 31 alpha and/or numeric characters.
> format format_string
> Specifies the naming convention format to use. format_string must be from 1 to 3599 alpha and/or numeric characters with no spaces or as a quoted string. The format string syntax is described by Schema Format String Syntax .
> Important: For a complete list of the statistics that are supported for this schema, refer to the Statistics and Counters Reference.
> show variables
> Displays the bulk statistics variable information.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> show variables [ [ apn | asngw | bcmcs | card | closedrp | common | context | cscf | ecs | fa | gprs | gtpc | gtpp | ha | ippool | ipsg | lac | pdif | port | ppp | radius | rp | sccp | sgsn | sgtp | ss7rd | ss7link| system | vpn ] [ obsolete ] ]
> [ apn | asngw | bcmcs | card | closedrp | common | context | cscf | ecs | fa | gtpc | gtpp | ha | ippool | ipsg | lac | pdif | port | ppp | radius | rp | sccp | sgsn | sgtp | ss7rd | ss7link| system | vpn ] [ obsolete ]
> Displays only the variables for the specified schema.
> If the obsolete keyword is used, obsolete (but still available) schema variables are displayed. An asterisk (*) is displayed next to schema variables that have been obsoleted.
> For information on available schemas, refer to the Bulk Statistics Configuration Mode Commands chapter.
> Usage
> Use this command to list supported bulk statistic variables. Variables can be listed for a specified schema. If no schema is specified, all supported variables are listed on a per-schema basis.
> Example
> The following command displays the bulkstat variables only for the card schema:
> show variables card
> transfer-interval
> Configures the frequency of transfer of collected statistics to the receiver.
> Product
> All
> Privilege
> Security Administrator, Administrator
> Syntax
> transfer-interval minutes
> minutes
> Specifies the number of minutes between the transfer of collected statistics to the receivers. minutes must be an integer from 1 through 999999.
> Usage
> Modify the transfer interval based upon the number of sessions per second. As the number of session requests a second increases it may become necessary to increase the transfer interval to reduce the processing overhead frequency for statistics delivery. This is tempered by the impact reduced resolution of statical data has on usefulness of data when the interval gets larger than the least busy hours and most busy hours of the day.
> The system is shipped from the factory with the transfer interval set to 480 minutes.
> Example
> transfer-interval 1440

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883