Security Administration (ISecurityAdmin Interface)

DestroyAccessControlTemplate

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

Category: ACT administration methods

DestroyAccessControlTemplate(tCtxt,ACTresource);

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

Related Methods

Top of Page