The Change Device Description (SNA Pass-Through) (CHGDEVSNPT) command changes a device description for an SNA pass-through device.

Parameters

Keyword	Description	Choices	Notes
DEVD	Device description	Name	Required, Key, Positional 1
LOCADR	Local location address	00-FE, *SAME	Optional
ONLINE	Online at IPL	*YES, *NO, *SAME	Optional
ACTTMR	Activation timer	1-2550, *SAME	Optional
SNPTDEV	SNA pass-through device desc	Name, *SAME, *NONE	Optional
SNPTGRP	SNA pass-through group name	Name, *SAME, *NONE	Optional
TEXT	Text 'description'	Character value, *SAME, *BLANK	Optional

Top

Device description (DEVD)

Specifies the name of the device description being changed.

This is a required parameter.

Local location address (LOCADR)

Specifies the local location address for this device.

*SAME

The value does not change.

location-address

Specify the location address.

Online at IPL (ONLINE)

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

*SAME

The value does not change.

*YES

This device is varied on automatically at IPL.

*NO

This device is not varied on automatically at IPL.

Activation timer (ACTTMR)

Specifies, for switched connections, the amount of time (in seconds) that the SNA pass-through support waits for the device to respond to the activation request from the host iSeries system. If the device does not respond within this time, it is considered not available.

*SAME

The value does not change.

activation-timer

Specify a number ranging from 1 through 2550 indicating the number of seconds before the device is considered not available.

SNA pass-through device desc (SNPTDEV)

Specifies the name of the associated SNA pass-through device that is attached to a host or advanced program-to-program communications (APPC) controller.

*SAME

The value does not change.

*NONE

No name is specified.

associated-device-name

Specify the name of a device that is attached to a host or an APPC controller that is associated with this device.

SNA pass-through group name (SNPTGRP)

Specifies the name configured for a group of host devices in a configuration list. This indicates that this device is tied to any one of the devices in that group which is available.

*SAME

The value does not change.

*NONE

No name is specified.

group-name

Specify the name configured for a group of host devices that must be associated with this device.

Text 'description' (TEXT)

*SAME

The text (if any) does not change.

*BLANK

No text is specified.

character-value

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

Examples

CHGDEVSNPT   DEVD(SNPTDEV1)  LOCADR(05)  SNPTDEV(DOWNDEV1)

This command changes an SNA pass-through device description named SNPTDEV1. The location address of the device is X'05'. The SNA pass-through device name associated with this device is DOWNDEV1.

Error messages

*ESCAPE Messages

CPF2618

Device description &1 not changed.