CRTLINSDLC (Create Line Description (SDLC))

CRTLINSDLC Command syntax diagram

 

Purpose

The Create Line Description (SDLC) (CRTLINSDLC) command creates a line description for a synchronous data link control (SDLC) line. More information about using this command is in the Communications Configuration Link to PDF 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.

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 two, then the resource name would be LIN012.

Up to six resource names can be specified if CNN(*SHM) is specified (X.21 short-hold mode). All lines specified must be attached to the same input/output processor. If ROLE(*SEC) and SHMNODE(*T20) are specified, only one resource name can be used.

 

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.

ROLE
Specifies whether the system is the primary station, the secondary station, or whether the two systems dynamically negotiate the primary and secondary roles.

The primary station is the controlling station and the secondary station is the responding station. The primary station controls the communications link by sending commands to the secondary station, and the secondary station responds to the commands.

*NEG: Allows the iSeries 400 and the remote system to negotiate which station is primary.

*PRI: The iSeries 400 is the primary station on this communications line.

*SEC: The iSeries 400 is a secondary station on this communications line.

INTERFACE
Specifies the type of physical interface on the Input/ Output Adapter (IOA) port.

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

*V35: The V.35 interface is used.

*X21: The X.21 interface is used.

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

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

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

*INTMODEM: The integrated modem interface is used.

CNN
Specifies the type of line connection used.

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

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

*MP: A nonswitched multipoint line is used.

*SHM: An X.21 short hold mode line is used.

*NONSWTCAL: A nonswitched point-to-point line is used for call mode.

*NONSWTANS: A nonswitched point-to-point line is used for answer mode.

Note: *NONSWTCAL and *NONSWTANS are valid only when INTERFACE(*INTMODEM) 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 (SDLC)(CHGLINSDLC) and appropriate Change Controller commands must be used to activate the SNBU feature. Switched network backup is valid only if the local modem and remote modem both support this feature.

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

*YES: The modem has the SNBU feature.

SHMNODE
Specifies, for X.21 short-hold mode lines only, the physical unit type of the controllers using the line. This parameter is valid only if CNN(*SHM) is specified.

*T21: Physical unit type 2.1 controllers are used. ROLE(*NEG) must also be specified.

*T20: Physical unit type 2.0 controllers are used. ROLE must be specified as *PRI or *SEC.

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 both a switched line and a switched network backup (SNBU) line, whether the line has an associated automatic call unit that performs automatic calling to the remote system.

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

*YES: This switched line has an automatic call unit.

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

Note: The controller descriptions 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 have already been created before this line description.

EXCHID
Specifies the hexadecimal exchange identifier that is used to identify the local system to the remote system. The 8-digit hexadecimal exchange identifier contains three digits for the block number and five digits for the identifier of this system.

*SYSGEN: The iSeries 400 creates the exchange identifier. Use the Display Line Description (DSPLIND) command to see the resulting exchange identifier.

exchange-identifier: Specify an exchange identifier. If the *SYSGEN value is not used, specify an exchange identifier containing eight hexadecimal digits starting with 056.

NRZI
Specifies whether non-return-to-zero-inverted (NRZI) data encoding is used for modems that are sensitive to certain bit patterns in the data stream. This ensures that the signal does not remain the same for an extended period of time. For digital phone lines, *NO is suggested.

Note: All data communications equipment on the line must use the same data transmission coding method.

*YES: NRZI data encoding is used.

*NO: NRZI data encoding is not used.

MAXCTL
Specifies the maximum number of controllers that the line supports.

1: One controller is supported. Use the default (1) for:

  • Nonswitched point-to-point and switched point-to-point connection types

  • Nonswitched point-to-point and multipoint connection types communicating with a host system using duplex, two-way simultaneous data transfer. (The host system specifies duplex data transfer in its NCP generation by specifying LINE ADDRESS=(nnn,FULL) on the LINE macroinstruction.)

  • Short-hold mode lines specified with ROLE(*SEC) and SHMNODE(*T20)

Short-hold mode lines specified with ROLE(*PRI) or ROLE(*NEG) can support up to 64 controllers.

maximum-controllers: Specify the maximum number of controllers supported by the line, a number large enough to account for all of the controllers that are currently attached to this line, and for those controllers to be attached in the near future. Valid values range from 1 through 254.

CLOCK
Specifies how the clocking function for the line is provided.

*MODEM: The modem supplies the clocking function.

*LOOP: The receiving clock provided by the modem data circuit-terminating equipment (DCE) is looped back to the modem (DCE) on the system data terminal equipment (DTE) transmitting clock. This option can be used to improve high speed data transmission when the modem (DCE) supports such an option. The valid interfaces for *LOOP are *V35, *X21BISV35, and *RS449V36.

*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 high speed data transmission and the modem (DCE) does not support looped clocking. The valid interfaces for *INVERT are *V35, *X21, *X21BISV35, and *RS449V36.

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

9600: 9600 bps is used.

line-speed: Specify the line speeds. Valid lines speeds are: 600, 1200, 2400 4800, 7200, 9600, 14400, 19200, 48000, 56000, 57600, 64000, 112000, 128000, 168000, 192000, 224000, 256000, 280000, 320000, 336000, 384000, 392000, 448000, 504000, 512000, 560000, 576000, 616000, 640000, 672000, 704000, 728000, 768000, 784000, 832000, 840000, 896000, 952000, 960000, 1008000, 1024000, 1064000, 1088000, 1120000, 1152000, 1176000, 1216000, 1232000, 1280000, 1288000, 1344000, 1400000, 1408000, 1456000, 1472000, 1512000, 1536000, 1568000, 1600000, 1624000, 1664000, 1680000, 1728000, 1736000, 1792000, 1856000, 1920000, 1984000, or 2048000 bits per second.

MODEM
Specifies the type of modem supported on the communications line.

The modem manual has information to determine the appropriate value for the modem.

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

*V54: Certain types of diagnostic tests (as defined by the CCITT recommendations) are run to the modem. The iSeries 400 supports CCITT V.54 loop three (local loop back) and loop two (a remote loop back).

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

*IBMLPDA1: An IBM modem with Link Problem Determination Aid-1 (LPDA-1) is used on the line.

*IBMLPDA2: An IBM modem with Link Problem Determination Aid-2 (LPDA-2) is used on the line.

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 one-half the full rate, or at the alternate rate, of the modem.

SWTCNN
Specifies, for the switched line and the switched network backup (SNBU) line, 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.

Note: *YES is valid only if the modem has the automatic answer feature or an X.21 circuit switched interface is used.

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

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: For an X.21 circuit switched interface, automatic dialing must be specified.

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

*YES: The system automatically calls a remote system.

Note: *YES is valid only if the system is using an automatic call unit or an X.21 circuit switched interface, or if the modem can call through a command interface.

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

Note: Valid only when INTERFACE(*INTMODEM) is specified.

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

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

*NONE: No dial command type (automatic call unit or X.21 circuit switched interface) is specified.

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

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.

SHMCALLTMR
Specifies the interval at which a connection is reestablished on an X.21 short-hold mode line to verify the state of the remote system even if no normal data traffic has occurred in the specified interval.

Note: This parameter is valid only if CNN(*SHM) is specified.

*NONE: No call is made to verify the connection.

call-timer: Specify an interval, ranging from 1 through 60 minutes, after which a call is made to verify the connection.

SHMMAXCNN
Specifies the amount of time the system allows a connection to continue if there are more controllers than there are available ports. The system clears the connection after the specified amount of time, delay further calls for the amount of time specified on the SHMANSDLY parameter, and then make any calls that had been waiting before re-calling the controller that was interrupted.

Note: This parameter is valid only if *PRI or *NEG is specified on the ROLE parameter and *SHM is specified on the CNN parameter.

8: The system waits 8 seconds before checking for other controllers.

*NOMAX: The timer is disabled.

mxcnct-timeout: Specify a value ranging from 1 through 254 seconds.

SHMANSDLY
Specifies the amount of time the system waits for controllers to call in before making outgoing calls.

Note: This parameter is valid only if *PRI or *NEG is specified on the ROLE parameter and *SHM is specified on the CNN parameter.

11: The system waits 1.1 seconds before making outgoing calls.

*NOMAX: The timer is disabled.

ans-delay-timeout: Specify a value ranging from 1 through 254 tenths of seconds. For example, 10 seconds equals 100 tenths of a second.

SHMCALLFMT
Specifies the format of the network identifier used in the local system's connection number (CNNNBR parameter).

Note: This parameter is valid only if *SHM is specified on the CNN parameter and *T21 is specified on the SHMNODE parameter.

*DNIC: A four-digit Data Network Identification Code is used. The iSeries 400 assumes the first four digits of the CALLNBR parameter are the Data Network Identification Code of the user's network. If a call is placed to a controller with the same DNIC (on the controller description CNNNBR parameter), a local call is assumed and the system discards the first four digits of the CNNNBR parameter.

*DCC: A three-digit Data Country Code is used. The iSeries 400 assumes the first three digits of the CALLNBR parameter are the Data Country Code. If a call is placed to a controller with the same DCC (on the controller description CNNNBR parameter), the system discards the first three digits of the CNNNBR parameter.

call-format: Specify the length of the area code or country or region code portion of the SHM calling number. Valid values range from 0 to 15.

SHMACC
Specifies the access code used by an X.21 short-hold mode line when calling a system on another network. The access code can be three or four digits and is valid only for X.21 short-hold mode lines with SHMNODE(*T21) specified.

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.

Note: This parameter is required for all X.21 short-hold mode lines. The calling number is passed to the remote system at the initial connection. This number is dialed by the remote system to reestablish the short-hold mode connection.

*NONE: The CRN (Call Request Normal) dial command is used by the V.25 bis line, or the line does not use X.21 short-hold mode.

calling-number: Specify up to 32 characters that represent the local telephone number for V.25 bis CRI (Call Request with Identification) automatic dialing.

For X.21 short-hold mode lines:

  • If SHMNODE(*T21) is specified, up to 14 characters can be specified for the calling number. The Data Network Identification Code (DNIC) or Data Country Code (DCC) must be included in the first three or four digits of the calling number.

  • If SHMNODE(*T20) is specified, up to 18 characters can be specified for the calling number. Include the DNIC or DCC in the first three or four digits of the calling number only if the remote device always calls from a different DNIC or DCC location.


STNADR
Specifies, for a switched secondary line or negotiable line, the hexadecimal station address to which the local system responds when polled by the remote system if it answers a call. Specify the station address in hexadecimal characters 01 through FE.

CNNPOLLRTY
Specifies, for a switched primary line or negotiable line, the number of connect poll retries before indicating the error and making the station inoperative.

7: Seven retries are attempted.

connect-poll-retry: Specify a value ranging from 0 through 64 for the number of retries.

CNNTMR
Specifies, for X.21 circuit-switched lines, the number of seconds an automatic answer connect request waits for an incoming call to be accepted.

*NOMAX: There is no disconnect limit.

connect-timer: Specify a value ranging from 1 through 32767 in 0.1-second intervals.

SHORTTMR
Specifies, for X.21 circuit-switched lines, the number of seconds the system waits between connection attempts. This timer is used during bursts of retry operations.

50: The system waits five seconds.

short-timer: Specify a value ranging from 10 through 600 in 0.1-second intervals.

LONGTMR
Specifies, for X.21 circuit-switched lines, the number of seconds the timer waits between bursts of retry operations. After a burst of retry attempts, the system waits for this timeout period before the next attempt. This parameter is used to control retries when you are attempting to make a call over an X.21 circuit-switched or short-hold mode network. Call attempts are characterized by "bursts" of retries. A single burst of retries is controlled by the short timer and short retry value. If all short retries are completed, the system delays for a longer time (the long timer) before attempting another burst of retries. The total number of these bursts of retries is based on the long retry value.

600: The system waits 60 seconds.

long-timer: Specify a value ranging from 100 through 6000 in 0.1-second intervals.

SHORTRTY
Specifies, for X.21 circuit-switched lines, the number of retry attempts made during a burst of retries.

7: Seven retries are attempted.

short-retry: Specify a value ranging from 0 through 254 for the number of retries.

LONGRTY
Specifies, for X.21 circuit-switched lines, the number of retry burst attempts made when processing a connect request. This parameter is used to control retries when you are attempting to make a call over an X.21 circuit-switched or short-hold mode network. Call attempts are characterized by "bursts" of retries. A single burst of retries is controlled by the short timer and short retry value. If all short retries are completed, the system delays for a longer time (the long timer) before attempting another burst of retries. The total number of these bursts of retries is based on the long retry value.

1: One retry is attempted.

long-retry: Specify a value ranging from 0 through 254 for the number of retries.

CPSRTY
Specifies whether call progress signals are retried for X.21 circuit-switched lines or X.21 short-hold mode lines. Up to 11 values can be specified; duplicate values are ignored.

Possible values are: 

*CPS41      *CPS44      *CPS47      *CPS71
*CPS42      *CPS45      *CPS48      *CPS72
*CPS43      *CPS46      *CPS49

This parameter can be specified only if INTERFACE(*X21) and either *SHM or *SWTPP are specified on the CNN parameter.

MAXFRAME
Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate request unit (RU) sizes. Since the maximum PIU size that the controller can send or receive is negotiated at exchange identifier time, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host system.

Note: The possible frame sizes are 265, 521 (default), 1033, and 2057.

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.

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

Note: For X.21 circuit-switched interface lines, full duplex permanent RTS must be specified.

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

MODULUS
Specifies whether extended sequence numbers are used.

8: Extended sequence numbers are not used (Modulus 8).

128: Extended sequence numbers are used (modulus 128).

MAXOUT
Specifies the maximum number of frames that are sent sequentially to a remote system before the remote system must respond. For modulus 8, the maximum number of frames range from 1 through 7. For modulus 128, the maximum number of frames range from 8 through 28.

7: Rotation of the text is done 270 degrees clockwise from the 0 degree writing position.

maximum-outstanding-frames: Specify a value ranging from 1 through 28 for the number of frames.

INACTTMR
Specifies, for a secondary or negotiable line, the time (in tenths of a second) that the system waits for a valid frame to flow before reporting the error and disconnecting the line. This timer is started at connection time, restarted upon transmission of any frame, and reset upon receipt of a frame with a valid frame check sequence.

300: The system waits 30.0 seconds.

*NOMAX: There is no disconnect limit.

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

POLLRSPDLY
Specifies, for a secondary line or negotiable line, the minimum number of seconds the system must wait before it responds to a data poll if there is no frame to transmit.

0: There is no delay.

poll-response-delay: Specify a value ranging from 1 through 2048 in 0.0001-second intervals.

NPRDRCVTMR
Specifies, for a primary line or a negotiable line, the number of seconds the system waits for either a final frame or an idle signal while the secondary station is continuously sending. If this time ends, the nonproductive receive condition is reported.

320: The system waits 32.0-seconds.

nonproductive-receive-timer: Specify a value ranging from 160 through 4200 in 0.1-second intervals.

IDLTMR
Specifies, for a primary or negotiable line, the time (in 0.1 second intervals) that the system waits before sampling the line for an idle signal. If an idle signal is found, error recovery procedures are started.

30: The system waits three seconds.

idle-timer: Specify a value ranging from 5 through 300 in 0.1-second intervals.

The following indicates the minimum value specify for different line characteristics: 

+---------------------------------------------------+
| Idle Timer Minimum Values for SDLC Lines          |
+----------------------+-----------+----------------+
| LINE CHARACTERISTIC  |   VALUE   | TIME (SECONDS) |
+----------------------+-----------+----------------+
| Duplex               |     5     |       0.5      |
+----------------------+-----------+----------------+
| Half duplex          |     10    |       1.0      |
+----------------------+-----------+----------------+
| Satellite link       |     20    |       2.0      |
+----------------------+-----------+----------------+

This time-out is also dependent on the remote station's processing time. You should also allow for the longest possible processing time at the secondary station. However, time-out values that are too long lengthen the time required to detect a failing remote station and can adversely affect perform- ance on a multipoint line. Also, if the idle timer is set to a value greater than the corresponding inactivity timer value at the secondary station, the line may report permanent errors rather than using normal recovery procedures for line errors.

CNNPOLLTMR
Specifies, for a primary line or negotiable line, the number of seconds the system waits for the response to a connect poll before sending the poll again.

30: The system waits three seconds.

connect-poll-timer: Specify a value ranging from 2 through 300 in 0.1-second intervals.

POLLPAUSE
Specifies, for a primary or negotiable line, the number of seconds the system pauses after the last remote system in the poll list is polled.

0: There is no pause.

poll-cycle-pause: Specify a value ranging from 1 through 2048 in 0.0001-second intervals.

FRAMERTY
Specifies the number of retries for an unanswered command frame or unacknowledged information frame before indicating the error and disconnecting the station.

7: Seven retries are attempted.

frame-retry: Specify a value from 0 through 64 for the number of retries.

FAIRPLLTMR
Specifies the maximum amount of time for which the system sends data to one or more work stations before requesting input from the work stations.

15: The system waits 15 seconds (during output data transfers to work stations) before polling for input.

fair-poll-time: Specify the amount of time (in seconds) the system waits (during output transfers) before polling for input. Valid values for this parameter range from 5 through 60 seconds.

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.

LINKSPEED
Specifies the link speed in bits per second (bps). This parameter is valid only if APPN* support is used on the system.

*INTERFACE: The following link speeds, based on the physical interface type, are used: 9600 bps for RS-232/V.24 and X.21bis/V.24, 48000 bps for V.35 and X.21bis/V.35, and 64000 bps for X.21 and RS-449/V.36.

*MIN: The minimum link speed is used.

*MAX: The maximum link speed is used.

link-speed: Specify the link speed. Valid values are: 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 64000, 112000, 128000, 168000, 192000, 224000, 256000, 280000, 320000, 336000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 2048000, 4M, 10M, 16M and 100M.

COSTCNN
Specifies the relative cost of being connected on the line. This parameter is required only if APPN* support is used on the system.

*CNN: The cost per connection time is 0 for nonswitched connections, and 128 for switched connections.

cost-per-connect-time: Specify a value ranging from 0 through 255.

COSTBYTE
Specifies the relative cost per byte for sending and receiving data on the line. This parameter is required only if APPN* support is used on the system.

*CNN: The cost per byte is 0 for nonswitched connections and 128 for switched connections.

cost-per-byte: Specify a value ranging from 0 through 255.

SECURITY
Specifies the security level of the physical line. This parameter is used only if APPN is used on the system.

*NONSECURE: Normal priority is used.

*PKTSWTNET: A packet switched network is used. Data does not always follow the same path through the network.

*UNDGRDCBL: An underground cable is used.

*SECURECND: A secure, unguarded conduit (for example, a pressurized pipe) is used.

*GUARDCND: A guarded conduit, which is protected against physical tapping, is used.

*ENCRYPTED: Data flowing on the line is encrypted.

*MAX: A guarded conduit, protected against physical and radiation tapping, is used.

PRPDLY
Specifies the level of propagation delay on the line. This parameter is valid only if APPN* support is used on the system. The order of the values from shortest to longest delay is *MIN, *LAN, *TELEPHONE, *PKTSWTNET, and *SATELLITE.

*TELEPHONE: The telephone propagation delay is used.

*MIN: The minimum propagation delay is used.

*LAN: The local area network propagation delay is used.

*PKTSWTNET: The packet switched network propagation delay is used.

*SATELLITE: The satellite propagation delay is used.

*MAX: The maximum propagation delay is used.

USRDFN1
Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

128: The value 128 is used.

user-defined-1: Specify a value ranging from 0 through 255.

USRDFN2
Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

128: The value 128 is used.

user-defined-2: Specify a value ranging from 0 through 255.

USRDFN3
Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

128: The value 128 is used.

user-defined-3: Specify a value ranging from 0 through 255.

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

CRTLINSDLC   LIND(BOSTON)  RSRCNAME(LIN041)

This command creates an SDLC line description named BOSTON with a resource name of LIN041.

Error messages for CRTLINSDLC

*ESCAPE Messages

CPF2718
Line description &1 not created due to errors.