METASEC_NEWACT Function

Creates a new ACT.

Syntax

Details

Syntax

rc = METASEC_NEWACT(tc, repos_uri, attr, attr_value<, attrn, attr_valuen>);

Required Arguments

tc (in): specifies a transaction context handle; can be an empty string " " to invoke with a temporary context.

repos_uri (in): specifies a 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): specifies a 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 for more information.

attr_value (in): specifies a 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 for more information.

Return Values

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 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	Required; the 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.

See Example: Working with ACTs for a usage example.

METASEC_NEWACT Function

Syntax

Required Arguments

Return Values

Details

See Also