CRTNWIFR (Create Network Interface (Frame Relay Network)) Command Description
CRTNWIFR Command syntax diagram
Purpose
The Create Network Interface (Frame-Relay Network) (CRTNWIFR) command
creates a network interface for a frame-relay (FR) network. More information
about using this command is in the Communications Configuration 
book.
Required Parameters
- NWID
- Specifies the name of the network interface description.
network-interface-description-name: Specify the name of a network interface description.
- 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 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.
resource-name: Specify a resource name.
Optional Parameters
- ONLINE
- Specifies whether this object is automatically varied on at initial program
load (IPL).
*YES: The network interface is automatically varied on at IPL.
*NO: This network interface is not automatically varied on at IPL.
- VRYWAIT
- Specifies whether the network interface is varied on asynchronously or
synchronously. For a synchronous vary on, 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 network interface 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 network interface is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
Notes
- Specifying a wait time in the network interface description affects system
IPL time, if ONLINE(*YES) is used, by the amount of time it takes to
synchronously vary on the network interface or reach the wait-time value.
- The time required to vary on a network interface is the time it takes to put tasks in place to manage the network interface, to activate the communications I/O processor (IOP) (including downloading the IOP model-unique Licensed Internal Code), and to establish communications with the data circuit-terminating equipment (DCE). Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, network interface protocol, and other factors.
- Specifying a wait time in the network interface description affects system
IPL time, if ONLINE(*YES) is used, by the amount of time it takes to
synchronously vary on the network interface or reach the wait-time value.
- DLCI
- Specifies the data link connection identifiers of the line descriptions for
the frame relay network interface being created.
*NONE: No data link connection identifier is specified.
Element 1: DLCI Number
DLCI-number: Specify the DLCI number for the line.
Element 2: Line description
line-description: Specify the DLCI line description.
- NRZI
- Specifies whether non-return-to-zero-inverted (NRZI) data encoding is used
for modems that are sensitive to certain bit patterns in the data stream. This
ensures that the signal does not stay the same for an extended period of time.
Note: All data communications equipment on the line must use the same transmission method.
*NO: NRZI data encoding is not used.
*YES: NRZI data encoding is used.
- INTERFACE
- Specifies the type of physical interface on the input/output adapter (IOA)
port.
*RS449V36: An RS-499/V.36 physical interface is used. This value is valid only for frame relay and SDLC links.
*V35: A V.35 physical interface is used. This value is valid only for frame relay, BSC, and SDLC links.
*X21: An X.21 physical interface is used. This value is valid only for frame relay, X.25, and SDLC links.
- CLOCK
- Specifies the method in which the clocking function is provided for the
network interface.
*MODEM: The modem provides the clocking.
*LOOP: The system inverts the clock from the modem and uses it as the transmit clock on the line.
*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.
Note: CLOCK(*LOOP) is not valid when INTERFACE(*RS449V36) or INTERFACE(*V35) is specified.
- LINESPEED
- Specifies the line speed in bits per second (bps)
1536000: The line speed is 1536000 bps.
56000: The line speed is 56000 bps.
64000: The line speed is 64000 bps.
128000: The line speed is 128000 bps.
192000: The line speed is 192000 bps.
256000: The line speed is 256000 bps.
320000: The line speed is 320000 bps.
384000: The line speed is 384000 bps.
448000: The line speed is 448000 bps.
512000: The line speed is 512000 bps.
1024000: The line speed is 1024000 bps.
1536000: The line speed is 1536000 bps.
2048000: The line speed is 2048000 bps.
line-speed: Specify the line speed. Valid values range from 56000 bps through 2048000 bps.
- LMIMODE
- Specifies whether the local management interface (LMI) for this adapter is
configured as terminal equipment or a frame handler.
*TE: The local system is configured to interface with a frame relay network as terminal equipment. The frame relay network must be set to operate at ANSI T1.617 Annex D, to be compatible with iSeries 400 link management frames.
*FH: The local system is configured to interface with another system as a frame handler. In this configuration, the local system is performing as the frame relay network.
*ANNEXA: The local system is configured to interface with a frame relay network as terminal equipment. The frame relay network must operate as an ITU (previously CCITT) Q.933 Annex A to be compatible with iSeries 400 link management frames.
*NONE: The local system is configured to interface with the frame relay network or another system without performing any LMI function.
- POLLITV
- Specifies the rate of the polling cycle. The polling cycle consists of a
status enquiry message and a status message exchange. The status message
includes the status of the DLCI.
10: A polling interval of 10 seconds is used.
polling-interval: Specify the polling interval to be used within a 5 to 30 second range.
- FULLINQITV
- Specifies the number of polling cycles that occur before a full status
inquiry is requested.
6: A full inquiry interval of 6 polling cycles is used.
full-inquiry-interval: Specify the number of polling cycles for a full status cycle to be requested. Valid values range from 1 through 255.
- 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 network interface, who are not on an authorization list, and whose user
group has no specific authority to the network interface.
*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 network interface.
*USE: The user can perform basic operations on the network interface, such as running a program or reading a file. The user cannot change the network interface. *USE authority provides object operational authority, read authority, and execute authority.
*EXCLUDE: The user cannot access the network interface.
authorization-list-name: Specify the name of the authorization list used.
- TEXT
- Specifies the text that briefly describes the network interface. 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 CRTNWIFR
CRTNWIFR NWID(THISONE) RSRCNAME(LINE031) ONLINE(*YES) VRYWAIT(15) DLCI((32 LINEABC) (409 LINEDEF) (94 LINELAST)) INTERFACE(*V35) LMIMODE(*TE)
This command creates the frame relay network interface THISONE. THISONE represents the resource named LINE031. THISONE is varied on at initial program load (IPL) with a vary on wait time of 15 seconds. It is created with three DLCIs (32, 409, and 94) which refer to line descriptions LINEABC, LINEDEF, and LINELAST respectively. The type of physical interface for the input/output adapter (IOA) port specified by THISONE is *V35. The local management interface mode is configured to interface with a frame relay network as terminal equipment (TE).
Error messages for CRTNWIFR
*ESCAPE Messages
- CPF27A0
- Network interface description &1 not created due to errors.