HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DELETE_TN3270_ACCESS
/* to delete */
} TN3270_SESSION_NAME;
3.77.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DELETE_TN3270_ACCESS
default_record
Specifies whether this verb refers to the default TN3270 user record that is used by any TN3270 user not
explicitly identified by a TCP/IP address (deleting this record means that such users cannot access TN server).
Possible values are:
AP_YES
This verb refers to the default TN3270 user record. The client_address parameter is reserved.
AP_NO
This verb refers to a normal TN3270 user record.
client_address
The TCP/IP address of the TN3270 user to be deleted. This is a string of 1–64 characters; the remaining
bytes in the string should be set to nulls.
The address 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 verb.
num_sessions
The number of sessions to be deleted, as follows:
• To delete one or more of the user’s sessions but leave other sessions configured, specify the number of
sessions that are being deleted. Each of these must be defined by its TCP/IP port number, as described
below.
• To delete all sessions, or to delete the user, specify zero in this parameter and do not include any TCP/IP
port numbers. Specify the type of deletion required in the delete_options parameter below.
delete_options
If the num_sessions parameter (see above) is nonzero, this parameter is ignored. If num_sessions is zero,
specify one of the following values:
AP_ALL_SESSIONS
Delete all sessions but leave the TN3270 user configured.
AP_DELETE_USER
Delete the user and all the user’s sessions.
For each session to be deleted, up to the number specified in num_sessions, the following parameter is
required:
tn3270_session_name.port_number
The TCP/IP port number used for the session. This must match a port number defined for this TN3270 user.
3.77.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
313