CRTLINDDI

CRTLINDDI (Create Line Description (DDI Network))

CRTLINDDI Command syntax diagram

Purpose

The Create Line Description (Distributed Data Interface) (CRTLINDDI) command creates a line description for a data-description interface line such as an FDDI (Fiber Distributed Data Interface) local area network. More information about using this command is in the Communications Configuration book.

Required Parameters

LIND

Specifies the name of the line description being created.

RSRCNAME

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

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified on 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 specified on the attached frame relay network interface description is 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.

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.

MAXFRAME

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

Note: The MAXFRAME value is provided by your telephone carrier from which subtract 44 bytes for the size of the header.

4105: The maximum frame size is 4105 bytes.

Note: This value changes to 1556 when RSRCNAME(*NWID) is specified.

maximum-frame-size: Specify the maximum frame size. Valid values range from 265 through 4444 bytes.

LOGLVL

Specifies the error logging level used by the DDI local area network (LAN) manager. This parameter is used to determine whether unsolicited LAN errors are logged. These messages are logged in either the QHST message queue or the QSYSOPR message queue.

Note: The LOGLVL parameter is not used when RSRCNAME(*NWID) is specified.

*OFF: Errors are not monitored.
*ERRORS: Logs LAN manager error messages only.
*ALL: Logs LAN manager error messages and informational messages.

LCLMGRMODE

Specifies whether this station is an observing network manager. An observing network manager logs network error messages and informational messages for this and other stations on the ring. These messages are logged in either the QHST message queue or the QSYSOPR message queue.
Examples of information available in observing mode only include errors on remote stations that do not affect general ring operation, or information about stations that are joining or leaving the ring.

Note: The LCLMGRMODE parameter is not used when RSRCNAME(*NWID) or LOGLVL(*OFF) is specified.

*OBSERVING: The LAN manager function of this station retrieves information generated by all adapters.
*NONE: The LAN manager function of this station only retrieves information generated by the local adapter.

Note: A local area network manager logs only those messages that pertain to this station and its ability to access the ring when (*NONE) is specified.

NWI

Specifies an attached nonswitched frame relay NWI.

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 an attached nonswitched frame relay NWI.

NWIDLCI

Specifies the data link control identifier (DLCI) for the network interface.

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: A DLCI is not specified for the network interface.
data-link-connection-ID: Specify the DLCI for the network interface to which this line permanently attaches. Valid values range from 1 through 1018.

ADPTADR

Specifies the 12-character hexadecimal adapter address.

Note: ADPTADR(*ADPT) cannot be specified when RSRCNAME(*NWID) is specified.

*ADPT: This value gives the user the preset DDI default address for this DDI adapter card. The user may display this by doing a DSPLIND on this line description after it has successfully varied on.
local-adapter-address: Specify an address for this system in the DDI network. Valid values range from hexadecimal 400000000000 through 7FFFFFFFFFFF.

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 an exchange identifier composed of eight hexadecimal digits starting with 056.

SSAP

Specifies source service access points (SSAPs). This is the hexadecimal logical address used to route incoming data from the bus to the proper user. A maximum frame size can be specified for each SSAP. Valid SSAP values are AA (for TCP/IP), and 04 through 9C divisible by 4 (for SNA).
The destination service access point (DSAP), specified by the remote controller, must match one of the SSAPs specified in order for communication to occur. All SSAP values must be unique.
*SYSGEN: The system automatically creates three SSAPs, hex 04 for SNA, and hex AA for TCP/IP applications.
Element 1: SSAPs
source-service-access-point: Specify up to 24 SSAPs using valid SSAP values.
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 may be transmitted or received). Valid values for this parameter range from 265 through 4444 bytes, but must not exceed the value of the MAXFRAME parameter.
Element 3: SSAP Type
*CALC: The system determines the SSAP type based on the following values:

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

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

*SNA: The SSAP is used for SNA communications. Valid values range from 04 through 9C and must be divisible by 4.
*NONSNA: The SSAP is used for non-SNA communications. Valid values range from 02 through FE and must be divisible by 2.

NETCTL

Specifies the name of an existing network controller.

GRPADR

Specifies the distributed data interface group addresses used. Group addresses must each be specified as a 12-digit hexadecimal number. Valid values range from 800000000000 through FFFFFFFFFFFE.
*NONE: No group addresses are specified.
group-address: Specify the group addresses to be used.

TKNRTTTIME

Specifies the token rotation time requested. This value is used when the station bids on the network. The lowest value of all attached stations on a ring determines the value the ring uses.

Note: TKNRTTTIME(*CALC) must be specified when RSRCNAME(*NWID) is specified.

*CALC: The system calculates the value based on the type of line that is linked to the controller.
token-rotation-time: Specify a value ranging from 4 through 167 milliseconds.

LINKSPEED

Specifies the link speed in bits per second (bps). This parameter is valid only if APPN* support is used on the system.
*MAX: The maximum link speed is used.
4M: A link speed of 4 million bits per second is used (Mbps).
*MIN: The minimum link speed is used.
link-speed: Specify the link speed. Valid values are: 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 64000, 112000, 128000, 168000, 192000, 224000, 256000, 280000, 320000, 336000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, 10M, and 16M.

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.
*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.
*LAN: The local area network propagation delay is used.
*PKTSWTNET: The packet switched network propagation delay is used.
*MIN: The minimum propagation delay is used.
*TELEPHONE: The telephone propagation delay is used.
*SATELLITE: The satellite propagation delay is used.
*MAX: The maximum propagation delay is used.

USRDFN1

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

USRDFN2

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

USRDFN3

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

AUTOCRTCTL

Specifies whether the system automatically creates controller descriptions when calls are received from adjacent systems on the local area network (LAN).
*NO: The system does not automatically create a controller description when incoming calls are received.
*YES: The system automatically creates 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 does 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 10,000 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 the user is granting to a user who does not have specific authority to an object, who is not on the authorization list, or whose user groups have no specific authority to the object.
*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 control the object's existence, specify the security for the object, change the object, change the owner for the object, and perform basic functions on the object. All authority allows the user to perform all operations on the object except those limited to the owner, or controlled by authorization list management authority.
*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 an authorization list. Users included on the authorization list are granted authority to the object as specified by the list. The authorization list must exist when the object is created.

TEXT

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

Example for CRTLINDDI
CRTLINDDI LIND(DDILAN1) RSRCNAME(LIN011) TEXT('Fiber Distributed Data Interface (FDDI) Line')

This command creates a DDI line description named DDILAN1 for an FDDI line installed on adapter LIN011 on the system.
Error messages for CRTLINDDI
*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.