The Create Line Description (X.25) (CRTLINX25) command creates a line description for an X.25 line.

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

Parameters

Keyword	Description	Choices	Notes
LIND	Line description	Name	Required, Positional 1
RSRCNAME	Resource name	Name	Required, Positional 2
LGLCHLE	Logical channel entries	Single values: *PROMPT Other values (up to 256 repetitions): Element list	Required, Positional 3
	Element 1: Logical channel identifier	Character value
	Element 2: Logical channel type	*PVC, *SVCIN, *SVCBOTH, *SVCOUT
	Element 3: PVC controller	Name
NETADR	Local network address	Character value	Required, Positional 4
CNNINIT	Connection initiation	*LOCAL, *REMOTE, *WAIT, *CALLER	Required, Positional 5
ONLINE	Online at IPL	*YES, *NO	Optional
INTERFACE	Physical interface	*X21BISV24, *X21BISV35, *RS232V24, *RS449V36, *X21, *INTMODEM	Optional
CNN	Connection type	*NONSWTPP, *SWTPP, *NONSWTCAL, *NONSWTANS	Optional
NWI	Attached nonswitched NWI	Name	Optional
NWICHLTYPE	NWI channel type	*B	Optional
NWICHLNBR	NWI channel number	1-30	Optional
SWTNWILST	Switched NWI list	Single values: *NONE Other values (up to 64 repetitions): Element list	Optional
	Element 1: NWI description	Name
	Element 2: NWI channel type	*B
	Element 3: NWI channel number	1-30, *CALC
VRYWAIT	Vary on wait	15-180, *NOWAIT	Optional
LINESPEED	Line speed	*CALC, 600, 1200, 2400, 4800, 7200, 9600, 12000, 14400, 19200, 48000, 56000, 57600, 64000, 128000, 192000, 256000, 320000, 384000, 448000, 512000, 576000, 640000, 704000, 768000, 832000, 896000, 960000, 1024000, 1088000, 1152000, 1216000, 1280000, 1344000, 1408000, 1472000, 1536000, 1600000, 1664000, 1728000, 1792000, 1856000, 1920000, 1984000, 2048000	Optional
EXCHID	Exchange identifier	05600000-056FFFFF, *SYSGEN	Optional
PKTMODE	Packet mode	*YES, *NO	Optional
INFTRFTYPE	Information transfer type	*UNRESTRICTED, *V110, *DOV, *SYNCMODEM	Optional
EXNNETADR	Extended network addressing	*YES, *NO	Optional
MAXFRAME	Maximum frame size	1024, 2048, 4096	Optional
DFTPKTSIZE	Default packet size	Element list	Optional
	Element 1: Transmit value	64, 128, 256, 512, 1024, 2048, 4096
	Element 2: Receive value	*TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096
MAXPKTSIZE	Maximum packet size	Element list	Optional
	Element 1: Transmit value	*DFTPKTSIZE, 64, 128, 256, 512, 1024, 2048, 4096
	Element 2: Receive value	*DFTPKTSIZE, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096
MODULUS	Modulus	8, 128	Optional
DFTWDWSIZE	Default window size	Element list	Optional
	Element 1: Transmit value	1-15, 2
	Element 2: Receive value	1-15, *TRANSMIT
ADRINSERT	Insert net address in packets	*YES, *NO	Optional
NETUSRID	Network user ID	Character value	Optional
CNNNBR	Connection number	Character value	Optional
CALLNBR	Calling number	Character value, *NONE	Optional
SWTCNN	Switched connection type	*BOTH, *ANS, *DIAL	Optional
CNNLSTOUT	Outgoing connection list	Name	Optional
CNNLSTOUTE	Connection list entry	Name	Optional
CNNLSTIN	Incoming connection list	Name, *NETATR	Optional
AUTOANS	Autoanswer	*YES, *NO	Optional
AUTODIAL	Autodial	*NO, *YES	Optional
DIALCMD	Dial command type	*NONE, *V25BIS	Optional
MDMINZCMD	Modem init command string	Character value, *NONE	Optional
CALLIMMED	Call immediate	*NO, *YES	Optional
AUTOCALL	Autocall unit	*NO, *YES	Optional
ACRSRCNAME	Autocall resource name	Name	Optional
PREDIALDLY	Predial delay	0-254, 6	Optional
REDIALDLY	Redial delay	0-254, 120	Optional
DIALRTY	Dial retry	0-254, 2	Optional
SWTDSC	Switched disconnect	*YES, *NO	Optional
SWTDSCTMR	Disconnect timers	Element list	Optional
	Element 1: Minimum connect timer	0-65535, 170
	Element 2: Disconnection delay timer	0-65535, 0
DSRDRPTMR	Data Set Ready drop timer	1-60, 6	Optional
AUTOANSTYP	Autoanswer type	*DTR, *CDSTL	Optional
RMTANSTMR	Remote answer timer	30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, 100, 105, 110, 115, 120	Optional
CLOCK	Clocking	*MODEM, *LOOP, *INVERT	Optional
SWTNWISLCT	Switched NWI selection	*FIRST, *CALC	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
X25DCE	X.25 DCE support	*NO, *YES, *NEG	Optional
NETCTL	Network controller	Name	Optional
SWTCTLLST	Switched controller list	Single values: *NONE, *ALL Other values (up to 64 repetitions): Name	Optional
IDLTMR	Idle timer	3-600, 40	Optional
FRAMERTY	Frame retry	0-64, 7	Optional
THRESHOLD	Error threshold level	*OFF, *MIN, *MED, *MAX	Optional
MODEM	Modem type supported	*NORMAL, *V54, *IBMWRAP	Optional
MODEMRATE	Modem data rate select	*FULL, *HALF	Optional
CTSTMR	Clear To Send timer	10-60, 25	Optional
LINKSPEED	Link speed	*INTERFACE, *MIN, 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, 16M, *MAX	Optional
COSTCNN	Cost/connect time	0-255, 128	Optional
COSTBYTE	Cost/byte	0-255, 128	Optional
SECURITY	Security for line	*NONSECURE, *PKTSWTNET, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX	Optional
PRPDLY	Propagation delay	*MIN, *LAN, *TELEPHONE, *PKTSWTNET, *SATELLITE, *MAX	Optional
USRDFN1	User-defined 1	0-255, 128	Optional
USRDFN2	User-defined 2	0-255, 128	Optional
USRDFN3	User-defined 3	0-255, 128	Optional
CMNRCYLMT	Recovery limits	Single values: *SYSVAL Other values: Element list	Optional
	Element 1: Count limit	0-99, 2
	Element 2: Time interval	0-120, 5
MSGQ	Message queue	Single values: *SYSVAL, *SYSOPR Other values: Qualified object name	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name
AUT	Authority	Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT	Optional

Top

Line description (LIND)

Specifies the name of the line description

This is a required parameter.

Resource names (RSRCNAME)

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.

Specifies the resource name that identifies the hardware the description represents.

Logical channel entries (LGLCHLE)

Specifies, when using the Create Line X.25 Description (CRTLINX25) or Change Line Description X.25 (CHGLINX25) command, up to 256 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.

You can enter multiple values for this parameter.

The possible channel identifier values are:

*PROMPT

Specifying *PROMPT presents an interactive display that can be used to process current logical channel entries.

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. Specify a logical channel identifier. Valid values range from hexadecimal numeral 001 through FFF.

The possible channel type values are:

*PVC

The logical channel is a permanent virtual circuit.

*SVCIN

The logical channel is a switched virtual circuit for incoming calls.

*SVCBOTH

The logical channel is a switched virtual circuit for both incoming and outgoing calls.

*SVCOUT

The logical channel is a switched virtual circuit for outgoing calls.

PVC-controller

Specify the name of the PVC controller to be assigned to the logical channel. This field is valid only if *PVC is specified for the channel type.

Local network address (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.

local-network-address

Specify the local network address.

Connection initiation (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 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 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.

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.

Physical interface (INTERFACE)

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

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

*X21 (X.25 and SDLC only)

X.21 physical interface.

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

RS-232/V.24 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.

Note: *NONSWTCAL and *NONSWTANS valid only when INTERFACE(*INTMODEM), or INFTRFTYPE *SYNCMODEM.

*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: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Attached nonswitched NWI (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 not *SWTPP.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

NWI channel type (NWICHLTYPE)

Specifies, for a nonswitched connection, the type of Integrated Services Digital Network (ISDN) channel that this line description uses. This parameter is pre-set to use one ISDN B-channel (a data-bearing channel) of the Network Interface description specified on the Attached nonswitched NWI (NWI) parameter.

*B

The B channel is used.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

NWI channel number (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.

Note: Valid only when RSRCNAME(*NWID) and CNN not *SWTPP.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Switched NWI list (SWTNWILST)

Specifies, for ISDN/T1 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.

Note: Valid only when RSRCNAME(*NWID) and CNN(*SWTPP).

The possible Network Interface Description Name values are:

*NONE

No network interface description is specified.

name

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

The possible Network Interface Channel Type values are:

*B

The B channel is used.

The possible Network Interface Channel-Number values are:

*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 to 30) to which the line description is restricted.

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.

Line speed (LINESPEED)

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

9600

The line speed is 9600 bps.

*CALC

The system calculates the value to use.

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

Exchange identifier (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

This value allows the operating system to create the exchange identifier. Use the Display Line Description (DSPLIND) command to see the resulting exchange identifier.

exchange-ID

Specify an 8-character (four hexadecimal bytes) exchange identifier ranging from 05600000 through 056FFFFF.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Packet mode (PKTMODE)

Specifies whether to access the ISDN or T1 virtual circuit service.

*NO

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

*YES

The ISDN/T1 virtual circuit service is accessed (Case B).

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Information transfer type (INFTRFTYPE)

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

Note: Valid only when RSRCNAME(*NWID) and CNN not *SWTPP.

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

Extended network addressing (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.

Maximum frame size (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.

Default packet size (DFTPKTSIZE)

Specifies the default packet sizes used for transmission and reception on this line. The values specified should match the default values used by the X.25 network.

The possible transmission values are:

128

The default packet size is 128.

transmit-packet-size

Specify a default packet size for transmission to all controllers that will attach to this line. The controller commands 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.

The possible reception values are:

*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 for all controllers that will attach to this line. The controller commands 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.

Maximum packet size (MAXPKTSIZE)

Specifies the maximum packet sizes for transmission and reception on this line. These values should match the maximum packet sizes supported for transmission and reception by the X.25 network. The value specified must not be less than the default packet size specified.

The possible transmission values are:

*DFTPKTSIZE

The maximum packet size for transmission is the same as the default packet size for transmission.

max-transmit-packet-size

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

Modulus (MODULUS)

Specifies whether the extended sequence numbers are used.

8

Extended sequence numbers are not used (Modulus 8).

128

Extended sequence numbers are used (Modulus 128).

Default window size (DFTWDWSIZE)

Specifies the default packet window size for transmission to and reception from controllers attached to this line. The controllers can override this default by specifying the X.25 default window size (DFTWDWSIZE) parameter on the controller commands.

The possible transmission values are:

2

The default packet window size is 2.

transmit-window-size

Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.

The possible reception values are:

*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. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.

Insert net address in packets (ADRINSERT)

Specifies whether the system inserts the local network address in call request packets.

*YES

The local network address is inserted in packets.

*NO

The local network address is not inserted in packets.

Network user ID (NETUSRID)

For switched lines, this parameter allows the network subscriber to request network user identification (NUI) information be encoded in the NUI Selection Facility for all call request packets sent by the local system on this line.

network-user-identification

Specify a NUI up to 214 hexadecimal characters in length.

Connection number (CNNNBR)

Specifies the number used to connect to this line. This is the telephone number to be dialed by the modem. A maximum of 32 characters can be specified.

connection-number

Specifies the connection number.

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.

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.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Outgoing connection list (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 is installed.

name

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

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Connection list entry (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.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Incoming connection list (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.

name

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

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.

Modem init command string (MDMINZCMD)

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

Note: Valid only when INTERFACE(*INTMODEM) 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:

    Period
    Less than sign
    Left parenthesis
    Plus sign
    Ampersand
    Asterisk
    Right parenthesis
    Semicolon
    Minus sign
    Slash
    Comma
    Underline
    Greater than sign
    Question mark
    Colon
    Equal sign
    Spaces
    Number sign
    Double quote
    Exclamation point
    At sign
    Hat symbol
    Percent
    Left square bracket
    Right square bracket
    Back slash

Note: The modem initialization string must begin with the two characters 'AT'.

Call immediate (CALLIMMED)

Specifies, for switched lines, whether a call (using the number specified in the CNNNBR parameter) is made immediately after varying on the line.

*NO

The system does not try to immediately call after varying on.

*YES

The system does try to immediately call after varying on.

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.

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.

Predial delay (PREDIALDLY)

Specifies the time interval to wait before dialing a number.

6

The default value of six provides a 3-second delay.

predial-delay

Specify a value ranging from 0 through 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.

Redial delay (REDIALDLY)

Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.

120

The default value of 120 provides a 60-second delay.

redial-delay

Specify a value ranging from 0 through 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.

Dial retry (DIALRTY)

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

2

The default number of retries is 2.

dial-retry

Specify a value ranging from 0 through 254.

Switched disconnect (SWTDSC)

Specifies whether the line is dropped when the last switched virtual circuit (SVC) is cleared and the switched disconnect timers (SWTDSCTMRs) have expired.

*YES

The switched connection is dropped.

*NO

The switched connection is not dropped.

Disconnect timers (SWTDSCTMR)

Specifies the timers used for disconnecting switched X.25 lines from the network or remote system. The minimum connect timer specifies the minimum length of time the system keeps the connection active. This timer is started when the connection is established. The disconnect delay timer specifies the length of time the system waits before attempting to disconnect the switched connection when no SVCs are active on the line or the last SVC completes and the minimum-connect-timer has expired.

The possible minimum-connect-timer values are:

min-connect-timer

Specify a value ranging from 0 through 65535 seconds.

The possible disconnect-delay-timer values are:

disconnect-delay-timer

Specify a value ranging from 0 through 65535 seconds.

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

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

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Switched NWI selection (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.

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.

X.25 DCE support (X25DCE)

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

*NO

The system does not communicate through the X.25 DCE support.

*YES

The system does communicate through the X.25 DCE support.

*NEG

The operating system negotiates with another system about whether to communicate through the X.25 DCE support. This value can only be specified for switched lines.

Network controller (NETCTL)

Specifies the name of an existing network controller.

Switched controller list (SWTCTLLST)

Specifies the names of up to 64 switched asynchronous controllers or specify *ALL for an 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. This parameter is valid only if the line is used to attach switched asynchronous X.25 controllers created by the Create Controller Description (Async) (CRTCTLASC) command. Attaching controllers that specify CNNNBR(*ANY) or ANSNBR(*ANY) may result in a reordering of this list.

You can enter multiple values for this parameter.

*ALL

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

*NONE

No switched asynchronous controller is specified.

names

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

Idle timer (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 following equation: (2 * P + (MAXPKTSIZE * 8) / LINESPEED + D) * 10, where "P" is the propagation delay (in seconds) of the medium that connects you to the network, MAXPKTSIZE is the maximum transmit packet size, and "D" is the DCE (Data Circuit-terminating Equipment) processing overhead (in seconds). Contact your network provider for information regarding these two values.

40

The default for this parameter is 40.

idle-timer

Specify a value ranging from 3 through 600. Each unit represents 0.1 seconds, which provides a timeout value ranging from 0.3 through 60 seconds.

Frame retry (FRAMERTY)

Specifies, for a primary, negotiable, or X.25 line, the number of retries for an unanswered command frame or unacknowledged information frame before indicating the error.

frame-retry

Specify a value from 0 to 64 for the number of retries.

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.

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 diagnostic tests to your modem.

*V54

Certain types of diagnostic tests (as defined by the CCITT recommendations) are run to your modem. This system supports CCITT V.54 loop 3, (a 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.

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

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.

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.

Link speed (LINKSPEED)

Specifies the link speed in bits per second (bps). This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

*INTERFACE (SDLC and X.25 only)

The link speed is based on the physical interface type: 9600 bps for RS-232/V.24 and X.21 bis/V.24, 48000 bps for V.35 and X.21 bis/V.35, and 64000 bps for X.21.

*MIN

A link speed of less than 1200 bps is used.

*MAX

A link speed greater than 100M bps 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.

Cost/connect time (COSTCNN)

Specifies the relative cost of being connected on the line. Zero implies a low cost while 255 indicates a high cost. This parameter is valid only if APPN is used on the system.

*CNN (SDLC and IDLC only)

The cost per connection time is based on the connection type: Zero for nonswitched connections and 128 for switched connections.

cost-per-connect-time

Specify a value ranging from 0 through 255.

Cost/byte (COSTBYTE)

Specifies the relative cost per byte for sending and receiving data on the line. Zero implies a low cost while 255 indicates a high cost. This parameter is valid only if APPN is used on the system.

*CNN (SDLC and IDLC only)

The cost per byte is based on the connection type: Zero for nonswitched connections and 128 for switched connections.

cost-per-byte

Specify a value ranging from 0 through 255.

Security for line (SECURITY)

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

*NONSECURE

There is no security on the line.

*PKTSWTNET

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

*UNDRGRDCBL

An underground cable is used.

*SECURECND

A secure, but unguarded, conduit is used.

*GUARDCND

A guarded conduit, 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.

Propagation delay (PRPDLY)

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

*MIN

The minimum propagation delay is used.

*LAN

Propagation delay using a local area network.

*TELEPHONE

Propagation delay using telephone lines.

*PKTSWTNET

Propagation delay using a packet switched network.

*SATELLITE

Propagation delay using satellite communications.

*MAX

The maximum propagation delay is used.

User-defined 1 (USRDFN1)

This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

128

The default value is 128.

user-defined-1

Specify a value ranging from 0 through 255.

User-defined 2 (USRDFN2)

This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

128

The default value is 128.

user-defined-2

Specify a value ranging from 0 through 255.

User-defined 3 (USRDFN3)

This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

128

The default value is 128.

user-defined-3

Specify a value ranging from 0 through 255.

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.

Message queue (MSGQ)

Specifies the message queue to which operational messages are sent.

*SYSVAL

The value in the system value QCFGMSGQ is used.

*SYSOPR

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

Qualifier 1: Message queue

name

Specify the name of the message queue to which operational messages are sent.

Qualifier 2: Library

name

Specify the name of the library where the message queue is located.

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

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

*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.