The Change Line Description (BSC) (CHGLINBSC) command changes a line description for a BSC line.

Parameters

Keyword	Description	Choices	Notes
LIND	Line description	Name	Required, Key, Positional 1
RSRCNAME	Resource name	Name, *SAME	Optional
ONLINE	Online at IPL	*SAME, *YES, *NO	Optional
ACTSNBU	Activate swt network backup	*SAME, *YES, *NO	Optional
VRYWAIT	Vary on wait	15-180, *SAME, *NOWAIT	Optional
SWTCTLLST	Switched controller list	Single values: *SAME Other values (up to 64 repetitions): Name	Optional
STNADR	Station address	04-FE, *SAME	Optional
DUPLEX	Duplex	*SAME, *HALF, *FULL	Optional
LINESPEED	Line speed	*SAME, 600, 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 57600	Optional
MODEM	Modem type supported	*SAME, *NORMAL, *V54, *IBMWRAP	Optional
MODEMRATE	Modem data rate select	*SAME, *FULL, *HALF	Optional
SWTCNN	Switched connection type	*SAME, *BOTH, *ANS, *DIAL	Optional
AUTOANS	Autoanswer	*SAME, *YES, *NO	Optional
AUTODIAL	Autodial	*SAME, *YES, *NO	Optional
DIALCMD	Dial command type	*SAME, *NONE, *V25BIS	Optional
ACRSRCNAME	Autocall resource name	Name, *SAME	Optional
CALLNBR	Calling number	Character value, *SAME, *NONE	Optional
INACTTMR	Inactivity timer	150-4200, *SAME, *NOMAX	Optional
MAXBUFFER	Maximum buffer size	8-8192, *SAME	Optional
CODE	Character code	*SAME, *EBCDIC, *ASCII	Optional
SYNCCHARS	SYN characters	*SAME, 2, 4	Optional
THRESHOLD	Error threshold level	*SAME, *OFF, *MIN, *MED, *MAX	Optional
STXLRC	Include STX character in LRC	*SAME, *YES, *NO	Optional
RCVTMR	Receive timer	30-254, *SAME	Optional
CONTTMR	Continue timer	16-24, *SAME	Optional
CTNRTY	Contention state retry	0-21, *SAME	Optional
DTASTTRTY	Data state retry	0-255, *SAME	Optional
TMTRTY	Transmit TTD or WACK retry	0-65534, *SAME, *NOMAX	Optional
RCVRTY	Receive TTD or WACK retry	0-65534, *SAME, *NOMAX	Optional
DSRDRPTMR	Data Set Ready drop timer	3-60, *SAME	Optional
AUTOANSTYP	Autoanswer type	*SAME, *DTR, *CDSTL	Optional
CTSTMR	Clear To Send timer	10-60, *SAME	Optional
RMTANSTMR	Remote answer timer	*SAME, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, 100, 105, 110, 115, 120	Optional
CMNRCYLMT	Recovery limits	Single values: *SAME, *SYSVAL Other values: Element list	Optional
	Element 1: Count limit	0-99
	Element 2: Time interval	0-120
TEXT	Text 'description'	Character value, *SAME, *BLANK	Optional

Top

Line description (LIND)

Specifies the name of the line description

This is a required parameter.

Resource name (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. The resource name is on the port. For example, the resource name may be CMN01 on an Ethernet port.

*SAME

The value does not change.

name

Specify the resource name of the communications port.

This is a required parameter.

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.

Station address (STNADR)

Specifies, for multipoint tributary lines, the hexadecimal address by which the local system is known to the remote system. The hexadecimal address is the polling address assigned to this system.

*SAME

The value does not change.

If a character code of *ASCII is specified, any address with the 6-bit set on cannot be used. If a character code of *EBCDIC is specified, any address with the 2-bit set on cannot be used.

station-address

Specify a hexadecimal value from 04 to FE. BSC control characters can not be specified.

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

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, BSC, SDLC, or IDLC) line or switched network backup (Async, BSC, or SDLC) 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, BSC, SDLC, or X.25 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 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 line connection is made by manually dialing the X.25 network.

*YES

The line connection is made by the system automatically dialing the X.25 network.

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.

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.

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 0.3 to 9.9 seconds.

Maximum buffer size (MAXBUFFER)

Specifies the maximum size of inbound and outbound data buffers.

*SAME

The value does not change.

Character code (CODE)

Specifies whether the extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII) character code is used on the line.

*SAME

The value does not change.

*EBCDIC

The EBCDIC character set code is used.

*ASCII

The ASCII character code is used.

SYN characters (SYNCCHARS)

Specifies the number of BSC SYN (synchronous) control characters to send when transmitting. The SYN control character is used to establish and maintain synchronization and as a time fill in the absence of any data or other control character.

*SAME

The value does not change.

2

The synchronization pattern consists of two consecutive SYN characters.

4

The synchronization pattern consists of four consecutive SYN characters.

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.

Include STX character in LRC (STXLRC)

Specifies whether the start of text (STX) control character is included in the longitudinal redundancy check (LRC) calculation. This applies only to lines using the ASCII character code.

*SAME

The value does not change.

*NO

The STX control character is not included in the LRC calculation.

*YES

The STX control character is included in the LRC calculation.

Receive timer (RCVTMR)

Specifies the duration of time the system waits for data from the remote system before a receive timeout occurs.

*SAME

The value does not change.

receive-timer

Specify a value from 30 to 254 in 0.1-second intervals.

Continue timer (CONTTMR)

Specifies, when the system is not ready to transmit or receive data, the duration of time the system waits before sending a control character which prevents the line from becoming inoperative. This parameter is not valid for an application type of RJE.

*SAME

The value does not change.

continue-timer

Specify a value from 16 to 24 in 0.1-second intervals.

Contention state retry (CTNRTY)

Specifies the number of contention state retries to attempt before indicating the error and making the line inoperative.

For BSC, contention is the state that exists after the end of transmission (EOT) character is received or sent and before a starting sequence (ENQ) has been positively acknowledged (ACK0).

In data communications, a type of half-duplex line or link control in which either user may transmit any time the line/link is available. In the event that both users attempt to transmit a request simultaneously, the protocols or the hardware determines who wins the contention.

*SAME

The value does not change.

contention-state-retry

Specify a value from 0 to 21 for the number of contention state retries.

Data state retry (DTASTTRTY)

Specifies the number of data state retries to attempt before indicating the error and ending the session.

For BSC, a data state is a time during which BSC is sending or receiving characters on the communications line.

*SAME

The value does not change.

data-state-retry

Specify a value from 0 to 255 for the number of data state retries.

Transmit TTD or WACK retry (TMTRTY)

Specifies the number of retries for transmitting temporary text delay (TTD) or wait before transmitting (WACK) before indicating a session failure. This parameter is not valid for an application type of RJE.

*SAME

The value does not change.

*NOMAX

Retries are attempted indefinitely.

transmit-TTD-or-WACK-retry

Specify a value from 0 to 65534 for the number of retries.

Receive TTD or WACK retry (RCVRTY)

Specifies the number of retries for receiving temporary text delay (TTD) or wait before transmitting (WACK) before indicating a session failure. This parameter can only be specified if the application type is program-to-program.

*SAME

The value does not change.

*NOMAX

Retries are attempted indefinitely.

receive-TTD-or-WACK-retry

Specify a value from 0 to 65534 for the number of retries.

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.

cts-timer

Specify a value ranging from 10 through 60 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

CHGLINBSC   LIND(BSCLIN1)  INACTTMR(300)

This command changes the inactivity timer for line description BSCLIN1 to 300 (30.0 seconds).

Error messages

*ESCAPE Messages

CPF261E

Line description &1 not changed.