dat_pz_free(3DAT)				     Direct Access Transport Library Functions					 dat_pz_free(3DAT)

NAME

       dat_pz_free - destroy an instance of the Protection Zone

SYNOPSIS

       cc [ flag... ] file... -ldat [ library... ]
       #include <dat/udat.h>

       DAT_RETURN
	   dat_pz_free (
	   IN	 DAT_PZ_HANDLE	  pz_handle
	   )

PARAMETERS

       pz_handle       Handle for an instance of Protection Zone to be destroyed.

DESCRIPTION

       The  dat_pz_free() function destroys an instance of the Protection Zone. The Protection Zone cannot be destroyed if it is in use by an End-
       point, LMR, or RMR.

       Use of the handle of the destroyed Protection Zone in any subsequent operation except for dat_pz_free() fails.

RETURN VALUES

       DAT_SUCCESS	       The operation was successful.

       DAT_INVALID_STATE       Parameter in an invalid state. The Protection Zone was in use by Endpoint, LMR, or RMR instances.

       DAT_INVALID_HANDLE      The pz_handle parameter is invalid.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard: uDAPL, 1.1, 1.2    |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libdat(3LIB), attributes(5)

SunOS 5.10							    16 Jul 2004 						 dat_pz_free(3DAT)