Create Line Desc (BSC) (CRTLINBSC)

The Create Line Description (BSC) (CRTLINBSC) command creates a line description for a BSC 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 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.

This is a required parameter.

Online at IPL (ONLINE)

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

*YES

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

*NO

This line is not automatically varied on at IPL.

Application type (APPTYPE)

Specifies the application type used by this device.

*PGM

This BSC line is used by a user-written program (not RJE or EML).

*RJE

This BSC line is used by the Remote Job Entry Facility.

*EML

This BSC line is used by 3270 device emulation.

Physical interface (INTERFACE)

Specifies the type of physical interface on the input/output adapter (IOA) port.

*RS232V24 (Async, BSC, X.25 and SDLC only)

RS-232/V.24 physical interface.

*V35 (BSC and SDLC only)

V.35 physical interface.

*X21 (X.25 and SDLC only)

X.21 physical interface.

*X21BISV24 (X.25, BSC and SDLC only)

X.21 bis/V.24 physical interface.

*X21BISV35 (X.25, BSC and SDLC only)

X.21 bis/V.35 physical interface.

*RS449V36 (Async, BSC, X.25 and SDLC only)

RS-449/V.36 physical interface.

*INTMODEM

The integrated modem interface is used.

Connection type (CNN)

Specifies the type of line connection.

*NONSWTPP

A nonswitched point-to-point line is used.

Note: This value cannot be selected if you choose *EML for the Application type (APPTYPE) parameter.

*SWTPP

A switched point-to-point line is used.

Note: This value cannot be selected if you choose *EML for the Application type (APPTYPE) parameter.

*MPTRIB

A multipoint tributary line.

Note: This value cannot be selected if you choose *RJE for the Application type (APPTYPE) parameter.

Switched network backup (SNBU)

Specifies, for nonswitched modems only, if the local modem supports the switched network backup utility (SNBU) feature. The backup feature is used to bypass a broken nonswitched (nonswitched line) connection by establishing a switched connection.

To activate SNBU, you must change the mode of the modem from nonswitched to switched. If the modem model is IBM 386x, 586x, or 786x, no change is required. Otherwise, specify *YES for the Activate swt network backup (ACTSNBU) parameter for the line description you are using.

*NO

The local modem does not have the SNBU feature.

*YES

The local modem has the SNBU feature.

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.

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

Autocall unit (AUTOCALL)

Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 line), whether the line has an associated automatic call unit that can automatically call the remote system.

*NO

No automatic call unit is associated with this line.

*YES

An automatic call unit is associated with this line.

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.

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.

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

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

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.

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

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.

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

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

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

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

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.

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

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

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.

*EBCDIC

The EBCDIC character set code is used.

*ASCII

The ASCII character code is used.

Receive timer (RCVTMR)

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

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.

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.

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.

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.

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

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

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.

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

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.

answer-timer

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

Text 'description' (TEXT)

Specifies text that briefly describes the line description.

*BLANK

Text is not specified.

character-value

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

Attached nonswitched ctls (CTL)

Specifies, for nonswitched lines, the names of one or more controllers to which this line is attached. The controller descriptions must already exist.

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.

You can enter multiple values for this parameter.

switched-controller-list

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

Modem data rate select (MODEMRATE)

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

*FULL

The line operates at the full rate of the modem.

*HALF

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

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.

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.

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

*NO

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

*YES

The STX control character is included in the LRC calculation.

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.

cts-timer

Specify a value ranging from 10 through 60 seconds.

Recovery limits (CMNRCYLMT)

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

The possible count-limit values are:

2

Two recovery attempts are made within the specified time interval.

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

5

The specified number of recovery attempts are made within a 5-minute interval.

time-interval

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

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*CHANGE

The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL

The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE

The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE

The user cannot access the object.

*LIBCRTAUT

The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

name

Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTLINBSC   LIND(BRANCHES)  RSRCNAME(LIN021)
            ONLINE(*NO)  CNN(*SWTPP)
            AUTOCALL(*YES)  ACRSRCNAME(LIN032)
            SWTCTLLST(BRANCH1 BRANCH2)

This command creates a BSC line description for the first port on the second IOA. It is set up to autodial on the second port of the third IOA, or to automatic answer. The controller descriptions in the SWTCTLLST already exist.

Error messages

*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.