Administration Commands

define_tn3270_access

Supplied parameters are:

list_name

The name of the security access list. This name is a character string of 1–14 locally displayable characters.

If this name matches an existing security access list, the users defined by this command are added to the list; otherwise a new list is created.

description

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

One or more security_user_data subrecords may follow. Each subrecord contains the following additional parameter:

user_name

Name of the user. This is a user ID defined using the define_userid_password command.

2.53.2 Returned Parameters

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

2.53.3 Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.

Parameter Check

If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

PARAMETER_CHECK

secondary_rc

One of the following:

INVALID_LIST_NAME

The supplied list_name parameter contained a character that was not valid.

INVALID_USER_NAME

One or more of the specified user names was not valid.

State Check

No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.

Other Conditions

Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.

2.54 define_tn3270_access

The define_tn3270_access command identifies which TN3270 clients, based on their IP addresses, can use the TN3270 server feature of SNAplus2 to access a host for 3270 emulation and defines the 3270 LU sessions available to that user.

211

Page 211
Image 211
HP UX Internet and Networking Software manual 54 definetn3270access, Listname