Add Configuration List Entries (ADDCFGLE)

Parameters

Keyword	Description	Choices	Notes
TYPE	Configuration list type	APPNDIR, APPNLCL, APPNRMT, APPNSSN, ASYNCADR, ASYNCLOC, RTLPASTHR, SNAPASTHR	Required, Positional 1
CFGL	Configuration list	Name	Optional
APPNLCLE	APPN local location entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Local location name	Communications name
	Element 2: Entry 'description'	Character value, *BLANK
APPNRMTE	APPN remote location entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Remote location name	Generic name, name, *ANY
	Element 2: Remote network identifier	Communications name, NETATR, NONE
	Element 3: Local location name	Communications name, *NETATR
	Element 4: Remote control point	Communications name, *NONE
	Element 5: Control point net ID	Communications name, NETATR, NONE
	Element 6: Location password	Character value, *NONE
	Element 7: Secure location	YES, NO, *VFYENCPWD
	Element 8: Single session	YES, NO
	Element 9: Locally controlled session	YES, NO
	Element 10: Pre-established session	YES, NO
	Element 11: Entry 'description'	Character value, *BLANK
	Element 12: Number of conversations	1-512, 10
ASYNCADRE	Async network address entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Network address	Character value
	Element 2: Dial retry	1-255, 2
	Element 3: Entry 'description'	Character value, *BLANK
ASYNCLOCE	Async remote location entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Remote location name	Communications name
	Element 2: Remote location identifier	Name
	Element 3: Entry 'description'	Character value, *BLANK
RTLPASTHRE	Retail pass-through entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Retail device	Name
	Element 2: SNUF device	Name
	Element 3: Default host program	Name
	Element 4: Entry 'description'	Character value, *BLANK
FTRCPNAME	Filtered control point name	Generic name, name, *ANY	Optional
FTRCPNETID	Filtered CP network identifier	Communications name, *NETATR	Optional
LCLLOCNAME	Local location name	Generic name, name, *ANY	Optional
FTRACN	Filter action	Character value, ACCEPT, REJECT	Optional
APPNDIRE	APPN directory search entries	Values (up to 300 repetitions): Element list	Optional
	Element 1: Filtered CP location name	Generic name, name, *ANY
	Element 2: Filtered CP location NETID	Communications name, *NETATR
	Element 3: Partner location name	Generic name, name, *ANY
	Element 4: Partner location network ID	Communications name, *NETATR
	Element 5: Entry 'description'	Character value, *BLANK
APPNSSNE	APPN session endpoint entries	Values (up to 300 repetitions): Element list	Optional
	Element 1: Remote location name	Generic name, name, *ANY
	Element 2: Remote network identifier	Communications name, *NETATR
	Element 3: Entry 'description'	Character value, *BLANK
GRPNAME	SNA pass-through group name	Name	Optional
DEV	SNA pass-through device desc	Values (up to 254 repetitions): Name	Optional
TEXT	Entry 'description'	Character value, *BLANK	Optional
SNAPASTHRE	SNA pass-through entry	Element list	Optional
	Element 1: SNA pass-through group name	Communications name
	Element 2: SNA pass-through device desc	Values (up to 254 repetitions): Communications name
	Element 3: Entry 'description'	Character value, *BLANK

Top

Configuration list type (TYPE)

Specifies the type of configuration list entry being added.

*APPNDIR: An advanced peer-to-peer networking* (APPN*) directory search filter configuration list is used.
*APPNLCL: An advanced peer-to-peer networking (APPN) local location list is used. Up to 476 APPN local location entries are allowed in the configuration list (using the CHGCFGL and CRTCFGL commands).
*APPNRMT: An APPN remote location list is used. Up to 1898 APPN remote location entries are allowed in the configuration list (using the CHGCFGL and CRTCFGL commands).
*APPNSSN: An APPN session end point filter configuration list is used.
*ASYNCADR: An asynchronous network address list is used. Up to 294 asynchronous network address entries are allowed in the configuration list.
*ASYNCLOC: An asynchronous remote location list is used. Up to 32000 asynchronous remote location entries are allowed in the configuration list.
*RTLPASTHR: A retail pass-through list is used. Up to 450 retail pass-through entries can be specified in the configuration list.
*SNAPASTHR: An SNA pass-through list is used. Up to 254 SNA pass-through entries can be specified in the configuration list.

APPN local location entry (APPNLCLE)

Specifies the APPN local location entry. This value is required if *APPNLCL is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

local-location-name: Specify the location name residing on the local system. This name is used by APPN to determine if the request coming in is for this system or another system in the network. The local location name must be unique and cannot already exist as a remote location name used by configuration list QAPPNRMT, or be specified on another system as a local location in the same APPN network.
entry-description: Specify a short description of 20 characters or less for each local entry.

APPN remote location entry (APPNRMTE)

Specifies the APPN remote location entry. This value is required if *APPNRMT is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

remote-location-name

Specify the full name of a remote location or a generic name ending with an asterisk (*). The generic location name is used to allow one directory entry to be defined for all locations, on a single control point, whose name matches the characters preceding the asterisk. You can also specify *ANY so the system will accept all requests sent through it. Generic entries are only allowed from network nodes.

remote-network-identifier

Specify the network identifier of the network in which the remote location resides. The default of *NETATR uses the LCLNETID value from the system network attributes.

local-location-name

Specify the location name residing on the local system. This name is used by APPN to match a local/remote location pair entry. The default of *NETATR uses the LCLLOCNAME value from the system network attributes.

control-point-name

Specify the control point providing network functions for the remote location. By using this control point name (directory entry for the remote location), the network is searched more efficiently to find the location. This field is required if the remote location name is generic. The default is *NONE.

control-point-network-identifier

Specify the network identifier of the network in which the control point resides. The default of *NETATR uses the LCLNETID value from the system network attributes.

location-password

Specify the password that is used when establishing sessions on the local location/remote location name pair. This value must contain an even number of hexadecimal characters. The default is *NONE.

secure-location

Specifies how security information is handled for program start requests received from remote systems. The value is sent to the remote system when sessions are established. It is used in determining how allocate or evoke requests should be built. The value only applies to conversations started with the SECURITY(SAME) level of security.

*NO: The remote system is not a secure location. Security validation done by the remote system is not accepted. SECURITY(SAME) conversations are treated as SECURITY(NONE). No security information will be sent with allocate or evoke requests.
*YES: The remote system is a secure location and the local system will accept security validation done by remote systems. For SECURITY(SAME) conversations, the local system allows the remote system to verify user passwords. On the remote system, user IDs are retrieved from the operating system. The user IDs are then sent with an already verified indicator in the allocate or evoke requests.
*VFYENCPWD: The remote system is not a secure location. For SECURITY(SAME) conversations, the remote system is not allowed to send the already verified indicator. On the remote system, user IDs and passwords are retrieved from the operating system. Passwords are then encrypted and sent with the user IDs in the allocate or evoke requests, to be verified by the local system. This value should only be used if the remote system is using i5/OS V3R2M0 or later. If the remote system does not support password protection then session establishment will not be allowed. For remote systems that support password protection, but do not support verification of encrypted passwords (VFYENCPWD), conversations will be treated as SECURITY(NONE).

number-of-conversations

Specify the number of conversations for a single session connection. The default number of conversations is 10. The default value must be used if single session is *NO. The valid range for the number of conversations is 1 through 512.

locally-controlled-session

Specify YES or NO to indicate whether a locally controlled session is allowed for this local location/remote location name pair. The default is *NO.

pre-established-session

Specify YES or NO to indicate whether the session is automatically bound when a connection is made between the local and remote location. The default is *NO.

entry-description

Specify a short description for each remote entry. The default is *BLANK.

Note: The combination of remote location name, network identifier, and local location name must be unique. Also, the remote location name can not already exist as a local location in configuration list QAPPNLCL, or as the current value for LCLLOCNAME or LCLCPNAME network attribute.

Async remote location entry (ASYNCLOCE)

Specifies the asynchronous remote location entry. This value is required if *ASYNCLOC is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

remote-location-name: Specify the name that, when combined with the remote location identifier, determines whether to accept an incoming call. It is the same as the name used in the remote system as it's local name. This value must be unique.
remote-location-identifier: Specify an identifier that, when combined with the remote location name, determines if an incoming call will be accepted. This identifier must be the same as the remote system has for its local identifier.
entry-description: Specify a short description for each remote location entry. The default is *BLANK.

Retail pass-through entry (RTLPASTHRE)

Specifies the retail pass-through entry. This value is required if *RTLPASTHR is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

retail-device-name: Specify the name of the retail device that communicates with the host. This value must be unique.
SNUF-device-name: Specify the name of the SNUF device through which the retail device communicates with the host. This value must be unique.
Default-host-program-name: Specify the name of the program to be started on the host if the program name is not present in the SNA command (INIT-SELF) that requests a session to be started.
entry-description: Specify a short description for each retail pass-through entry. The default is *BLANK.

Local location name (LCLLOCNAME)

Specifies the local location name being supplied by the caller that is being filtered by the local system. When the local system is initiating a session, this is the local location name being used. When a bind is received from another system, this is the Secondary Logical Unit (SLU) name being used.

Note: This parameter is valid only if TYPE(*APPNSSN) is specified.

*ANY: Any local location name will be filtered by the local system.
generic*-local-location-name: Specify the generic local location name (part of a name followed by an asterisk) of the local location(s) being filtered. The generic local location name allows one entry to be defined for all local location names, on the system, with a name that matches the characters preceding an *.
local-location-name: Specify the local location name that is being filtered by the local system.

APPN directory search entries (APPNDIRE)

Specifies the APPN directory search entry being filtered by the local system. This parameter may be specified when *APPNDIR is specified for the TYPE parameter. Up to 300 entries may be specified at a time.

The possible Filtered Location Name values are:

*ANY: Any control point location will be filtered.
generic*-filtered-CP-loc-name: Specify the generic name (part of a name followed by an asterisk) of the control point location(s) to be filtered. The generic name allows one name to be specified for all control point locations with a name that matches the characters preceding an asterisk (*).
filtered-CP-location-name: Specify the control point location name to be filtered. This is the name of the location that is owned by the adjacent control point being filtered if the adjacent CP is an end node or LEN node. Or, the name of some location that accesses the local network via the adjacent control point (a non-native network node). This location name represents the name of the session partner attempting to establish a session with the remote location name (the location that exists in the local system's network).

The possible Filtered CP Location Network ID values are:

*NETATR: The LCLNETID value specified in the system network attributes is used.
filtered-CP-location-network-ID: Specify the network identifier associated with the CP location name to be filtered.

The possible Partner Location Name values are:

*ANY: Any remote location will be filtered.
generic*-partner-location-name: Specify the generic name (part of a name followed by an asterisk) of the partner location(s) to be filtered. The generic name allows one name to be specified for all partner locations with a name that matches the characters preceding an asterisk (*).
partner-location-name: Specify the name of the partner location to be filtered.

The possible Partner Network Identifier values are:

*NETATR: The LCLNETID value specified in the system network attributes is used.
partner-network-identifier: Specify the network identifier associated with the partner location to be filtered.

The possible Entry Description values are:

*BLANK: Text is not specified.
'entry-description': Specify a short description of 20 characters or less for each entry.

APPN session endpoint entries (APPNSSNE)

Specifies the APPN session endpoint entry being filtered by the local system. This parameter may be specified when *APPNSSN is specified for the TYPE parameter. Up to 300 entries may be specified at a time.

The possible Remote Location Name values are:

*ANY: Any remote location will be filtered.
generic*-remote-location-name: Specify the generic name (part of a name followed by an asterisk) of the remote location(s) to be filtered. The generic name allows one name to be specified for all remote locations with a name that matches the characters preceding an asterisk (*).

The possible Remote Network Identifier values are:

*NETATR: The LCLNETID value specified in the system network attributes is used.
Remote-network-identifier: Specify the remote network identifier associated with the remote location to be filtered.

The possible Text Description values are:

*BLANK: Text is not specified.
'entry-description': Specify a short description of 20 characters or less for each entry.