ADDCNNLE

ADDCNNLE (Add Connection List Entry)

ADDCNNLE Command syntax diagram

Purpose

The Add Connection List Entry (ADDCNNLE) command is used to add an entry to a connection list.

Required Parameters

CNNL

Specifies the name of the connection list to which this entry is added.

ENTRY

Specifies the name of the entry to be added to the connection list. Each entry in the connection list must have a unique name.

RMTNBR

Specifies the number of the remote system in the Integrated Services Digital Network (ISDN).
*ANY: Any value, including no value, specified in the received Called Party Number information element (IE) (encoded on the call by the system) is acceptable for incoming calls. For outgoing calls, the system requires the target number to be supplied so that a Called Party Number or Keypad Facility IE can be encoded on the outgoing call. Therefore, if *ANY is specified for an outgoing call, the call out attempt fails.
'remote-number': Specify the remote number (up to 32 characters enclosed in apostrophes). Extra characters, such as parentheses, can be used to aid in readability, if they are specified on the remove character (RMVCHR) parameter when the connection list was created using the Create Connection List (CRTCNNL) command.

Optional Parameters

RMTNBRTYPE

Specifies the type of remote number.
*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.

RMTNBRPLAN

Specifies the numbering plan used for the remote 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.

RMTSUBADR

Specifies the subaddress of the remote system.
*ANY: Any value, including none, specified in the received Called Party Subaddress IE is acceptable for incoming calls. For outgoing calls, no Called Party Subaddress IE is encoded.
remote-subaddress: Specify the subaddress of the remote system; up to 40 hex characters.

RMTSUBTYPE

Specifies the type of remote subaddress.
*NETTYPE: A default value is used based on the network type specified on the NETTYPE parameter when the connection list was created using the CRTCNNL command.
*NSAP: The remote subaddress type is NSAP (X.213).
*USER: Some of the common OS/400 objects and database physical files are included.

LCLNBR

Specifies information about the local number that is called for an incoming call. If the entry is used for an outgoing call this parameter is ignored.
*ANY: Any value, including no value, specified in the received Called Party Number IE is acceptable.
*NWID: Any value, including no value, specified in the received Called Party Number IE is acceptable. The number used for outgoing calls is determined by the network interface description.
'local-number': Specify the local number (up to 32 characters enclosed in apostrophes). For this entry, only calls directed at this local number are accepted. Extra characters, such as parentheses, can be used if they are specified on the remove character parameter (RMVCHR parameter).

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 to present the local number 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.

LCLSUBADR

Specifies the subaddress of the local system.
*ANY: Any value, including no value, specified in the Received Calling Party Subaddress IE is acceptable for incoming calls. For outgoing calls, no Called Party Subaddress IE is encoded.
*NWID: Any value, including no value, specified in the received Called Party Subaddress IE is acceptable for incoming calls. For outgoing calls, the Called Party Subaddress IE is encoded on the network interface description.
local-subaddress: Specify the local subaddress; up to 40 hex characters.

LCLSUBTYPE

Specifies the type of subaddress used by the local system.
*NETTYPE: A default value is used based on the network type specified on the NETTYPE parameter when the connection list was created using the CRTCNNL command.
*NSAP: The subaddress type is NSAP (X.213).
*USER: The subaddress type is user-specified.

INFTRFTYPE

Specifies the information transfer type. The information transfer type determines the layer-1 protocol.
*UNRESTRICTED: The data-channel traffic appears as digital information; no physical transformation is required and each B-channel operates at capacity (64k bits per second (bps)).
*V110: The transfer type is V-series Recommendation 110. Each B-channel operates at 56k bps.
*DOV Allows Data Over Voice (DOV) digital data to be transferred over an ISDN voice call. Also, this is referred to as Data Over Voice Bearer Service (DOVBS), Data Over Speech Bearer Service (DOSBS), TollSaver, or TollMizer. This option should only be used if an ISDN voice call is less expensive than an ISDN data call or if a bearer service for data is not available. The remote location must also support this feature. Data is transferred at 56Kbps in each direction.
*FAXMODEM: Allows Facsimile (FAX) data from the integrated fax modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a fax device on an analog telephone line or to another ISDN device that has Group 3 FAX modem capabilities. Data is transferred at fax speeds up to 14.4Kbps.
*ASYNCMODEM: Allows data from the integrated asynchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using an asynchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.
*SYNCMODEM: Allows data from the integrated synchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a synchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.

MDMINZCMD

Specifies the command string to send to set the modem.
*NONE: No command string is sent to the modem.
*LIND: The command string from the line description is used.
command-string: Specifies up to 60 characters that represent the command string sent to the modem. Valid characters are upper case A thru Z, lower case a thru z, numbers 0 thru 9, and special characters:

Table 1. Special characters

Character Description

. Period

< Less than sign

( Left parenthesis

+ Plus sign

& Ampersand

* Asterisk

) Right parenthesis

; Semicolon

- Minus sign

/ Slash

, Comma

_ Underline

> Greater than sign

? Question mark

: Colon

= Equal sign

Spaces

# Number sign

" Double quote

! Exclamation mark

@ At sign

^ Circumflex

% Percent

[ Left square bracket

] Right square bracket

\ Back slash

$ Dollar sign

TEXT

Specifies the text that briefly describes the entry in the connection list. More information is in Commonly used parameters.
*BLANK: Text is not specified.
'description': Specify a description of the entry. Specify up to 50 characters of text, enclosed in apostrophes.

Example for ADDCNNLE
ADDCNNLE CNNL(CHICAGO) ENTRY(CORPORATE) RMTNBR('(896) 999-5555')

This command adds entry CORPORATE in connection list CHICAGO. The entry will have (896) 999-5555 as a remote number.
Error messages for ADDCNNLE
*ESCAPE Messages

CPF266C

Connection list &1 not found.

CPF266F

Entry &2 not added to connection list &1.

Character	Description
.	Period
<	Less than sign
(	Left parenthesis
+	Plus sign
&	Ampersand
*	Asterisk
)	Right parenthesis
;	Semicolon
-	Minus sign
/	Slash
,	Comma
_	Underline
>	Greater than sign
?	Question mark
:	Colon
=	Equal sign
	Spaces
#	Number sign
"	Double quote
!	Exclamation mark
@	At sign
^	Circumflex
%	Percent
[	Left square bracket
]	Right square bracket
\	Back slash
$	Dollar sign