CRTNWIISDN (Create Network Interface Description for ISDN) Command Description

CRTNWIISDN Command syntax diagram

 

Purpose

The Create Network Interface Description for ISDN (CRTNWIISDN) command creates a network interface description for an integrated services digital network (ISDN) attachment.

 

Required Parameters

NWID

Specifies the name of the network interface description.

RSRCNAME

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

 

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 type of integrated services digital network (ISDN) to which the system is attached. The value specified on this parameter is used to determine the defaults for several parameters that are dependent on the type of ISDN to which the system is attached.

*NETATR: This value indicates that the default network type specified in the network attributes are used. The values of the parameters in the network attributes for the system can be displayed by using the Display Network Attributes (DSPNETA) command. If no value is specified on the DFTNETTYPE parameter, the user should specify one by using the Change Network Attributes (CHGNETA) command.

*ATT: This value is used when attaching to an ISDN that uses the AT&T Generic interface.

*DBP1TR6: This value is used when attaching to an ISDN controlled by Germany's post telephone and telegraph administration (PTT). (Deutsche Bundespost 1TR6).

*ETSI: This value is used when attaching to an ISDN that uses the European interface (ETSI, also known as EuroISDN standard).

*JAPAN: This value is used when attaching to an ISDN that uses the Japanese interface.

*NISDN: This value is used when attaching to an ISDN that uses National ISDN-1 or National ISDN2 standard for North America.

*NORTEL: This value is used when attaching to an ISDN that uses the Northern Telecom interface.

*ATTG3: This value is used when attaching to an ISDN in the United States or Canada that uses AT&T Definity G3i switching equipment. This is used only for the IBM CallPath Server for AS/400 product.

RATE

Specifies the rate used by the system.

*BASIC: A basic rate interface is used by the system.

*PRIMARY: A primary rate interface is used by the system.

CHLENTRY

Specifies a channel entry corresponding to a B channel associated with the network interface. The user can specify up to two B channel entries for a basic rate interface.

Element 1: Channel Number

*SWTALL: This value is used for all switched B channels.

*D: This value is used for one nonswitched D channel.

channel-number: Specify the B-channel number. Valid values are based on the number of channels allowed for specific NETTYPE. If the RATE specified is for basic rate service, only 2 channels can be selected. For a NETTYPE of *ETSI and RATE of *PRIMARY, up to 30 channels can be selected. All other primary rate services will allow up to 23 channels to be selected.

Element 2: Channel Connection

*SWT: This value is used for switched connections.

*NONSWT: This value is used for nonswitched (permanent) connections.

Element 3: Line Description

line-description: Specify an existing line description. Names of ISDN data link control (IDLC), network, Point to Point Protocol (PPP) and X.25 line descriptions can be specified.

Note:

A D channel can only be specified with one network line description, while a B channel can be specified with an IDLC or PPP or X.25 line description.

PCLENTRY

Specifies a list of protocols used and protocol-specific information.

*PPPMAX: Specifies the PPP protocol. The associated microcode is preloaded, and the maximum number of channels based on NETTYPE are available for use.

*IDLCMAX: Specifies the IDLC protocol. The associated microcode is preloaded, and the maximum number of channels based on NETTYPE are available for use.

*X25MAX: Specifies the X.25 protocol. The associated microcode is preloaded, and the maximum number of channels based on NETTYPE are available for use.

Element 1: Protocol Used

*PPP: The PPP protocol is used.

*IDLC: The IDLC protocol is used.

*X25: The X.25 protocol is used.

Element 2: Preload Microcode

*LOAD: Microcode is preloaded. Preloading allows the system to report faster to incoming calls at vary-on time, since the necessary tasks are already in place.

*NOLOAD: Microcode is not preloaded.

Element 3: Maximum Channels

*MAX: The maximum number of channels for this network interface description (NWID) that are available for use by the specified protocol based on the RATE and NETTYPE parameters.

*NONE: The maximum number of channels is not specified.

maximum-channels: Specify the maximum number of channels to be used based on the specified RATE and NETTYPE parameters.

LCLNBR

Specifies the local number for this system in the ISDN network. The local number can be up to 40 characters long. Special characters are used to delimit the number; see the RMVCHR parameter.

*CNNL: The system determines the local number by using the connection list object specified for the call.

'local-number': Specify up to 40 characters for the local number. A maximum of two numbers can be specified when the NETTYPE is *ATT or *NISDN or *NORTEL and the RATE is *BASIC. The second LCLNBR is used when a second SPID number is specififed.

LCLNBRTYPE

Specifies the type of local number specified on the LCLNBR parameter.

*NETTYPE: The system determines the local number type by using the value specified on the NETTYPE parameter.

*UNKNOWN: The local number type is not known.

*INTERNATL: The local number is an international number type.

*SUBSCRIPTION: The local number is a subscription number type.

*NATIONAL: The local number is a national address type.

*NETSPECIFIC: The local number type is specific to the network.

*ABR: The local number type is abbreviated.

LCLNBRPLAN

Specifies the numbering plan used for the local number.

*NETTYPE: The numbering plan is determined by the value specified on the NETTYPE parameter.

*UNKNOWN: The numbering plan is not known.

*ISDN: The ISDN E.164 numbering plan is used.

*DATA: The data numbering plan is used.

*NATIONAL: The national numbering plan is used.

*PRIVATE: A private numbering plan is used.

LCLNBRPSN

Specifies the intention of the calling user for the presentation of the local number to the called user. This parameter applies only to outgoing calls.

*NONE: The local number presentation is not encoded. The network determines whether the local number is presented to the called user.

*ALLOW: The local number is presented to the called user.

*RESTRICT: The presentation of the local number to the called user is restricted by the network.

RMVCHR

Specifies the characters to be removed from the local number. Extra characters are removed from the numbers before sending or comparing them. The ability to shorten numbers prior to their use by the system means the user can insert extra characters in numbers to make them more organized and readable.

*NETTYPE: The system determines the characters to be removed using the value specified on the NETTYPE parameter.

*NONE: No characters are removed.

'character': Specify up to 10 characters to be removed.

AUTOSPID

Specifies whether Automated service profile identifier detection (SPID) Selection procedures are to be used. When AUTOSPID = *YES is specified, procedures are used to allow the network to download the SPID parameters to the adapter. In this case all other SPID values will be ignored. This parameter is only valid when RATE is *BASIC and NETTYPE is *ATT or *NISDN or *NORTEL. Contact your network service provider to determine if they provide Auto-SPID capability.

*NO: Auto service profile identifier detection will not be used.

*YES: Auto service profile identifier detection will be used.

SPID

Specifies the SPID to be used in an exchange of information between the system and the network when communications are initialized. The SPID value is assigned by and can be obtained from the network provider when the user subscribes to the network.

Element 1: SPID Number

SPID-number: Specify the SPID number. Valid values are 1 and 2.

Element 2: SPID Value

*NONE: No SPID is used for the exchange.

SPID-value: Specify the service profile identifier. A minimum of 9 characters are required, and no more than 20 characters can be specified.

Note: The second SPID number is used when a second LCLNBR is specified.

X31NFYCLS

Specifies the method for the packet handler in the ISDN to notify the system of an incoming packet mode call.

*NETTYPE: The method of notifying the system is determined by the value specified on the NETTYPE parameter.

*NONE: The packet handler provides no notification.

*CONDITIONAL: The packet handler provides notification only if a packet mode call cannot be delivered on an existing connection.

*UNCONDITIONAL: The packet handler provides notification for every packet mode call.

SETUPDIF

Specifies the defaults used to send SETUP messages to the network.

*NONE: The defaults for sending SETUP messages are used: High Layer Compatibility IE is not sent; Low-Lay Compatibility IE is sent; Bearer Capability IE is sent in the SETUP message; and Terminal Capability IE is not sent in the SETUP message.

*NOLLCIE: The Low-Layer Compatibility IE (Information Element) is not sent with the SETUP message.

X31DIF

Specifies network-specific differences in X.31 Case B operations.

*NETTYPE: The system determines whether X.31 call data is checked depending on the value specified on the NETTYPE parameter.

*NONE: There are no differences in packet mapping.

*NOCALLINGNETADR: The call data does not contain a calling network address.

*NOCALLEDNETADR: The call data does not contain a called network address.

*NOCALLUSERDATA: The call data does not contain user data.

ACTTMR

Specifies the amount of time in tenths of a second, allowed for the interface activation process to complete.

*NETTYPE: The system determines the amount of time allowed by using the value specified on the NETTYPE parameter.

activation-timer: Specify a value ranging from 10 through 300 in 0.1-second intervals.

REACTTMR

Specifies the amount of time allowed for interface reactivation to occur following a temporary loss of synchronization.

*NETTYPE: The system determines the amount of time allowed by using the value specified on the NETTYPE parameter.

*NONE: The system does not wait for reactivation to occur.

*WAIT: The system waits indefinitely for the reactivation to occur.

reactivation-timer: Specify a value ranging from 10 through 1800 in 0.1-second intervals.

SHORTHAUL

Specifies the short haul distance in feet for ISDN primary rate line which is connected to a network via a Channel Service Unit (CSU) or NT-1 which is external to the adapter. This choice is only available for primary rate service and LONGHAUL has not been specified.

*MAX133: The system will use a distance of 0 to 133 feet or 0 to 41 meters.

*MAX266: The system will use a distance of 133 to 266 feet or 41 to 81 meters.

*MAX399: The system will use a distance of 266 to 399 feet or 81 to 122 meters.

*MAX533: The system will use a distance of 399 to 533 feet or 122 to 162 meters.

*MAX655: The system will use a distance of 533 to 655 feet or 162 to 200 meters.

*NONE: The system will use the value defined for the LONGHAUL parameter.

LONGHAUL

Specifies the long haul line build out (LBO) for a ISDN primary rate line which is directly attached to the network service provider. The LBO parameter is in units of decibels and is used to match the signal characteristics of the adapter and the transmission line to the network. Contact your network service provider to obtain the proper value for this parameter. This choice is only available for primary rate service and SHORTHAUL has not been specified.

0.0: The system will use 0.0 decibels (dB).

7.5: The system will use 7.5 dB.

15.0: The system will use 15.0 dB.

22.5: The system will use 22.5 dB.

CLOCK

Specifies that clock source used for primary rate service.

*LOOP: The system will use a loop timing.

*LOCAL: The system will use a local timing.

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: Count 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: 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 Values

*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 description, who are not on an authorization list, and whose user group has no specific authority to the network interface 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 network interface description.

*USE: The user can perform basic operations on the network interface description, such as running a program or reading a file. The user cannot change the network interface description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the network interface 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 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 CRTNWIISDN

CRTNWIISDN   NWID(ISDNNET)  RSRCNAME(LIN011)
  NETTYPE(*ATT)  CHLENTRY((1) (2 *NONSWT))

This command creates a network interface description named ISDNNET which uses the resource associated with resource name LIN011. The network interface description is configured to attach to an ISDN which conforms to the AT&T generic basic rate, and uses the first B channel for switched circuit calls and the second B channel for nonswitched circuit calls.

Error messages for CRTNWIISDN

*ESCAPE Messages

CPF27A0

Network interface description &1 not created due to errors.