# show ims-authorization

This chapter describes the outputs of the show ims-authorization command.
show ims-authorization policy-control statistics
Table 1. show ims-authorization policy-control statistics Command Output Descriptions

Field | Description
--- | ---
DPCA Session Stats
Total Current Sessions | The total number of DPCA session currently running on this system.
Total IMSA Adds | The total number of IP multimedia subsystem applications (IMSAs) added to service.
Total DPCA Starts | The total number of Diameter Policy Control Applications (DPCAs) started.
Total Secondary Create | The total number of secondary contexts created. IMPORTANT: This field is no longer available in 14.0 and later releases.
Total Secondary Terminate | The total number of secondary contexts deleted. IMPORTANT: This field is no longer available in 14.0 and later releases.
Total Session Updates | The total number of updates applied for session/s. IMPORTANT: This field is no longer available in 14.0 and later releases.
Total Terminated | The total number of Diameter Policy Control Application sessions terminated.
DPCA Session Failovers | The total number of Diameter Policy Control Application sessions failed.
DPCA Message Stats
Total messages Received | Total policy control messages received for IMS authorization policy control.
Total Messages Sent | Total messages sent to IMS authorization policy control server.
Total CCR | Total Credit Control Request (CCR) messages received.
Total CCA | Total Credit Control Answer (CCA) messages sent in response to CCRs.
CCR-Initial | Total number of initial CCR messages received.
CCA-Initial | Total number of initial CCA messages sent in response to initial CCR messages.
CCA-Initial Accept | Total number of initial CCA messages accepted in response to initial CCR messages.
CCA-Initial Reject | Total number of initial CCA messages rejected in response to initial CCR messages.
CCA-Initial Timeouts | Total number of initial CCA messages timed out in response to initial CCR messages.
CCR-Update | Total number of Credit Control Request (CCR) messages received after initial CCR for update.
CCA-Update | Total Credit Control Answer (CCA) messages sent in response to update CCRs.
CCA-Update Timeouts | Total Credit Control Answer (CCA) messages sent in response to update CCRs but timed out.
CCA-Update Errors | Total number of errors in parsing the CCA-Update Message.
CCR-Final | Total number of final CCR messages received to end application.
CCA-Final | Total number of final CCA messages sent in response to final CCR messages to end session/s.
CCA-Final Timeouts | Total number of final CCA messages sent in response to final CCR messages to end session/s but timed out.
CCA-Final Errors | Total number of errors in parsing the CCA-Terminate Message.
ASR | Total number of Abort-Session-Requests (ASRs) received.
ASA | Total number of Abort-Session-Accept (ASA) messages sent in response to Abort-Session-Requests (ASRs).
RAR | Total number of Re-Auth-Requests (RARs) received for re-authorization.
RAA | Total number of Re-Auth-Requests (RARs) answered with Re-Auth-Answer (RAA) message.
RAR-CCR collision | Total number of Re-Auth-Request (RAR) messages received from PCRF when there is any outstanding request.
DPCA Message Error Stats
Diameter Protocol Errs | Total number of errors related to Diameter protocol.
Bad Answers | Total number of errors related to invalid response/answers.
Unknown Session Reqs | Total number of errors related to unknown session requests.
Unknown Command Code | Total number of errors related to unknown command codes.
Unsupported Command Code | Total number of errors related to unsupported command codes.
Unk Failure Handling | Total number of errors related to unknown handling of failures.
DPCA Termination Cause Stats
Diameter Logout | Total number of DPCA session termination due to Diameter logout.
Service Not Provided | Total number of DPCA session termination due to unavailability of service.
Bad Answer | Total number of DPCA sessions terminated due to invalid/bad response reason.
Administrative | Total number of DPCA sessions terminated due to administrative reasons.
Link Broken | Total number of DPCA sessions terminated due to link broken.
Auth Expired | Total number of DPCA sessions terminated due to authorization expired.
User moved | Total number of DPCA sessions terminated as subscriber/user moved to unknown/non-service area.
Session Timeout | Total number of DPCA sessions terminated due to timed out reason.
Auth Rejected | Total number of DPCA sessions terminated due to authorization rejected.
Other Errors | Total number of DPCA sessions terminated due to unknown reasons or reasons not listed in this list.
DPCA Experimental Result Code Stats: | Statistics of the number of times the specific Experimental-Result-Code value was received in the Diameter Gx Credit-Control-Answer (CCA) from the PCRF per IMSA service.
Error Initial Parameters | The number of times DIAMETER_ERROR_INITIAL_PARAMETERS (5140) Experimental-Result-Code value was received in the Diameter Gx CCA.
Error Trigger Event | The number of times DIAMETER_ERROR_TRIGGER_EVENT (5141) Experimental-Result-Code value was received in the Diameter Gx CCA.
Bearer Not Authorized | The number of times DIAMETER_ERROR_BEARER_NOT_AUTHORIZED (5143) Experimental-Result-Code value was received in the Diameter Gx CCA.
Traffic Mapping Rejected | The number of times DIAMETER_ERROR_TRAFFIC_MAPPING_INFO_REJECTED (5144) Experimental-Result-Code value was received in the Diameter Gx CCA.
PCC Rule Event | The number of times DIAMETER_PCC_RULE_EVENT (5142) Experimental-Result-Code value was sent in the Diameter Gx Re-Auth-Request (RAR).
Conflicting Request | This error is used when the PCRF cannot accept the UE-initiated resource request as a network-initiated resource allocation is already in progress with packet filters that cover the packet filters in the received UE-initiated resource request.
Bearer Event | This error is used when a PCC rule for some reason cannot be enforced or modified successfully in a network initiated procedure.
Bad Exp Result Code | The number of times an unknown Experimental-Result-Code value (apart form the ones recognized in CCA that are listed above PCC Rule Event) was received in the Diameter CCA.
Session Release Cause
Unspecified Reason | The total number of sessions released due to unspecified reasons.
UE Subscription Changed | The total number of sessions released due to a change in the UE subscription.
Insuffcnt Srvr Resource | The total number of sessions released due to insufficient server resources.
DPCA Failure Handling Stats
Connection Based FH
Total Message Timeouts | Total number of response message timeouts, i.e. PCRF failed to respond within the configured timeout value.
CCA-Initial | Response to the CCR-I message was timed out.
CCA-Update | Response to the CCR-U message was timed out.
CCA-Terminate | Response to the CCR-T message was timed out.
Total Message Send Errs | Total number of requests failed to be sent due to socket based send errors.
CCR-Initial | CCR-I failed to be sent due to socket based errors.
CCR-Update | CCR-U failed to be sent due to socket based errors.
CCR-Terminate | CCR-T failed to be sent due to socket based errors.
Result Code Based FH |
Configured Result Code | Failure handling being undertaken due to configured result code range.
CCA-Initial | Failure handling being undertaken due to configured result code range for CCA-Initial messages.
CCA-Update | Failure handling being undertaken due to configured result code range for CCA-Update messages.
CCA-Terminate | Failure handling being undertaken due to configured result code range for CCA-Terminate messages.
Unh and Unk Result Code | Failure handling being undertaken due to a result code which is neither defined in the diameter or customer specs.
CCA-Initial | Failure handling being undertaken due to unknown result code for CCA-Initial messages.
CCA-Update | Failure handling being undertaken due to unknown result code for CCA-Update messages.
CCA-Terminate | Failure handling being undertaken due to unknown result code for CCA-Terminate messages.
FH Behavior
Continue | Total number of times the failure handling action continue has been undertaken.
Retry-And-Continue | Total number of times the failure handling action retry-and-continue has been undertaken.
CCR on Call Terminate | Total number of times the failure handling action continue has been undertaken and CCR-T has been sent to PCRF on call termination.
Retry-And-Terminate | Total number of times the failure handling action retry-and-terminate has been undertaken.
Terminate | Total number of times the failure handling action terminate has been undertaken.
Peer Switches
Attempted Switches | Total number of peer switches attempted.
Successful Switches | Total number of peer switches successful.
Switches-Tx timeout | Total number of peer switches due to timeout expiry.
Switches-RAR change | Total number of peer switches due to RAR from secondary server.

show ims-authorization policy-gate status full

IMPORTANT:

This command is no longer an option in StarOS release 11.0 and beyond.
Table 2. show ims-authorization policy-gate status full Command Output Descriptions

Field | Description
--- | ---
CallID | Specifies Call Identifier.
IMSI | Specifies International Mobile Subscriber Identity (IMSI) of subscriber.
NSAPI | Specifies Network Service Access Point Identifier (NSAPI) to a single PDP context of the subscriber.
Charging Rule | Specifies dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Precedence | Displays the precedence of the dynamic charging rule applicable to specific flow.
Flow Status | Specifies the status of flow with specific charging rule. Possible states are: Open Closed Dormant
Flow Dir | Specifies the direction of flow with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service. Possible states are: Uplink Downlink
Source Addr | Specifies the source IP address of flow with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Source Addr Mask | Specifies the masking of source IP address of flow with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Destination Addr | Specifies the destination IP address of flow with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Destination Addr Mask | Specifies the masking of destination IP address of flow with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Source Port | Specifies the IP port of flow origin with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Destination Port | Specifies the destination IP port of flow end with specific dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.

show ims-authorization policy-gate counters all

IMPORTANT:

This command is no longer an option in StarOS release 11.0 and beyond.
Table 3. show ims-authorization policy-gate counters all Command Output Descriptions

Field | Description
--- | ---
CallID | Specifies Call Identifier.
IMSI | Specifies International Mobile Subscriber Identity (IMSI) of subscriber.
NSAPI | Specifies Network Service Access Point Identifier (NSAPI) to a single PDP context of the subscriber.
Charging Rule | Specifies dynamic charging rule applicable for specific flow through a policy gate in IMS authorization service.
Gate State changed | Displays the change state of policy gate for specific subscriber flow. Possible values are: 0: No change 1: Changed
Uplink Pkts Statistics | Displays the statistics of packets in uplink direction.
Downlink Pkts Statistics | Displays the statistics of packets in downlink direction.
Pkts processed | Displays the total number of packets received and processed.
Bytes processed | Displays the total number of bytes received and processed.
Pkts dropped | Displays the total number of packets received but dropped.
Bytes dropped | Displays the total number of bytes received but dropped.

show ims-authorization servers
Table 4. show ims-authorization servers ims-auth-service Command Output Descriptions

Field | Description
--- | ---
Service Name | IMS authorization service name.
IMS Authorization Server | IMS authorization server name.
Server Type | IMS Authorization server type. It may be Policy, Charging, or both.
PCRF host | Identifies the Policy Control and Charging Rules Function (PCRF) host.
Operational State | Indicates operational state of the authorization server.
Server Session State | Indicates authorization server session state.
Server Statistics | Indicates authorization server session statistics.
Session Active | Total number of active authorization server sessions.
Session Opened | Total number of opened authorization server sessions.
Session Closed | Total number of closed authorization server sessions.
Sessions switched due to Tx Expiry | Total number of sessions switched due to transmission expiry.
Sessions switched due to reselection | Total number of sessions switched due to re-selection of authorization servers.
Server Up -> down indications | Total number of servers going to down state from up state.
Total servers matching specified criteria | Total number of servers matching the specified criteria.

show ims-authorization service name
Table 5. show ims-authorization service name Command Output Descriptions

Field | Description
--- | ---
IMS Authorization Service Name | Name of IMS authorization service name.
Context | Name of the context in which IMS authorization service is configured.
Service State | State of the IMS authorization service.
Service mode | Mode of IMS authorization service for policy and charging.
Binding Mechanism | Describes the mechanism on the control of bearer resources based on a binding mechanism that binds one or more service to a bearer.
QoS Update Timeout | Specifies the timeout duration in seconds to discard QoS update request. NOTE: QoS Update Timeout is no longer shown in StarOS release 11.0 and beyond.
Reauth Trigger | Specifies the Re-authorization trigger’s status.
P-CSCF Discovery | Specifies the configured route-table applicable for Proxy-Call Session Control Function (P-CSCF) discovery.
P-CSCF Selection Table[ n ] | Specifies the configured selection table information for Proxy-Call Session Control Function (P-CSCF) server selection. [n] indicates the selection table number.
Diameter Policy Control Specifies Diameter Policy Control related configuration and information.
Endpoint | Specifies Diameter endpoint name for Diameter Policy Control.
Origin-Realm | Specifies Diameter origin domain name for Diameter Policy Control.
Dictionary | Specifies the configured applicable dictionary for Diameter Policy Control.
Update-Dictionary-Avps | Indicates whether the 3GPP Rel. 8 AVPs or 3GPP Rel. 9 AVPs are selected for encoding.
Request Timeout | Indicates the configured request timeout value.
Reauth Trigger | Indicates the re-authorization trigger status.
Custom Reauth Trigger | Indicates enabled custom reauth event triggers.
Failure Handling | Specifies the configured mechanism for failure handling in Diameter Policy Control.
Peer Switch | Specifies the status of Peer switching for in Diameter Policy Control. IMPORTANT: This field has been deprecated in 8.1 and later releases.
Host Selection | Specifies host selection mechanism with selection table.
Host Reselection Subscriber Limit | Specifies the limit of subscriber bind to specific host origin to trigger re-selection of host.
Host Reselection Interval | Specifies time interval to trigger host re-selection for subscriber.
Host Selection Table[ n ] | Specifies the configured selection table information for host server selection. [n] indicates the selection table number.
Precedence | Specifies the precedence applicable.
Primary Host | Specifies the primary name/IP address the host.
Secondary Host | Specifies the secondary name/IP address of the host.

show ims-authorization sessions full all
Table 6. show ims-authorization sessions full all Command Output Descriptions

Field | Description
--- | ---
CallId | The call identifier.
Service Name | The IMS authorization service name.
IMSI | The International Mobile Subscriber Identity (IMSI) of subscriber.
Session ID | The session ID is of type UTF8String and is used to identify a specific session.
NSAPI | The Network Service Access Point Identifier (NSAPI) to a single PDP context of the subscriber.
Bearer Usage | Indicates the bearer usage for this session. IMPORTANT: This field is no longer available in 14.0 and later releases.
Bearer Type | Indicates the bearer type. IMPORTANT: This field is no longer available in 14.0 and later releases.
Bearer ID | Indicates the bearer identifier. IMPORTANT: This field is no longer available in 14.0 and later releases.
Context Type | Indicates the PDP context type: Primary or Secondary. IMPORTANT: This field is no longer available in 14.0 and later releases.
SGSN IP-Addr | IP address of the SGSN node.
APN | Indicates the Access Point Name (APN) for this service.
Bearer Control Mode | The bearer control mode: UE/NW
State | Indicates the session state.
Primary PCRF Server | The primary Policy Control and Charging Rules Function (PCRF) server host name.
Secondary PCRF Server | The secondary PCRF server host name.
Primary P-CSCF | The primary Proxy-Call Session Control Function gateway address.
Secondary P-CSCF | The secondary P-CSCF gateway address.
UE IP Address
UE IP Session Type | Specifies the type of the address assigned to the user. The possible valid values are IPv4, IPv6 and IPv4_IPv6.
IPv4 Address | Displays the IPv4 address assigned to the user.
IPv6 Address | Displays the IPv6 address assigned to the user.
Primary OCS
Hostname | Specifies the Primary-Event-Charging-Function-Name of type DiameterURI, or the address of primary online charging system.
Port | The port associated with the primary OCS.
Protocol | The protocol associated with the primary OCS.
Secondary OCS
Hostname | Specifies the Secondary-Event-Charging-Function-Name of type DiameterURI, or the address of secondary online charging system.
Port | The port associated with the secondary OCS.
Protocol | The protocol associated with the secondary OCS.
Primary CCF
Hostname | Specifies the Primary-Charging-Collection-Function-Name of type DiameterURI or the address of primary offline charging system for the bearer.
Port | The port associated with the primary CCF.
Protocol | The protocol associated with the primary CCF.
Secondary CCF
Hostname | Specifies the Secondary-Charging-Collection-Function-Name of type DiameterURI or the address of secondary offline charging system for the bearer.
Port | The port associated with the secondary CCF.
Protocol | The protocol associated with the secondary CCF.
Auth Decision | Parameters configured for authorization decision.
Event Triggers | Triggers for different events for Authorization decision.
Event Report Indication | Specifies which type of changes will trigger an event report from the PCRF.
QoS Policy | Specifies QoS policy for specific session.
QoS Class | The QoS class applicable to this session.
Max Uplink Bw(in bps) | The maximum bandwidth for uplink direction, in bps.
Max Downlink Bw(in bps) | The maximum bandwidth for downlink direction, in bps.
Guaranteed Uplink Bw(in bps) | The guaranteed bandwidth for uplink direction, in bps.
Guaranteed Downlink Bw(in bps) | The guaranteed bandwidth for downlink direction, in bps.
Apn Uplink AMBR(in bps) | The APN uplink AMBR, in bps.
Apn Downlink AMBR(in bps) | The APN downlink AMBR, in bps.
Charging Rules | Dynamic charging rule applicable for specific session in IMSA service. NOTE: Charging Rules are no longer shown in StarOS release 11.0 and beyond.
Rule Name | Name of the applicable dynamic charging rule.
Precedence | Precedence of the applicable dynamic charging rule.
Revalidation Time | Specifies the time at which the next CCR-U will be sent out for the Re-validation Timeout EVENT TRIGGER.
Session Packet Statistics | Specifies the session data statistics. NOTE: Session Packet Statistics are no longer shown in StarOS release 11.0 and beyond.
Uplink Pkt Processed | Total number of packets processed in uplink direction.
Uplink Bytes Processed | Total number of bytes processed in uplink direction.
Uplink Pkt Dropped | Total number of packets dropped or not processed in uplink direction.
Uplink Bytes Dropped | Total number of bytes dropped or not processed in uplink direction.
Downlink Pkt Processed | Total number of packets processed in downlink direction.
Downlink Bytes Processed | Total number of bytes processed in downlink direction.
Downlink Pkt Dropped | Total number of packets dropped or not processed in downlink direction.
Downlink Bytes Dropped | Total number of bytes dropped or not processed in downlink direction.
Total sessions matching specified criteria | The total number of sessions matching the specified criteria.