Sets the communication line characteristics for a specific
terminal device.
Format
SET device-name[:]
1 – Parameter
device-name
Indicates the name of the device whose characteristics are to
be set. The device name has the form ddcu where dd is the device
code, c is the controller designation, and u is the unit number.
LAN devices are specified as the name of the device that is unit
0. For example, the first terminal device on a LAN is specified
as TTA0, the second as TTB0.
2 – Qualifiers
2.1 /ADDRESS_COMPRESSION
/ADDRESS_COMPRESSION (default)
/NOADDRESS_COMPRESSION
Indicates whether the address and control fields are compressed.
2.2 /CLEAR_COUNTERS
/CLEAR_COUNTERS=(keyword,...)
Determines which counters to clear when trying to resolve
performance problems. The default is to clear all counters. With
this qualifier, you can specify one or more of the following
keywords:
Keyword Description
ALL Resets all counters.
BAD_FCS_PACKETS Resets the count of packets with a bad frame
check sequence (FCS).
DATA_LOST Resets the count of lost characters that were
reported by hardware.
DROPPED_ Resets the count of all characters thrown away.
CHARACTERS
FRAMING_ERRORS Resets the count of characters with framing
errors.
LONG_PACKETS Resets the count of packets longer than the
current maximum receive unit (MRU) setting.
RECEIVED_ Resets the count of total packets received.
PACKETS
RUNT_PACKETS Resets the count of packets with too few
characters.
TOTAL_ Resets the count of all characters received.
CHARACTERS
TRANSMITTED_ Resets the count of total packets transmitted.
PACKETS
2.3 /CONNECT
Sets the line parameters and binds the ASN device to the physical
terminal.
2.4 /ECHO
/ECHO=(FAILURE=value, INTERVAL=value)
Specifies the number of Link Control Protocol (LCP) echo requests
and the interval between requests that must be sent without
response before the line is considered down. The default number
of echo requests is 0.
2.5 /FLOW_CONTROL
/FLOW_CONTROL=control-option
Indicates the type of flow control used over the physical
link. You can specify one of the following keywords with this
qualifier:
Keyword Description
HARDWARE Uses RTS/CTS flow control. If using this control, the
transmit Asynch Control Character Map (ACCM) can be
0x0, 0x0, 0x0, 0x60000000. Only valid for lines set to
/MODEM or /COMMSYNCH.
XON_XOFF Uses band flow control. If using this control, the
(de- optimal transmit ACCM is 0xA0000, 0x0, 0x0, 0x60000000.
fault) Only valid for asynchronous lines.
2.6 /HANGUP
/HANGUP
/NOHANGUP
Determines the action that occurs when a session is terminated.
This qualifier notifies the ASN driver when a modem hangup is
necessary due to an idle device. For example, when the last
network connection is closed on a transient line that is set
to /NOHANGUP, the line switches back to the terminal driver but
the modem remains connected. This allows users to reaccess the
line and log in without having to redial and reestablish the
connection.
To use this qualifier, you must have PHY_IO privilege, or the
line must have TT2$M_MODHANGUP already set.
2.7 /MAGIC_NUMBER_RETRIES
/MAGIC_NUMBER_RETRIES=value
Specifies the number of attempts made to negotiate a magic
number. Magic numbers are used to detect looped back connections.
If you specify 0, no negotiations are made. If you specify 255,
negotiation continues until a number is found. The default number
of attempts is 5.
2.8 /MAXCONFIGURE
/MAXCONFIGURE=value
Indicates the number of configure-request packets sent without
receiving a valid configure-ack, configure-nak, or configure-
reject before assuming the peer is unable to respond. Specify
a value in the range of 0 to 255. The default number of packets
sent is 10.
2.9 /MAXFAILURE
/MAXFAILURE=value
Indicates the number of configure-nak packets sent without
receiving a valid configure-ack before assuming that the
configuration is not converging. Specify a value in the range
of 0 to 255. The default number of packets sent is 5.
2.10 /MAXTERMINATE
/MAXTERMINATE=value
Indicates the number of terminate-request packets sent without
receiving a terminate-ack before assuming that the peer is unable
to respond. Specify a value in the range of 0 to 255. The default
number of packets is 2.
2.11 /MRU
/MRU=size
Specifies the largest packet that can be received over the line.
This value is used as part of the line negotiation, and the
actual MRU setting can vary. Specify a value in the range of 6
to 1500. The default packet size is 1500.
2.12 /MTU
/MTU=size
Specifies the largest packet that can be transmitted over the
line. This value is used as part of the line negotiation, and the
actual maximum transfer unit (MTU) setting can vary. Specify a
value in the range of 6 to 1500. The default packet size is 1500.
2.13 /NETWORK_PROTOCOL
/NETWORK_PROTOCOL=(protocol-name)
Specifies the the protocol allowed over the link. The default
network protocol is TCP/IP.
2.14 /PASSIVE
/PASSIVE
/NOPASSIVE (default)
Notifies the PPP driver how to handle the PPP connection. It can
either actively initiate the connection or wait for the remote
host to start the connection.
2.15 /PERMANENT
/PERMANENT
/NOPERMANENT
Determines how the link is handled when a connection is closed or
lost. If you specify /PERMANENT, the link remains in place with
the PPP driver in control. If you specify /NOPERMANENT, the link
is treated as a transient connection, and the terminal reverts to
the terminal driver.
2.16 /PROTOCOL_COMPRESSION
/PROTOCOL_COMPRESSION (default)
/NOPROTOCOL_COMPRESSION
Specifies whether the two octet protocol fields are compressed
into a single octet.
2.17 /RECEIVE_ACCM
/RECEIVE_ACCM=mask-value
Identifies the starting Asynch Control Character Map (ACCM).
This mask is used by the PPP driver to negotiate the final ACCM
for asynchronous ports. Specify a mask in the range of 0x0 to
0xFFFFFFFF. The default mask value is 0xFFFFFFFF, 0x0, 0x0,
0x60000000, 0x0, 0x0, 0x0. The masks are ordered from low-order
longword to high-order longword. Specify the longword mask until
the last mask bits are set. The remaining longwords are set to
0. With 8 longwords, there is 1 bit for every ASCII character
position (from 0 to 255). The ASCII characters 0x20 through 0x3F
and 0x5E cannot be quoted.
2.18 /RESTART_TIMER
/RESTART_TIMER=msecs
Interval in milliseconds (msecs) used to time the transmission
of configure-request and terminate-request packets. Expiration of
the restart timer results in a timeout event and retransmission
of the packet. Specify a value from 1 to 90. The default is 30
(.03 seconds), which is intended for relatively slow speed links.
For smaller, faster links, specify a smaller value.
2.19 /SPEED
/SPEED=(input-rate,output-rate)
Allows you to control the input and output speed of the line for
asynchronous ports. To use this qualifier, you must have PHY_IO
privilege, or the line must already have TT2$M_SETSPEED set.
Specify one of the following speeds: 50, 75, 100, 134, 150, 300,
600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, 19200, 38400,
57600, 76800, or 115200. If your line allows split speed, you
can specify different speeds for input and output. If you only
specify one speed, it is used for both input and output.
2.20 /TRANSMIT_ACCM
/TRANSMIT_ACCM=mask-value,...
Identifies the starting Asynch Control Character Map (ACCM). This
mask is used by the PPP driver to negotiate the final transmit
ACCM for asynchronous ports. Specify a mask in the range of 0x0
to 0xFFFFFFFF. The default mask value is 0xFFFFFFFF, 0x0, 0x0,
0x60000000, 0x0, 0x0, 0x0. The masks are ordered from low-order
longword to high-order longword. Specify the longword mask until
the last mask bits are set. The remaining longwords are set to
0. With 8 longwords, there is 1 bit for every ASCII character
position (from 0 to 255). The ASCII characters 0x20 through 0x3F
and 0x5E cannot be quoted.
PPPD> SET/PERMANENT TTA0:
%PPPD-I-CONNECTTERM, converting connection on device _TTA0: to a
Point-to-Point connection
In this example, the SET command is setting up a permanent
network connection over the serial port TTA0.