HP UX Internet and Networking Software manual Locallualias, 5250DISPLAY, 5250PRINTER

Administration Commands

define_emulator_user

Specifies whether the user has permission to change the session to use a different screen model from the one specified. Possible values are:

YES

The user can change the screen model.

NO

The user cannot change the screen model.

One or more 5250_session_data subrecords may follow. Each subrecord contains the following additional parameters:

session_name

A name identifying the session. This name is an 8-byte string consisting of locally displayable characters. If the name matches an existing session name defined for this 5250 user, the information for that session is replaced; otherwise, a new session is added.

description

An optional string of 0–31 characters. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_emulator_user_def command.

local_lu_alias

LU alias of the local LU that this session uses. This must match the name of an APPC local LU that has already been defined.

plu_alias

LU alias of the partner LU that this session uses.

To indicate that the partner LU is identified by its fully qualified name instead of its LU alias, do not specify this parameter, and specify the fully qualified name in the fqplu_name parameter. For more information, see Section 2.43, define_partner_lu.

fqplu_name

Fully qualified name of the partner LU. Specify 3–17 type-A characters that consist of a 1–8 character net- work name, followed by a period, followed by a 1–8 character partner LU name.

This parameter is used only if the plu_alias parameter is not specified; it is ignored if plu_alias is specified.

mode_name

Name of the mode that this session uses. This name is an 8-byte type-A character string starting with a letter. The mode name must match the name of an APPC mode that has already been defined; it is generally set to the SNA-defined mode name QPCSUPP.

session_type

Type of the 5250 session (display or printer). Possible values are:

5250_DISPLAY

Display session

5250_PRINTER

Printer session

2.22.2 Returned Parameters

No parameters are returned by SNAplus2 when this command executes successfully.

92