CRTLINBSC (Create Line Description (BSC))

CRTLINBSC Command syntax diagram

 

Purpose

The Create Line Description (BSC) (CRTLINBSC) command creates a line description for a Binary Synchronous Communications (BSC) line. More information about using this command is in the Communications Configuration

book.

 

Required Parameters

LIND

Specifies the name of the line description being created.

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 a "Token-ring port". The value specified on the RSRCNAME parameter cannot be changed from *NWID to another value or from another value to *NWID.

 

Optional Parameters

ONLINE

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

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

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

APPTYPE

Specifies the application type being used.

*PGM: This BSC line is used by a user-written program, not by the Remote Job Entry (RJE) function of the AS/400 Communications Utilities Program or 3270 device emulation.

*RJE: This BSC line is used by the RJE function.

*EML: This BSC line is used by the 3270 device emulation.

INTERFACE

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

*RS232V24: The RS-232/V.24 interface is used.

*V35: The V.35 interface is used.

*X21BISV24: The X.21 bis/V.24 interface is used.

*X21BISV35: The X.21 bis/V.35 interface is used.

*RS449V36: The RS-449/V.36 interface is used.

CNN

Specifies the type of line connection used.

*NONSWTPP: A BSC nonswitched point-to-point line is used.

Note:

This value cannot be selected if *EML is specified on the APPTYPE parameter.

*SWTPP: A BSC switched point-to-point line is used.

Note:

This value cannot be selected if *EML is specified on the APPTYPE parameter.

*MPTRIB: A BSC multipoint tributary line is used.

Note:

This value cannot be selected if *RJE is specified on the APPTYPE parameter. This value must be specified when APPTYPE(*EML) is specified.

SNBU

Specifies, for controllers attached to nonswitched lines only, whether the switched network backup (SNBU) feature is activated or deactivated. This feature lets the user bypass a broken nonswitched connection by establishing a switched connection. This parameter applies only if SWITCHED(*NO) and SNBU(*YES) are specified when the controller description is created.

Note:

The Change Line Description (BSC) (CHGLINBSC) command and Change Controller Description (BSC) (CHGCTLBSC) command must be used to actually activate the SNBU feature. SNBU is valid only if both local and remote modems support this feature.

*NO: The remote modem does not have the switched network backup (SNBU) feature.

*YES: The modem has the SNBU feature.

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.

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

AUTOCALL

Specifies, for switched lines and switched network backup lines, whether the line has an associated autocall unit which performs automatic calling to the remote system.

*NO: This switched line does not have an autocall unit.

*YES: This switched line has an autocall unit.

CTL

Specifies the name of the controller description to which this object is attached.

Note:

The controller description must already exist. Do not use this parameter when following the normal procedure of creating descriptions for lines first, controllers second, and devices last. Use this parameter only when the associated controller descriptions already exist before this line description is created.

SWTCTLLST

Specifies the names of up to 64 controllers that can establish a connection with the switched line. The controller descriptions must already exist.

Note:

Do not use this parameter when following the normal procedure of creating descriptions for lines first, controllers second, and devices last. However, once the controller descriptions are created, specify the list by using the CHGLINBSC command.

STNADR

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

CLOCK

Specifies that the clocking function for the line is provided by the modem (*MODEM), which is the default on this parameter.

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

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

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

LINESPEED

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

9600: The default value is 9600 bps.

line-speed: Specify the line speed. Valid line speeds are: 600, 1200, 2400 4800, 7200, 9600, 14400, 19200, 48000, 56000, and 57600 bps.

MODEM

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

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

*V54: A certain type of diagnostic test (as defined by CCITT recommendations) is run to the modem. The iSeries 400 system supports CCITT V.54 loop 3 (local loop back) and loop 2 (remote loop back).

Note:

Loop 2 diagnostic support is available on nonswitched lines only.

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

MODEMRATE

Specifies the speed (bits per second) 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 one-half the full rate, or at the alternate rate, of the modem.

SWTCNN

Specifies, for the switched and switched network backup, whether the 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 local system starts the call.

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.

*YES: The system automatically answers incoming calls.

*NO: The system operator must manually answer incoming calls.

Note:

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

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.

*NO: The system operator must manually call a remote system.

*YES: The iSeries 400 automatically calls a remote system.

Note:

*YES is valid only if the system is using an autocall unit and AUTOCALL was specified as *YES.

DIALCMD

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

*NONE: No dial command type is specified. An automatic call unit establishes the connection.

*V25BIS: The use of one physical interface for call establishment and data transmission is allowed. It is sometimes referred to as a serial automatic call interface because the digits are presented serially on the link from the system data terminal equipment (DTE) to the modem data circuit-terminating equipment (DCE).

*V25BIS is valid only for INTERFACE(RS232V24).

ACRSRCNAME

Specifies the resource name that describes the automatic call 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, 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.

*NONE: Specifies that the CRN 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.

INACTTMR

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

300: The default value is 30 seconds.

*NOMAX: There is no disconnect limit.

inactivity-timer: Specify a value ranging from 150 through 4200 in 0.1-second intervals.

MAXBUFFER

Specifies the maximum size (in bytes) of inbound and outbound data buffers.

1024: The default buffer size is 1024 bytes.

buffer-size: Specify a buffer size ranging from 8 through 8192 bytes.

CODE

Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.

*ASCII: The ASCII character set code is used.

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.

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

STXLRC

Specifies whether the start of text (STX) control character is included in the longitudinal redundancy check (LRC) calculation. This only applies 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. The 9404 system unit always includes STX.

RCVTMR

Specifies the number of seconds the system waits for data from the remote system before a receive timeout occurs.

30: The default value is three seconds.

receive-timer: Specify a value ranging from 30 through 254 in 0.1-second intervals.

CONTTMR

Specifies the number of seconds the system waits before sending a control character that prevents the line from being dropped when the system is not ready to transmit or receive data.

20: The default value is 20 seconds.

continue-timer: Specify a value ranging from 16 through 24 in 0.1-second intervals.

CTNRTY

Specifies the number of contention state retries to attempt before indicating an 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).

7: Seven retries are attempted.

contention-state-retry: Specify a value ranging from 0 through 21 for the number of contention state retries.

DTASTTRTY

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

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

7: Seven retries are attempted.

data-state-retry: Specify a value ranging from 0 through 255 for the number of data state retries.

TMTRTY

Specifies the number of retries for transmitting temporary-text-delay (TTD) or wait-before-transmitting positive acknowledgement character (WACK) to keep the line operative before indicating the error and ending the session. If the application type is RJE, this parameter cannot be specified.

60: The default value is 60.

*NOMAX: There is no disconnect limit.

transmit-TTD-or-WACK-retry: Specify a value ranging from 0 through 65534 for the number of retries.

RCVRTY

Specifies the number of retries for receiving TTD or WACK before indicating the error and failing the session. This parameter can only be specified if the application type is *PGM.

45: The default value is 45 retries.

*NOMAX: There is no disconnect limit.

receive-TTD-or-WACK-retry: Specify a value ranging from 0 through 65534 for the number or retries.

DSRDRPTMR

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

6: Character density is 16.7 characters per inch.

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

AUTOANSTYP

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

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.

25: The system waits up to 25 seconds for the CTS state to begin or end.

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

60: The system waits 60 seconds before signaling an error.

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.

Element 1: Maximum Recovery Limit

2: Two recovery attempts are made within the interval specified.

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

5: A 15-second time-out period is used.

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.

Other Single Value:

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

AUT

Specifies the authority given to users who do not have specific authority to the line description, who are not on an authorization list, and whose user group has no specific authority to the line description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 line description.

*USE: The user can perform basic operations on the line description, such as running a program or reading a file. The user cannot change the line description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the line description.

authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the line description. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

Example for CRTLINBSC

CRTLINBSC   LIND(BRANCHES)  RSRCNAME(LIN021)
  ONLINE(*NO)  CNN(*SWTPP)  AUTOCALL(*YES)
  ACRSRCNAME(LIN032)  SWTCTLLST(BRANCh2 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 for CRTLINBSC

*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.