%mdlmgr_AddFolder Macro

Adds a folder to the Project Tree.

Syntax

Required Arguments

Optional Arguments

Syntax

%mdlmgr_AddFolder(

ParentId=parent-UUID-or-path

Name=folder-name

<Desc=description>

NewFolderId=folder-Id-variable

<Trace=On | Off>

);

Required Arguments

ParentId=parent-UUID-or-path

specifies the UUID or the model repository path of the parent folder.

If the folder that you are creating is a subfolder, you can use the value of NewFolderId= that was specified during the macro call of parent folder as the value for parent-UUID-or-path. For example, if a parent folder exists and NewFolderId=&folderId was set in the macro call for the parent folder, then you can specify ParentId=&folderId in the subfolder macro call.

If you specify the repository path, use one of these forms:

//ModelManagerDefaultRepo/MMRoot/
//ModelManagerDefaultRepo/MMRoot/folder-name/

Restriction

A folder can be added only to the MMRoot node or a folder in the Project Tree.

Name=folder-name

specified the name of the folder. The name can contain letters, spaces, the underscore ( _ ), the hyphen ( - ), and the period ( . ).

NewFolderId=folder-Id-variable

specifies a variable that is used to identify the new folder.

SAS Model Manager creates a global macro variable, %folder-Id-variable whose value is the folder UUID or the path in the SAS Metadata Repository. You can use &folder-Id-variable as the value of a ParentId= argument in the %mdlmgr_AddFolder( ) or %mdlmgr_AddProject( ) macros. For example, if NewFolderId=folderId, then you can use ParentId=&folderId in the %mdlmgr_AddProject( ) macro.

Optional Arguments

Desc=description

specifies a description of the folder.

Trace=On | Off

specifies whether to supply verbose trace messages to the SAS log.

Default

Off