DATA Step Functions for Metadata Security Administration

METASEC_GETNACTA Function

Returns the nth attribute for an ACT.

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

Argument	Direction	Description
tc	in	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	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	Character variable that contains the name of the nth attribute found on the ACT; see Details.
attr_value	out	Character variable that contains the value of the nth attribute found on the ACT; see Details.

Return Values

Value	Description
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.

The following table provides more information about the attr and attr_value arguments.

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

Example

Example: Working with ACTs

Related Functions

Top of Page