[ Previous | Next | Contents | Home | Search ]
AIX Versions 3.2 and 4 Asynchronous Communications Guide

Setting Terminal Options with stty-cxma

stty-cxma is a utility program that sets and displays the terminal options for the Micro Channel 128-port, ISA 8-, and 128-port, PCI 8-, and PCI 128-port adapters and is located in /usr/lbin/tty directory. The format is:

stty-cxma [-a] [option(s)] [ttyname]

With no options, stty-cxma displays all special driver settings, modem signals, and all standard parameters displayed by stty(1) for the tty device referenced by standard input. Command options are provided to change flow control settings, set transparent print options, force modem control lines, and display all tty settings. Any unrecognized options are passed to stty(1) for interpretation. The options are:

-a
Displays all of the unique adapter option settings, as well as all of the standard tty settings reported by the stty -a command.
ttyname
Sets and displays options for the given tty device, instead of standard input. This form can be used with a tty pathname prefixed by /dev/ or with a simple tty name beginning with tty. This option may be used on a modem control line when no carrier is present.

The following options specify transient actions to be performed immediately:

break
Sends a 250 ms break signal out on the tty line.
flush
Indicated an immediate flush (discard) of tty input and output.
flushin
Flushes tty input only.
flushout
Flushes tty output only.

The following options specify actions that are reset when the device is closed. The device will use the default values the next time it is opened.

stopout
Stops output exactly as if an XOFF character was received.
startout
Restarts stopped output exactly as if an XON character was received.
stopin
Activates flow control to stop input.
startin
Releases the flow control to resume stopped input.
[-]dtr [drop]
Raises the DTR modem control line, unless DTR hardware flow control is selected.
[-]rts [drop]
Raises the RTS modem control line, unless RTS hardware flow control is selected.

The following options remain in effect until the system is rebooted or until the options are changed.

[-]fastcook
Performs cooked output processing on the intelligent card to reduce host CPU usage, and increase raw mode input performance.
[-]fastbaud
Alters the baud rate tables, so 50 baud becomes 57,600 baud, 75 baud becomes 76,800 baud, 110 baud becomes 115,200 baud, and 200 baud becomes 230,000 baud for supported devices.
[-]rtspace
Enables/disables RTS hardware input flow control, so RTS drops to pause remote transmission.
[-]ctspace
Enables/disables CTS hardware output flow control, so local transmission pauses when CTS drops.
[-]dsrpace
Enables/disables DSR hardware output flow control, so local transmission pauses when DSR drops.
[-]dcdpace
Enables/disables DCD hardware output flow control, so local transmission pauses when DCD drops.
[-]dtrpace
Enables/disables DTR hardware input flow control, so DTR drops to pause remote transmission.
[-]forcedcd
Disable [re-enable] carrier sense, so the tty may be opened and used even when carrier is not present.
[-]altpin
Maps the RJ-45 connector pinouts to the default 10-pin connector values or the 8-pin connector values. When this parameter is enabled, the location of DSR and DCD is switched so that DCD is available when using an 8-pin RJ-45 connector instead of the 10-pin RJ-45 connector. (Default=disable.)

Possible values:

enable (specifies 8-pin connector values)

disable (specifies 10-pin connector values)

startc c
Sets the XON flow control character. The character may be given as a decimal, octal, or hexadecimal number. Octal numbers are recognized by the presence of a leading zero, and hexadecimal numbers are denoted by a leading 0x. For example, the standard XON character, CTRL-Q, can be entered as 17 (decimal), 021 (octal), or 0x11 (hexadecimal).
stopc c
Sets the XOFF flow control character. The character may be given as a decimal, octal, or hexadecimal number (see startc for format of octal and hexadecimal numbers).
astartc c
Sets auxiliary XON flow control character. The character may be given as a decimal, octal, or hexadecimal number (see startc for format of octal and hexadecimal numbers).
astopc c
Sets auxiliary XOFF flow control character. The character may be given as a decimal, octal, or hexadecimal number (see startc for format of octal and hexadecimal numbers).
[-]aixon
Enables auxiliary flow control, so that two unique characters are used for XON and XOFF. If both XOFF characters are received, transmission will not resume until both XON characters are received.
[-]2200flow
Uses 2200 style flow control on the port. The 2200 terminals support an attached printer and use four flow control characters: terminal XON (0xF8), printer XON (0xF9), terminal XOFF (0xFA) and printer XOFF (0xFB).
[-]2200print
Determines how these flow control characters are interpreted. If 2200print is set, run independent flow control for terminal and transparent print devices. Otherwise, terminal and printer flow control are logically tied together. If either XOFF character is received, all output is paused until the matching XON character is received.
maxcps n
Sets the maximum characters per second (cps) rate that characters are output to the transparent print device. The rate chosen should be just below the average print speed. If the number is too low, printer speed will be reduced. If the number is too high, the printer uses flow control, and user entry time is reduced. The default is 100 cps.
maxchar n
Sets the maximum number of transparent print characters the driver places in the output queue. Reducing this number increases system overhead; increasing this number delays operator keystroke echo times when the transparent printer is in use. The default is 50 characters.
bufsize n
Sets the driver's estimate of the size of the transparent printer's input buffer. After a period of inactivity, the driver bursts this many characters to the transparent printer before reducing to the maxcps rate. The default is 100 characters.
onstr s
Sets the terminal escape sequence to turn transparent printing on. The strings can be composed of standard ASCII printing and non-printing characters. Control (non-printing) characters must be entered by their octal values, and must consist of three digits preceded by a back-slash character. For example, the Escape character, 33 octal, should be entered as \033. If transparent printing is turned on by the string <Esc>[5i (ANSI standard), it would be entered as: \033[5i.
offstr s
Sets the terminal escape sequence to turn transparent printing off. Refer to onstr s for the format of the strings.
term t
Sets the transparent printer on/off strings to values found in the internal default table. Internal defaults are used for the following terminals: adm31, ansi, dg200, dg210, hz1500, mc5, microterm, multiterm, pcterm, tvi, vp-a2, vp-60, vt52, vt100, vt220, wyse30, wyse50, wyse60, or wyse75. If the terminal type is not found in the internal default table, ditty reads the terminfo entry for the terminal type and sets transparent print on/off strings to values given by the mc5/mc4 attributes found in the terminfo entries.

[ Previous | Next | Contents | Home | Search ]