CHGNWIISDN (Change Network Interface Description for ISDN) Command Description

CHGNWIISDN Command syntax diagram

 

Purpose

The Change Network Interface Description for ISDN (CHGNWIISDN) command changes a network interface description for an integrated services digital network (ISDN) attachment.

 

Required Parameters

NWID

Specifies the name of the network interface description.

 

Optional Parameters

RSRCNAME

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

*SAME: The value does not change.

resource-name: Specify the resource name.

ONLINE

Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME: The value does not change.

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

*SAME: The value does not change.

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

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

*SAME: The value does not change.

*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 NETTYPE. If the NETTYPE specified is for basic rate service, only 2 channels can be selected. For a NETTYPE of *ETSI, 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.

PCLENTRY

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

'local-number': Specify the local number. A maximum of two numbers can be specified when NETTYPE is *ATT or *NISDN or *NORTEL. A second local number can be specified only when a second SPID number is used.

LCLNBRTYPE

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

*SAME: The value does not change.

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

*SAME: The value does not change.

*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 whether the calling user presents the local number to the called user. This parameter applies only to outgoing calls.

*SAME: The value does not change.

*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 up to 10 characters to be removed from local number before the number is used by the system. Extra characters are removed from numbers before sending or comparing the numbers. The ability to shorten numbers prior to their use by the system means the user can insert extra characters in numbers to help make them more organized and readable.

*SAME: The value does not change.

*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 Automatic service profile identifier detection (SPID) Selection procedures are to be used. When AUTOSPID is *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 the NETTYPE is *ATT or *NISDN or *NORTEL. Consult your network service provider to determine if they provide Auto-SPID capability.

*SAME: The value does not change.

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

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

SPID

Specifies the service profile identifier (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.

*SAME: The value does not change.

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: A second SPID number must be specified for the second LCLNBR to be used.

X31NFYCLS

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

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

X31DIF

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

*SAME: The value does not change.

*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 allowed in tenths of a second, for the interface activation process to complete.

*SAME: The value does not change.

*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 in tenths of a second, for interface reactivation to occur following a temporary loss of synchronization.

*SAME: The value does not change.

*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 reactivation to occur.

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

SHORTHAUL

Specifies that short haul distance in feet for an 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 when primary rate service is selected and LONGHAUL has not been specified.

*SAME: The value does not change.

*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 by the LONGHAUL parameter.

LONGHAUL

Specifies that long haul line build out (LBO) for an 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 when primary rate service is selected and SHORTHAUL has not been specified.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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

*SAME: The value does not change.

*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

Element 1: Count Limit

count-limit: Specify the number of recovery attempts to be made. Valid values range from 0 through 99.

Element 2: Time Interval

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.

TEXT

Specifies the text that briefly describes the network interface description. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGNWIISDN

CHGNWIISDN   NWID(ISDNNET)  RSRCNAME(LIN021)

This command changes the resource name for the network interface described name ISDNNET to LIN021.

Error messages for CHGNWIISDN

*ESCAPE Messages

CPF27A7

Network interface description &1 not changed due to errors.