CHGLINASC (Change Line Description (Async))

CHGLINASC Command syntax diagram

 

Purpose

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

 

Required Parameters

LIND
Specifies the name of the line description being changed.

 

Optional Parameters

RSRCNAME
Specifies the resource name that describes the automatic call unit port.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.

*SAME: The value does not change.

resource-name: Specify the resource name of the communications port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01 and the port on the IOA is 2, then the resource name would be LIN012.

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

*SAME: The value does not change.

*NO: This line is not automatically varied on at IPL.

*YES: The line is automatically varied on at IPL.

ACTSNBU
Specifies, for controllers supporting the switched network backup (SNBU) feature, whether the SNBU feature is activated or deactivated. Both the local and remote modems must support the SNBU feature to perform a valid activation.

*SAME: The value does not change.

*NO: The switched network backup (SNBU) feature is not activated.

*YES: The switched network backup feature (SNBU) is activated. To start the feature when the nonswitched connection is broken, specify ACTSNBU(*YES) on the line description command.

VRYWAIT
Specifies whether the line is varied on asynchronously or synchronously. For a 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 the vary on to complete. 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.

SWTCTLLST
Specifies, for switched lines, or those with the SNBU feature, the names of up to 64 switched controllers that can establish a connection with this switched asynchronous line. The controller descriptions must already exist.

*SAME: The value does not change.

switched-controller-name: Specify the switched controller name. The user can specify up to 64 switched controllers that can establish a connection.

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

*SAME: The value does not change.

8: A value of eight data bits per character is used.

7: The format of this tape is FMT3570E. The data format is written on the tape volume with a 3570E device.

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 parity type specified by the PARITY parameter.

*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.

STOPBITS
Specifies the number of stop bits added to the end of each character. These bits are used to keep the local and remote ends of the line synchronized. The local system and the remote system must use the same number of stop bits.

Note: At line speeds of 300 bps or less, two stop bits are recommended.

*SAME: The value does not change.

1: Add one stop bit to each character.

2: The page width is 132 printed characters per line.

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

*SAME: The value does not change.

*FULL: Request-to-send (RTS) is permanently turned on (for full-duplex modems).

*HALF: RTS is turned on only when transmission is required (for half-duplex modems).

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

Specify *ALL or *CNTL only when communicating with a remote system that requires echo. If *ALL or *CNTL is specified for the echo prompt, *FULL must also be specified for the duplex prompt.

*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 before end-of-record characters are echoed to the remote system.

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

*SAME: The value does not change.

line-speed: Specify the line speed. Valid values are: 50, 75, 110, 150, 300, 600, 1200, 2400, 4800, 7200, 9600, 14400, 19200, 28800, 38400, 57600, 76800, 57600, 76800, or 115200 bps.

MODEM
Specifies the type of modem supported on the communications line. Refer to the modem documentation to determine the appropriate value.

*SAME: The value does not change.

*NORMAL: No attempt is made to run diagnostic tests on the modem.

*V54: This value means that certain types of diagnostics (as defined by the CCITT recommendations) are run to the modem. The iSeries 400 supports CCITT V.54 loop 3 (local loop back) and loop 2 (remote loop back).

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

MODEMRATE
Specifies the speed at which the line operates if the line has the data rate select function.

Note: The user is responsible for ensuring that the specified line speed corresponds to the actual modem rate.

*SAME: The value does not change.

*FULL: The line operates at the full rate of the modem.

*HALF: The line operates at half the rate, or at the alternate rate of the modem.

SWTCNN
Specifies whether the switched or switched network backup line is used for incoming calls, for outgoing calls, or for 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.

AUTOANS
Specifies, for switched or switched network backup (SNBU) lines, whether the system automatically answers a call from a remote system to establish the connection or whether the user must manually answer the call and place the modem in data mode.

*SAME: The value does not change.

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

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

*NO: The incoming call must be manually answered.

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

Note: *YES is valid only if the system is using an automatic call unit or if the modem being used is capable of calling through a command interface.

*SAME: The value does not change.

*YES: The line connection is made by the system automatically dialing the remote system.

*NO: The line connection is made by manually dialing the remote system.

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 type is specified. An automatic call unit establishes the connection.

*V25BIS: The dial command type V.25 bis is used. V.25 bis 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 (DTE) to the modem (DCE).

*OTHER: Another dial command type is used. The IBM AT command set is one example of another dial command type that is used by asynchronous protocols.

SETMDMASC
Specifies the V25BIS command that will set the modem to ASYNC mode.

*SAME: The value does not change.

*NONE: No 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, 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 A through Z, lower case a through z, numbers 0 thru 9, and the following special characters:

Table 1. Special characters

Character Description
. 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

No embedded blanks are allowed.

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

Note: Valid only when INTERFACE(*INTMODEM) was specified on the create.

*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:

Table 2. Special characters

Character Description
. 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 mark
@ At sign
^ Circumflex
% Percent
[ Left square bracket
] Right square bracket
\ Back slash
$ Dollar sign

Note: The first two characters of the modem initialization command string must begin with 'AT'. These first two characters must be in uppercase.

ACRSRCNAME
Specifies the resource name that describes the automatic call unit port.

*SAME: The value does not change.

autocall-resource-name: Specify the resource name of the autocall unit port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN02 and the port is 1, then the resource name is LIN021.

CALLNBR
Specifies the local telephone number of the line used for the V.25 bis call request with identification (CRI) dial command. This parameter is used when the CRI function is needed for V.25 bis. When V.25 bis CRI dialing is used, the system takes the called (connection) number from the CNNNBR parameter of the controller description, adds a separator character (;), and concatenates the calling number at the end. Specify the calling number only if the modem and the network both support the CRI dial command.

*SAME: The value does not change.

*NONE: The CRN (Call Request Normal) dial command is used by the V.25 bis line.

calling-number: Specify up to 32 characters that represent the local telephone number for V.25 bis CRI auto-dialing.

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

*SAME: The value does not change.

*NOMAX: There is no disconnect limit.

inactivity-timer: Specify an inactivity timer value.

MAXBUFFER
Specifies the maximum size of inbound and outbound data buffers.

*SAME: The value does not change.

buffer-size: Specify a value ranging from 128 through 4096 characters for the buffer size.

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 monitoring of errors occurs.

*MIN: The error threshold is set at a minimum monitoring level.

*MED: Error thresholding is set to a medium monitoring level.

*MAX: The error threshold is set at a maximum monitoring level.

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. The system uses the RTS/CTS signals to control the data flow. 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: The hardware determines the correct values. Hardware flow control is performed using Request To Send (RTS) and Clear To Send (CTS) flow control signals. The hardware signals the modem to stop sending data by dropping RTS signals when it is not capable of receiving characters. When the hardware is again able to receive characters, it raises the RTS signal to the modem. Also, the hardware monitors the CTS/RTS signal from the modem and stops sending data when it turns OFF.

 

Notes

  1. If *YES or *HARDWARE is specified, DUPLEX(*FULL) must be specified.

  2. If *HARDWARE is specified, XONCHAR and XOFFCHAR parameters cannot be specified.


XONCHAR
Specifies the hexadecimal value of the flow control character XON. 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.

XON-character: Specify a value ranging from 01 through FF for the hexadecimal value of the flow control character XON. The character should not appear in the normal data stream, such as hexadecimal 20 (ASCII blank).

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 a value ranging from 01 through FF for the hexadecimal value of the flow control character XOFF. The character should not appear in the normal data stream, such as hexadecimal 20 (ASCII blank).

EORTBL
Specifies the end of record (EOR) table, which allows the system to recognize logical records when receiving data. The line feed (LF) can be defined as an 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 pairs, where the first element of a pair is the EOR character and the second element specifies the number of characters that follow the EOR character.

*SAME: The value does not change.

Element 1: End of Record Characters

EOR-character: Specify a value ranging from 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. Up to eight EOR character entries can be specified.

Element 2: Additional End of Record Characters

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

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 ranging from 1 through 254 in 0.5- second intervals, or specify 0 to indicate no timer.

Note: Idle timer is also called inter-character timer.

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

*SAME: The value does not change.

DSR-drop-timer: Specify a value ranging from 3 through 60 seconds.

AUTOANSTYP
Specifies the method 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.

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.

CTS-timer: Specify a value ranging from 10 through 120 seconds.

RMTANSTMR
Specifies the amount of time the 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.

CMNRCYLMT
Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.

*SAME: The value does not change.

*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

Element 1: Maximum Recovery Limit

count-limit: Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.

Element 2: Recovery Time Interval

time-interval: Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.

TEXT
Specifies the text that briefly describes the program and its function. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

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

Example for CHGLINASC 

CHGLINASC   LIND(CHICAGO)  LINESPEED(4800)

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

Error messages for CHGLINASC

*ESCAPE Messages

CPF261E
Line description &1 not changed.