CRTLINTRN

CRTLINTRN (Create Line Description (Token-Ring Network)) Command Description

CRTLINTRN Command syntax diagram

Purpose

The Create Line Description (Token-Ring Network) (CRTLINTRN) command creates a line description for a token-ring network line. More information about using this command is in the Communications Configuration book.

Required Parameters

LIND

Specifies the name of the line description being created.

RSRCNAME

Specifies the resource name that describes the automatic call unit port.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. 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 1, then the resource name is LIN011.

*NWID: The resource name is determined by the network interface used.
*NWSD: The resource name is determined by the network server description used.
resource-name: Specify a resource name.

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.

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

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.

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.

NETCTL

Specifies the name of an existing network controller. This parameter can be specified for lines attached to a Transmission Control Protocol/Internet Protocol (TCP/IP) network.

MAXCTL

Specifies the maximum number of controllers that the line supports.
40: The line supports 40 controllers.
maximum-controllers: Specify a number large enough to account for all controllers currently active to this network, and the controllers that will be attached in the near future. Valid values range from 1 through 256.

NWI

Specifies the network interface description to be used.

Note: NWI(*NONE) must be specified when RSRCNAME(*NWID) is not specified. Otherwise, NWI(*NONE) can be specified only when NWIDLCI(*NONE) is also specified.

*NONE: No network interface is specified.
NWI-name: Specify the name of the network interface description to be used.

NWIDLCI

Specifies the frame relay network interface data link connection identifier to be used.

Note: NWIDLCI(*NONE) must be specified when RSRCNAME(*NWID) is not specified. Otherwise, NWIDLCI(*NONE) can be specified only when NWI(*NONE) is also specified.

*NONE: No network interface data link connection identifier is specified.
NWI-data-link-connection-ID: Specify the network interface data link connection identifier to be used. Valid values range from 1 through 1018.

NWITYPE

Specifies the network interface type.
*FR: The network interface type is frame relay.
*ATM: The network interface type is Asynchronous Transfer Mode (ATM).

NWS

Specifies the network server description to which this line is attached.

Note: The NWS parameter can only be specified when RSRCNAME(*NWSD) is specified.

Element 1: Network server description
*NONE: No server description is specified.
network-server-description-name: Specify the name of an existing network server description to be used.
Element 2: Network server port
*INTERNAL: The internal network server port to which the line is attached. There can only be one internal network server port configured for each network server.
network-server-port: Specify the network server port to which the line is attached. Valid values are 1 and 2.

DUPLEX

Specifies whether the hardware can send and receive data simulateously. In half duplex mode, the hardware must alternate between sending data and receiving data. In full duplex mode, one cable is dedicated to send data and another cable is dedicated to receive data. Therefore, data can be sent and received simultaneously. A hub is required for full duplex.

Note: Duplex (DUPLEX) parameter set to *AUTO, if it has a default value and line speed (LINESPEED) parameter has 100M or *AUTO.

*HALF: The line communicates using half duplex mode.
*FULL: The line communicates using full duplex mode.
*AUTO: The duplex value will be determined by the hardware using auto-negotiation.

LINESPEED

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

Notes

When RSRCNAME(*NWID) and NWITYPE(*FR) are specified, *NWI must be specified on this parameter.

Duplex (DUPLEX) parameter set to *AUTO, if it has a default value and line speed (LINESPEED) parameter has 100M or *AUTO.

16M: The line speed is 16 million bits per second (Mbps).
4M: The line speed is 4 million bits per second (Mbps).
100M: The line speed is 100 million bits per second (Mbps).
*AUTO: The line speed value will be determined by the hardware using auto-negotiation.
*NWI: The line speed used is for a network interface. LINESPEED(*NWI) is only valid when RSRCNAME(*NWID) and NWITYPE(*FR) are specified.

MAXFRAME

Specifies the maximum frame size that can be transmitted and received on this line description.
A default of 1556 bytes is used when RSRCNAME(*NWID) and NWITYPE(*FR) are specified. A default of 4060 is used when RSRCNAME(*NWID) and NWITYPE(*ATM) are specified. Otherwise, a default of 4105 bytes is used.

Notes

For NWITYPE(*FR), if the LINESPEED is 4M, a value greater than 4060 cannot be specified.

For token-ring adapters that support only a 4M LINESPEED, values 4472 and lower must be specified.

When RSRCNAME(*NWID) and NWITYPE(*FR) are specified, valid values for this parameter range from 265 through 8148 bytes. The MAXFRAME value is provided by your telephone carrier from which subtract 44 bytes for the size of the header.

When RSRCNAME(*NWID) and NWITYPE(*ATM) are specified, valid values for this parameter range from 265 through 16393 bytes. The MAXFRAME value is provided by your telephone carrier from which subtract 20 bytes for the size of the header.

maximum-frame-size: Specify the maximum frame size value to be used. The valid frame sizes (in bytes) range from 265 through 8148 bytes when the network interface is a frame relay. Otherwise, valid frame sizes (in bytes) range from 265 through 16393.

LECFRAME

Specifies the LAN emulation client (LEC) frame size that can be transmitted and received on this line description.

Note: MAXFRAME always be at least 20 less than this field.

4544: The LEC frame size is 4544 bytes.
1516: The LEC frame size is 1516 bytes.
9234: The LEC frame size is 9234 bytes.
18190: The LEC frame size is 18190 bytes.

ACTLANMGR

Specifies whether Local Area Network (LAN) Manager is activated for this line.

Notes

ACTLANMGR(*YES) must be specified when RSRCNAME(*NWID) is specified.

ACTLANMGR(*NO) will ignore the values in TRNLOGLVL, TRNMGRMODE, LOGCFGCHG and TRNINFBCN.

*YES: LAN manager support is activated for this line.
*NO: LAN manager support is not activated for this line.

TRNLOGLVL

Specifies the error logging level used by the Token Ring Local Area Network (TRLAN) Manager.

Notes

TRNLOGLVL is ignored when ACTLANMGR(*NO) is specified.

*OFF: No monitoring of errors occurs.
*MIN: Starts the minimum reporting level, which reports only conditions that indicate degraded performance and beaconing.
*MED: Starts the medium reporting level, which reports conditions that indicate potential degraded performance as well as those reported for the *MIN reporting level.
*MAX: The maximum error logging level, which reports all error conditions, including those reported for the *MIN and *MED reporting levels, is used.

TRNMGRMODE

Specifies whether the token-ring manager is controlling or observing.

Notes

TRNMGRMODE(*OBSERVING) must be specified when RSRCNAME(*NWID) is specified.

TRNMGRMODE is ignored when ACTLANMGR(*NO) is specified.

*OBSERVING: The token-ring manager is observing.
*CONTROLLING: The token-ring manager is controlling.

LOGCFGCHG

Specifies whether NAUN (nearest active upstream neighbor) changes are logged.

Notes

LOGCFGCHG(*LOG) must be specified when RSRCNAME(*NWID) is specified.

LOGCFGCHG is ignored when ACTLANMGR(*NO) is specified.

*LOG: NAUN changes are logged.
*NOLOG: NAUN changes are not logged.

TRNINFBCN

Specifies whether an informational message is sent to QSYSOPR when beaconing occurs.

Notes

TRNINFBCN(*YES) must be specified when RSRCNAME(*NWID) is specified.

TRNINFBCN is ignored when ACTLANMGR(*NO) is specified.

*YES: A message is sent to QSYSOPR when beaconing occurs.
*NO: A message is not sent to QSYSOPR when beaconing occurs.

ADPTADR

Specifies the 12-character hexadecimal adapter address.
*ADPT: This value gives the user the preset token-ring default address for this token-ring adapter card. The user may display this by using the Display Line Description (DSPLIND) command on this line description after it has successfully varied on.

Note: This value is not valid when RSRCNAME(*NWID) and NWITYPE(*FR) is specified, or RSRCNAME(*NWSD) is specified.

local-adapter-address: Specify an address for this system in the token-ring network. Valid values range from hexadecimal 400000000000 through 7FFFFFFFFFFF.

FCNADR

Specifies whether token ring functional addresses are used.
*NONE: A functional address is not used.
functional-address: Specify a group of hexadecimal functional addresses that are encoded in bit-significant format. Valid values range from hex C00000000001 through hex C00040000000. The first digit must be C. Functional addresses must be unique.
+----------------------------------------------------+ | IEEE- and IBM-Defined Functional Addresses | +-------------------------------+--------------------+ | Active monitor | C00000000001 | +-------------------------------+--------------------+ | Ring Parameter Server | C00000000002 | +-------------------------------+--------------------+ | Network Server Heartbeat | C00000000004 | +-------------------------------+--------------------+ | Ring Error Monitor | C00000000008 | +-------------------------------+--------------------+ | Configuration Report Server | C00000000010 | +-------------------------------+--------------------+ | Synchronous Bandwidth Manager | C00000000020 | +-------------------------------+--------------------+ | Locate--Directory Server | C00000000040 | +-------------------------------+--------------------+ | NETBIOS | C00000000080 | +-------------------------------+--------------------+ | Bridge | C00000000100 | +-------------------------------+--------------------+ | IMPL Server | C00000000200 | +-------------------------------+--------------------+ | Ring Authorization Server | C00000000400 | +-------------------------------+--------------------+ | LAN Gateway | C00000000800 | +-------------------------------+--------------------+ | Ring Wiring Concentration | C00000001000 | +-------------------------------+--------------------+ | LAN Manager | C00000002000 | +-------------------------------+--------------------+ | User-defined |C00000004000 through| | | C00040000000 | +-------------------------------+--------------------+

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 (if the *SYSGEN value is not specified) an exchange identifier composed of eight hexadecimal digits starting with 056.

SSAP

Specifies the source service access point (SSAP). The most commonly used SNA SSAP is hex 04. All SSAP values must be unique.

Note: It is recommended that SSAPs F0, F8 and FC are not used for lines attached to network server descriptions.

*SYSGEN: The system generates one of the source service access points: 04, 12, AA, or C8.
Element 1: SSAPs
source-service-access-point: Specify a source service access point for receiving and transmitting data. A maximum of 24 SSAP values can be specified.

For Transmission Control Protocol/Internet Protocol (TCP/IP) applications, the SSAP must be AA.

For Systems Network Architecture (SNA) applications, the SSAP must be a hex value ranging from 04 through 9C in multiples of four (04, 08, 0C, and so on).

For high-performance routing (HPR) applications, the SSAP must be hex C8.

For non-SNA applications, the SSAP must be a hex value ranging from 02 through FE in multiples of two (02, 04, 06, and so on).

For local area network (LAN) printer applications, specify an SSAP value of 12 and an SSAP type of *NONSNA.

Element 2: Frame Size for SSAPs
*MAXFRAME: The frame size specified on the MAXFRAME parameter is used.
SSAP-maximum-frame: Specify the maximum SSAP frame size (the maximum size of the data field that can be transmitted or received). When RSRCNAME(*NWID) and NWITYPE(*FR) are specified, valid values for this parameter range from 265 through 8148 bytes. Otherwise, valid values for this parameter range from 265 through 16393 bytes.

Note: This value cannot be larger than the value specified on the MAXFRAME parameter.

Element 3: SSAP Type
*CALC: The system determines the SSAP type based on the following hex values:

04 through 9C, divisible by 4 (for SNA)

C8 (for HPR)

02 through FE, divisible by 2 (for non-SNA)

*SNA: The SSAP is used for SNA communications. Valid values range from hex 04 through hex 9C in multiples of four (04, 08, 0C, and so on).
*NONSNA: The SSAP is used for non-SNA communications. Valid values range from hex 02 through hex FE in multiples of two (02, 04, 06, and so on).
*HPR: The SSAP is used for HPR communications. It also can be used for SNA applications. The valid value is hex C8.

ELYTKNRLS

Specifies whether the early token release option is used.

Note: ELYTKNRLS(*LINESPEED) must be specified when RSRCNAME(*NWID) is specified.

*LINESPEED: The value specified on the LINESPEED parameter is used to determine whether the early token release option is used.
*YES: The early token release option is used. *YES can be specified only if the LINESPEED parameter contains the value 16M.
*NO: The early token release option is not used.

THRESHOLD

This parameter, and its values *OFF, *MIN, *MED, and *MAX, can be specified but it is not used by the system starting in release V2R3M0. The parameter may be removed in a later release.

ACCTYPE

Specifies the type of access to the ATM network.
*SVC: This line represents a LAN emulation client using switched virtual circuits.
*PVC: This line represents a LAN emulation client using a permanent virtual circuit.

PVCID

Specifies the virtual path identifier and virtual circuit identifier pairs associated with this permanent virtual circuit.

Note: PVCID required if ACCTYPE(*PVC) is specified.

Element 1: Virtual Path Identifier
virtual-path-id: Specify a number that represents the virtual path identifier. This number must be in the range of 0 to 7.
Element 2: Virtual Circuit Identifier
virtual-circuit-id: Specify a number that represents the virtual circuit identifier. This number must be in the range of 32 to 4095.

USELECSADR

Specifies whether the LAN emulation configuration server (LECS) should be connected to request the remote LAN emulation server (LES) address.
*YES: The LECS address is used.
*NO: The LECS address is not used.

LESATMADR

Specifies the ATM network address of the remote LAN emulation server.

Note: This parameter must be other than *NONE if USELECSADR(*NO) is specified.

Single Value
*NONE: ATM network address is not used.
Element 1: Network prefix
network-prefix: Specify the network prefix of the ATM address of the remote server. This is a 26 digit hexadecimal value.
Element 2: End system identifier
end-system-identifier: Specify the end system identifier of the remote server. This is a 12 digit hexadecimal value.
Element 3: Selector byte
selector byte: Specify the selector byte of the remote server. This is a two digit hexadecimal value.

EMLLANNAME

Specifies the emulated LAN name.
*NONE: Emulated LAN name not used.
emulated-LAN-name: Specify the emulated LAN name. A maximum of 32 characters may be specified.

LECDSCTIMO

Specifies the amount of time in minutes a LAN emulation (LE) client will wait before disconnecting an idle virtual circuit connection to another client.
10: The LE client will wait 10 minutes.
*NOMAX: The LE client will wait indefinitely.
LEC-disconnect-timeout: Specify the number of minutes the LE client will wait before disconnecting an idle virtual circuit connection to another client. The value must be in the range of 1 to 30 minutes.

LINKSPEED

Specifies the link speed in bits per second (bps). This parameter is valid only if APPN* support is used on the system.
16M: A link speed of 16 million bits per second (Mbps) is used.
4M: A link speed of 4 million bits per second is used (Mbps).
10M: A link speed of 10 million bits per second (Mbps) is used.
100M: A link speed of 100 million bits per second (Mbps) is used.
*MIN: The minimum link speed is used.
*MAX: The maximum link speed is used.
link-speed: Specify the link speed. Valid values range from 1200 to 603979776000.

COSTCNN

Specifies the relative cost of being connected on the line. This parameter is required only if APPN* support is used on the system.
0: The format of this tape is QIC5010, which is used for 1/4 inch cartridge tapes that can hold 13.5 gigabytes of data.
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.
0: The cost per byte is 0.
cost-per-byte: Specify a value ranging from 0 through 255.

SECURITY

Specifies the security level of the physical line. This parameter is used only if APPN is used on the system.
*NONSECURE: Normal priority is used.
*PKTSWTNET: A packet switched network is used. Data does not always follow the same path through the network.
*UNDGRDCBL: An underground cable is used.
*SECURECND: A secure, unguarded conduit (for example, a pressurized pipe) is used.
*GUARDCND: A guarded conduit, which is protected against physical tapping, is used.
*ENCRYPTED: Data flowing on the line is encrypted.
*MAX: A guarded conduit, protected against physical and radiation tapping, is used.

PRPDLY

Specifies the level of propagation delay on the line. This parameter is valid only if APPN* support is used on the system. The order of the values from shortest to longest delay is *MIN, *LAN, *TELEPHONE, *PKTSWTNET, and *SATELLITE.
*MIN: The minimum propagation delay is used.
*LAN: The local area network propagation delay is used.
*TELEPHONE: The telephone propagation delay is used.
*PKTSWTNET: The packet switched network propagation delay is used.
*SATELLITE: The satellite propagation delay is used.
*MAX: The maximum propagation delay is used.

USRDFN1

Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.
128: The value 128 is used.
user-defined-1: Specify a value ranging from 0 through 255.

USRDFN2

Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.
128: The value 128 is used.
user-defined-2: Specify a value ranging from 0 through 255.

USRDFN3

Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.
128: The value 128 is used.
user-defined-3: Specify a value ranging from 0 through 255.

AUTOCRTCTL

Specifies whether the system will automatically create controller descriptions when calls are received from adjacent systems on the local area network (LAN).
*NO: The system will not automatically create a controller description when incoming calls are received.
*YES: The system will automatically create a controller description when incoming calls are received.

AUTODLTCTL

Specifies the number of minutes an automatically created controller can remain in an idle state (switched from varied on to varied on pending) before the controller description and attached device descriptions are varied off and deleted.
1440: The controller description can be idle for 1440 minutes (24 hours).
*NONE: The system will not automatically delete or vary off the automatically configured, idle controller descriptions.
wait-time: Specify the number of minutes to wait before deleting the automatically configured, idle controller descriptions for this line. Valid values range from 1 to 10000 minutes.

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

CMNRCYLMT

Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.
Element 1: Maximum Recovery Limit
2: Two recovery attempts are made within the interval specified.
count-limit: Specify the number of recovery attempts to be made. Valid values range from 0 through 99.
Element 2: Recovery Time Interval
5: A 15-second time-out period is used.
time-interval: Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.
Other Single Value
*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

AUT

Specifies the authority given to users who do not have specific authority to the line description, who are not on an authorization list, and whose user group has no specific authority to the line description.
*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.
*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.
*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the line description.
*USE: The user can perform basic operations on the line description, such as running a program or reading a file. The user cannot change the line description. *USE authority provides object operational authority, read authority, and execute authority.
*EXCLUDE: The user cannot access the line description.
authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the line description. More information on this parameter is in Commonly used parameters.
*BLANK: Text is not specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Examples for CRTLINTRN
Example 1: Creating a Token-Ring Line Description
CRTLINTRN LIND(TRLAN1) RSRCNAME(LIN011) TEXT('TOKEN-RING LINE')

This command creates a token-ring line (TRLAN1) with resource name LIN011 and exchange identifier 05612345.
Example 2: Creating a Token-Ring Line Description
CRTLINTRN LIND(TRNLIN) RSRCNAME(*NWSD) NWSD(REMODEL 2)

This command creates a token-ring line description named TRNLIN that is attached to port 2 of network server REMODEL.
Error messages for CRTLINTRN
*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.