DATA Step Functions for Metadata Security Administration

METASEC_NEWACT Function

Creates a new ACT.

rc = METASEC_NEWACT(tc,repos_uri<,attr,attr_value>...<,attr_3,attr_value_3>);

Argument	Direction	Description
tc	in	Transaction context handle; can be an empty string " " to invoke with a temporary context
repos_uri	in	Character variable or constant that contains the URI of the repository where you are creating the ACT; use the following form of URI: "Reposid:xxxxxxxx"
attr	in	Character variable or constant that specifies an ACT attribute. You must pair this argument with an attr_value argument, and you can specify up to three attr and attr_value pairs. See Details.
attr_value	in	Character variable or constant that contains the value of an ACT attribute; you must pair this argument with an attr argument, and you can specify up to three attr and attr_value pairs. See Details.

Return Values

Value	Description
0	Successful completion
-1	Unable to connect to the metadata server
-99 or less	Other error; see log or sysmsg() for information

Details

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

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.

Attribute	Attribute Value	Maximum Length of Attribute Value	Notes
NAME	Character string	60	Required; he attribute value must be unique within the repository
DESC	Character string	200	Optional
USE	REPOS or empty string	5	Optional; when you specify REPOS, the ACT becomes the new default repository ACT. See the following caution.

CAUTION:: Passing in an empty string for the USE attribute is not recommended.
Passing in an empty string has an effect only when the ACT already has USE=REPOS. However, setting a repository ACT's USE attribute to a blank leaves the repository in a default mode where all permissions are granted. If you want to change the default ACT, it is recommended that you set USE=REPOS on the ACT that you want to use as the repository ACT. The metadata server automatically removes the USE=REPOS attribute from the previous repository ACT. Thus the repository is not left in a mode with no repository ACT.

Example

Example: Working with ACTs

Related Functions

Top of Page