Note ¯ After making any configuration changes to a line (Line0 or Line1) or to the T1 expansion card, you must use the save all and reboot commands for the changes to take effect.

Displaying PortMaster 3 Diagnostic Information

• set console-see page 2-19

• set debug isdn on-see page 17-7

• set debug isdn-d frames on-see page 17-7

• set debug mdp-status on|off-see page 17-9

  When finished, use the following commands:

• set debug off-see page 17-5

• reset console-see page 2-15

  To display line configuration or status, use the following commands:

• show global-see page 2-27

• show sessions-see page 2-38

• show Line0

• show mcppp

• show modems

• show M0

Summary of PortMaster 3 Commands

PortMaster 3 Commands

reset MO

This command resets an internal digital modem and reloads its digital signal processor (DSP) code.

reset MO

MO	Digital modem number m0 through m59.

Example

M0: Modem Resetting

Command> reset m1

M1: Modem Resetting

See Also

reset V0

When you are using Multichassis PPP, this command resets a virtual port on the master unit and the corresponding physical port on the slave unit.

reset V0

V0	Virtual port number, 0, 1, and so on.

Usage

See Also

set endpoint

This command enables Multichassis PPP, which supports RFC 1990 Multilink PPP across multiple PortMaster products sharing an Ethernet.

set endpoint Hex

Hex	Endpoint discriminator-a 1 to 12-digit hexadecimal number. ComOS appends zeros if you specify less than 12 digits.

Usage

To enable Multichassis PPP, set the endpoint discriminator on all PortMaster products sharing a hunt group and Ethernet to the same 12-digit hexadecimal number. For convenience you can use the Ethernet MAC address of one PortMaster as the endpoint discriminator for all the PortMaster products on that hunt group, but any 12-digit hexadecimal number will serve.

Note ¯ You must use the save all and reboot commands after issuing the set endpoint command for the endpoint discriminator to take effect.

Example

See Also

set isdn switch

This command sets the switch type for ISDN connections to the PortMaster ISDN PRI ports.

set isdn-switch ni-2|dms-100|4ess|att-5ess

set isdn-switch net5|vn2|vn3|1tr6|ntt|kdd

ni-2	National ISDN-2 (NI-2) compliant. This is the default.
dms-100	Northern Telecom DMS-100.
4ess	AT&T 4ESS.
att-5ess	AT&T 5ESS.
net5	European ISDN PRI standard.
vn2	France-older switch.
vn3	France-older switch.
1tr6	Germany-older switch.
ntt	Japan.
kdd	Japan.
ts014	Australia. To use this switch type, set the port type to network hardwired, set the directory number for the port appropriately, and reset the port.

|ts014

Usage

Example

set Line0|line2 encoding

This command sets the encoding method used with T1 or E1 lines or the T1 expansion card.

set Line0|line2 encoding b8zs|ami|hdb3

Line0	line0 or line1.
line2	T1 expansion card.
b8zs	Bipolar 8-zero substitution. This is the default for T1 lines.
ami	Alternate mark inversion.
hdb3	High-density bipolar 3. This is the default for E1 lines.

Example

set Line0|line2 framing

This command sets the framing format used for the E1 or T1 line or the T1 expansion card.

set Line0|line2 framing esf|d4|crc4|fas

Line0	line0 or line1.
line2	T1 expansion card.
esf	Extended superframe. This is the default format for T1 lines.
d4	D4 framing, an alternative format for T1 lines.
crc4	Cyclic redundancy check 4. This is the default format for E1 lines.
fas	Frame Alignment Signal, an alternative format for E1 lines.

Example

set Line0|line2 group

This command allows you to set the channel rate for a group on a fractional T1 or E1 line or on a T1 expansion card to 56Kbps or 64Kbps.

set Line0|line2 group Cgroup 56k|64k

Line0	line0 or line1.
line2	T1 expansion card.
Cgroup	Defined channel group from 1 to 63.
56k	56Kbps, typically used for D4 framing.
64k	64Kbps, used for framing types other than D4. This is the default.

Usage

See Also

set Line0 group channels - page 9-9

set Line0|line2 group channels

This command allows you to divide each of the T1 or E1 lines or the T1 expansion card into groups that function as synchronous ports.

set Line0|line2 group Cgroup|none channels Channel-list

Line0	line0 or line1.
line2	T1 expansion card.
Cgroup	Group number from 1 to 63 that designates a port number on each T1 or E1 line or T1 card, or none to unassign channels.
Channel-list	Space-separated list of one or more channel numbers, from 1 through 24 for T1, or 1 through 30 for E1. The channel numbers do not have to be contiguous.

Usage

When set to fractional, the T1 expansion card supports only one line group and the first line group found is used for configuration.

Example

Command> set line0 fractional
Command> set line0 group 2 channels 1 2 3 4
Command> set line0 group 2 64k
Command> save all
Command> reboot

Now configure the channel group 2 as you would any PortMaster synchronous port.

See Also

set Line0|line2

This command allows you to use a line as a single E1 or T1 line, as PRI B channels, as a fractional E1 or T1 line divided into channel groups, or for inband signaling for channelized T1.

Note ¯ T1 and E1 settings are mutually exclusive and are dependent on the PortMaster model.

set Line0 isdn|t1|e1|fractional|inband

set line2 t1|fractional

Line0	line0 or line1.
line2	T1 expansion card.
isdn	Uses the line as PRI B channels. This is the default.
t1	Uses the entire line as a T1 line.
e1	Use the entire line as an E1 line.
fractional	Divides the line into groups specified by the set Line0 | line2 group command (see page 9-9).
inband	Sets the line for inband signaling, used for channelized T1 and E1. The signaling protocol for channelized T1 is specified by the set Line0 signaling command (see page 9-13). For channelized E1, use the set Line0 signaling mfr2 command (see page 9-14).

Usage

When the T1 expansion card is installed, a new port-W24 for a single PRI or W48
for two PRIs-is added to the list of active ports.

When set to isdn, Line2 defaults to T1 operation. When set to fractional, the T1 card supports only one line group and the first line group found is used for configuration.

Note ¯ The T1 card is hot-swappable. After removing the card from the PortMaster 3 slot, you must wait for a few seconds before re-inserting it. If you remove the T1 card and re-insert it immediately, the PortMaster 3 locks up and you must turn it off and on again to restart.

Note ¯ T1 and E1 lines require an external clock signal provided by the device that the PortMaster is connected to, or by the telephone company network.

set Line0|line2 loopback

This command sets a T1 or E1 line for local network loopback.

set Line0|line2 loopback on|off

Line0	line0 or line1.
line2	T1 expansion card.
on	Turns on local network loopback.
off	Turns off local network loopback.

Usage

Example

set Line0 pcm

This command sets the digital encoding method used for analog signals.

set Line0 pcm u-law|a-law

Line0	line0 or line1.
u-law	Default method of analog-to-digital conversion used for T1 PRI lines.
a-law	Default method of analog-to-digital conversion used for E1 PRI lines.

Usage

ComOS 3.8 and later supports the V.90 modem protocol for Lucent and 3Com chipsets for dial-in modems on T1 PRI lines.

Example

set Line0 signaling

This command sets the inband signaling protocol and the inband call options used with channelized T1.

set Line0 signaling wink|immediate|fxs

Line0	line0 or line1.
wink	E & M wink start protocol, an option for use with channelized T1 lines. This is the default.
immediate	E & M immediate start protocol.
fxs	Foreign exchange station (FXS) loop start protocol.

Note ¯ You must first set Line0 to inband signaling using the command set line0 inband before using the command set Line0 signaling.

Example

See Also

set Line0 signaling mfr2

This command sets inband signaling to multifrequency R2 signaling (MFR2) for a channelized E1 line.

set Line0 signaling mfr2 r2gen|Profile

Line0	line0 or line1.
r2gen	Generic R2, the default when Line0 is set for inband signaling. Sets inband signaling to MFR2 but without tone signaling.
Profile	One of the following channelized E1 inband signaling profiles:
	0	ITU-T standard, Argentina and other countries.
	1	Mexico.
	2	Brazil.
	3	Venezuela.
	4	Mexico. Profile 4 is a subset of profile 1 and is used with switches that do not support caller ID. This profile can be used in Mexico wherever profile 1 is used, but the reverse is not true.

Usage

MFR2 signaling is supported by ComOS release 3.8 and later for incoming calls on E1 lines and requires the use of Lucent True Digital K56flex modem cards.

Use the show line0 command to display the type of inband signaling used and the MFR2 profile selected.

For more information on configuring for MFR2 signaling, refer to the PortMaster Configuration Guide.

Note ¯ You must first set the line to inband signaling using the command set Line0 inband before setting the line to MFR2 signaling.

Examples

line0 changed to inband signaling, MFR2

Command> set line1 signaling r2gen

line1 changed to inband signaling, R2MF generic

See Also

show Line0 - page 9-19

set line2 clock

This command sets the source for the clock signal for the T1 expansion card.

set line2 clock internal|external

line2	T1 expansion card.
internal	Selects the built-in 1.544Mhz crystal to drive the line. This setting is used for dry wire configurations or back-to-back connections.
external	Built-in digital service unit (DSU)/ channel service unit (CSU) extracts the clock signal from the line. This is the default.

Examples

line2 clocking changed to external

Command> set line2 clock internal

line2 clocking changed to internal

See Also

set location analog

This command sets the digital modems of a PortMaster 3 to analog modem service when dialing out to the specified location.

set location Locname analog on|off

Locname	Location name that is in the location table.
on	Enables analog modem service on dial-out.
off	Disables analog modem service on dial-out, and causes the service to revert to ISDN.

Usage

Example

set M0

This command makes the digital modems on the PortMaster 3 available or unavailable.

set M0 on|off

M0	Any modem number from m0 to m59. Changes to the default setting must be made to individual modems.
on	Makes the modem available for use. This is the default.
off	Busies the modem so it is unavailable.

Usage

Any user on a modem that is busied is disconnected.

Note ¯ Digital modems do not require any configuration or initialization string.

Example

See Also

set M0 lastcall

This command forces an active modem into ADMIN mode as soon as a user logs off.

set M0 lastcall

M0	Any modem number from m0 to m59. Changes to the default setting must be made to individual modems.

Usage

To return the modem to its normal operation, reboot or use the command set M0 on.

The modem status displayed by the show M0 and show modems commands is ACT(LC) instead of ACTIVE, to show that the modem status is Active (Last Call).

Note ¯ When circuits are available to the PortMaster but no modems are available, the PortMaster replies to another incoming call with a user busy signal to the telephone company, giving the user a busy signal, instead of forwarding the call to the next line in the hunt group. The telephone company might be able to configure the line for "forward when busy" to prevent this behavior.

Example

Modem M20 changed from on to lastcall

See Also

set M0 on|off - page 9-16

show M0 - page 9-22

set S0 directory

This command sets a telephone number for an individual port when the line is configured as ISDN B channels.

set S0 directory Number

S0	One of the ISDN ports.
Number	Access telephone number.

Usage

BACP and BAP Supports. ComOS 3.8 and later supports the Bandwidth Allocation Control Protocol (BACP), according to RFC 2125. Because BACP and the Bandwidth Allocation Protocol (BAP) are both negotiated protocols, no commands are necessary to turn them on. The only requirement for the use of BAP and BACP is setting directory numbers on the serial ports so the PortMaster can offer a second number to the client dialing in.

BACP supports local exchange telephone numbers. If a long-distance BACP user is configured to dial a local exchange telephone number, the PortMaster checks the Called-Station-Id when the second channel is requested. To implement this configuration, do not set the directory numbers.

Example

show Line0

Shows the status of a E1 or T1 line on a PortMaster 3.

show Line0|line2

Line0	line0 or line1.
line2	T1 expansion card.

E1 Example

Command> show line1
---------------------- line1 - E1 Primary Rate ISDN --------------------
Status: DOWN F3	Framing: FAS	Encoding: HDB3	PCM: a-law
	Violations
	-------------------------------
	Bipolar	1209159
	CRC4	0
	E-bit	0
	FAS

T1 Examples

Command> show line0
--------------------- line0 - T1 Primary Rate ISDN -------------------
Status: UP	Framing: ESF	Encoding: B8ZS	PCM: u-law
Receive Level:	+2dB to -7.5dB
Alarms		Violations
------------------------------------		---------------------------------
Blue	0	Bipolar	102
Yellow	0	CRC Errors	1
Receive Carrier Loss	0	Multiframe Sync	9
Loss of Sync	0

Line0 is configured for inband signaling-channelized T1

Command> show line0
--------------------- line0 - T1 Inband DS0 ----------------------------
Status: UP	Framing: ESF	Encoding: B8ZS	PCM: u-law
Signaling: Trunk E&M wink start		Options: inbound calls only
Receive Level:	+2dB to -7.5dB
Alarms		Violations
------------------------------------		---------------------------------
Blue	0	Bipolar	5
Yellow	0	CRC Errors	0
Receive Carrier Loss	0	Multiframe Sync	2
Loss of Sync	0

.

Explanation

Status	Status of T1 or E1 line.
F State-E1 only (F3 in example)	PRI layer 1 state at the user side of the interface. Range: F0 to F6. F0-Power off, no signal. F1-Operational. F2 to F5-Failure conditions FC1 to FC4. F6-Power on, no signal.
Framing	Framing format in use.	See page 9-7.
Encoding	Encoding method in use.	See page 9-7.
PCM	Pulse code modulation method in use.	See page 9-12.
Signaling	Type of inband signaling in use	See page 9-10 and page 9-13.
Options	Inband signaling options in use.	See page 9-13.
Receive Level	Signal strength on the line.
E1 Alarms	Remote Alarm-Remote is in alarm state. Receive Carrier Loss-Loss of carrier signal. Loss of Sync-Device loss of synchronization signal.
T1 Alarms	Blue-Unframed all ones (1s) signal. Yellow-D4 bit2, D4 12th F-bit, or extended superframe (ESF) mode (framing) signal. Receive Carrier Loss-Loss of carrier signal. Loss of Sync-Device loss of synchronization signal.
E1 Violations	Bipolar-Consecutive bipolar violations of same polarity. CRC4-Errors in the CRC4 code words (CRC4 framing). E-bit-CRC4 error bits. FAS bit-Errors in the frame alignment signal (FAS) code words (FAS framing).
T1 Violations	Bipolar-Consecutive bipolar violations of same polarity. CRC Errors-Errors in CRC6 code words (ESF framing), or in the Ft framing bit position (D4 framing). Multiframe Sync-Multiframes received out of synchronization.

show M0

This command shows the status of a digital modem on a PortMaster 3.

show M0

M0	The digital modem number.

Example

Command> show m0
State:	ACTIVE
Active Port:	S2
Transmit Rate:	28800
Receive Rate:	28800
Connection Type:	LAPM/V42BIS
Chars Sent:	19001366
Chars Received:	3177827
Retrains:	0
Renegotiations:	3
Total Calls:	63
Modem Detects:	58
Good Connects:	56
Connection Failures
No Modulation:	1
No Protocol:	1
Total Failed:	2
Session Terminations
Lost Carrier:	0
Normal Disconnect:	56

Explanation

State:	Modem status-one of the following:
	ACTIVE	The modem is in use.
	ACT(LC)	The modem is in use but will go into ADMIN mode as soon as user logs off.
	READY	The modem is available for use.
	ADMIN	The modem has been busied out.
	TEST	The modem is under test.
	DOWN	The modem is not available.
Active Port:	Digital modem port assignment.
Transmit Rate:	Modem transmission speed in bits per second.
Receive Rate:	Modem reception speed in bits per second.
Connection Type:	Data link-layer protocol/compression standard used.
	The following status information is measured since the PortMaster was last rebooted:
Chars Sent:	Number of characters transmitted.
Chars Received:	Number of characters received.
Retrains:	Number of modem retrain events.
Renegotiations:	Number of modem handshake renegotiation events.
Total Calls:	Total calls attempted.
Modem Detects:	Total calls where a remote modem was detected.
Good Connects:	Number of detected calls that made valid connections.
Connection Failures:	Reason and number of modem connection failures, as follows:
	No Modulation:	No signal modulation detected.
	No Protocol:	No link-layer protocol detected.
	Total Failed:	Total failed connections.
Session Terminations:	Reason and number of modem session terminations, as follows:
	Lost Carrier:	DCD was lost, with consequent session termination.
	Normal Disconnect:	Normal session termination.

show modems

Shows the status of the digital modems on a PortMaster 3.

show modems

Example

Command> show modems
Mdm	Port	Status	Speed	Compression	Protocol	Calls	Retrain	Disconnect
----	----	-------	--------	-----------	--------	------	-------	----------
M0	S2	ACTIVE	28800	V42BIS	LAPM	12	0	NORMAL
M1	S3	ACTIVE	28800	V42BIS	LAPM	5	0	NORMAL
M2	S4	ACTIVE	28800	V42BIS	LAPM	7	0	NORMAL
M3	S11	READY	UNKNWN	NONE	NONE	0	0	NORMAL

Explanation

Mdm	Digital modem number.
Port	PortMaster port assignment.
Status	ACTIVE	The modem is in use.
	READY	The modem is available for use.
	ADMIN	The modem has been busied out.
	TEST	The modem is under test.
	DOWN	The modem is not available.
Speed	The connect speed in bits per second.
Compression	Compression standard used.
Protocol	Data-link layer protocol used.
Calls	Number of calls since the last PortMaster reboot.
Retrain	Number of times the modem changes speed (retrains) due to a change in line quality since the last PortMaster reboot.
Disconnect	Type of modem disconnection, normal or lost carrier.

show mcppp

This command displays the addresses of the neighboring PortMaster devices in the same Multichassis PPP group, and a list of connections to virtual and physical ports on the PortMaster.

show mcppp

Example

Command> show mcppp
Neighbors:
pm3-02-e0 (172.16.137.14) pm3-03-e0 (172.16.137.12)
pm3-01-e0 (172.16.137.11)
Port	User	Host/Inet/Dest	Type	Peer
----	------	--------------	--------	-------------------------
S11	misha	192.168.96.2	SLAVE	pm3-02-e0
S39	neil	172.16.200.4	SLAVE	pm3-03-e0
V0	bsmith	192.168.200.1	VIRTUAL	pm3-01-e0

Explanation

Port	Physical port number (for example S11) used as a slave port for a Multichassis PPP connection, or a virtual port number (for example, V0) established to complete a Multichassis PPP connection with another PortMaster in the same Multichassis PPP group.
User	Username of the user logged in to the port.
Host/Inet/Dest	Hostname, or IP address of login user.
Type	Port type, as follows:
	SLAVE	Physical port used as a slave for a corresponding virtual port on another PortMaster in the same Multichassis PPP group.
	VIRTUAL	Virtual port created for a corresponding physical port on another PortMaster in the same Multichassis PPP group.
Peer	Name or IP address of the PortMaster in the same Multichassis PPP group that is connected to the login user via a corresponding physical or virtual port.