CHGDEVHOST (Change Device Description (SNA Host))

CHGDEVHOST Command syntax diagram

 

Purpose

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

 

Required Parameters

DEVD

Specifies the name of the device description being changed.

 

Optional Parameters

LOCADR

Specifies the local location address. Specify a 2-character hexadecimal value ranging from 01 through FF.

*SAME: The value does not change.

location-address: Specify two hexadecimal characters with a permissible value ranging from 01 through FF for the local location address.

ONLINE

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

*SAME: The value does not change.

*YES: The device is automatically varied on at IPL.

*NO: This device is not automatically varied on at IPL.

MAXLENRU

Specifies the default maximum request unit (RU) length that can be sent or received by the local systems if the maximum size is not specified in the bind.

Note:

This parameter is valid for devices attached to controllers of X.25 networks.

*SAME: The value does not change.

*CALC: The system determines the value to use.

maximum-length-request-unit: Specify a value, ranging from 256 through 4096 bytes, in 256-byte increments, to be used as the maximum length for incoming request units. Values of 241, 245, 247, 497, 501, and 503 bytes are valid only for devices attached to an X.25 controller.

ENDSSNHOST

Specifies how the host device ends a session with the host system.

Note:

This 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 400 to end the session.

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

EMLDEV

Specifies the type of 3270 device being emulated. This parameter is valid only if *EML was specified on the APPTYPE parameter when the device was created. The change requested by this command becomes effective the next time either the Start 3270 Display Emulation (STREML3270) command or the Start Print Emulation (STRPRTEML) command accesses the device.

*SAME: The value does not change.

3278: This device description is used to emulate a 3278 display device.

3284: This device description is used to emulate a 3284 printer device.

3286: This device description is used to emulate a 3286 printer device.

3287: This device description is used to emulate a 3287 printer device.

3288: This device description is used to emulate a 3288 printer device.

3289: This device description is used to emulate a 3289 printer device.

EMLKBD

Specifies the type of 3278 display keyboard being emulated. A value is specified for this parameter only if APPTYPE(*EML) was specified when the device was created. The specified value is used if EMLDEV(3278) was specified.

*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 both uppercase and lowercase characters.

EMLNUMLCK

Specifies whether numeric input fields will only allow numeric data on a 5250 keyboard. A value can be specified for this parameter only if this is a 3270 device emulation application type (APPTYPE is *EML).

*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. Numeric data that can be typed includes the characters 0 through 9 and the symbols + - , . and blank.

EMLWRKSTN

Specifies that this emulation device is associated with a real display device or printer device and that it is reserved for use exclusively by that work station. If no device or *ANY is specified, any work station can use the emulation device. A value can be specified for this parameter only if APPTYPE(*EML) is specified.

*SAME: The value does not change.

*ANY: Any work station can use the emulation device.

emulation-work-station: Specify the device name for the work station that uses this emulation device.

TEXT

Specifies the text that briefly describes the device file. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

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

Example for CHGDEVHOST

CHGDEVHOST   DEVD(COMMDSP1)  EMLDEV(3286)

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

Error messages for CHGDEVHOST

*ESCAPE Messages

CPF2618

Device description &1 not changed.