Change Line Desc (BSC) (CHGLINBSC)

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

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

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
CLOCK Clocking *SAME, *MODEM, *INVERT, *SYSTEM 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

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.

Clocking (CLOCK)

Specifies how the clocking function for the line is provided.

*SAME
The value does not change.
*MODEM
The clocking function for the line is provided by the modem.
*INVERT
The transmit clock provided by the modem data circuit-terminating equipment (DCE) is inverted before use. This option can be used when having problems with data transmission and the modem (DCE) does not support looped clocking. The valid interfaces for *INVERT are *RS232V24, *RS449V36, *V35, *X21BISV24, and *X21BISV35.

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 15 to 420 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.