The Change Configuration List Entry (CHGCFGLE) command changes one entry in the SNA pass-through configuration list. One entry consists of a group name, entry description, and upstream SNA pass-through device names. The user can add, remove, or change the SNA pass-through device names associated with each entry denoted by a group name.

Parameters

Keyword	Description	Choices	Notes
TYPE	Configuration list type	*SNAPASTHR	Required, Key, Positional 1
GRPNAME	SNA pass-through group name	Name, *SAME	Optional, Key, Positional 2
DEV	SNA pass-through device desc	Single values: *SAME Other values (up to 254 repetitions): Name	Optional
TEXT	Entry 'description'	Character value, *SAME, *BLANK	Optional
SNAPASTHRE	SNA pass-through entry	Single values: *SAME Other values: Element list	Optional
	Element 1: SNA pass-through group name	Communications name
	Element 2: SNA pass-through device desc	Single values: *SAME Other values (up to 254 repetitions): Communications name
	Element 3: Entry 'description'	Character value, *SAME, *BLANK

Top

Configuration list type (TYPE)

Specifies the type of configuration list entry being changed.

This is a required parameter.

*SNAPASTHR

The SNA pass-through list is used. One SNA pass-through entry can be specified to be changed in the configuration list.

SNA pass-through group name (GRPNAME)

Specifies the SNA pass-through group name of the configuration list entry being changed.

*SAME

The value does not change.

group-name

Specify the name of the entry being changed. An entry is identified by a group name. The group name must already exist in the configuration list. The group name has upstream SNA pass-through device names associated with it.

SNA pass-through device desc (DEV)

Specifies the names of the upstream SNA pass-through devices associated with the group name specified for the GRPNAME parameter.

*SAME

The value does not change.

device-name

Specify the name of the device or devices to use for the pass-through session(s).

Entry 'description' (TEXT)

Specifies text that briefly describes the SNA pass-through group.

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

*SAME

The value does not change.

*BLANK

Text is not specified.

'entry-description'

Specify a description of up to 50 characters for the SNA pass-through entry being changed.

SNA pass-through entry (SNAPASTHRE)

Specifies the SNA pass-through entry. This parameter can be specified if TYPE(*SNAPASTHR) is specified. However, because this parameter may be removed in a later release, whenever possible use GRPNAME, DEV, and TEXT parameters.

Examples

CHGCFGLE   TYPE(*SNAPASTHR)  GRPNAME(CICSGROUP)
           DEV(HOSTDEV1 HOSTDEV2)
           TEXT('Chicago Host CICS group')

This command changes the device names currently associated with the SNA configuration group CICSGROUP to HOSTDEV1 and HOSTDEV2.

Error messages

*ESCAPE Messages

CPF260F

Configuration list &1 not found.

CPF261C

Index for configuration list &1 not changed.

CPF2625

Not able to allocate object &1.

CPF2634

Not authorized to object &1.

CPF2663

Configuration list &1 previously deleted.

CPF9838

User profile storage limit exceeded.