Retcode, Rc-start, Rc-end, 225 | Cisco Systems OL-15491-01 manual

Appendix A CSG2 Command Reference

retcode

retcode

To specify the range of application return codes for which the CSG2 refunds quota for Prepaid Error Reimbursement, use the retcode command in CSG2 refund configuration mode. To disable this feature, use the no form of this command.

retcode {ftp http imap pop3 sip smtp wap} rc-start[rc-end]

no retcode {ftp http imap pop3 sip smtp wap} rc-start[rc-end]

Syntax Description		ftp	The CSG2 refunds quota for FTP application return codes.
		http	The CSG2 refunds quota for HTTP and WAP 2.0 application return
			codes.
			Note The http keyword affects only HTTP and WAP 2.0. For
			WAP 1.x refunds, use the wap keyword.

		imap	The CSG2 refunds quota for Internet Message Access Protocol
			(IMAP) application return codes.

		pop3	The CSG2 refunds quota for Post Office Protocol, version 3 (POP3)
			application return codes.

		sip	The CSG2 refunds quota for Session Initiation Protocol (SIP)
			application return codes.
			Note For SIP calls, only the return code to the INVITE method is
			used.
			For SIP events, each event is a transaction associated with a
			single return code.

		smtp	The CSG2 refunds quota for Simple Mail Transfer Protocol (SMTP)
			application return codes.

		wap	The CSG2 refunds quota for WAP 1.x application return codes.
			Note The wap keyword affects only WAP 1.x. For WAP 2.0
			refunds, use the http keyword.

		rc-start	Specifies the beginning of the range of values for specific application
			return codes. The range is 1 to 65535 (0xffff).

		rc-end	(Optional) Specifies the end of the range of values for specific
			application return codes. The range is the value of rc-startto 65535
			(0xffff). If you are specifying a single value as the range, do not
			specify rc-end.


Defaults		None

Command Modes		CSG2 refund configuration

		Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide

	OL-15491-01			A-225
	OL-15491-01			A-225

Image 225

Cisco Systems OL-15491-01 appendix Retcode, Rc-start, Rc-end, 225

Contents

CSG2 Command Reference Appendix a CSG2 Command Reference Appendix a CSG2 Command Reference Appendix a CSG2 Command Reference Appendix a CSG2 Command Reference Enters CSG2 policy configuration mode Command DescriptionAccounting Release Modification Syntax Description Defaults Command Modes ActivationActivation automatic user-profile No activation Related Commands Description Ip csg serviceConfiguration mode Aoc append url Aoc enableAoc append url No aoc append url Aoc confirm Aoc confirm Aoc confirm token No aoc confirmToken Aoc append url Ip csg service Movies aoc enable Aoc confirm ?CSGAOCOK Aoc enable No aoc enable Aoc enableAoc enable Usage Guidelines Examples Command Description Basis Defaults Command Modes Ip csg service Offnet basis second Ip csg service Movies Basis fixed Meter exclude svc-idle Meter include imapMeter increment Block Ip csg contentBlock No block Parse length Command History Release Modification Usage Guidelines Examples Related CommandsClass Syntax Description Clear ip csgUser All 12.415MD The ftp keyword was added 12.411MD This command was introducedIP address Show ip csg Clear ip iscsi statistics Command Modes Command HistoryClear ip iscsi statistics ReleaseModification Clear record-storage-module stats Clear record-storage-module statsFollowing example clears RSM-related statistics Clear record-storage-module stats Client-group CSG2 content Mode Ip csg content MoviesNext-hop Defines a next-hop IP address Default weight-valueis 1 quadran Content CSG2 serviceCSG2 service configuration You must configure a policy before configuring this command CSG2 policy configuration mode Debug ip csg Http detail Gtp quota-serverImap Interm Service ha Service detailSession event Session state detail Replicate Statistics Entries user idle duration pod no entries user idle Entries user idlePod Billing to entries user idle Service Ip csg radius pod timeoutIp csg billing Ip csg entries user idle Tcp FlagsWap Mask Appendix a CSG2 Command Reference Flags Refunds quota for Prepaid Error Reimbursement Enters CSG2 refund configuration modeIp csg refund Retcode Default idle duration is 300 seconds 5 minutes Idle CSG2 contentCSG2 content configuration Idle duration no idle duration Service with no subscriber sessions Idle CSG2 serviceSets the pending connection timeout Pending Ip csg service Movies Idle Idle CSG2 service Idle content connection Idle CSG2 content Inservice No inservice Inservice CSG2 contentDefault value is no inservice Detects an error, the command fails Ip CSG2 content No ip any ip-addressAny Ip csg content Moviescomedy Ip 172.18.45.0/24 tcp Command Modes Command History Usage Guidelines Examples Ip iSCSI Ip csg iscsi drain delayIp csg iscsi drain packet Ip csg iscsi profile Ip iscsi target-profile Name iSCSIPort iSCSI Ip csg billing billing-plan-name Ip csg billingNo ip csg billing billing-plan-name Entries user idle Ip csg bma Syntax Description Defaults Command Modes Command History Ip csg bma keepalive Ip csg bma activateIp csg bma local-port Ip csg bma messages Sticky seconds Ip csg bma activate Ip csg bma activate 2 sticky Related Commands Description Ip csg bma Ip csg bma keepaliveIp csg ipc keepalive Ip csg psd keepalive Csg bma command Quota-server local-port command, respectivelyIp csg bma local-port Ip csg bma local-port port-number No ip csg bma local-port Ip csg psd local-port CSG2 accounting service A1Cisco Persistent Storage Device PSD Ip csg bma local-port Ip csg bma messages 12.411MD This command was migrated from CSG1Ip csg bma messages number no ip csg bma messages CSG2 buffers up to 10000 GTP’ messages Ip csg psd drain packet Ip csg psd drain delayIp csg psd margin Ip csg quota-server messages Ip csg bma retransmit Ip csg bma retransmit number-of-secondsNo ip csg bma retransmit Ip csg bma retries PacketNumber-of-retries Ip csg ipc retries Ip csg psd retriesIp csg quota-server retries Min auto Ip csg bma window Ip csg case-sensitive No ip csg case-sensitive Ip csg case-sensitiveMatch header Match method Ip csg content content-name No ip csg content content-name Ip csg content Subscriber-iphttp-headerforwarded-for Vlan CSG2 content Vrf BlockSubscriber-iphttp-headerforwarded-for No ip csg database Ip csg databaseServer Ip csg database 10.1.2.3 11111 Default maximum number of entries is Default idle duration is 5 secondsIp csg entries fragment Ip csg database Ip csg entries session user max Ip csg entries user profile Server that answers user ID queries Ip csg entries session user max Command Description Ip csg entries user idle Packet of Disconnect message when an entry idles out Ip csg entries fragment Defines the maximum number of entries in the CSG2 fragmentDatabase, or how long the CSG2 is to retain the entries Ip csg entries user max 12.411MD This command was introducedIp csg entries user max entries No ip csg entries user max Ip csg entries user max Related Commands Description Ip csg entries user profile CommandDescription Ip csg database Server that answers user ID queriesIp csg entries user profile radius pass Ip csg ipc crashdump NeverTolerance number-of-seconds Ip csg ipc keepalive Default value is 8 secondsIp csg ipc keepalive number-of-seconds No ip csg ipc keepalive Ip csg ipc retransmit Default value is 4 secondIp csg ipc retransmit number-of-seconds No ip csg ipc retransmit Ip csg ipc retries Ip csg ipc retries number-of-retriesNo ip csg ipc retries Ip csg iscsi drain delay Ip csg iscsi drain packet ISCSI configuration mode Target to be used as backup storage for the CSG2 Ip csg iscsi profile target-profile-name Ip csg iscsi profileNo ip csg iscsi profile No iSCSI target is specified Ip csg map Ip csg map map-name No ip csg map map-nameMatch header Match method Match url Match patterns as case-sensitive Ip csg case-sensitiveMap Policy Command Ip csg mode single-tpIp csg mode single-tp No ip csg mode single-tp Ip csg policy Ip csg policy policy-name No ip csg policy policy-nameAccounting Map Accounting Enters CSG2 map configuration modeIp csg map Ip csg policy Moviescomedy Ip csg psd Buffer for the Cisco Persistent Storage Device PSD Tunneling protocol prime GTP’ messages, beyond the sizeIp csg psd retransmit Ip csg psd window Ip csg psd drain delay Ip csg psd drain delay number-of-secondsNo ip csg psd drain delay Ip csg psd drain packet Cisco Persistent Storage Device PSD when the Billing Ip csg psd keepalive number-of-seconds Ip csg psd keepaliveNo ip csg psd keepalive Defines the Interprocessor Communication IPC keepalive time Ip csg psd local-port Csg psd commandIp csg psd local-port port-number No ip csg psd local-port Local-port Related Commands Description Ip csg psd margin Configures a Cisco Persistent Storage Device PSDIp csg psd margin number no ip csg psd margin Can buffer for all Billing Mediation Agents BMAs Ip csg psd retransmit number-of-seconds Ip csg psd retransmitNo ip csg psd retransmit Defines the Interprocessor Communication IPC retransmit Ip csg psd retries Following example shows how to allow two PSD retriesDiscarding it the initial attempt plus four retries Ip csg psd retries Defines the maximum number of Billing Mediation Agent BMA Defines the Billing Mediation Agent BMA transmit window size Ip csg psd window Ip csg quota-server Syntax Description Defaults Ip csg quota-server reassign Ip csg quota-server retransmitIp csg quota-server window Ip csg quota-server activate Default value is Global configuration100 Ip csg quota-server activate Ip csg quota-server keepalive For subscribers101 Quota-server local-port Ip csg quota-server local-port1024 to 102 Billing Mediation Agent BMA Following example configures quota server local portFor subscribers 103 Ip csg quota-server messages 104Ip csg quota-server messages 105 Ip csg quota-server reassign 106 Ip csg quota-server retransmit Ip csg quota-server retries Is 1 to 65535. The default value is107 Ip csg quota-server retries 108 Server transmit window automatically. The CSG2 keeps track Ip csg quota-server windowAs the minimum window 109 110 Size for the CSG2 Ip csg radius ack error parse No ip csg radius ack error parse111 112 Ip csg radius ack error user No ip csg radius ack error user113 Ip csg radius ack error parse Related Commands Command DescriptionAccounting Interim Request when it encounters a Radius Parse error condition Ip csg radius correlation Ip csg radius correlationNo ip csg radius correlation Csgusersessioncorrelator=string 116 Key Ip csg radius endpointSpecifies a Radius key 117 118 Endpoint Nas Ip csg radius monitorIp csg radius userid 119 Command History Usage Guidelines Release Modification Radius handoff is disabledIp csg radius handoff Ip csg radius handoff duration No ip csg radius handoff Ip csg radius start restart Session-id121 Optional Specifies a Radius key Ip csg radius monitor Network Access Server NAS 12.415MD This command was introducedIp csg radius monitor nas 123 Ip csg radius monitor nas 124Ip csg radius monitor nas 1.2.3.4 vrf Nastable Ip csg radius on-off purge Default rate is 1000 User Table entry deletions per secondSpecified rate 125 Vsa Ip csg radius pod attribute3gpp 126 Key to use in calculating the Authenticator Following example shows how to specify Radius attributes 44Between retransmissions 127 Example, write memory Ip csg radius pod nasPossible values are 0 128 Nas Message and sent to the NAS in the PoD129 Default timeout is 5 seconds Ip csg radius pod timeoutDefault number of retransmits is 3 retransmits Command History Examples Release Modification 131 Ip csg radius proxy 132 Csg-source-address is set to csg-address Arguments were added Configuration mode for this command changed from module CSGTable table-namekeyword and argument were removed Csg-source-address 134 135 Ip csg radius reauthorization attribute Ip csg radius reauthorization attribute vsa 7777 Ip csg radius reauthorization attributeIp csg radius reauthorization attribute 26 7778 136 Ip csg radius start restart session-id This commandRadius start restart session-id 26 keyword was removed Ip csg radius start restart session-id 138 Ip csg radius stop purge 139Ip csg radius stop purge 140 User-Name Ip csg radius useridCalling-Station-Id 141 142 Variable Ip csg records formatCombined http Combined wap 144 Ip csg redirect 145 Following example shows how to configure CSG2 redirects For Prepaid Error Reimbursement For CSG2 Prepaid Error ReimbursementIp csg refund Flags Ip csg replicate Replication is not enabled 148 Content servers on the standby system Ip csg report radius attribute Ip csg report http headerIp csg report smtp rfc2822 149 150 Ip csg report radius attribute No Radius attributes are copied into CDRs151 Ip csg report http header Ip csg report usage152 Ip csg report smtp rfc2822 No ip csg report smtp rfc2822 Ip csg report smtp rfc2822Ip csg report wap actual-pdu 153 Ip csg report usage Defaults Command Modes Command History Usage GuidelinesBytes ip Seconds 155 Start message into call detail records CDRs 156 Ip csg report wap actual-pdu Ip csg service service-name No ip csg service service-name Ip csg serviceActivation Aoc append url Aoc confirm Aoc enable 157 Activation ServiceURL-rewriting Basis 159 Snmp-server enable traps csg Ip csg snmp timerBma Psd Ip csg subscriber Command Modes Interface configurationIp csg subscriber No ip csg subscriber Interface is not a CSG2 subscriber interface Ip csg transport-type assign Specifies a service class value162 Ip csg transport-type assign 1.2.3.4 Target-profile-name Name of the iSCSI profile Ip iscsi target-profileIp iSCSI 163 164 Map CSG2 policy configurationMap map-name no map map-name Header-map Url-map 166 CSG2 map configuration Match header167 Convention Description Match header host1 *.2.*.44Zero or more characters Zero or one character 169 \character 170 Case-sensitive Match method method-name No match method method-name Match methodMethod-name Method to be matched. Valid methods are Match method get 172 173 As case-sensitive Match url pattern No match url pattern Syntax Description Command Modes Command HistoryMatch url http//url-string HTTP//url-string 175 176 Ip csg map Movies Ip csg map Images Match url *.gifjpg 177 Meter exclude control sip Meter exclude control sip no meter exclude control sip178 Are billed for by the CSG2 when doing prepaid debits Specifies which Internet Message Access Protocol Imap bytesBeginning of a service when the service is configured for Service Duration Billing Meter exclude control sip Meter exclude mms wapMeter exclude network-init Sip 181 Ip csg service SERVICE-A Meter exclude network-init sip SERVICE-A serviceMeter exclude network-init sip 182 183 Meter exclude pause rtsp No meter exclude pause rtsp Meter exclude pause rtspSIP session from the CSG2 usage calculation Meter exclude network-init sip 185 Meter exclude svc-idle Offnet serviceMeter exclude svc-idle No meter exclude svc-idle Only basis second is meaningful with meter exclude svc-idle 187 Body header Meter include imapBody only Body other RFC822 Ip csg service S1Prepaid debits 189 190 Meter increment value No meter increment value Meter incrementSpecify meter increment 191 192 Ip csg service Offnet Meter increment Ip csg service Offnet Meter initial Default quota is 0 quadrans CSG2 service configurationMeter initial Meter initial value no meter initial value 194 Meter minimum Default number is 0 quadransMeter minimum value no meter minimum value Charge is 110 quadrans 196 Ip csg service Offnet Meter minimum Mode Default mode is prepaid CSG2 billing configurationSpecifies variable or fixed call detail record CDR format 197 198 Mode tcp Name target-name No name target-name Name iSCSITarget-name Name of the iSCSI target Target named eftcompany.com 200 Reverse Next-hopSubscriber media Next-hop or next-hop reverse 202 Id id OwnerName name 203 Parse length Parse length number no parse length204 205 Parse protocol Configures content for CSG2 services, and enters CSG2 content configuration mode206 Each time the service runs low on quota Configured, but none are activePassthrough Passthrough quota-grantno passthrough Default pending connection timeout is 30 seconds Pending timeout no pendingPending Displays information about the CSG2 Policy-name Name of a configured CSG2 billing policy Policy CSG2 contentThis policy, do not configure the accounting command 209 210 Services, and enters CSG2 policy configuration modePriority Policy Country priority Port iSCSI No default behavior or valuesPort port-number no port port-number 211 212 213 Reauthorization threshold 214 Ip csg service A1 Reauthorization threshold Default initial reauthorization timeout is 4 seconds Reauthorization timeoutDefault maximum reauthorization timeout is 60 seconds 215 216 Maximum reauthorization timeout of 20 seconds Records delay seconds no records delay Records delayDefault value is 0 no records delay Transaction closes, but before the connection closes Records granularity ServiceBytes bytes Seconds seconds 219 Bytes bytes Records intermediateSeconds seconds 220 221 Refund policy-name No refund policy-name RefundPolicy-name Name of the refund policy Refund Connection redundancy is not enabled Replicate delay seconds no replicate delayIf you do not specify a delay, there is no delay Replicate Enables state replication between redundant CSG2 systems Ip csg replicate224 Rc-start RetcodeRc-end 225 226 Masks and values for CSG2 Prepaid Error Reimbursement Sami rate all Default rate is 1.9 GbpsSami rate bits-per-second all No sami rate bits-per-secondall Service service-name No service service-name ServiceService-name Name of a configured CSG2 billing service None CSG2 billing configuration 229 Show ip csg Ip-address ip-mask UserShow ipc sctp Id user-name Show module csg content Command Default Command Modes Command HistoryShow ip csg accounting Show module csg stats 232 Following example shows how to display the CSG2 statisticsDetail Router# show ip csg stats 233 Datagram packets = Datagram frags = 234 235 236 IPC 237 CSG Other Stats Total sessions = 40344, alloc fail = 238 239 240 Router# show ip csg quota-serverRouter# show ip csg sessions 241 State Description 242 Command Default Command Modes Command History Examples Show ip iscsi243 244 Router# show ip iscsi stats iSCSI StatsRouter# show ip iscsi stats detail iSCSI Stats Target name= iqn.2002-10.edu.unh.iol.iscsi.draft20-target1 245 246 Show record-storage-moduleRouter# show record-storage-module stats Router# show record-storage-module target-info all detail 247 Records Snmp-server enable traps csgState 248 Ip csg snmp timer Following example enables CSG2 trapsCSG2 records, and enters CSG2 Snmp timer configuration mode Snmp-server enable traps csg Obscure Subscriber-ip http-header forwarded-forHttp-header x-forwarded-for 250 251 Verify confirm Verify confirm token No verify confirm token252 253 Verify enable Verify enableNo verify enable 254 Vlan vlan-number Vlan CSG2 contentNo vlan Vlan-number Dot1q encapsulation Vlan number Vrf Contentvrf Vrf-name VRF within which the content should match packetsVrf No vrf