CRTLINX25 (Create Line Description (X.25))

CRTLINX25 Command syntax diagram

 

Purpose

The Create Line Description (X.25) (CRTLINX25) command creates a line description for an X.25 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 identifies the hardware that the description represents.

*NWID: The resource name specified on the attached ISDN network interface description is used.

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.

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

LGLCHLE
Specifies, when using the Create Line Description (X.25) CRTLINX25 or CHGLINX25 command, a list of entries to be added, removed, or changed in the logical channel table. A channel entry consists of a channel identifier, a logical channel type, and a PVC controller.

Note: Logical channel entries with attached permanent virtual circuit (PVC) controllers cannot be added, removed, or changed.

*PROMPT: By using the *PROMPT option, any entry can be added, removed, or altered. Specifying *PROMPT shows the current logical channel entries.

Element 1: Logical Channel Identifier

logical-channel-identifier: Specify a three-character hexadecimal number ranging from 001 to FFF for the logical channel identifier. The first digit (from left to right) is the logical channel group number; the second and third digits make up the logical channel number.

Element 2: Logical Channel Type

*PVC: The logical channel is a permanent virtual circuit.

*SVCIN: The logical channel is a switched virtual circuit for input only.

*SVCOUT: The logical channel is a switched virtual circuit for output only.

*SVCBOTH: The logical channel is a switched virtual circuit for both input and output.

Element 3: PVC Controller

PVC-controller: Specify (optionally) the name of the permanent virtual circuit (PVC) controller that is assigned to the logical channel. This field is only valid when the channel type is *PVC.

NETADR
Specifies the local network address for this system. Up to 17 characters can be specified if *YES is specified for the EXNNETADR parameter. Otherwise up to 15 characters can be specified.

CNNINIT
Specifies the method used to establish the X.25 data link connection.

*LOCAL: The local system initiates the connection by issuing the set asynchronous balanced mode (SABM) communications command to establish the connection.

*REMOTE: The remote system initiates the connection by issuing the SABM communications command. The local system waits for the connection to be established.

*WAIT: The local system waits for a disconnect (DISC) or disconnect mode (DM) from the data circuit-terminating equipment (DCE) before attempting to activate the link.

*CALLER: The connection is initiated from either the local system or the remote system based on call direction.

 

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.

INTERFACE
Specifies the type of physical interface on the input/ output adapter (IOA) port. The valid interface types are:

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

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

*RS232V24: The RS232/V.24 interface is used.

*RS449V36: The RS449/V.36 interface is used.

*X21: The X.21 interface is used.

*X31: The X.31 interface is used. This is the International Telegraph and Telephone Consultative Committee (CCITT) recommendation which defines the support of packet mode terminal equipment by an integrated services digital network (ISDN). Specify this value to run X.25 over an ISDN B channel.

*INTMODEM: The integrated modem interface is used.

Note: *INTMODEM is valid on when RSRCNAME is not *NWID.

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.

*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 valid only when INTERFACE(*INTMODEM) or INFTRFTYPE(*SYNCMODEM).

NWI
Specifies, for a nonswitched connection, the network interface description containing the channel to which this line permanently attaches.

Note: Valid only when RSRCNAME(*NWID) and CNN(*NONSWTPP), CNN(*NONSWTCAL) or CNN(*NONSWTANS).

NWICHLTYPE
Specifies, for a nonswitched connection, the type of ISDN channels that this line description uses. This parameter is preset to use one ISDN B-channel of the network interface description.

*B: The B channel is used.

NWICHLNBR
Specifies, for a nonswitched connection, the channel number (1 through 30) of the network interface description that is used by this line description. 2, 23 or 30 channels are available for each network interface description, depending on whether the network interface is basic or primary rate and what the network type is, but only one line description can be permanently attached to a channel. The Display Network Interface Description (DSPNWID) command is used to display information about the channel numbers for a given NWID.

SWTNWILST
Specifies, for ISDN switched connections, a list of network interface descriptions to which this line can be attached. A network interface description is chosen from the list based on the value specified by the switched NWI selection parameter (SWTNWISLCT) at the time an incoming or outgoing call is processed.

*NONE: No network interface description is specified.

Element 1: Network Interface Description Name

NWI-description-name: Specify, for switched connections, the name of the network interface description to which this line attaches.

Element 2: Network Interface Channel Type

*B: The B channel is used.

Element 3: Network Interface Channel-Number

*CALC: The system selects one of the 30 channel numbers (based on availability) defined for the network interface description when an incoming or outgoing call is processed.

NWI-channel-number: Specify a channel number (1 or 30) to which the line description is restricted.

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.

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

9600: The line speed is 9600 bps.

*CALC: The line speed is calculated by the system.

line-speed: Specify one of the following values (in bps) for the line speed: 

     600    57600    576000   1152000   1728000
    1200    64000    640000   1216000   1792000
    2400   128000    704000   1280000   1856000
    4800   192000    768000   1344000   1920000
    7200   256000    832000   1408000   1984000
   14400   320000    896000   1472000   2048000
   19200   384000    960000   1536000
   48000   448000   1024000   1600000
   56000   512000   1088000   1664000
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 generates the exchange identifier.

exchange-identifier: Specify the exchange identifier. If the *SYSGEN value is not used, an exchange identifier consisting of eight hexadecimal digits starting with 056 must be specified.

PKTMODE
Specifies whether to access the ISDN virtual circuit service.

*NO: The ISDN network is used to provide transparent access to an X.25 packet switched network external to the ISDN (Case A).

*YES: The ISDN virtual circuit service is accessed (Case B).

INFTRFTYPE
Specifies the information transfer type. The information transfer type determines the layer 1 protocol.

Note: Valid only when RSRCNAME(*NWID) and CNN(*NONSWTPP), CNN(*NONSWTCAL) or CNN(*NONSWTANS).

*UNRESTRICTED: The data-channel traffic appears as digital information; no physical transformation is required and each B-channel operates at capacity (64k bps).

*V110: The transfer type is V-series Recommendation 110. Each B-channel operates at 56k bps.

*DOV Allows Data Over Voice (DOV) digital data to be transferred over an ISDN voice call. Also, this is referred to as Data Over Voice Bearer Service (DOVBS), Data Over Speech Bearer Service (DOSBS), TollSaver, or TollMizer. This option should only be used if an ISDN voice call is less expensive than an ISDN data call or if a bearer service for data is not available. The remote location must also support this feature. Data is transferred at 56Kbps in each direction.

*SYNCMODEM: Allows data from the integrated synchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a synchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.

EXNNETADR
Specifies whether network addressing is extended to permit the use of 17 characters in an address name.

*NO: Network addresses can be up to 15 characters.

*YES: Network addresses can be up to 17 characters.

MAXFRAME
Specifies the maximum frame size that can be transmitted and received on this line description.

1024: The default frame size is 1024.

maximum-frame-size: Specify one of the following values: 1024, 2048, or 4096.

DFTPKTSIZE
Specifies the default packet size used by the X.25 network.

Element 1: Transmit Packet Size

128: The default packet size is 128.

transmit-packet-size: Specify a default packet size for transmission to all controllers attached to this line. The controllers can override this default with the DFTPKTSIZE parameter on the controller commands. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

Element 2: Receive Packet Size

*TRANSMIT: The value specified as the default packet size for transmission is used as the default for reception.

receive-packet-size: Specify a default packet size for reception from all controllers attached to this line. The controllers can override this default with the DFTPKTSIZE parameter on the controller commands. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

MAXPKTSIZE
Specifies the maximum packet size for transmission and reception on an X.25 network. The value specified must not be less than the default packet size specified.

Element 1: Maximum Transmit Packet Size

*DFTPKTSIZE: The maximum packet size for transmission is the same as that specified as the default packet size for transmission on the DFTPKTSIZE parameter in this command.

transmit-packet-size: Specify a default packet size for transmission to all controllers attached to this line. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

Element 2: Maximum Receive Packet Size

*DFTPKTSIZE: The maximum packet size for reception is the same as that specified as the default package size for reception on the DFTPKTSIZE parameter on this command.

*TRANSMIT: The value specified as the default packet size for transmission is used as the default for reception.

receive-packet-size: Specify a default packet size for reception from all controllers attached to this line. The controllers can override this default with the DFTPKTSIZE parameter on the controller commands.

MODULUS
Specifies the packet numbering used. The valid numbers are listed below.

8: Character density is 18 characters per inch. This value is valid only on double-byte character set (DBCS) printers.

128: Modulus 128 packet numbering is used.

DFTWDWSIZE
Specifies the default window size used by the X.25 network.

Element 1: Transmit Window Size

2: The default packet window size is 2; modulus 8 is supported.

transmit-window-size: Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use modulus 128 packet numbering.

Element 2: Receive Window Size

*TRANSMIT: The value specified as the default window size for transmission is used as the default for reception.

receive-window-size: Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use modulus 128 packet numbering.

NETCTL
Specifies the name of an existing network controller.

SWTCTLLST
Specifies the names of up to 64 switched asynchronous X.25 controllers or specify *ALL for unlimited number of switched asynchronous X.25 controllers that can establish a connection with an X.25 switched virtual circuit (SVC). The controller descriptions must already exist, and have been created using the Create Controller Description (Async) (CRTCTLASC) command. Asynchronous X.25 controllers that are specified as dial-in can be connected to SVCIN or SVCBOTH logical channels. Attaching controllers that specify CNNNBR(*ANY) or ANSNBR(*ANY) may result in a reordering of this list.

*NONE: No switched controllers are specified.

*ALL: All X.25 switched controllers that are created using the Create Controller Description (Async) (CRTCTLASC) command and list this line description on Switched Line List (SWTLINLST) parameter can be used to establish a connection with an X.25 switched virtual circuit (SVC).

switched-controller-name: Specify the switched controller name.

NETUSRID
Specifies, for switched lines, whether network user identification (NUI) information is included in the facility field of call request packets sent on this line. The NUI facility identifies calling data terminal equipment (DTE) to the network.

This parameter can be specified as a single value (*NONE) or as a hexadecimal network user identification.

*NONE: No NUI information is sent over this line.

network-user-identification: Specify the hexadecimal NUI that is sent. The system inserts the NUI facility code (X'C6') and the NUI length in the facility field of a call request packet.

IDLTMR
Specifies the maximum amount of time (in 0.1 second intervals) that the system waits for acknowledgment from the network for each frame sent before re-transmission.

Note: The IDLTMR value should be greater than or equal to the value of the following equation: 

(2 * P + (MAXPKTSIZE*8)/LINESPEED + D) * 10

where "P" is the propagation delay (in seconds) of the medium that connects the user to the network, MAXPKTSIZE is the maximum transmit packet size, and "D" is the DCE (Data Circuit-terminating Equipment) processing overhead (in seconds). Contact the network provider for information about variables P and D.

40: The default value is 40 (4 seconds).

idle-timer: Specify a value ranging from 4 through 600. Each unit represents 0.1 seconds, which provides a timeout value ranging from 0.4 through 60 seconds.

FRAMERTY
Specifies the maximum number of retries attempted for various error conditions on the interface, such as link level time-outs, logical link level re-transmissions and others.

7: Seven retries are attempted.

frame-retry: Specify a value ranging from 0 through 64 retries.

ADRINSERT
Specifies whether the system inserts the local network address in CALL REQUEST or CALL ACCEPTED packets.

*YES: The local network address is inserted in packets.

*NO: The local network address is not inserted in packets.

X25DCE
Specifies whether the system communicates via the X.25 data circuit-termination equipment (DCE) support. This allows a system to communicate with another system without going through an X.25 network.

*NO: The iSeries 400 does not communicate via the X.25 (DCE) support.

*YES: The iSeries 400 communicates via the X.25 (DCE) support.

*NEG: The iSeries 400 negotiates with another system about whether to communicate through the X.25 (DCE) support. This value can only be specified for switched lines.

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.

CNNNBR
Specifies, for switched lines, the telephone number used to establish a switched connection on this line description. The value specified on this parameter is sent to the autocall unit if automatic calling is used to establish a switched connection, or it is sent to the V.25 bis modem if V.25 bis automatic dialing is used to establish the connection. When manual dialing is used to establish a switched connection on the line, this number is displayed to the system operator. For X.25, this number is the remote data terminal equipment (DTE) address for the switched virtual circuit (SVC) provided by the X.25 network.

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: The CRN (Call Request Normal) 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 (Call Request with Identification) auto-dialing.

MODEM
Specifies the type of modem supported on the communications line. Refer to the modem information to select the appropriate value.

*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 3 (local loop back) and loop 2 (a remote loop back).

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

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

Note: The user is responsible for ensuring that the line speed corresponds to the actual modem rate.

*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 switched lines or switched network backup lines, whether the line is used for incoming calls, for outgoing calls, or for both incoming and outgoing calls.

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

CNNLSTOUT
Specifies, for ISDN switched connections, the name of a connection list object that contains the ISDN assigned numbers for a dial-out operation to the ISDN.

*NONE: A user specified connection list for dial-out operations is not used. The connection list is automatically configured if OSI Communications Subsystems/400 is installed.

connection-list-name: Specify the name of the connection list for dial out operations.

CNNLSTOUTE
Specifies, for ISDN switched connections, the entry name from the connection list used to make a call to the ISDN. The connection list must be specified on the CNNLSTOUT parameter.

CNNLSTIN
Specifies for ISDN switched connections the name of the connection list that is used to retrieve call information (or connection) for identifying authorized incoming calls.

*NETATR: The connection list used by this line description is taken from the list of system default network attributes that were identified at IPL (Initial Program Load). The Display Network Attributes (DSPNETA) command can be used to see the name of the connection list.

connection-list-name: Specify the name of the connection list used for this line description.

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 iSeries 400 does not automatically 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 or if the modem used is capable of calling though a command interface.

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: V.25 bis is a recommendation which allows the use of one physical interface for call establishment and data transmission. It is sometimes referred to as a serial automatic call interface because the digits are presented serially on the link from the system (DTE) to the modem (DCE).

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

Note: Valid only when INTERFACE(*INTMODEM) or INFTRFTYPE(*FAXMODEM) or INFTRFTYPE(*ASYNCMODEM) or INFTRFTYPE(*SYNCMODEM) 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.

CALLIMMED
Specifies, for switched (CNN(*SWTPP)) lines, whether a call (using the number specified by the CNNNBR parameter) is made immediately after the line description is varied on.

*NO: The call is not made immediately after the line description is varied on. Instead, it must be initiated by an application program.

*YES: The call is made immediately after the line description is varied on.

AUTOCALL
Specifies, for switched 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.

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.

PREDIALDLY
Specifies how long to wait (in 0.5 second intervals) before dialing.

Note: This parameter is valid only for switched lines (CNN(*SWTPP)).

6: The value of 6 provides a 3-second delay.

predial-delay: Specify a value ranging from 1 through 254 in 0.5-second intervals, or specify 0 to indicate no delay.

REDIALDLY
Specifies the length of time (in 0.5-second intervals) to wait before re-dialing when the call attempt is unsuccessful. This parameter can be specified only if CNN(*SWTPP) is also specified.

120: A 60-second delay occurs before the number to the remote system is redialed.

redial-delay: Specify the length of time before the number to the remote system is redialed, or specify 0 to indicate no delay. Valid values range from 1 through 254 (in 0.5-second intervals).

DIALRTY
Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.

Note: Dial retries can only be specified for switched lines (CNN(*SWTPP)).

2: The LZ algorithm with the 12-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ12 requires the most storage and processing time of the LZ algorithms; however, it compresses the data stream the most.

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

SWTDSC
Specifies whether the switched connection on this line is disconnected when the last switched virtual circuit (SVC) is cleared.

*YES: The switched connection is disconnected when the last device is varied off.

*NO: The switched connection is not disconnected when the last switched virtual circuit is cleared.

SWTDSCTMR
Specifies the settings for the switch disconnect timers that run when switched X.25 lines are disconnected from the network or remote system.

Element 1: Settings for the Minimum Connect Timer

170: The minimum connect timer keeps the connection active for a minimum of 170 seconds. This timer is started when the connection is established.

minimum-connect-timer: Specify the minimum length of time the system keeps the connection active. Valid values for the minimum connect timer range from 0 through 65535 seconds.

Element 2: Settings for the Disconnect Delay Timer

0: The system breaks the switched connection as soon as the following two conditions occur:

  1. The line is idle.

  2. The minimum connect timer has expired.

disconnect-delay-timer: Specify the number of seconds (ranging from 0 through 65535 seconds) the system waits before breaking the switched line connection. The system breaks the switched connection only when the following conditions occur:

  1. The line is idle.

  2. The minimum connect timer has expired.

  3. The disconnect delay timer has expired.


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.

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.

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.

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

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, 128000, 192000, 256000, 320000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, 10M, and 16M.

SWTNWISLCT
Specifies the method used to select network interfaces from the switched network interface list.

*FIRST: Selection begins with the first network interface specified in the switched network interface list.

*CALC: The system calculates which network interface is selected.

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

128: The cost per connect time is 128.

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.

128: The cost per byte is 128.

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.

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

*NONSECURE: Normal priority is used.

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

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

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

*MIN: The minimum propagation delay is used.

*TELEPHONE: The telephone 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.

MSGQ
Specifies the qualified name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management Link to PDF book.

Single Values

*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.

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 CRTLINX25 

CRTLINX25   LIND(X251)  RSRCNAME(LIN011)
  LGLCHLE((111 *PVC CTL1) (222 *SVCIN))
  NETADR(12345)  CNNINIT(*LOCAL)  TEXT('X.25 Line')

This command creates an X.25 line (X251) with resource name LIN011, two logical channels (with an attached PVC controller), a network address of 12345, and local connection initiation.

Error messages for CRTLINX25

*ESCAPE Messages

CPF2718
Line description &1 not created due to errors.