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
- 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.
- appserv (optional)
- Application server. This parameter specifies whether to display UAMs and UIMs assigned to the Application Server output group in the scroll area.
- appss (optional)
- Application subsystem. This parameter specifies whether to display UAMs and UIMs assigned to the Application Subsystem output group in the scroll area
- card (optional)
- This parameter specifies whether to display UAMs and UIMs assigned to the Card output group in the scroll area.
- clk (optional)
- Clock. This parameter specifies whether to display UAMs and UIMs assigned to the Clock output group in the scroll area.
- db (optional)
- Database. This parameter specifies whether to display database-related unsolicited messages in the scroll area.
- dbg (optional)
- Debug. This parameter specifies whether to display UAMs and UIMs assigned to the Debug output group in the scroll area.
- 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).
- 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.
- gtt (optional)
- This parameter specifies whether to display UAMs and UIMs assigned to the GTT output group in the scroll area.
- gws (optional)
- This parameter specifies whether to display UAMs and UIMs assigned to the GWS output group in the scroll area.
- link (optional)
- This parameter specifies whether to display link maintenance-related unsolicited messages in the scroll area.
- 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.
- 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.
- meas (optional)
- Measurement. This parameter specifies whether to display UAMs and UIMs assigned to the Measurements Maintenance output group in the scroll area.
- mon (optional)
- Monitor. This parameter specifies whether to display UAMs and UIMs assigned to the Monitor output group in the scroll area.
- mps (optional)
- This parameter specifies whether to display UAMs and UIMs assigned to the MPS output group in the scroll area.
- 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.
- 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.
- 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.
- pu (optional)
- Program update. This parameter specifies whether to display program update-related unsolicited messages in the scroll area.
- sa (optional)
- Security administration. This parameter specifies whether to display security administration-related unsolicited messages in the scroll area.
- seas (optional)
- This parameter specifies whether to display UAMs and UIMs assigned to the SEAS Maintenance output group in the scroll area.
- sys (optional)
- System. This parameter specifies whether to display system maintenance-related unsolicited messages in the scroll area.
- 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.
- traf (optional)
- Traffic. This parameter specifies whether to display traffic-related unsolicited messages displayed in the scroll area.
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 thertrv-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
;