DestroyAccessControlTemplate :: SAS(R) 9.3 Open Metadata Interface: Reference and Usage

Short Description

Destroys an ACT and removes references to it from all associated objects.

Syntax

DestroyAccessControlTemplate(tCtxt,ACTresource);

Parameters

Method Parameters

Parameter	Type	Direction	Description
tCtxt	string	in	Optional handle representing a server-side transaction context.
ACTresource	string	in	Optional resource identifier of an ACT object. If TCTXT is used, do not specify a value in ACTRESOURCE.

Details

The DestroyAccessControlTemplate method destroys an ACT object and removes all references to it from all associated objects.

When TCTXT is set to a valid value, the destruction of the ACT and removal of its references is deferred until the EndTransactionControl method is invoked on a resource with the SECAD_COMMIT_TC flag.

When TCTXT is null and ACTRESOURCE is set to a valid value, the ACT is destroyed immediately, along with all references. For instructions on how to format a URN for the ACTRESOURCE parameter, see Using the ISecurityAdmin Server Interface.

Exceptions Thrown

The SAS Open Metadata Interface explicitly returns the following exceptions for the DestroyAccessControlTemplate method:

OK
SECAD_INVALID_TC_HANDLE
SECAD_INVALID_RESOURCE_SPEC
SECAD_OBJECT_NOT_ACT
SECAD_ACT_DOES_NOT_EXIST
SECAD_NOT_AUTHORIZED

Examples

The following code fragment shows how the DestroyAccessControlTemplate method is issued in a Java environment:

public void destroyAccessControlTemplate(String transCtxt, String
ACTSpec)
 throws Exception {
		
		try
		{
			iSecurityAdmin.DestroyAccessControlTemplate(transCtxt, ACTSpec);
		}
		catch (Exception e) {
			System.out.println("DestroyAccessControlTemplate: Exceptions");
			e.printStackTrace();
			throw e;
		}
}

The following example destroys the ACT identified by ACTSPEC:

public void termACT() throws Exception {
			
		try {
			iSecurityAdmin.destroyAccessControlTemplate("", ACTspec);
		}
		catch (Exception e)
		{
			throw e;
		}
	}

DestroyAccessControlTemplate