NAME

snalu62_delete − Deletes one or more definitions created by the snalu62_define_xxx verbs. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_delete(
       STATUS_VEC status_vec,
       char ∗local_lu_name,
       char ∗remote_lu_name,
       char ∗mode_name,
       TP_NAME ∗tpn,
       SRV_INFO ∗server_info
       );
 
 
 
 

SUPPLIED PARAMETERS

local_lu_name

A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-known alias of the local LU to be deleted. If none of the remaining parameters are specified, then the local LU and all the definitions associated with the LU are deleted.  Otherwise, only the specified definitions are deleted. 
 
 

remote_lu_name

A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-known alias of the remote LU being deleted.  If none of the remaining parameters are specified, then the remote LU and all the mode names associated with the remote LU are deleted.  Otherwise, only the specified mode name is deleted. The local_lu_name parameter must also be specified. 
 
 

mode_name

A pointer to a null-terminated ASCII string specifying the mode name to be deleted. Only the specified mode name is deleted. The local_lu_name and remote_lu_name parameters must also be specified. 
 

tpn

A pointer to a TP_NAME structure specifying the transaction program name to be deleted. The translate field of the TP_NAME structure specifies if the interface needs to translate the name.  The local_lu_name parameter must also be specified. 
 
 

server_info

A pointer to a SRV_INFO structure specifying the LU6.2 Server to use.  Supply sufficient information to uniquely identify the LU6.2 Server.  If this parameter is not specified, the interface attempts to connect to a local server with the name LU62_SRV. 
 
 

RETURNED PARAMETER

status_vec

A pointer to a STATUS_VEC array to receive the completion status information. 
 
 

DESCRIPTION

 
The execution of this verb involves only the local LU; it does not cause any information to be sent outside the LU.

Deleting definitions makes those definitions unavailable to the local LU.  Use the following guidelines when deleting definitions:
 
 
 

•
 
When deleting a local LU name and all its associated parameter values, call this verb only when the local LU is not participating in any network activity.
 

•
 
When deleting a remote LU name and all its associated parameter values, call this verb only when the local LU is not participating in any network activity involving the remote LU.
 

•
 
When deleting a mode name and all its associated parameter values, call this verb only when the local LU is not participating in any network activity involving the remote LU and mode name.
 

•
 
When deleting a transaction program name and all its associated parameter values, call this verb only when the transaction program is not in use.
 

Note that you can use this verb to delete both a transaction program name and a remote LU or mode name definition with the same call. 
 
 

RESTRICTIONS

 
Only a process having superuser privileges or a user listed in the system group in the /etc/group file can call this verb. 

If you are using this verb to manage an LU6.2 Server on a remote node, the remote server must have access to an access validation file that includes your node name. 
 
 
For a description of the LU6.2 Server access validation file, see Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Administrator’s Guide. 
 
 

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: None

Manuals: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming and IBM’s Systems Network Architecture Transaction Programmer’s Reference Manual for LU Type 6.2.