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 book, SC41-5401.

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 names	Values (up to 6 repetitions): Name	Required, Positional 2
ONLINE	Online at IPL	*YES, *NO	Optional
ROLE	Data link role	*NEG, *PRI, *SEC	Optional
INTERFACE	Physical interface	*RS232V24, *RS530V36, *V35, *X21, *X21BISV24, *X21BISV35, *RS449V36, *INTMODEM	Optional
CNN	Connection type	*NONSWTPP, *SWTPP, *MP, *SHM, *NONSWTCAL, *NONSWTANS	Optional
SNBU	Switched network backup	*NO, *YES	Optional
SHMNODE	SHM node type	*T21, *T20	Optional
VRYWAIT	Vary on wait	15-180, *NOWAIT	Optional
AUTOCALL	Autocall unit	*NO, *YES	Optional
EXCHID	Exchange identifier	05600000-056FFFFF, *SYSGEN	Optional
NRZI	NRZI data encoding	*YES, *NO	Optional
MAXCTL	Maximum controllers	1-254, 1	Optional
CLOCK	Clocking	*MODEM, *SYSTEM, *LOOP, *INVERT	Optional
LINESPEED	Line speed	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, 2048000	Optional
MODEM	Modem type supported	*NORMAL, *V54, *IBMWRAP, *IBMLPDA1, *IBMLPDA2	Optional
SWTCNN	Switched connection type	*BOTH, *ANS, *DIAL	Optional
AUTOANS	Autoanswer	*YES, *NO	Optional
AUTODIAL	Autodial	*NO, *YES	Optional
MDMINZCMD	Modem init command string	Character value, *NONE	Optional
DIALCMD	Dial command type	*NONE, *V25BIS	Optional
ACRSRCNAME	Autocall resource name	Name	Optional
SHMCALLTMR	SHM call timer	1-60, *NONE	Optional
SHMMAXCNN	SHM maximum connect timer	1-254, 8, *NOMAX	Optional
SHMANSDLY	SHM answer delay timer	1-254, 11, *NOMAX	Optional
SHMCALLFMT	SHM call format	0-15, *DNIC, *DCC	Optional
SHMACC	SHM access code	Character value, X''	Optional
CALLNBR	Calling number	Character value, *NONE	Optional
STNADR	Station address	01-FE	Optional
CNNPOLLRTY	Connect poll retry	0-64, 7	Optional
CNNTMR	Connect timer	1-32767, *NOMAX	Optional
SHORTTMR	Short timer	10-600, 50	Optional
LONGTMR	Long timer	100-6000, 600	Optional
SHORTRTY	Short retry	0-254, 7	Optional
LONGRTY	Long retry	0-254, 1	Optional
CPSRTY	Call progress signal retry	Values (up to 11 repetitions): *CPS41, *CPS42, *CPS43, *CPS44, *CPS45, *CPS46, *CPS47, *CPS48, *CPS49, *CPS71, *CPS72	Optional
MAXFRAME	Maximum frame size	265, 521, 1033, 2057	Optional
DUPLEX	Duplex	*HALF, *FULL	Optional
INACTTMR	Inactivity timer	150-4200, 300, *NOMAX	Optional
POLLRSPDLY	Poll response delay	0-2048, 0	Optional
NPRDRCVTMR	Nonproductive receive timer	160-4200, 320	Optional
IDLTMR	Idle timer	5-300, 30	Optional
CNNPOLLTMR	Connect poll timer	2-300, 30	Optional
POLLPAUSE	Poll cycle pause	0-2048, 0	Optional
FRAMERTY	Frame retry	0-64, 7	Optional
FAIRPLLTMR	Fair polling timer	5-60, 15	Optional
DSRDRPTMR	Data Set Ready drop timer	3-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
TEXT	Text 'description'	Character value, *BLANK	Optional
CTL	Attached nonswitched ctls	Values (up to 254 repetitions): Name	Optional
MODEMRATE	Modem data rate select	*FULL, *HALF	Optional
THRESHOLD	Error threshold level	*OFF, *MIN, *MED, *MAX	Optional
MODULUS	Modulus	8, 128	Optional
MAXOUT	Maximum outstanding frames	1-28, 7	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, 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, 4M, 10M, 16M, *MAX	Optional
COSTCNN	Cost/connect time	0-255, *CNN	Optional
COSTBYTE	Cost/byte	0-255, *CNN	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
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)

Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name.

This is a required parameter.

You can enter multiple values for this parameter.

Online at IPL (ONLINE)

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

*YES

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

*NO

This line is not automatically varied on at IPL.

Data link role (ROLE)

Specifies whether the system is the primary station, or the secondary station, or whether the system dynamically negotiates 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 data link by sending commands to the secondary station, and the secondary station responds to the commands.

*NEG

This value allows this system and the remote system to negotiate which station is primary.

*PRI

This system is the primary station on this communications line.

*SEC

This system is a secondary station on this communications line.

Physical interface (INTERFACE)

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

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

RS-232/V.24 physical interface.

*V35 (BSC and SDLC only)

V.35 physical interface.

*X21 (X.25 and SDLC only)

X.21 physical interface.

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

X.21 bis/V.24 physical interface.

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

X.21 bis/V.35 physical interface.

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

RS-449/V.36 physical interface.

*INTMODEM

The integrated modem interface is used.

Connection type (CNN)

Specifies the type of line connection.

*NONSWTPP

A nonswitched point-to-point line is used.

*SWTPP

A switched point-to-point line is used.

*MP

A nonswitched multipoint line.

*SHM

An X.21 short hold mode line.

*NONSWTCAL

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

*NONSWTANS

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

Switched network backup (SNBU)

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

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

*NO

The local modem does not have the SNBU feature.

*YES

The local modem has the SNBU feature.

SHM node type (SHMNODE)

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

*T21

Specifies physical unit type 2.1 controllers. *NEG must also be specified for the Data link role (ROLE) parameter.

This value should be specified when using the following controllers:

• APPC controllers

*T20

Specifies physical unit type 2.0 controllers. *PRI or *SEC must be specified for the Data link role (ROLE) parameter.

This value should be specified when using the following controllers:

• host controllers
• remote work station controllers
• finance controllers

Vary on wait (VRYWAIT)

Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.

*NOWAIT

The system does not wait for vary on completion. The line is varied on asynchronously.

vary-on-wait

Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.

Notes:

1. When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
2. The time required to vary on a line is the time it takes to:
   • Put tasks in place to manage the line
   • Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
   • Establish the communications tasks and processes

Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.

Autocall unit (AUTOCALL)

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

*NO

No automatic call unit is associated with this line.

*YES

An automatic call unit is associated with this line.

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.

NRZI data encoding (NRZI)

Specifies whether non-return-to-zero-inverted (NRZI) data coding is to be 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.

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

*YES

NRZI data coding is used.

*NO

NRZI data coding is not used.

Maximum controllers (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 value ranging from 1 to 254. The number must be large enough to account for all of the controllers that are currently active to this line, and for those controllers you know will be attached in the near future.

Clocking (CLOCK)

Specifies how the clocking function for the line is provided.

*MODEM

The clocking function for the line is provided by the modem.

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

Line speed (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 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.

Switched connection type (SWTCNN)

Specifies whether the switched (Async, BSC, SDLC, or IDLC) line or switched network backup (Async, BSC, or SDLC) line is used for incoming calls, outgoing calls, or both.

*BOTH

The line is used for both incoming and outgoing calls.

*ANS

The line is used for incoming calls only.

*DIAL

The line is used for outgoing calls only.

Autoanswer (AUTOANS)

Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 line), whether the system automatically answers a call from a remote system to establish the connection, or whether the system operator manually answers the call and places the modem in data mode.

Note: *YES is a valid option only if the modem has the automatic answer feature.

*YES

The incoming call is automatically answered by the automatic answer feature.

*NO

The incoming call must be manually answered.

Autodial (AUTODIAL)

Specifies, for switched lines, whether the system automatically calls a remote system to establish a connection or if the system operator must manually place the call.

*NO

The line connection is made by manually dialing the X.25 network.

*YES

The line connection is made by the system automatically dialing the X.25 network.

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

Dial command type (DIALCMD)

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

*NONE

No dial command is used. (An automatic call unit is used to establish the connection.)

*V25BIS

V.25 bis is a recommendation which allows the use of one physical interface for call establishment and data transmission. It is referred to as a serial automatic call interface because the digits are presented serially on the link from the system to the modem.

Autocall resource name (ACRSRCNAME)

Specifies the automatic call resource name that describes the automatic call unit port that is used to establish a connection with a remote system. Use the Work with Hardware Resources (WRKHDWRSC) command to determine the resource name.

SHM call timer (SHMCALLTMR)

Specifies the interval at which a connection is re-established on an X.21 short hold mode (SHM) line to verify the state of the remote system if no SHM reconnection has occurred in the specified interval. This parameter is valid only if *SHM is specified on the Connection type (CNN) parameter.

*NONE

No call is made to verify the connection.

short-hold-mode-call-timer

Specify an interval, from 1 to 60 minutes, at which a call is made to verify the connection.

SHM maximum connect timer (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, delays further calls for the amount of time specified on the SHM answer delay timer (SHMANSDLY) parameter, and then makes 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 Data link role (ROLE) parameter and if *SHM is specified on the Connection type (CNN) parameter.

8

The system waits eight seconds before checking for other controllers.

*NOMAX

The timer is disabled.

maximum-connect-timeout

Specify a value ranging from 1 through 254 seconds.

SHM answer delay timer (SHMANSDLY)

Specifies the amount of time the system waits for controllers to call in before making outgoing calls. The SHM answer delay timer is started when one of the following is true:

• The time specified by the SHM maximum connect timer (SHMMAXCNN parameter) has expired.
• A period of time equal to twice the value of the SHMMAXCNN parameter has elapsed with no opportunities for incoming calls to be received.

Note: This parameter is valid only if *PRI or *NEG is specified on the Data link role (ROLE) parameter and if *SHM is specified on the Connection type (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 equal 100 tenths of seconds.

SHM call format (SHMCALLFMT)

Specifies the format for the X.21 short hold mode line call number. This parameter is valid only if *SHM is specified on the Connection type (CNN) parameter.

*DNIC

The Data Network Identification Code (DNIC) is used.

*DCC

The Data Country Code (DCC) is used.

call-format

The length of the area code or country or region code portion of the SHM calling number. Specify a number from 0 to 15.

SHM access code (SHMACC)

Specifies the access code for the X.21 short hold mode line. This parameter is valid only if *SHM is specified on the Connection type (CNN) parameter.

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.

Station address (STNADR)

Specifies, for a switched secondary or negotiable line, the hexadecimal station address to which the local system responds when polled by the remote system if it answers a call.

station-address

Specify a hexadecimal value from 01 to FE.

Connect poll retry (CNNPOLLRTY)

Specifies, for a switched primary line or a negotiable line, the number of connection polling retries to make before indicating the error and making the station inoperative.

connect-poll-retry

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

Connect timer (CNNTMR)

Specifies, for an X.21 circuit switched interface, the amount of time an automatic answer connect request waits for an incoming call to be accepted.

*NOMAX

The system waits indefinitely.

connect-timer

Specify a value from 1 to 32767 in 0.1 second intervals.

Short timer (SHORTTMR)

Specifies, for X.21 circuit switched interface or short hold mode, the short timer used during bursts of retry operations. The system waits between connection attempts for this timeout period.

1. The SHORTTMR parameter is used only for X.21 circuit-switched or short-hold mode lines.
2. The default meets most countries' or regions' requirements relative to call retries and call delays. In the event that the default does not meet your country's or region's requirements, the value must be configured in accordance with the country or region requirement. Before changing this value, ensure that the new value is in accordance with your country's or region's requirements.

   If you are not aware of your country's or region's requirement, your IBM representative or IBM-approved remarketer can provide this information.

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.

50

The system waits five seconds.

short-timer

Specify a value from 10 to 600 in 0.1 second intervals.

Long timer (LONGTMR)

Specifies for an X.21 circuit switched interface or short hold mode, the long timer used 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 &odq.bursts&cdq. 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 from 100 to 6000 in 0.1 second intervals.

Short retry (SHORTRTY)

Specifies for an X.21 circuit switched interface or short hold mode, the number of retry attempts that are made during a burst of retries.

short-retry

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

Long retry (LONGRTY)

Specifies, for an X.21 circuit switched interface or short hold mode, the number of burst retry attempts 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 &odq.bursts&cdq. 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 from 0 to 254 for the number of retries.

Call progress signal retry (CPSRTY)

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

Valid values are: *CPS41, *CPS42, *CPS43, *CPS44, *CPS45, *CPS46, *CPS47, *CPS48, *CPS49, *CPS71, and *CPS72.

This parameter can be specified only if *SHM or *SWTPP is specified for the Connection type (CNN) parameter and *X21 is specified on the Physical interface (INTERFACE) parameter.

Maximum frame size (MAXFRAME)

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

frame-size

The standard frame sizes are:

• 265 (All line types)
• 521 (All line types)
• 1033 (All line types)
• 1994 (Token-ring only)
• 2057 (SDLC or Token-ring)
• 4105 (TDLC or Token-ring)
• 4060 (Token-ring only)
• 8156 (Token-ring only)
• 16393 (Token-ring only)

Duplex (DUPLEX)

Specifies whether request-to-send (RTS) is permanently turned on (for duplex modems) or turned on only when transmission is required (for half duplex modems).

*HALF

Request-to-send (RTS) is turned on only when transmission is required (for half duplex modems). You can choose to run half duplex even if the modem can support duplex communication.

*FULL

Request-to-send (RTS) is permanently set on (for duplex modems).

Inactivity timer (INACTTMR)

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

300

The system waits 30 seconds (300 tenths of a second) for a valid frame.

inactivity-timer

Specify a value from 150 to 4200 in 0.1 second intervals.

Poll response delay (POLLRSPDLY)

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

poll-response-delay

Specify a value from 1 to 2048 in 0.0001 second intervals, or 0 to indicate no delay.

Nonproductive receive timer (NPRDRCVTMR)

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

nonproductive-receive-timer

Specify a value from 160 to 4200 in 0.1 second intervals.

Idle timer (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 detected, error recovery procedures are started.

idle-timer

Specify a value from 5 to 300 in 0.1 second intervals.

Connect poll timer (CNNPOLLTMR)

Specifies, for a primary or negotiable line, the time the system waits for the response to a connect poll before resending the poll.

connect-poll-timer

Specify a value from 2 to 300 in 0.1 second intervals.

Poll cycle pause (POLLPAUSE)

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

poll-cycle-pause

Specify a value from 1 to 2048 in 0.0001 second intervals, or 0 to indicate no pause.

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.

Fair polling timer (FAIRPLLTMR)

Specifies, for a multipoint line, the number of seconds the system waits before resuming polling of stations without pending data transfer requests.

fair-poll-timer

Specify a value from 5 to 60 in one second intervals.

Data Set Ready drop timer (DSRDRPTMR)

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

drop-timer

Specify a value ranging from 3 through 60 seconds.

Autoanswer type (AUTOANSTYP)

Specifies the method that the system uses to answer incoming calls.

*DTR

The system enters the Data Terminal Ready state, signals the modem to answer calls, and waits for the modem to enter the Data Set Ready (DSR) state.

*CDSTL

The system enters the Connect Data Set to Line (CDSTL) state after monitoring the Ring Indicator to signal the modem to answer the call.

Remote answer timer (RMTANSTMR)

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

answer-timer

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

Text 'description' (TEXT)

Specifies text that briefly describes the line description.

*BLANK

Text is not specified.

character-value

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

Attached nonswitched ctls (CTL)

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

You can enter multiple values for this parameter.

name

Specify the names of one or more attached nonswitched controllers. Up to 254 controller names can be specified.

Modem data rate select (MODEMRATE)

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

*FULL

The line operates at the full rate of the modem.

*HALF

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

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.

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

Maximum outstanding frames (MAXOUT)

Specifies the maximum number of frames that can be sent to a remote system before the remote system must respond back. For modulus 8, the maximum number of frames must be 1 to 7. For modulus 128, the maximum number of frames must be 8 to 28.

maximum-outstanding-frames

Specify a value from 1 to 28 for the number of outstanding frames.

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 and RS-449V.36.

*MIN

A link speed of less than 1200 bps is used.

*MAX

A link speed greater than 100M bps is used.

link-speed

Specify a link speed. The valid link speeds 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, 4M, 10M and 16M bps.

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.

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

CRTLINSDLC   LIND(BOSTON)  RSRCNAME(LIN041)

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

Error messages

*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.