METASEC_GETACTA Function

Returns an ACT attribute.

Syntax

Details

Syntax

rc = METASEC_GETACTA(tc, act_uri, 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 or constant that contains the URI of the ACT that is requested; can be blank if the ACT was specified when creating the TC; use the following form of URI: “omsobj:AccessControlTemplate/xxxxxxxx.yyyyyyyy”.

attr (in): specifies a character variable that specifies the ACT attribute whose value you are requesting; see Details for more information.

attr_value: returns a character variable that contains the value of the ACT attribute; see Details for more information.

Return Values

0: Successful completion.

-1: Unable to connect to the metadata server.

-99 or less: Attribute is not set; see log or sysmsg() for information.

Details

This function calls the ISecAdmin method GetAccessControlTemplateAttribs(). For information about this method, see SAS Open Metadata Interface: Reference and Usage.

Lowercase or mixed-case ACT attributes (Name, Desc, Use) are automatically uppercased (NAME, DESC, USE). 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	Optional
`DESC`	Character string	200	Optional
`USE`	`REPOS` or empty string	5	Optional; the `REPOS` value indicates that the specified ACT is the default repository ACT

See Example: Working with ACTs for a usage example.

METASEC_GETACTA Function

Syntax

Required Arguments

Return Values

Details

See Also