diff --git a/docs/img/libraries.png b/docs/img/libraries.png new file mode 100644 index 0000000..8245fdb Binary files /dev/null and b/docs/img/libraries.png differ diff --git a/docs/libraries.md b/docs/libraries.md new file mode 100644 index 0000000..e8ed24d --- /dev/null +++ b/docs/libraries.md @@ -0,0 +1,37 @@ +--- +layout: article +title: Libraries +description: Libraries in Data Controller are configurable in different ways according to the SAS flavour in use. +og_image: img/libraries.png +--- + +# Adding Libraries to Data Controller + +The process for adding new libraries to Data Controller depends on whether we are talking about: + +* The VIEW or EDIT menu +* Which flavour of SAS is being used + +In VIEW mode, all available libraries are shown, unless the [DC_RESTRICT_VIEWER](/dcc-options/#dc_restrict_viewer) option is set. + +In EDIT mode, only the libraries corresponding to the configuration in [MPE_TABLES](/dcc-tables) are visible. This list may be shorter if the user is not in the [admin group](/dcc-groups/#data-controller-admin-group) or does not have the necessary [security](/dcc-security/) settings. + +![library list](img/libraries.png) + +Flavour specific guidance is below. + +## Viya Libraries + +Library definitions should be added in the `autoexec.sas` of the configured Compute Context using Environment Manager. + +## SAS 9 EBI Libraries + +Library definitions can be added in the `[DC Meta Path]/services/public/Data_Controller_Settings` stored process, IF required. In most cases, libname statements are NOT required because they are taken from metadata. + +For the VIEW menu, the libname statement is made using the [mm_assignlib](https://core.sasjs.io/mm__assignlib_8sas.html) macro (META engine). It is important that each library has a unique (up to 8 char) LIBREF. + +For the EDIT menu, direct libname statements are derived using the [mm_assigndirectlib](https://core.sasjs.io/mm__assigndirectlib_8sas.html) macro. + +## SASjs Server Libraries + +New library definitions can be added in the `[DC Drive Path]/services/public/settings.sas` stored program. diff --git a/mkdocs.yml b/mkdocs.yml index 1675a9b..3349b3c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -31,6 +31,7 @@ nav: - Excel Formulas: excel.md - Formats: formats.md - Groups: dcc-groups.md + - Libraries: libraries.md - Options: dcc-options.md - Row Level Security: row-level-security.md - Security: dcc-security.md