Table Of Contents

Maintenance and Diagnostics for External Resources

Introduction

Service States—Overview

Status, Control, and Administrative Commands

SIP Phone Address of Record and Registered Contact

SIP-REG-CONTACT

Aggregation Status

Status Aggr Command

Destination Point Code

H.323 Gateway

Status Command

Control Command

ISDN Switchover

Media Gateway

Status Command

Control Command

Signaling Gateway Process

Status Command

Stream Control Transmission Protocol Association

Status Command

Control Command

Subscriber Termination

Status Command

Control Command

Subsystem Table

Show Command

Status Command

Control Command

Trunk Group

Status Command

Control Command

Trunk Termination

Using the Status Command to Check Trunk Termination Status

Control Command—Trunk Terminations

Reset Command to Clear Manual and Blocked States

Equip Command

Unequip Command

Diagnostic Tests

Media Gateway Tests

Subscriber Termination Tests

SS7 Trunk Termination Tests

ISDN Trunk Termination Tests

CAS Trunk Termination Tests

Announcement Trunk Termination Tests

Command Responses

Generic Responses to Status or Control Command Failures

Generic Success and Failure Responses

System Error Response

Termination Reason Responses

Trunk Reason Responses

Trunk Termination Reason Responses—SS7 Only

Fault Reason Responses

Status Update Processor

Maintenance and Diagnostics for External Resources

---

Revised: December 10, 2008, OL-4495-07

Introduction

This chapter describes the administration, diagnostic, and maintenance (ADM) commands for external resources accessed by the Cisco BTS 10200 Softswitch. These include, status and control commands.

---

Note This chapter explains how to perform maintenance and diagnostics on external resources that have already been entered into the database. The procedures for entering these resources into the database are provided in the Cisco BTS 10200 Softswitch Provisioning Guide. For example, refer to Chapter 11, "SS7 Provisioning", in the Cisco BTS 10200 Softswitch Provisioning Guide for the procedure to add SS7 resources.

---

Service States—Overview

ADM commands control or show the status of an external resource. The Cisco BTS 10200 Softswitch monitors and administers resource states, and accesses the following external resources:

•Aggregation routers

•Media gateways (MGWs), including the following gateway types:

–Residential gateways (RGWs)

–Trunking gateways (TGWs)

•Trunk groups (TGs)

•Trunks

•Subscriber terminations

The following resources have dependencies:

•Allowed subscriber states depend upon the current RGW or IAD state.

•Allowed trunk states for ISDN depend upon the current TG state, which in turn depends upon the current TGW state.

•Allowed trunk states depend upon the TGW.

There are two types of service states for external resources:

•Administrative—The state that the Cisco BTS 10200 Softswitch operator has provisioned for the link to that resource

•Operational—The physical condition of the link to the resource (or the physical condition of the resource)

These two types of service states are independent of each other. This is illustrated with the following example:

A Cisco BTS 10200 Softswitch operator executes the control command to place an MGW connection in service. The administrative state is now "In Service" (ADMIN_INS). However, the link between the Softswitch and the MGW might be out (cut, damaged, or placed out of service by the owner/operator of the MGW) or the MGW itself might be physically removed or placed out of service. Thus, the operational state of the MGW link is MGW_STATUS_DOWN. A status report of the MGW lists both the administrative state and operational state of the link to the MGW.

Status, Control, and Administrative Commands

This section explains how to use status, control, and other administrative commands applicable to external resources, including:

•SIP Phone Address of Record and Registered Contact

•Aggregation Status

•Destination Point Code

•H.323 Gateway

•ISDN Switchover

•Media Gateway

•Signaling Gateway Process

•Stream Control Transmission Protocol Association

•Subscriber Termination

•Subsystem Table

•Trunk Group

•Trunk Termination

SIP Phone Address of Record and Registered Contact

This section describes the status and control commands related to SIP phone contact information.

---

Note The system automatically creates an Address of Record (AOR) to subscriber (aor2sub) record when a subscriber is created.

Use the change command to update the status of aor2sub and the show command to display the status of aor2sub.

---

The SIP register contact (status sip-reg-contact) command queries the status of the registered contact for the particular AOR (SIP phone subscriber). Calls can be originated from or terminated to a SIP subscriber only if the AOR has a currently registered contact. Calls cannot be originated or terminated if the registered contact for the AOR is expired or freed.

SIP-REG-CONTACT

Use the status sip-reg-contact command to display the operational status of the dynamic contact for a specific AOR.

Examples

status sip-reg-contact aor-id=4695551885@SYS44CA146.boston3.com;

---

Note In this example, the registered contact for this AOR ID has expired, and calls cannot be originated from or terminated to this host.

---

Example of system response:

AOR ID -> 4695551885@SYS44CA146.boston3.com;

USER -> 4692551885

HOST -> 64.101.150.141

PORT -> 5062

USER TYPE -> USER_IP_TYPE

EXPIRES -> 1800

EXPIRETIME -> Wed Jun 4 11:08:33 2003

STATUS -> EXPIRED CONTACT

Reply : Success: 

status sip-reg-contact aor-id=7135551833@SYS12CA146.houston2.com;

---

Note In this example, the registered contact for this AOR ID is valid, and calls can be originated from and terminated to this host.

---

Example of system response:

AOR ID -> 7135551833@SYS12CA146.houston2.com;

USER -> 7132551833

HOST -> 64.100.120.125

PORT -> 5060

USER TYPE -> USER_IP_TYPE

EXPIRES -> 3600

EXPIRETIME -> Wed Jun 4 11:37:44 2003

STATUS -> REGISTERED CONTACT

Reply : Success:

Aggregation Status

This section describes the status command for an aggregation (aggr) router. Aggregation routers are used in cable and network-based call signaling (NCS) markets. In cable markets, they are used as cable modem termination systems (CMTSs). In NCS markets, they are used as edge routers.

Status Aggr Command

Use the following example to check the status of an aggregation router:

status aggr id=CMTS1

Reply Example:

Reply : Success: 

AGGR ID -> CMTS1

OPER STATE -> AGGR IN Service

RESULT -> ADM configure result in success

REASON -> ADM executed successful

The following table provides the AGGR operational-state values and possible responses for the command:

AGGR Operational-state Value	Description	CLI Output
IN SERVICE	The TCP connection to the AGGR is up.	AGGR IN SERVICE
CONNECTING	The TCP connection to the AGGR is being set up.	AGGR CONNECTING
INITIALIZING	Identifies the initial state of the AGGR before a Call Agent (CA) attempts to connect to it.	AGGR INITIALIZING (This is a transitional state, which is rarely seen).
OUT OF SERVICE	The AGGR is out of service.	AGGR OUT OF SERVICE

Destination Point Code

This section describes the ADM status command for destination point codes (DPCs).

Examples

status dpc id=dpc1;

H.323 Gateway

This section describes the status and control commands for H.323 gateways.

The following table contains the RAS states for H.323 gateways:

RAS State	Description
CCH323_RAS_STATE_NONE	The H.323 gateway operational state is ADMIN OOS.
CCH323_RAS_STATE_GRQ	The H.323 gateway is in the Gatekeeper Discovery state.
CCH323_RAS_STATE_RRQ	The H.323 gateway is in the Gateway Registration state.
CCH323_RAS_STATE_IDLE	The H.323 gateway is ready for calls.
CCH323_RAS_STATE_URQ	The H.323 gateway is in the Un-registration state.

Status Command

This section describes the status command for H.323 gateways.

Command Types

Status

Examples

status h323-gw id=CHINA-1; 

Reply Example:

Reply : Success: 

ADMIN_STATE -> ADMIN_INS

H3A PROCESS NUMBER -> 30

H3A PROCESS NAME -> H3A1

ENDPOINT ID -> 

ACTIVE CALLS -> 0

RAS STATE -> CCH323_RAS_STATE_GRQ

RAS PORT -> 35881

IP ADDRESS -> 10.89.224.125

REGISTERED GATEKEEPER ID -> 

PRIMARY GATEKEEPER ID -> 

PRIMARY GATEKEEPER PORT -> 0

PRIMARY GATEKEEPER IP -> 

H323 VERSION -> 4

TIME TO LIVE -> 0

NUM ALT GATEKEEPERS -> 0

ALT GATEKEEPER PERMANENT -> TRUE

THRESHOLD_ENABLED -> FALSE

OUT_OF_RESOURCES -> FALSE

ALT GATEKEEPER LIST ->

Control Command

This section describes the control command for H.323 gateways.

Examples

control h323-gw id=CHINA_1; target-state=INS;

Reply Example:

Reply : Failure: 

INITIAL STATE -> ADMIN_INS

REQUEST STATE -> ADMIN_INS

RESULT STATE -> ADMIN_INS

FAIL REASON -> ADM entity in desired state

REASON -> ADM is in request state

RESULT -> ADM configure result in warning

H323GW ID -> CHINA_1

ISDN Switchover

This section describes the control command for ISDN switchover. For ISDN status, use the status trunk group command described in the "Trunk Group" section. This command is only applicable to nonfacility-associated signaling (NFAS). It switches the D channel that is active to standby, and the D channel that is standby to active.

---

Step 1 Use the following example to display the current TGs with ISDN D channels.

show isdn-dchan

Following is an example of the display:

TGN_ID=1700

DCHAN_TYPE=PRIMARY

SET_ID=backset1

DCHAN_SLOT=3

DCHAN_PORT=0

DCHAN_INTF=0

TGN_ID=1701

DCHAN_TYPE=PRIMARY

SET_ID=backset1

DCHAN_SLOT=3

DCHAN_PORT=1

DCHAN_INTF=0

Reply Example:

Reply : Success:  Entries 1-2 of 2 returned.

Step 2 Use the following example to switch over an ISDN D channel.

control isdn-dchan tgn-id=1; 

Reply Example:

Reply : Success

---

Media Gateway

This section describes the status and control commands for media gateways.

Status Command

This section describes how to check the status of a media gateway.

---

Step 1 The following example checks the status of a media gateway:

status mgw id=c5300_197; 

Reply Example:

Reply : Success: 

MGW ID -> c5300_197

RESULT -> ADM configure result in success

REASON -> ADM executed successful

ADMIN STATE -> ADMIN_INS

OPER STATE -> Media gateway in working status

---

Table 5-1 lists the administrative states the system can return.

Table 5-1 Returnable Administrative States 

State	Definition
ADMIN-INS	In-service
ADMIN-OOS	Out of service
ADMIN-MAINT	Maintenance Mode
ADMIN-OOS-PENDING	Transitioning to out of service
ADMIN-MAINT-PENDING	Transitioning to Maintenance Mode

The system can report the following MGW operational states:

•Media gateway in unknown status

•Media gateway in working status

•Media gateway in down status

•Media gateway cannot be reached

Control Command

This section shows how to control a media gateway in service. Modes can be either forced or graceful. Forced mode tears down all calls immediately; graceful mode allows calls in progress to complete before teardown.

---

Step 1 Use the following example to control a media gateway in service:

control mgw id=c5300_162; mode=forced; target-state=INS;

Reply Example:

Reply : Success: CLI change successful

MGW ID -> c5300_162

INITIAL STATE -> ADMIN_OOS

REQUEST STATE -> ADMIN_INS

RESULT STATE -> ADMIN_INS

FAIL REASON -> ADM found no failure

REASON -> ADM executed successful

RESULT -> ADM configure result in success

---

Note The rules for placing an MGW into the OOS, INS, and MAINT states are shown in Figure 5-1.

---

---

Figure 5-1 Administrative and Operational Maintenance States for MGW

Signaling Gateway Process

This section describes the status command for the signaling gateway process (SGP) table.

Status Command

The SGP status command returns the state of the SGP.

Examples

status sgp id=sgp1;

Where sgp-id is the ID of the selected signaling gateway process in the sgp table. For example, sgp222. This is an optional token.

Stream Control Transmission Protocol Association

This section details the status and control commands for the Stream Control Transmission Protocol (SCTP) Association table. Use the status command to check the status of an SCT association. Use the control command to control an SCTP that is out of service. Forced is the only permitted mode—this mode immediately tears down all calls.

Status Command

Use the following command example to check the status of an SCTP association.

Examples

status sctp-assoc id=sctpassoc1;

Control Command

The following command example shows how to control an SCTP out of service. Forced mode tears down all calls immediately.

Examples

control sctp-assoc id=sctpassoc1; target-state=INS; mode=FORCED;

Subscriber Termination

This section describes the status and control commands for subscriber terminations. Either a range of subscribers can be specified by using *@mgw-id for the ID parameter, or a single subscriber can be specified (for example: sub-ctx1@Cisco.com).

---

Note When first provisioned, all subscriber terminations are in the unequipped (UEQP) state. A subscriber termination must also be in the UEQP state before it can be deleted.

---

Individual subscriber terminations can be placed into any of three administrative service states: INS, OOS, and MNT. The relationship between subscriber termination states and the residential gateway (RGW) state is provided in Table 5-2.

Table 5-2 RGW and Subscriber Termination States 

RGW State	Allowed Subscriber Termination States
OOS	•OOS •UEQP
INS	•OOS •MAINT •INS •UEQP
MAINT	•OOS •MAINT •UEQP

Where:

•OOS means out of service.

•MAINT means maintenance.

•INS means in-service.

•UEQP means unequipped.

The rules for placing RGW subscriber terminations into the OOS, INS, and MAINT states (which depend upon the RGW state) are shown in Figure 5-2.

Figure 5-2 Administrative and Operational Maintenance States for Residential Gateways

Status Command

This section describes how to show the status of subscriber terminations. It is organized as follows:

•Single Subscriber Termination Status

•All Subscriber Terminations Status

•Administrative State Token

•Operating State Token

•

Single Subscriber Termination Status

This section describes how to check the status of a single subscriber termination.

The following example checks the status of a single subscriber termination:

status subscriber-termination id=ubr204_1;

Reply Example:

RESULT -> ADM configure result in success

REASON -> ADM executed successful

ADMIN STATE -> ADMIN_INS

OPER STATE -> Termination is idle

SUBCRIBER DN -> ubr204_1

FAULT REASON -> No fault reason available

---

Note Table 5-3 lists the administrative states the system can return.

---

Table 5-3 Returnable Administrative States 

State	Definition
ADMIN-UEQP	Unequipped
ADMIN-INS	In-service
ADMIN-OOS	Out of service
ADMIN-MAINT	Maintenance Mode
ADMIN-OOS-PENDING	Transitioning to out of service
ADMIN-MAINT-PENDING	Transitioning to Maintenance Mode

All Subscriber Terminations Status

This section describes how to show the status of all subscriber-terminations on a particular gateway.

The following example shows the status of all subscriber-terminations on a particular gateway:

status subscriber-termination id=*@ubr235;

Reply Example:

SUBCRIBER DN -> ubr235_1

ADMIN STATE -> ADMIN_UEQP

OPER STATE -> Termination is unequiped

REASON -> ADM executed successful

RESULT -> ADM configure result in success

FAULT REASON -> No fault reason available

SUBCRIBER DN -> ubr235_2

ADMIN STATE -> ADMIN_UEQP

OPER STATE -> Termination is unequiped

REASON -> ADM executed successful

RESULT -> ADM configure result in success

FAULT REASON -> No fault reason available

Reply : Success: 

Administrative State Token

The Administrative State (admin-state) token returns the administrative state of the subscriber termination. Valid values are:

•UEQP—Unequipped; resource is not commissioned. Resource is not registered.

•OOS—Termination was manually controlled out of service.

•INSQ Termination was manually controlled in service, but operationally may be available or unavailable.

•OOS-PENDING—Termination was manually controlled out of service with mode graceful, termination is still involved in a call.

•MAINT—Termination was in maintenance mode, can run diagnostic commands.

•MAINT-PENDING—Termination was manually controlled to MAINT state, but termination is still involved in call.

•ALL—Return all possible states.

The following command example returns only those trunk terminations that are in administrative state OOS (if any), and operating state IDLE (if any):

status trunk-termination tgn-id=12; cic=1-1000; admin-state=OOS; oper-state=idle 

Operating State Token

The Operating State (oper-state) token expands the range of useful information returned by the status subscriber-termination command.

Valid values for the oper-state token are:

•FA—Faulty

•NF—Not faulty

•IDLE—Termination idle

•ACTIVE—Termination active

•DOWN—Termination down

•TERM-FA—Termination fault

•TEMP-DOWN—Termination temporarily down

•UNREACH—Termination unreachable

•INT-MAINT—Termination internal maintenance

•UEQP—Termination unequipped

•ALL—All states, same as executing command without oper-state token

The following example returns only those subscriber terminations that are FA (if any):

status subscriber-termination id=*@ubr235; oper-state=FA;

---

Note If the media gateway keep-alive is disabled the connectivity status (reachable/unreachable) in termination status command output is only last known status, however all other status information is the latest.

---

Table 5-4 Returnable Operational States

State	Definition
UNKNOWN	•The termination is not being audited for connectivity. •Capabilities, termination, and connection are not being synchronized with the termination. •When KEEPALIVE-METHOD=NONE in MGW-PROFILE, the termination status is UNKNOWN even if the transaction becomes UNREACHABLE. •Newly-provisioned terminations are in this state.
ACTIVE	•The termination is being audited for connectivity. •Capabilities, termination, and connection are being synchronized with the termination.
UNREACHABLE	•The termination is unreachable. •This occurs when MGW KEEPALIVE declares an MGW unreachable. •This changes to ACTIVE when MGW KEEPALIVE detects an MGW is reachable or any termination previously UNREACHABLE starts sending MGCP messages (NTFY, RSIP).
FAULTY	•The termination returneda permanent error code, making it unusable for future calls. Note The error code may occur only in certain circumstances and re-audit/auto-recovery may succeed. This does not mean the termination recovered from that condition. •The flag MGCP-MAX-FAULT-COUNT controls how many times BTS tries to recover the fault (performing re-audit/auto-recovery) before putting it in this state.
MTRANS	•Maintenance Transient, the termination is in the middle of anaudit/re-audit/auto-recovery. •This state may go along with other states (MTRANS-UNREACH).
IDLE	The termination is not involved in transient/active call
BUSY	•The termination is involved in Active/Transient call. •This state may go along with CTRANS state.
CTRANS	•Call Transient, the termination is involved in a Transient call. •This state always goes with BUSY.
RESERVED	The termination is reserved for a call during Busy Line Verification
SERV_EFFC_TEST	The termination is in a Service Effecting Network loopback or Network Continuity test.

Source Token

The source token specifies whether to query the Call Agent, or the EMS, for status information. It is an optional token.

Valid values for the source token are:

•EMS (Default)—Query the local EMS database for most current status.

•AGENT—Query the remote Call Agent database for most current status.

The following example returns the current status of a Call Agent:

status subscriber-termination id=*@ubr235; source=AGENT;

Control Command

This section describes how to control subscriber terminations on a particular gateway. To control a subscriber termination to the unequipped or equipped state, use the equip or unequip commands in the "Equip Command" section and the "Unequip Command" section. This section is organized as follows:

•Control a Single Subscriber Termination

•Control All Subscriber Terminations

•Equip Command

•Unequip Command

Control a Single Subscriber Termination

Use the control command to control one subscriber-termination on a particular gateway.

---

Note To control a subscriber termination to the unequipped or equipped state, use the equip or unequip commands.

---

The following example controls a single subscriber termination into service:

control subscriber-termination id=*@c3810_167; mode=forced; target-state=INS;

Reply Example:

Reply : Success: CLI change successful

ID -> c3810_167

REQUEST STATE -> ADMIN_INS

RESULT STATE -> ADMIN_INS

FAIL REASON -> ADM found no failure

REASON -> ADM executed successful

RESULT -> ADM configure result in success

Control All Subscriber Terminations

This section describes how to control all subscriber-terminations on a particular gateway.

The following example controls to MAINT all subscriber-terminations on a particular gateway:

control subscriber-termination id=*@ubr235; mode=forced; target-state=MAINT

Reply Example:

Reply : Success: CLI change successful

ID -> ubr235

REASON -> ADM executed successful

RESULT -> ADM configure result in success

REQUEST STATE -> ADMIN_MAINT

RESULT STATE -> ADMIN_MAINT

FAIL REASON -> ADM found no failure

CLI>diag subscriber-termination

Reply : Success: Diagnostic Subscriber Menu.

Equip Command

The equip command changes the administrative state of terminations that are in the UEQP state to OOS state. It ignores the terminations in the states INS, MAINT, or OOS.

Use the following example to equip a subscriber termination:

equip subscriber-termination id=97_8@ipclab.cisco.com;

Reply Example:

Reply : Success: CLI change successful

ID -> Subcriber ID -> 97_8@ipclab.cisco.com

REASON -> ADM executed successful

RESULT -> ADM configure result in success

FAIL REASON -> ADM found no failure

Unequip Command

The unequip command changes the administrative state of subscriber terminations that are in OOS state into UEQP state. It ignores the terminations in the INS, MAINT, or UEQP states.

Use the following command to unequip a subscriber termination:

unequip subscriber-termination id=97_8@ipclab.cisco.com;

Reply Example:

Reply : Success: CLI change successful

ID -> Subcriber ID -> 97_8@ipclab.cisco.com

REASON -> ADM executed successful

RESULT -> ADM configure result in success

FAIL REASON -> ADM found no failure

FAIL REASON -> ADM found no failure

Subsystem Table

This section describes the show, status and control commands for the Subsystem table. This table holds the information for all the subsystems using signaling connection control part (SCCP). Because the Cisco BTS 10200 Softswitch supports multiple origination point codes (OPCs), both the subsystem ID and OPC_ID are required to determine subsystem information.

Show Command

Use the show command to display information about the provisioned subsystem(s), including IDs and OPC_IDs.

show subsystem;

Typical system response:

ID=LNP_SSN

LOCAL_SSN=248

REMOTE_SSN=248

SCCP_NW_ID=1

OPC_ID=opc

SCCP_VERSION=ANS92

TCAP_VERSION=ANS92

APPLICATION_VERSION=AIN01

STATUS=UIS

Reply : Success:  Entries 1-1 of 1 returned.

Status Command

The status subsystem command returns the state of a subsystem. You must enter the ID and OPC_ID in this command.

status subsystem id=LNP_SSN; opc_id=opc;

Typical system response:

SUBSYSTEM ID -> LNP_SSN 

OPC ID -> opc

ADMIN STATE -> User in service

OPER STATE -> Subsystem allowed

REASON -> ADM executed successful

RESULT -> ADM configure result in success

Reply : Success: 

Control Command

The following example shows how to control a subsystem out of service in forced mode:

control subsystem id=LNP_SSN; opc_id=opc; target-state=OOS; mode=FORCED; 

Trunk Group

This section describes the status and control commands for trunk groups (TGs). Individual TGs can be placed into any of three administrative service states: INS, OOS, and MAINT. The relationship between TGW and TG state is provided in Table 5-5.

Table 5-5 ISDN TGW/TG State Relationships

TGW State	Allowed TG States
INS	•OOS •MAINT •INS
MAINT	•OOS •MAINT

Status Command

This section describes how to show the status of one TG ID.

The following example shows the status of a single TG ID:

status trunk-grp id=2;

Reply Example:

RESULT -> ADM configure result in success

REASON -> ADM executed successful

ADMIN STATE -> ADMIN_INS

OPER STATE -> Trunk group in-service

TGN ID -> 2

Table 5-6 lists the administrative states that the system can return.

Table 5-6 Returnable Administrative States 

State	Definition
ADMIN-INS	In service.
ADMIN-OOS	Out of service.
ADMIN-MAINT	Maintenance Mode.
ADMIN-OOS-Pending	Transitioning to out of service.
ADMIN-MAINT-Pending	Transitioning to Maintenance Mode.
ACL	Congestion is at level 1
ACL	Congestion is at level 2
ACL	Congestion is at level 3
TFC	Congestion is at level 1
TFC	Congestion is at level 2
TFC	Congestion is at level 3

The system can return the following operating states:

•Trunk group in-service

•Trunk group out of service

•Trunk group manually busy

•Trunk group operate in wait state

•Trunk group operate in standby state

•Trunk group restore session request normal

•Trunk group restore session request switchover

•Trunk group restore session request maintenance

•Trunk group restore session fail normal

•Trunk group restore session fail switch-over

•Trunk group restore session fail maintenance

•Trunk group restore establish request normal

•Trunk group restore establish request switchover

•Trunk group restore establish request maintenance

•Trunk group restore establish fail normal

•Trunk group restore establish fail switchover

•Trunk group restore establish fail maintenance

•Trunk group in maintenance state

•Trunk group down session set fail soft normal

•Trunk group down session set fail hard normal

•Trunk group down session set fail soft maintenance

•Trunk group down session set fail hard maintenance

•Trunk group down establish request soft normal

•Trunk group down establish request hard normal

•Trunk group down establish request soft maintenance

•Trunk group down establish request hard maintenance

•Trunk group down establish fail soft normal

•Trunk group down establish fail hard normal

•Trunk group down establish fail soft maintenance

•Trunk group down establish fail hard maintenance

•Trunk group delete graceful

•Trunk group request remove release

•Trunk group request remove session set

•Trunk group remove graceful in-service and maintenance state

•DPC is inaccessible

Control Command

This section describes how to control one trunk group ID.

---

Note When performing the following commands in immediate succession, always wait at least one second before performing the second command:
      control trunk-grp tgn-id=129; mode=forced; target-state=oos;
      control trunk-grp tgn-id=129; mode=forced; target-state=ins;

---

The following example controls a single trunk group ID into service:

control trunk-grp id=2; mode=forced; target-state=INS;

Reply Example:

Reply : Success: CLI change successful

INITIAL STATE -> ADMIN_OOS

REQUEST STATE -> ADMIN_INS

RESULT STATE -> ADMIN_INS

FAIL REASON -> ADM found no failure

REASON -> ADM executed successful

RESULT -> ADM configure result in success

TGN ID -> 2

---

Caution When you control an ISDN trunk in-service, the media gateway must be in-service.
When you control an ISDN trunk group, all ISDN trunks in that trunk group are controlled to the same state.

---

Trunk Termination

This section describes the status and control commands for trunk terminations. Either a range (for example, cic=1-24;) or a single value (for example, cic=1;) for the CIC parameter can be specified for the status and control of trunk terminations.

Individual ISDN trunks and trunking groups can be placed into any of three administrative service states:

•INS

•OOS

•MAINT

---

Note Use the following command to control all trunk terminations for a particular CIC group to INS. This command resets the circuits. The forced option brings the circuits to INS by using the reset procedure.

control trunk-termination tgn-id=17; cic=1-23; target-state=ins; mode=forced;

---

The relationship between trunk/trunk group state and the TGW state is provided in Table 5-7. For all other trunk types, the trunk state and trunk group state are independent.

Table 5-7 ISDN TGW/TG State Relationships

TGW State	Allowed TG States	Allowed Trunk States
INS	•OOS •MAINT •INS	•UEQP OOS •UEQP OSS, MAINT •UEQP OOS, MAINT, INS
MAINT	•OOS •MAINT	•UEQP OOS •UEQP OSS, MAINT

Where:

•TGW—trunking gateway

•TG—trunk group

•OOS—out of service

•MAINT—maintenance

•INS—in service

•UEQP—unequipped

The rules for placing trunks and TG into the OOS, INS, and MAINT states (which depend upon the TGW state) are shown in Figure 5-3.

Figure 5-3 ISDN Administrative and Operational Maintenance States for a Trunking Gateway

Using the Status Command to Check Trunk Termination Status

This section describes how to check trunk termination status. This section is organized as follows:

•Trunk Termination Status—Basic Command

•Trunk Termination Status—Optional Tokens

•Trunk Termination Status—"status tt" Command

Trunk Termination Status—Basic Command

This section describes how to check the status of one trunk termination. This command can be executed for one CIC (for example, cic=1;), a range of CICs (for example, cic=1-12;) or for all CICs (cic=all;).

Use the following example to check the status of one trunk termination:

status trunk-termination tgn-id=2; cic=8;

Reply Example:

Reply : Success: 

RESULT -> ADM configure result in success

REASON -> ADM executed successful

TGN ID -> 2

CIC -> 8

TERM ADMIN STATE -> ADMIN_INS

TERM OPER STATE -> Termination is idle

TERM REASON -> No fault reason available

TRUNK STATIC STATE -> ACTV

TRUNK DYNAMIC STATE -> TRNS

TRUNK REASON -> NON_FAULTY

---

Note Table 5-8 lists the administrative states the system can return for the term admin status response.

---

---

.

Table 5-8 Returnable Administrative States

State	Definition
ADMIN-UNEQP	Unequipped.
ADMIN-INS	In Service.
ADMIN-OOS	Out of Service.
ADMIN-MAINT	Maintenance Mode.
ADMIN-OOS-PENDING	Transitioning to Out of Service.
ADMIN-MAINT-PENDING	Transitioning to Maintenance Mode.
ADMIN-NULL	Resource does not exist.

Trunk Termination Status—Optional Tokens

The following optional tokens can be used with the status trunk-termination command. They expand the range of useful information returned. Either all, or none of the tokens can be used, with the exception of the off-normal token, which must be used by itself (without any other tokens).

•Administrative State (admin-state). Valid values are:

–UEQP—Unequipped; resource is not commissioned. Resource is not registered.

–OOS—Termination was manually controlled out of service.

–INS—Termination was manually controlled in service, but operationally may be available or unavailable.

–OOS-PENDING—Termination was manually controlled out of service with the graceful mode, termination is still involved in a call.

–MAINT—Termination was in maintenance mode, can run diagnostic commands.

–MAINT-PENDING—Termination was manually controlled to the MAINT state, but termination is still involved in call.

–ALL—Return all possible states.

The following command example returns only those trunk terminations that are in administrative state OOS (if any), and operating state IDLE (if any):

status trunk-termination tgn-id=12; cic=1-1000; admin-state=OOS; oper-state=idle 

•Operating State (oper-state). Valid values for the oper-state token are:

–FA—Includes FAULTY, UNREACH, TEMP-DOWN, and DOWN.

–FAULTY—The MGCP endpoint returned a permanent error code.

–UNREACH—The MGCP endpoint was declared as not reachable. This indicates gateway connectivity problems.

–TEMP-DOWN—The MGCP endpoint is temporarily down.

–DOWN—MGCP endpoint is down because GW termination has sent an RSIP-down message.

–NF—Includes INT-MAINT, IDLE, BUSY, and ACTIVE.

–INT-MAINT—Internal error recovery is in progress.

–IDLE—Termination is not involved in a call, but is available.

–BUSY— Termination is involved in transient call.

–ACTIVE—Termination is involved in stable call.

–UEQP—Termination is not equipped.

–ALL—Returns all possible operational states.

The following command example returns only those trunk terminations that are FA (if any):

status trunk-termination tgn-id=12; cic=ALL; oper-state=FA; 

•Static State (static-state). Valid values for the static-state token are:

–UEQP—Unequipped resource is not commissioned. Resource is not registered.

–LBLK—Termination is locally blocked: either manually taken OOS/MAINT (block reason can be MANUAL-OOS, MAINT-OOS), or automatically went out of service.

–RBLK—Termination is remotely blocked (blocked by remote side).

–ACTV—Available.

–All—Returns all possible static states.

The following command example returns only those terminations that are locally blocked (if any):

status trunk-termination tgn-id=101; cic=1-24; static-state=lblk;l 

•Dynamic State (dynamic-state). Valid values for the dynamic-state token are:

–IBSY—Trunk-termination is involved in an incoming active call.

–OBSY—Trunk-termination is involved in an outgoing active call.

–TRNS—Transient maintenance state (sent maintenance signaling message and waiting for response).