Change Device Desc (SNA Host) (CHGDEVHOST)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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

Top

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
Top

Device description (DEVD)

Specifies the name of the device description being changed.

This is a required parameter.

Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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 iSeries system to end the session.
*RSHUTD
The host device sends the SNA command requesting the host system to end the session.
Top

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.
Top

Examples

CHGDEVHOST   DEVD(COMMDSP1)  EMLDEV(3286)

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

Top

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.
Top