Name

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

FORMAT

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
     );
 
 
 
 

Arguments

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

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. 
 
 

server_info
 
A pointer to a SRV_INFO structure specifying the LU6.2 Server to utilize.  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. 
 
 
 

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.

 
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.

 
You can use this verb to delete both a transaction program name and remote LU or mode name definitions 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.
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully