Module UtilityService

Macros to derive relative and absolute paths.

Since: 2.1

Macro Summary
external

LSAF
%lsaf_getabsolutepath(lsaf_base_path=, lsaf_relative_path=);
Gets an absolute path for an item relative to the specified base path. Neither path is ...
external

LSAF
%lsaf_getrelativepath(lsaf_base_path=, lsaf_absolute_path=);
Gets a relative path for an item relative to the specified base path. Neither path is ...

Macro Detail

%lsaf_getabsolutepath(lsaf_base_path=, lsaf_relative_path=);

[ Exposure: external ]
Gets an absolute path for an item relative to the specified base path. Neither path is
validated for existence or for valid characters. Logging in to SAS Life Science Analytics
Framework is not required to perform this operation.

The macro variable _lsafAbsolutePath_ is set to the absolute path or blank, if the operation
fails.

Syntax
%LSAF_GETABSOLUTEPATH(LSAF_BASE_PATH=lsaf-base-path, LSAF_RELATIVE_PATH=lsaf-relative-path);

          
History:
   2017-01-19
original coding
   2019-02-13
update to 2.1
Expected Macro Variables:
_lsafAbsolutePath_ - The absolute path.
_lsafMsg_ - The return message.
_lsafRC_ - The return code.
Parameters:
lsaf_base_path - - Required - The absolute path to the base container location.
lsaf_relative_path - - Required - The path of the file relative to the base path. A
        value of . returns the full base path. A value of .. returns the parent of the base
        path. For example, if the base path is /SAS/Folder1/Folder2/Folder3
        - A parameter value of ./File4 returns an absolute path value of
        /SAS/Folder1/Folder2/Folder3/Folder4
        - A parameter value of ../Folder4 returns an absolute path value of
        /SAS/Folder1/Folder2/Folder4
        - A parameter value of ../../Folder4 returns an absolute path value of
        /SAS/Folder1/Folder4
File: lsaf_getabsolutepath.sas
First available in version: 1.5

%lsaf_getrelativepath(lsaf_base_path=, lsaf_absolute_path=);

[ Exposure: external ]
Gets a relative path for an item relative to the specified base path. Neither path is
validated for existence or for valid characters. Logging in to SAS Life Science Analytics
Framework is not required to perform this operation.

The macro variable _lsafRelativePath_ is set to the relative path or blank, if the operation
fails.

Syntax
%LSAF_GETRELATIVEPATH(LSAF_BASE_PATH=lsaf-base-path, LSAF_ABSOLUTE_PATH=lsaf-absolute-path);

          
History:
   2016-10-25
original coding
   2019-02-13
update to 2.1
Expected Macro Variables:
_lsafMsg_ - The return message.
_lsafRC_ - The return code.
_lsafRelativePath_ - The relative path.
Parameters:
lsaf_base_path - - Required - The absolute path to the base container location.
lsaf_absolute_path - - Required - The absolute path of the file relative to the base path.
File: lsaf_getrelativepath.sas
First available in version: 1.5