Administration Commands

delete_tn3270_access

This command refers to the default TN3270 access record. The client_address parameter is not used.

NO

This command refers to a specific TN3270 access record specified in the client_address parameter.

client_address

The TCP/IP address of the client to be deleted. This can be specified as a dotted-decimal IP address (such as 193.1.11.100), as a fully qualified name (such as newbox.this.co.uk), or as an alias (such as newbox), as specified on the define_tn3270_access command.

delete_options

To delete one or more sessions but not all the sessions, do not specify this parameter. Specify the sessions to be deleted using port_number parameters. To delete all sessions, specify one of the following values:

ALL_SESSIONS

Delete all sessions but leave the TN3270 client configured.

DELETE_USER

Delete the client and all the client’s sessions.

Each tn3270_session_name subrecord contains the following parameter:

port_number

The TCP/IP port number used for the session. If the delete_options parameter is not specified, use this parameter to specify each session to be deleted.

2.90.2 Returned Parameters

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

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

INVALID_CLIENT_ADDRESS

The client address specified in the client_address parameter did not match the TCP/IP address defined for any TN3270 user.

INVALID_PORT_NUMBER

The TCP/IP port number specified in the port_number parameter did not match any TCP/IP port number defined for this user.

State Check

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

283

Page 283
Image 283
HP UX Internet and Networking Software manual 283