Change Line Desc (Async) (CHGLINASC)

The Change Line Description (Async) (CHGLINASC) command changes a line description for an asynchronous line.

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Line description (LIND)

Specifies the name of the line description.

This is a required parameter.

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name if this line description does not use an external Ethernet device server.

*SAME

The value does not change.

*ETHDEVSVR

This line description uses an external Ethernet device server which supports RFC 2217. These servers are sometimes known as Ethernet serial servers or Ethernet terminal servers.

name

Specify the resource name of the communications port.

Online at IPL (ONLINE)

Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME

The value does not change.

*YES

The line is automatically varied on at initial program load (IPL).

*NO

This line is not automatically varied on at IPL.

Activate swt network backup (ACTSNBU)

Specifies, for modems that support the switched network backup (SNBU) feature and that are not IBM 386x, 586x, or 786x models, whether the SNBU feature is activated or deactivated. The local modem and remote modem must both support the SNBU to activate it. IBM 386x, 586x, and 786x models are activated with a hardware switch only. This feature lets you bypass a broken nonswitched connection (nonswitched line) by establishing a switched connection.

*SAME

This value does not change from the value previously specified either on this parameter or on the SNBU parameter of the command creating the line description.

*NO

The SNBU feature is not used.

*YES

The SNBU feature is activated. You must also specify a value of *YES for the Activate swt network backup (ACTSNBU) parameter for the controller.

Vary on wait (VRYWAIT)

Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.

*SAME

The value does not change.

*NOWAIT

The system does not wait for vary on completion. The line is varied on asynchronously.

vary-on-wait

Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.

Notes:

1. When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
2. The time required to vary on a line is the time it takes to:
   • Put tasks in place to manage the line
   • Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
   • Establish the communications tasks and processes

Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.

Switched controller list (SWTCTLLST)

Specifies the names of up to 64 switched controllers that can establish a connection with this switched line. The controller descriptions must already exist. This parameter is valid only if the line is switched or the nonswitched line has the switched network backup (SNBU) feature.

*SAME

The value does not change.

switched-controller-list

Specify the switched controller names. Up to 64 switched controllers can be specified.

Data bits per character (BITSCHAR)

Specifies the number of data bits per character (excluding the parity bit if any).

*SAME

The value does not change.

8

8 data bits per character are used.

Note: 8 bits with parity cannot be used with some Input/Output processors.

7

7 data bits per character are used.

Type of parity (PARITY)

Specifies the type of parity used for error checking (a parity bit is a binary digit inserted in each byte of data to make the arithmetic sum of all the digits, including the parity bit, always odd or always even).

Note: The remote system must use the same parity.

*SAME

The value does not change.

*NONE

No parity bit is inserted in the data byte.

*ODD

The arithmetic sum of all the digits, including the parity bit, is odd.

*EVEN

The arithmetic sum of all the digits, including the parity bit, is even.

Stop bits (STOPBITS)

Specifies the number of bits added to the end of each character. These bits are used to keep the local and remote ends of the line synchronized.

Note: The remote system must use the same number of stop bits as the local system.

*SAME

The value does not change.

1

1 stop bit is added to each character.

2

2 stop bits are added to each character.

Note: At line speeds of 300 bps or lower, 2 stop bits are recommended.

Duplex (DUPLEX)

Specifies whether request-to-send (RTS) is permanently turned on (for duplex modems) or turned on only when transmission is required (for half duplex modems).

*SAME

The value does not change.

*HALF

Request-to-send (RTS) is turned on only when transmission is required (for half duplex modems). You can choose to run half duplex even if the modem can support duplex communication.

*FULL

Request-to-send (RTS) is permanently set on (for duplex modems).

Echo support (ECHO)

Specifies whether the system sends back (echo) all characters it receives to the remote system, send back all characters except end-of-record characters, or if echo is inhibited.

Note: Specify *ALL or *CNTL if this line supports communication with a remote system that requires echo. If you specify *ALL or *CNTL, you must also specify *FULL for the Duplex (DUPLEX) parameter.

*SAME

The value does not change.

*NONE

No characters received are echoed to the remote system.

*ALL

All characters received are echoed to the remote system.

*CNTL

All characters received prior to end-of-record characters are echoed to the remote system.

Line speed (LINESPEED)

Specifies the line speed in bits per second (bps).

*SAME

The value does not change.

1200

1200 bps is used.

line-speed

Specify the line speeds. Valid lines speeds are: 50, 75, 110, 150, 300 600, 1200, 2400 4800, 7200, 9600, 14400, 19200, 28800, 38400, 57600, 76800, or 115200 bits per second.

Modem type supported (MODEM)

Specifies the type of modem supported on the communications line. Refer to the modem manual to determine the appropriate value to select.

*SAME

The value does not change.

*NORMAL

No attempt is made to run a diagnostic test to your modem.

*V54

A certain type of diagnostic test (as defined by the CCITT recommendations) is run to your modem. This system supports CCITT V.54 loop 3, local loop back, and loop 2, which is a remote loop back.

*IBMWRAP

An IBM modem with wrap test capabilities is used on the communications line.

Modem data rate select (MODEMRATE)

Specifies the speed at which the line operates if the modem has the data rate select feature.

*SAME

The value does not change.

*FULL

The line operates at the full rate of the modem.

*HALF

The line operates at half the full rate of the modem.

Switched connection type (SWTCNN)

Specifies whether the switched (Async or BSC) line or switched network backup (Async or BSC) line is used for incoming calls, outgoing calls, or both.

*SAME

The value does not change.

*BOTH

The line is used for both incoming and outgoing calls.

*ANS

The line is used for incoming calls only.

*DIAL

The line is used for outgoing calls only.

Autoanswer (AUTOANS)

Specifies, for switched or switched network backup lines (Async or BSC line), whether the system automatically answers a call from a remote system to establish the connection, or whether the system operator manually answers the call and places the modem in data mode.

Note: *YES is a valid option only if the modem has the automatic answer feature.

*SAME

The value does not change.

*YES

The incoming call is automatically answered by the automatic answer feature.

*NO

The incoming call must be manually answered.

Autodial (AUTODIAL)

Specifies, for switched or switched network backup (SNBU) lines, whether the system automatically calls a remote system to establish a connection or if the system operator must manually place the call.

*SAME

The value does not change.

*NO

The system does not automatically call a remote system.

*YES

The system automatically calls a remote system.

Note: Automatic dialing is valid only if the system is using an automatic call unit or if the modem can call through a command interface.

Dial command type (DIALCMD)

Specifies the type of dial command used to establish a switched connection with a remote system.

*SAME

The value does not change.

*NONE

No dial command is used. (An automatic call unit is used to establish the connection.)

*V25BIS

V.25 bis is a recommendation which allows the use of one physical interface for call establishment and data transmission. It is referred to as a serial automatic call interface because the digits are presented serially on the link from the system to the modem.

*OTHER

The IBM command set is one example of another command type that is used by asynchronous protocols. The dial digits and all other call-related data must be placed directly into the data stream by the application program.

Set modem to ASYNC command (SETMDMASC)

Specifies the V25BIS command string to send to the modem to set the modem to ASYNC mode.

*SAME

The value does not change.

*NONE

No V25BIS command string is sent to the modem.

END

The END command string is generally used as the command to set most modems to ASYNC mode. For cases that do not use the END command string, you should enter the command string appropriate for that modem to set it to ASYNC mode.

command-string

Specify up to 40 characters that represent the command issued. Valid characters are upper case characters A through Z, lower case characters a through z, numbers 0 through 9, and the following special characters:

.

Period

<

Less than sign

(

Left parenthesis

+

Plus sign

&

Ampersand

*

Asterisk

)

Right parenthesis

;

Semicolon

-

Minus sign

/

Slash

,

Comma

_

Underline

>

Greater than sign

?

Question mark

:

Colon

=

Equal sign

Modem init command string (MDMINZCMD)

Specifies the modem initialization command string sent to set the modem.

Note: Valid only when INTERFACE(*INTMODEM) or INFTRFTYPE(*SYNCMODEM) is specified.

*SAME

The value does not change.

*NONE

No command string is sent to the modem.

command-string

Specifies up to 60 characters that represent the command string sent to the modem. Valid characters are upper case A thru Z, lower case a thru z, numbers 0 thru 9, and special characters:

    Period
    Less than sign
    Left parenthesis
    Plus sign
    Ampersand
    Asterisk
    Right parenthesis
    Semicolon
    Minus sign
    Slash
    Comma
    Underline
    Greater than sign
    Question mark
    Colon
    Equal sign
    Spaces
    Number sign
    Double quote
    Exclamation point
    At sign
    Hat symbol
    Percent
    Left square bracket
    Right square bracket
    Back slash

Note: The modem initialization string must begin with the two characters 'AT'.

Autocall resource name (ACRSRCNAME)

Specifies the automatic call resource name that describes the automatic call unit port that is used to establish a connection with a remote system. Use the Work with Hardware Resources (WRKHDWRSC) command to determine the resource name.

*SAME

The value does not change.

Calling number (CALLNBR)

Specifies the local telephone number of the line that is used for the V.25 bis Call Request with Identification (CRI) dial command. When V.25 bis CRI dialing is used, the system takes the called (connection) number (CNNNBR parameter ), adds a separator character (;), and puts the calling number at the end. The default, *NONE, indicates that Call Request Normal (CRN) is used.

Specify the calling number only when the modem and network support the CRI dial command.

*SAME

The value does not change.

*NONE

Call Request Normal (CRN) is used. CRN dialing sends only the connection number to the V.25 bis modem.

calling-number

Specify the local telephone number if V.25 bis CRI dialing is required. The number can be up to 32 characters in length. See your modem documentation to determine the values allowed by the modem.

Note: Specify the calling number only if both the modem and network support the V.25 bis CRI dial command.

Remote internet address (RMTINTNETA)

Specifies the internet address of the Ethernet device server.

*SAME

The value does not change.

character-value

Specify the internet address of the Ethernet device server.

An IPv4 internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. Leading zeros in each part of the dotted decimal internet address are invalid and will be removed. An internet address is not valid if it has a value of all binary ones or zeros for the network identifier (ID) or host portion of the address. If the internet address is entered from the command line, the address must be enclosed in apostrophes.

An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address. An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped).

Remote port (RMTPORT)

Specifies the remote port for the TCP/IP connection to the Ethernet device server.

*SAME

The value does not change.

port-number

Specify a value ranging from 1 through 65535.

Inactivity timer (INACTTMR)

Specifies the time (in tenths of a second) the system waits for activity on a switched line before disconnecting the line.

*SAME

The value does not change.

*NOMAX

The system waits indefinitely for activity.

inactivity-timer

Specify a value from 150 to 4200 units. Each unit represents 0.1 second, which provides a time range of 15 to 420 seconds.

Maximum buffer size (MAXBUFFER)

Specifies the maximum size of inbound and outbound data buffers.

*SAME

The value does not change.

Error threshold level (THRESHOLD)

Specifies the temporary error threshold level being monitored by the system. A permanent error is reported only if the errors occurred consecutively and exceeded the retry limit.

Note: Specifying the THRESHOLD parameter affects all threshold errors. They cannot be specified individually.

*SAME

The value does not change.

*OFF

No threshold errors are reported.

*MIN

The threshold for errors is set to a minimum monitoring level.

*MED

The threshold for errors is set to a medium monitoring level.

*MAX

The threshold for errors is set to a maximum monitoring level.

Flow control (FLOWCNTL)

Specifies whether the hardware controls the data flow.

*SAME

The value does not change.

*NO

Prevents the hardware from generating or recognizing flow control characters, and prevents the use of Request to Send (RTS) and Clear to Send (CTS) flow control signals.

*YES

The system uses the flow control capabilities of the asynchronous protocol. If *YES is specified, the hardware recognizes flow control characters. This means that upon receipt of an XOFF character, the hardware stops transmission until an XON character is received. It also means that the hardware sends an XOFF character to the remote location when it is incapable of receiving characters. When the hardware is again able to receive characters, it sends an XON character to the remote system.

*HARDWARE

If this option is specified, the hardware signals the modem to stop sending data by dropping RTS signals when it is not capabl of receiving characters. When the hardware is able to receive characters again, it raises the RTS signal to the modem. Also, the hardware monitor the CTS and RTS signal from the modem and stops sending data when it is turned off.

NOTES:

1. If *YES or *HARDWARE is specified, DUPLEX(*FULL) must be specified.
2. Hardware flow control is performed using the Request To Send (RTS) and Clear To Send (CTS) flow control signals.

XON character (XONCHAR)

Specifies the hexadecimal value of the flow control character XON. If the system received an XOFF character while sending data, it automatically stops sending, and it starts sending data again only after receiving an XON character.

*SAME

The value does not change.

XON-character

The XON-character can be any value from hexadecimal 01 through FF; however, you must specify a different character than the XOFF character and one that does not appear in your normal data stream, such as hexadecimal 20 (ASCII blank).

XOFF character (XOFFCHAR)

Specifies the hexadecimal value of the flow control character XOFF. If the system receives an XOFF character while sending data, it automatically stops sending, and starts sending data again only after receiving an XON character.

*SAME

The value does not change.

XOFF-character

Specify the hexadecimal XOFF character. The XOFF-character can be any value between hexadecimal 01 and FF; however, you must specify a different character than the XON character and one that does not appear in your normal data stream, such as hexadecimal 20 (ASCII blank).

End-of-Record table (EORTBL)

Specifies the table which allows the hardware to recognize logical records when receiving data. You can define a line feed (LF) as an end-of-record (EOR) character in the data stream, and have the hardware return the data when the LF character is detected in the data stream.

The EOR table is specified as a set of paired elements, in which the first element of a pair is the EOR character and the second element specifies the number of characters that follow the EOR character. Up to 8 entries can be specified. A value of 00 indicates that no end-of-record character is defined.

*SAME

The value does not change.

EOR-character

Specify the end-of-record character(s). Valid end-of-record characters are in the range hexadecimal 01 through 7F (if 7 bits-per-character) or 01 through FF (if 8 bits-per-character). End-of-record characters are specified as they appear on the line after any translation by the Asynchronous communications support.

trailing-characters

Specify the number of additional characters received after the end-of-record character is detected. The number of trailing characters is 0 through 4.

Idle timer (IDLTMR)

Specifies the time (in 0.5 second intervals) that the system waits between characters before the adapter forwards the receive buffer to the system.

*SAME

The value does not change.

idle-timer

Specify a value from 1 to 254 in 0.5 second intervals, or specify 0 which represents no timer.

Note: Idle timer is also referred to as inter-character timer.

Data Set Ready drop timer (DSRDRPTMR)

Specifies the amount of time that the system waits for the modem to exit the Data Set Ready (DSR) state before signaling an error.

*SAME

The value does not change.

drop-timer

Specify a value ranging from 3 through 60 seconds.

Autoanswer type (AUTOANSTYP)

Specifies the method that the system uses to answer incoming calls.

*SAME

The value does not change.

*DTR

The system enters the Data Terminal Ready state, signals the modem to answer calls, and waits for the modem to enter the Data Set Ready (DSR) state.

*CDSTL

The system enters the Connect Data Set to Line (CDSTL) state after monitoring the Ring Indicator to signal the modem to answer the call.

Clear To Send timer (CTSTMR)

Specifies the amount of time the system waits for the modem to enter or exit the Clear to Send (CTS) state before signaling an error.

*SAME

The value does not change.

*NOMAX

The system waits indefinitely.

cts-timer

Specify a value ranging from 10 through 120 seconds.

Remote answer timer (RMTANSTMR)

Specifies the amount of time that system waits for the modem to enter the Data Set Ready (DSR) state after dialing before signaling an error.

*SAME

The value does not change.

answer-timer

Specify a value ranging from 30 through 120 seconds in 5-second intervals.

Recovery limits (CMNRCYLMT)

Specifies the second-level communications recovery limits to be used for this line description.

The possible count-limit values are:

*SAME

The value does not change.

*SYSVAL

The value in the QCMNRCYLMT system value is used.

count-limit

Specify the number of recovery attempts to be performed by the system. Valid values range from 0 through 99.

The possible time-interval values are:

*SAME

The value does not change.

time-interval

Specify the number of minutes within which recovery attempts are made. Valid values range from 0 through 120 in 1-minute intervals.

Text 'description' (TEXT)

Specifies text that briefly describes the line description.

*SAME

The value does not change.

*BLANK

Text is not specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

Example 1: Change an Async Line Description

CHGLINASC   LIND(CHICAGO)  LINESPEED(4800)

This command changes the line speed for line description CHICAGO to 4800 bits per second.

Example 2: Change the Remote Port of an Asynchronous Line Description Using an Ethernet Device Server

CHGLINASC LIND(ASCDESVR) RMTPORT(7800)

This command changes the line description ASCDEVSVR to specify a remote port of 7800 for the connection to the Ethernet device server.

Error messages

*ESCAPE Messages

CPF261E

Line description &1 not changed.