4.151 chg-trm

Use the change terminal command to configure the operational characteristics of each of the 40 terminal ports used to connect modems, printers, and terminals to the system.

Parameters

trm (mandatory)
Terminal. The ID number of the terminal whose characteristics are to be changed.
Range:
1 - 40
all (optional)
This parameter specifies whether to display unsolicited messages of all types (TRAF, LINK, SA, DB, SYS, PU, UIMRD, APPSERV, APPSS, CARD, CLK, DBG, GTT, GWS, MEAS, MON, MPS, SEAS) in the scroll area.
Range:
yes
receive all
no
receive none
Default:
yes—If type=emsalm is specified

Current value—if type parameter value is not emsalm

appserv (optional)
Application server. This parameter specifies whether to display UAMs and UIMs assigned to the Application Server output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current appserv value.

If type=emsalm is specified—yes

System Default:
no
appss (optional)
Application subsystem. This parameter specifies whether to display UAMs and UIMs assigned to the Application Subsystem output group in the scroll area
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current appss value.

If type=emsalm is specified—yes

System Default:
no
baud (optional)
The line speed (baud rate) for this terminal’s serial port connection.
Range:
2400, 4800, 9600, 19200, 38400, 57600, 115200

Note:

Values 38400, 57600, and 115200 are only valid when the OAMHC is used.
Default:
No change to the current value
System Default:
9600
card (optional)
This parameter specifies whether to display UAMs and UIMs assigned to the Card output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current card value.

If type=emsalm is specified—yes

System Default:
no
clk (optional)
Clock. This parameter specifies whether to display UAMs and UIMs assigned to the Clock output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current clk value.

If type=emsalm is specified—yes

db (optional)
Database. This parameter specifies whether to display database-related unsolicited messages in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current db value.

If type=emsalm is specified—yes

System Default:
no
dbg (optional)
Debug. This parameter specifies whether to display UAMs and UIMs assigned to the Debug output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current dbg value.

If type=emsalm is specified—yes

System Default:
no
dural (optional)
Terminal lockout time. The length of time the terminal is disabled after each failed login/unlock attempt in excess of the threshold configured on the mxinv parameter. The value can be specified as seconds (ss); minutes and seconds (mmss); or hours, minutes, and seconds (hhmmss).
Range:
0 - 999999

0–59 (ss)

0–5959 (mmss)

0–995959 (hhmmss)

999999

Default:
No change to the current value
System Default:
100
1 minute, 0 seconds
fc (optional)
Flow control. The type of flow control used to regulate the flow of data between the system and an RS-232 connected device, so that no characters are lost (especially at high baud rates). The control setting of the system and the connected device must match.
Range:
sw
software flow control
none
neither hardware nor software flow control
Default:
No change to the current value
System Default:
sw
gtt (optional)
This parameter specifies whether to display UAMs and UIMs assigned to the GTT output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current gtt value.

If type=emsalm is specified—yes

gws (optional)
This parameter specifies whether to display UAMs and UIMs assigned to the GWS output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current gws value.

If type=emsalm is specified—yes

System Default:
no
link (optional)
This parameter specifies whether to display link maintenance-related unsolicited messages in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current link value.

If type=emsalm is specified—yes

logintmr (optional)
Login timer. The amount of time, in seconds, allowed for a user to log into a Telnet terminal after selecting the terminal.

Note:

This parameter applies to Telnet terminals.
Range:
3 - 600, none

none—Login can occur at any time after selecting the terminal.

Default:
No change to the current value
System Default:
none
logouttmr (optional)
Logout timer. The amount of time, in seconds, before the Telnet session closes after the user manually or automatically logs out.

Note:

This parameter applies to Telnet terminals.
Range:
0 - 1200, none

none—The Telnet session does not close after logout.

Default:
No change to the current value
System Default:
none
meas (optional)
Measurement. This parameter specifies whether to display UAMs and UIMs assigned to the Measurements Maintenance output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current meas value.

If type=emsalm is specified—yes

System Default:
no
mon (optional)
Monitor. This parameter specifies whether to display UAMs and UIMs assigned to the Monitor output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current mon value.

If type=emsalm is specified—yes

mps (optional)
This parameter specifies whether to display UAMs and UIMs assigned to the MPS output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current mps value.

If type=emsalm is specified—yes

mxinv (optional)
Login/unlock failure threshold. When a login or unlock failure occurs on a terminal, a counter of successive login failures is incremented by one. After the increment, if the counter is greater than or equal to the mxinv parameter value, the system sends an information message to all system administrator ports and locks out the port temporarily. The port is locked out for an interval that is specified in the dural parameter.

To disable the info message and temporary lockout function for the terminal, specify mxinv=0.

Range:
0 - 9
Default:
No change to the current value
System Default:
5
successive failed login/unlock attempts
pngfailcnt (optional)
Ping fail count. The number of consecutive ping fails that must occur before the Telnet connection is dropped.

Note:

This parameter applies to Telnet terminals or to EMSALM terminals that have Telnet connections.
Range:
1 - 10
Default:
No change to the current value
System Default:
1
pngtimeint (optional)
Ping time out. The amount of time, in milliseconds, that must pass before the IPSM card initiates a new ping cycle.

Note:

This parameter applies to Telnet terminals or to EMSALM terminals that have Telnet connections.
Range:
100 - 1200000, none

none—Pinging does not occur.

Default:
No change to the current value
System Default:
none
prty (optional)
Parity. The parity for this terminal’s serial port connection.
Range:
none
even
odd
Default:
No change to the current value
System Default:
even
pu (optional)
Program update. This parameter specifies whether to display program update-related unsolicited messages in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current pu value.

If type=emsalm is specified—yes

sa (optional)
Security administration. This parameter specifies whether to display security administration-related unsolicited messages in the scroll area.
Range:
yes
receive all
no
receive none
yes—Receive all.

no—Receive none.

Default:
If all is specified—current all value

If all is not specified—current sa value.

If type=emsalm is specified—yes

sb (optional)
Stop bit. The number of stop bits used in communications with the terminal.
Range:
1 - 2
Default:
No change to the current value
System Default:
1
seas (optional)
This parameter specifies whether to display UAMs and UIMs assigned to the SEAS Maintenance output group in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current seas value.

If type=emsalm is specified—yes

sys (optional)
System. This parameter specifies whether to display system maintenance-related unsolicited messages in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current sys value.

If type=emsalm is specified—yes

tmout (optional)
Maximum channel idle time. The maximum amount of time in minutes that a login session can remain idle (no user input) on a terminal before being automatically logged off. To disable idle time monitoring for a terminal, specify tmout=0.
Range:
0 - 99
Default:
No change to the current value
System Default:
30
minutes
traf (optional)
Traffic. This parameter specifies whether to display traffic-related unsolicited messages displayed in the scroll area.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current traf value

If type=emsalm is specified—yes

System Default:
no
type (optional)
The type of device being connected to this terminal.
Range:
vt320, ksr, printer, sccs, mgmt, telnet, emsalm, none, seas

The emsalm value is valid for terminals 1-40.

The telnet, emsalm, seas, and none are valid values for terminals 17 - 40.

Default:
Current value.
System Default:

vt320 -terminals 1-16

telnet-terminals 17-40

uimrd (optional)
Unsolicited messages. This parameter specifies whether to display the unsolicited messages assigned to this group.
Range:
yes
receive all
no
receive none
Default:
If all is specified—current all value

If all is not specified—current uimrd value.

If type=emsalm is specified—yes

System Default:
no

Example

chg-trm:trm=13:type=ksr:baud=9600:uimrd=yes

chg-trm:trm=1:link=yes:sys=yes:db=yes

chg-trm:trm=17:all=yes

chg-trm:trm=22:type=none

chg-trm:trm=10:link=yes:card=yes:clk=yes

chg-trm:trm=1:type=ksr:gtt=yes

chg-trm:trm=17:logintmr=50

chg-trm:trm=17:pngtimeint=1000

chg-trm:trm=17:pngfailcnt=5

Dependencies

At least one optional parameter must be specified.

The system requires that at least two terminals be configured as security administration terminals. If only two security administration terminals are configured, the value of the  type parameter cannot be changed to a value that would make the terminal unusable (printer or none) because only one security administration terminal would remain.

The combined total line speed (baud rate) for all active terminal ports cannot exceed 168,000. This value allows for 16 terminal to be configured at 9600 bps each.

If the prty=none parameter is specified, then the type=vt320 parameter cannot be specified. A VT320 terminal does not support 7-bit data bytes and no parity. The number of data bits cannot be changed.

If the prty=none parameter is specified, then the type=sccs parameter cannot be specified.

For terminals 1 – 16, the type=telnet parameter cannot be specified.

For terminals 17 - 40, the value of the type parameter must be telnet,seas, emsalm, or none.

If the type=telnet parameter is specified, then the baud, prty, sb, and fc parameters cannot be specified.

If the value of  the type parameter is telnet, seas, or emsalm, and if the value of the trm parameter is 17-40, then an IPSM card must be equipped in the system. Parameters for these terminals cannot be changed unless an IPSM card has been added for the target terminal.

Note:

For one IPSM card, telnet terminals 17-24 are available. For two IPSM cards, telnet terminal IDs 17-32 are available. For three IPSM cards, telnet terminal IDs 17-40 are available. If an installed IPSM card is removed, the eight terminal IDs that were assigned to that card are no longer available. For example, if three IPSM cards are installed, and the second card that was installed is then removed, telnet terminal IDs 17-24 and 33-40 are available. To make the IDs consecutive again, the third card that was previously installed must be removed and re-installed. Then, its available terminal IDs change from 33-40 to 25-32. Use the rtrv-trm command to display the available telnet terminal IDs.

The terminal port must be inhibited (see the inh-trm command) before the type, baud, prty, sb, and fc  parameters can be changed.

The all, traf, link, sa, db, sys, uimrd, and pu parameters can be changed on any terminal, including the one in use, regardless of the port status (inhibited or allowed).

The port cannot be removed from service (rmv-trm) when the type, baud, prty, sb, and fc parameters are being changed.

The dural parameter must be specified in the range of 0–995959 or with a value of 999999.

The hours portion of the dural parameter must be in the range 0–99.

The seconds portion of the dural parameter must be in the range 0–59.

The Terminal table is corrupt or cannot be found.

The IP User Interface (Telnet) feature must be enabled and turned on before the type=telnet parameter (IDs 17-40) or the type=emsalm parameter (IDs 1-40).can be specified.

The minutes portion of the dural parameter must be in the range 0–59.

A valid value must be specified or the baud parameter. Baud rates 38400, 57600, and 115200 are only valid when the OAMHC is used.

The terminal state requested must be answered.

The parity (prty) parameter must have a valid value assigned.

The flow control (fc) parameter if specified must have a valid value assigned.

The specified terminal must be inhibited before the type=seas parameter can be specified.

If the specified terminal is a SEAS Terminal, then the SEAS output group cannot be turned off.

If the SEAS Over IP feature is turned on, then an IPSM card must be provisioned at the location corresponding to the specified SEAS terminal.

The SEAS Over IP feature must be enabled before the type=seas parameter can be specified.

The type=seas parameter cannot be specified if:

  • The value of the trm parameter is 1  - 16.
  • Specifying the parameter results in more than one SEAS terminal on an IPSM card.
  • Specifying the parameter results in more than two SEAS terminals in the EAGLE.
  • An IPSM  card is not physically present in the corresponding location.
  • An available (unconfigured) SEAS terminal does not exist in the SEASCFG table.

The IP User Interface feature must be turned on before the value of the type parameter can be telnet, seas, emsalm, or none.

The IPTERM table is corrupt or could not be found.

The type=telnet parameter must be specified before the logintmr and logouttmr parameters can be specified.

If the value specified for the type parameter is seas or none, then the pngtimeint and pngfailcnt parameters cannot be specified.

The terminal must be in the Inhibited state before the logintmr, logouttmr, pngtimeint, and pngfailcnt parameters can be specified.

Notes

Refer to Maintenance Guide for a list of unsolicited output messages that you might see for each output group.

This command cannot be entered when an upgrade is in progress.

If your terminal has the auto-wrap feature, you must disable the feature to use the terminal on the system.

To disable the informational message and temporary port lockout feature for a terminal, specify the mxinv=0 parameter.

To prevent a terminal from being disabled, specify the dural=0 parameter.

To make the lockout period for a terminal indefinite, specify the dural=999999 parameter. When disabled, a terminal remains disabled until the port is inhibited (inh-trm command) and then allowed (alw-trm command).

Terminal idle time monitoring and auto-logout applies only if the terminal type is vt320, ksr, or sccs. The chg-trm command can be entered with a tmout parameter value for other terminal types, but it has no effect.

Using the terminal type of none conveys to the terminal processor that a particular port is not connected or is no longer in use. The terminal processor does not service output queues for a terminal port that is configured as type=none.

When the terminal type for a terminal is changed to type=emsalm, the value for all output group parameters is set to yes.

When the terminal type for a terminal is changed from type=emsalm to another type, the current value for all output groups is not changed. A command must be entered to change one or more output group values to another value.

Note:

Though the output groups are set to yes, terminals of type emsalm do not display any reports or any UIMs except "UIM 1083 system alive".

The number of data bits cannot be changed; it is set to 7.

Software flow control (XON and XOFF pacing), involves sending control codes between the system and the connected device.

Software flow control is recommended if the connected device is a printer. Software flow control is highly recommended if the connected device is a modem.

To connect a modem, specify the type=vt320 parameter.

The all parameter cannot be specified in the command with the other message status parameters (traf, link, sa, db, sys, or pu). If the all parameter and other message status parameters are specified together in the command, the terminal is assigned the other specified message status parameters and the all parameter is ignored.

If a SEAS terminal is being removed, then a warning that states “Invalidating the Terminal data in SEASCFG table” appears.

If the SEAS output group is turned off for a SEAS terminal, then a message "SEAS Output Group is SET for SEAS Terminal trm number"" appears.

Output

chg-trm:trm=2:all=yes

    rlghncxa03w 04-05-07 11:11:28 EST EAGLE 31.5.0
    CHG-TRM: MASP A - COMPLTD 
;