Change Cfg List Entries (CHGCFGLE)

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

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.