Optional Arguments

CUSTOM_PROPERTIES=NONE | ADD (custom-properties-list) | REMOVE (property-names-list) | <REPLACE> (custom-properties-list)

specifies how custom properties for the folder are updated. Custom properties are supported by specific SAS applications such as SAS Marketing Automation. Valid operations are the following:

NONE

removes all custom properties from the folder, if there are any.

ADD (custom-properties-list)

adds the specified custom properties to the folder.

The form of the custom-properties-list value is

("property-name-1" "property-value-1" <"description-1">)

...

("property-name-n" "property-value-n" <"description-n">)

where

property-name

specifies the name of the property.

Restriction:Property names cannot begin with an underscore (_) character.

Requirement:Property names must be unique. If a specified property name already exists in the folder, then the UPDATE FOLDER statement will fail. Therefore, it is recommended that you add a prefix or suffix to the property name to ensure uniqueness.

property-value

specifies the value of the property.

description

specifies the description of the property. The description is optional.

REMOVE (property-names-list)

removes the specified custom properties from the folder.

The form of the property-names-list value is

"property-name-1" <... "property-name-n">

Interaction:If you specify both the ADD and REMOVE operations, then the REMOVE operation occurs first.

<REPLACE> (custom-properties-list)

replaces the current custom properties for the folder with the specified properties.

See the ADD operation for a description of the form of the custom-properties-list value.

Default:REPLACE (if a custom properties list is specified with no operation keyword)

Interaction:If you specify both the ADD and REMOVE operations, then the REMOVE operation occurs first.

DESCRIPTION="descriptive-text"

specifies the description of the folder.

Alias:DESC=

LOCATION="current-parent-folder-name"

LOCATION="current-parent-folder-path"

specifies the current parent folder of the folder that you are updating. The following rules apply:

• If the folder is in the root directory of the information map, then you can specify the folder by name without an initial slash. For example, location="CUSTOMERS".
• If the parent folder is not in the root directory, then you must qualify it with a location that starts with a slash. For example, location="/CUSTOMERS/Europe".

Restriction:The root folder cannot be updated.

NAME="new-folder-name"

specifies the new name of the folder.