CRTNWIATM (Create Network Interface (ATM Network))

CRTNWIATM Command syntax diagram

 

Purpose

The Create Network Interface (ATM) (CRTNWIATM) command creates a network interface for an Asynchronous Transfer Mode (ATM) 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

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

NETTYPE

Specifies the standard used by the ATM network.

*AUTO: The system automatically detects the network type, the first time the network interface is varied on. The reported network type will be set to *UNI30 or *UNI31.

*UNI30: The network uses the UNI3.0 standard. Switched virtual circuit (SVC) connections are used.

*UNI31: The network uses the UNI3.1 standard. Switched virtual circuit (SVC) connections are used.

*UNI40: The network uses the UNI4.0 standard. Switched virtual circuit (SVC) connections are used.>

*PVCONLY: The network uses only permanent virtual circuit (PVC) connections. No switched virtual circuit (SVC) connections are used.

MAXPMPSYS

Specifies the maximum number of end systems for all point to multipoint connections.

0: There will be a maximum of 0 end systems for all point to multipoint connections.

maximum-PMP-systems: Specify the maximum number of end systems for all point to multipoint connections. The value must be in the range of 0 to 2048.

SVCCNN

Specifies maximum number of switched virtual circuit connections that can be established by this network interface.

516: There can be a maximum of 516 switched virtual connections.

switched-virtual-connections: Specify the maximum number of switched virtual connections. This is a numeric value in the range of 16 to 2064.

NETSWTTIMO

Specifies the amount of time the ATM adapter card waits to make a connection to the network switch before ending a vary-on sequence with failing status.

2: ATM adapter card waits 2 minutes to make a connection to the network switch.

*NOMAX: There is no time limit to make a connection.

network-switch-time-out: Specify the amount of time the ATM adapter card waits to make a connection to the network switch. This is a numeric value in the range of 1 to 30 minutes.

PHYLYROPT

Specifies the control options for the physical interface.

*NONE: No control options are specified.

physical-layer-options: Specify the control options for the physical interface. This is a hexadecimal value in the range of 0000 to FFFF.

LINE

Specifies the line description name of a line attached to this network interface. The line descriptions must already exist. A maximum of one line descriptions may attach to this network interface.

line-name: Specify the name of a line description to be attached to this network interface.

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 CRTNWIATM

CRTNWIATM   NWID(NWIATM1)  RSRCNAME(LINE031)
  ONLINE(*YES)  VRYWAIT(15)

This command creates the ATM network interface NWIATM1. NWIATM1 represents the resource named LINE031. NWIATM1 is varied on at initial program load (IPL) with a vary on wait time of 15 seconds.

Error messages for CRTNWIATM

*ESCAPE Messages

None.