METASEC_GETNACTA Function

Returns the nth attribute for an ACT.

Syntax

Details

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.

METASEC_GETNACTA Function

Syntax

Required Arguments

Return Values

Details

See Also