METASEC_GETNACTA Function

Returns the nth attribute for an ACT.

Syntax

rc = METASEC_GETNACTA(tc, act_uri, n, attr, attr_value);

Required Arguments

tc (in)
specifies a transaction context handle; can be an empty string " " to invoke with a temporary context. If tc is returned from the METASEC_BEGTRAN function, then tc references an existing ACT.
act_uri (in)
specifies a character variable that contains the URI of the ACT that is requested; this URI is in the following form: “omsobj:AccessControlTemplate/xxxxxxxx.yyyyyyyy”.
n (in)
One-based numeric index value that indicates which row to return from the array. For more information, see Array Parameters.
attr (out)
returns a character variable that contains the name of the nth attribute found on the ACT; see Details for more information.
attr_value (out)
returns a character variable that contains the value of the nth attribute found on the ACT; see Details for more information.

Return Values

0
Successful completion, but no ACTs are found.
-1
Unable to connect to the metadata server.
-4
Numeric value (n) exceeds the maximum usable value.
-5
n is out of range.
-99 or less
Other error; see log or sysmsg() for information.

Details

This function calls the ISecAdmin method GetAccessControlTemplateAttribs(). For information about the method, see SAS Open Metadata Interface: Reference and Usage.
The following table provides more information about the attr and attr_value arguments.
ACT Attribute Specifications
Attribute
Attribute Value
Maximum Length of Attribute Value
Notes
NAME
Character string
60
DESC
Character string
200
USE
REPOS or empty string
5
The REPOS value indicates that the specified ACT is the default repository ACT
See Example: Working with ACTs for a usage example.