CRTLINFR (Create Line Description (Frame Relay Network)) Command Description

CRTLINFR Command syntax diagram

 

Purpose

The Create Line Description (Frame-Relay Network) (CRTLINFR) command creates a line description for a frame-relay network (FR) line. More information about using this command is in the Communications Configuration Link to PDF book.

 

Required Parameters

LIND
Specifies the name of the line description being created.

line-description-name: Specify the name of a line description.

 

Optional Parameters

NWI
Specifies, for a nonswitched connection, the frame relay network interface description containing the DLCI to which this line permanently attaches. If a DLCI is not specified for the network interface, a description cannot be specified. If a DLCI is specified for the network interface, a description must be specified.

*NONE: A network interface description is not specified.

NWI-name: Specify the name of the network interface to which this line permanently attaches.

NWIDLCI
Specifies the data link control identifier (DLCI) number for the network interface, which is supplied by the network provider. Valid DLCI values range from 1 through 1018.

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

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

  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.

MAXCTL
Specifies the maximum number of controllers supported by a line.

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. The recommended MAXFRAME values are: 502, 1014, 1590, 2038, 4086, and 8182 bytes.

1590: The maximum frame size is 1590 bytes.

maximum-frame-size: Specify the maximum frame size value to be used. Valid values range from 265 through 8182.

LINKSPEED
Specifies the link speed in bits per second (bps). This parameter is valid only if APPN* support is used on the system.

64000: The link speed is 64000 bps.

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.

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.

*SYSGEN: The system automatically creates three SSAPs: hex 04 for Systems Network Architecture (SNA) applications, hex C8 for high-performance routing (HPR) applications, and hex AA for Transmission Control Protocol/Internet Protocol (TCP/IP) applications.

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 TCP/IP applications, the SSAP must be AA.

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

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). Valid values for this parameter range from 265 through 8182 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.

NETCTL
Specifies the name of an existing network controller.

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 valid only if APPN* support is used on the system.

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

*NONSECURE: Normal priority is used.

*UNDGRDCBL: An underground cable is used.

*SECURECND: A secure, unguarded conduit (for example, a pressurized pipe) is used.

*GUARDCND: A guarded conduit, which is protected against physical tapping, is used.

*ENCRYPTED: Data flowing on the line is encrypted.

*MAX: A guarded conduit, protected against physical and radiation tapping, is used.

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

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

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

*MIN: The minimum propagation delay is used.

*TELEPHONE: The telephone propagation delay is used.

*SATELLITE: The satellite propagation delay is used.

*MAX: The maximum propagation delay is used.

USRDFN1
Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

128: The value 128 is used.

user-defined-1: Specify a value ranging from 0 through 255.

USRDFN2
Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

128: The value 128 is used.

user-defined-2: Specify a value ranging from 0 through 255.

USRDFN3
Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

128: The value 128 is used.

user-defined-3: Specify a value ranging from 0 through 255.

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

Single Values

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

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

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

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.

Example for CRTLINFR 

CRTLINFR   LIND(FRLIN)  NWI(NEWONE)  NWIDLCI(1001)
  ONLINE(*YES)  VRYWAIT(*NOWAIT)  MAXFRAME(1600)
  LINKSPEED(2400)

This command creates frame relay line FRLIN. FRLIN is attached to a frame relay NWI named NEWONE using DLCI number 1001. FRLIN is automatically varied on at initial program load (IPL). The system does not wait for the vary on to complete; therefore, the line is varied on asynchronously. The maximum frame size for this line is 1600 and the link speed is 2400 bits per second (bps).

Error messages for CRTLINFR

*ESCAPE Messages

CPF2718
Line description &1 not created due to errors.