Create Device Desc (SNA Host) (CRTDEVHOST)

Parameters

Keyword	Description	Choices	Notes
DEVD	Device description	Name	Required, Positional 1
LOCADR	Local location address	01-FF	Required, Positional 2
RMTLOCNAME	Remote location	Communications name	Required, Positional 3
ONLINE	Online at IPL	YES, NO	Optional
CTL	Attached controller	Name	Optional
APPTYPE	Application type	RJE, EML, *PGM	Optional
MAXLENRU	Maximum length of request unit	*CALC, 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	3278, 3284, 3286, 3287, 3288, 3289	Optional
EMLKBD	Emulated keyboard	UPPER, LOWER	Optional
EMLNUMLCK	Emulated numeric lock	NO, YES	Optional
EMLWRKSTN	Emulation work station	Name, *ANY	Optional
ENDSSNHOST	End session with host	UNBIND, RSHUTD	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
DEPLOCNAME	Dependent location name	Communications name, *NONE	Optional
AUT	Authority	Name, CHANGE, ALL, USE, EXCLUDE, *LIBCRTAUT	Optional

Top

Attached controller (CTL)

Specifies the name of the controller description to which this device is attached.

Note: To use this device for communicating with a remote location that resides on the same system as the local location, specify a controller description that was created with LINKTYPE (*LOCAL) specified.

Application type (APPTYPE)

Specifies what application type is used by this device.

*RJE

The application is BSC Remote Job Entry (RJE).

*EML

The application is 3270 device emulation, using the 3270 Device Emulation Utility, or the 3270 program interface support provided in the System/38 environment.

*PGM

This device is used for program-to-program communications.

Maximum length of request unit (MAXLENRU)

Specifies the maximum request unit (RU) length allowed.

*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).

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.

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

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

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

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

Dependent location name (DEPLOCNAME)

Specifies the dependent local location name used for Dependent LU Requester (DLUR), providing additional security for the connection. If this name is filled in, an activation request (SNA ACTLU) from a Dependent LU Server (DLUS) node must reference this name or it is rejected.

Remote DLUS nodes may optionally accept unsolicited reply PSIDs (Product Set IDs) from the IBM i for auto-definition of LUs at the DLUS node. If so, then this name will be sent to the DLUS node in the reply PSID and it will be returned on the ACTLU request.

If unsolicited reply PSIDs are not supported by the DLUS node, then there will have to be close coordination of the PU name definitions on both systems.

*NONE

No location name is defined.

dependent-location-name

Specify the dependent location name used for DLUR applications.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE: The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE: The user cannot access the object.

*LIBCRTAUT: The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTDEVHOST   DEVD(COMMDSP1)  LOCADR(FE)
             RMTLOCNAME(SYS)  CTL(HOSTCTL001)
             APPTYPE(*EML)  EMLDEV(3284)

This command creates a device description for an SNA host communications device named COMMDSP1. The address of the device is X'FE'. It is attached to the controller HOSTCTL001 and communicates with SYS. This device uses 3270 emulation to emulate a 3284 printer.