Change Device Desc (SNA Host) (CHGDEVHOST)

The Change Device Description (SNA Host) (CHGDEVHOST) command changes a device description for a Systems Network Architecture (SNA) host system device.

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword Description Choices Notes
DEVD Device description Name Required, Key, Positional 1
LOCADR Local location address *SAME, 01, 02, 03, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, 1C, 1D, 1E, 1F, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A, 2B, 2C, 2D, 2E, 2F, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 3A, 3B, 3C, 3D, 3E, 3F, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 4A, 4B, 4C, 4D, 4E, 4F, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 5A, 5B, 5C, 5D, 5E, 5F, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 6A, 6B, 6C, 6D, 6E, 6F, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 7A, 7B, 7C, 7D, 7E, 7F, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 8A, 8B, 8C, 8D, 8E, 8F, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 9A, 9B, 9C, 9D, 9E, 9F, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, AA, AB, AC, AD, AE, AF, B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, BA, BB, BC, BD, BE, BF, C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, CA, CB, CC, CD, CE, CF, D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, DA, DB, DC, DD, DE, DF, E0, E1, E2, E3, E4, E5, E6, E7, E8, E9, EA, EB, EC, ED, EE, EF, F0, F1, F2, F3, F4, F5, F6, F7, F8, F9, FA, FB, FC, FD, FE, FF Optional
ONLINE Online at IPL *SAME, *YES, *NO Optional
MAXLENRU Maximum length of request unit *CALC, *SAME, 241, 245, 247, 256, 497, 501, 503, 512, 768, 1009, 1015, 1024, 1280, 1536, 1792, 2048, 2304, 2560, 2816, 3072, 3328, 3584, 3840, 4096 Optional
EMLDEV Emulated device *SAME, 3278, 3284, 3286, 3287, 3288, 3289 Optional
EMLKBD Emulated keyboard *SAME, *UPPER, *LOWER Optional
EMLNUMLCK Emulated numeric lock *SAME, *YES, *NO Optional
EMLWRKSTN Emulation work station Name, *SAME, *ANY Optional
ENDSSNHOST End session with host *SAME, *UNBIND, *RSHUTD Optional
TEXT Text 'description' Character value, *SAME, *BLANK Optional

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Local location address (LOCADR)

Specifies the local location address for this device.

Valid values range from 01 to FF.

*SAME
The value does not change.

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.

Maximum length of request unit (MAXLENRU)

Specifies the maximum request unit (RU) length allowed.

*SAME
The value does not change.
*CALC

The system determines the best value to use.

This is the recommended value.

maximum-length-request-unit

Specify a value, 256 through 4096, in amounts of 256, to be used as the maximum length for incoming request units. Values 241, 247, 497, 503, 1009, and 1015 can also be specified but are valid only if the device is attached to an X.25 network.

Emulated device (EMLDEV)

Specifies that this program device entry is used to send and receive 3270 data streams. The emulation device parameter consists of an emulation device type and an emulation device data format. The emulation device data format specifies the format of the type 3270 data stream being sent or received. A 20- or 32-byte common header that contains type 3270 command and data flow information is located at the start of the I/O buffer that is sending or receiving the type 3270 data stream. This parameter applies only to SNUF communications. This parameter can be specified as a list of two values (elements) or as a single value (*NONE).

*SAME
The value does not change.
3278

This device is used to emulate a 3278 display device.

3284

This device is used to emulate a 3284 printer device.

3286

This device is used to emulate a 3286 printer device.

3287

This device is used to emulate a 3287 printer device.

3288

This device is used to emulate a 3288 printer device.

3289

This device is used to emulate a 3289 printer device.

Emulated keyboard (EMLKBD)

Specifies the type of 3278 display keyboard that is emulated. This parameter is valid only when *EML is specified for the Application type (APPTYPE) parameter.

*SAME
The value does not change.
*UPPER

A 3270 display device keyboard is emulated with uppercase characters only.

*LOWER

A 3270 display device keyboard is emulated with uppercase and lowercase characters.

Emulated numeric lock (EMLNUMLCK)

Specifies whether numeric input fields only allow numeric data on a 5250 keyboard. The value can be specified for this parameter only if *EML is specified for the Application type (APPTYPE) parameter.

*SAME
The value does not change.
*NO

3270 emulation allows any data to be typed in the numeric input fields.

*YES

3270 emulation allows only numeric data to be typed in the numeric input fields. Valid numeric data include the characters 0 through 9 and symbols + - , . and blank.

Emulation work station (EMLWRKSTN)

The emulation work station associates an emulation device with a real display or printer device. The device address is reserved for use exclusively by that work station. If no device or *ANY is specified, any work station can use the emulation device.

*SAME
The value does not change.
*ANY

Any work station can use the emulation device.

work-station

Specify the name for the work station that is to use this emulation device.

End session with host (ENDSSNHOST)

Specifies how the host device ends a session with the host system. The ENDSSNHOST parameter can be changed at any time and takes effect immediately after the change occurs.

*SAME
The value does not change.
*UNBIND

The host device sends the SNA command requesting the IBM i to end the session.

*RSHUTD

The host device sends the SNA command requesting the host system to end the session.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*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 

CHGDEVHOST   DEVD(COMMDSP1)  EMLDEV(3286)

This command changes the device description named COMMDSP1 so it emulates a 3286 printer.

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.