SAS Packages Framework, version 20220925

**SAS Packages Framework**, version `20220925` New parameter `mirror=` added to the `%installPackage()` macro. The `mirror` indicates which web location for packages installation is used. Value `1` indicates: `https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main` Value `2` indicates: `https://pages.mini.pw.edu.pl/~jablonskib/SASpublic/SAS_PACKAGES` Default value is `1`.
Merge pull request #50 from beauweta/patch-1
2026-01-06 22:50:05 +00:00 · 2022-09-25 19:11:55 +02:00 · 2022-08-30 19:16:32 +02:00 · 2022-08-30 18:56:26 +02:00 · 2022-05-31 21:53:53 +02:00 · 2022-05-31 21:50:58 +02:00
18 changed files with 855 additions and 162 deletions
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ A **SAS package** is an automatically generated, single, stand alone *zip* file
 The *purpose of a package* is to be a simple, and easy to access, code sharing medium, which will allow: on the one hand, to separate the code complex dependencies created by the developer from the user experience with the final product and, on the other hand, reduce developer's and user's unnecessary frustration related to a remote deployment process.
-In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. **The latest version** of SPF is **`20220420`**.  
+In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. **The latest version** of SPF is **`20220925`**.  
 To get started with SAS Packages try this [**`Getting Started with SAS Packages`**](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf "Getting Started with SAS Packages") presentation (see the `./SPF/Documentation` directory).
@@ -23,6 +23,13 @@ Short description of the SAS Packages Framework macros can be found [here](https
  - [SAS dla Administratorów i Praktyków 2020](https://www.youtube.com/watch?v=mXuep2k48Z8&feature=youtu.be&t=0s "SASAiP2020") (October 2020, in Polish)
  - [Boston Area SAS Users Group webinar](https://www.basug.org/videos?wix-vod-video-id=78067e61413d43d3a6951974b3bc3014&wix-vod-comp-id=comp-klv807gt "BASUG") (November 2020)
  - [SAS Global Forum 2021 V.E.](https://www.youtube.com/watch?v=hqexaQtGw88 "SGF2021") (May 20th, 2021)
 ---
 ### Initiative to add SAS Packages Framework to SAS Base/Viya:
 A **SASware Ballot Idea** for adding *SAS Packages Framework* macros into Base SAS and Viya was submitted Friday, May 27th 2022. If you would like to support the idea visit this [communities.sas.com post](https://communities.sas.com/t5/SASware-Ballot-Ideas/Add-SAS-Packages-Framework-to-the-SAS-Base-Viya/idi-p/815508) and up vote the idea!
 ---
 ### The User:
@@ -93,7 +100,7 @@ This is a list of locations where the SAS Packages Framework is used:
 If you want to share that you are using the SPF let me know and I'll update the list.
-If you find the SPF usefull **share info** about it or **give it a [star](https://github.com/yabwon/SAS_PACKAGES/stargazers)** so more people will know.
+If you find the SPF useful **share info** about it or **give it a [star](https://github.com/yabwon/SAS_PACKAGES/stargazers)** so more people will know.
 ---
@@ -106,7 +113,7 @@ Currently the following packages are available (see the `./packages` directory):
    set %SQL(select * from sashelp.class order by age);
  run;
 ```
-SHA256 digest for SQLinDS: 701B69BE71B99792803BCE7718ED486259310FFB92E6D77ED1BC029D9CC67B60
+SHA256 digest for SQLinDS: 96D0EFE02DF1AE0D7D875A10CAF7EF63CDEF85DD0CF9418934BEFAF0C067D453
 [Documentation for SQLinDS](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/sqlinds.md "Documentation for SQLinDS")
@@ -118,7 +125,7 @@ SHA256 digest for MacroCore: A23C29529F3CE7D0C8BEE9545C5D22D5B5594907547374A5135
 - **DFA** (Dynamic Function Arrays)\[0.5\], contains set of macros and FCMP functions which implement: a dynamically allocated array, a stack, a fifo queue, an ordered stack, and a priority queue, run `%helpPackage(DFA,createDFArray)` to find examples.
-SHA256 digest for DFA: 6B3FB0B06B47A7EF1BB004B483B0F39B8F553F7F16D02A7E24CDE388BBA704EA
+SHA256 digest for DFA: 5BFFCE78439E1CDDCBB15C95CD287AA4195BF64BB17DDB8FE374EC3535B4F491
 [Documentation for DFA](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/dfa.md "Documentation for DFA")
@@ -141,12 +148,12 @@ SHA256 digest for DFA: 6B3FB0B06B47A7EF1BB004B483B0F39B8F553F7F16D02A7E24CDE388B
      which = 1:H:2
  );
 ```
-SHA256 digest for macroArray: DF63B0E027827A82038F1C8422787A0BC569BA93104BA1778DB6DD088A5D255C
+SHA256 digest for macroArray: ED12BC96F8A4E9E7C4D651EC1E15479DB9B55D98B274B63C507ED842081F7AB7
 [Documentation for macroArray](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/macroarray.md "Documentation for macroArray")
- **BasePlus**\[1.14\] adds a bunch of functionalities I am missing in BASE SAS, such as:
+- **BasePlus**\[1.17\] adds a bunch of functionalities I am missing in BASE SAS, such as:
 ```sas
 call arrMissToRight(myArray); 
 call arrFillMiss(17, myArray); 
@@ -164,7 +171,7 @@ format x bool.;
 %zipLibrary(sashelp,libOut=work)
 ```
-SHA256 digest for BasePlus: 12A9A2155D9C6F969DF0A66E3A18D0938B8194FA3AA9D70EDDE1CB71DEF9691E
+SHA256 digest for BasePlus: 56B260350FEB7D5118F581B9EFD1B9CE1F0298DCB9A4C000A7654E2FF3F0298C
 [Documentation for BasePlus](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/baseplus.md "Documentation for BasePlus")
@@ -173,12 +180,12 @@ SHA256 digest for BasePlus: 12A9A2155D9C6F969DF0A66E3A18D0938B8194FA3AA9D70EDDE1
 The dataset with functions can be shared between different operating systems
 and allows to generate macros on site without showing their code.
-SHA256 digest for GSM: E6E2A6214EE7DC6E06AA76916A68B216DD7665184E63CF2C01F487A038E71B09
+SHA256 digest for GSM: 2AEBC150FBA99A4AAB0265A21C57E89200BFD96B633B898F32743D1C8831A159
 [Documentation for GSM](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/gsm.md "Documentation for GSM")
 - **dynMacroArray**\[0.2\], set of macros (wrappers for a hash table) emulating dynamic array in the data step (macro predecessor of DFA)
-SHA256 digest for dynMacroArray: 7DA9BFDED37C18C4FB5BD7579A81A4B2578EEEF1546D1A3AB5C80DE07C88A615
+SHA256 digest for dynMacroArray: D7E0B8F85C05EBF8622204E0D2F3E990D48D0A9B3911051C3AD44DC98954DDCF
 ### ======
--- a/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf
+++ b/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf
--- a/SPF/Documentation/SAS(r)
+++ b/SPF/Documentation/SAS(r)
--- a/SPF/SPFinit.md
+++ b/SPF/SPFinit.md
@@ -21,7 +21,7 @@ A **SAS package** is an automatically generated, single, stand alone *zip* file
 The *purpose of a package* is to be a simple, and easy to access, code sharing medium, which will allow: on the one hand, to separate the code complex dependencies created by the developer from the user experience with the final product and, on the other hand, reduce developer's and user's unnecessary frustration related to a remote deployment process.
-In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20220420`**.  
+In this repository we are presenting the **SAS Packages Framework** which allows to develop and use SAS packages. The latest version of SPF is **`20220925`**.  
 **To get started with SAS Packages** try this [**`Getting Started with SAS Packages`**](https://github.com/yabwon/SAS_PACKAGES/blob/main/SPF/Documentation/Getting_Started_with_SAS_Packages.pdf "Getting Started with SAS Packages") presentation (see the `./SPF/Documentation` directory).
@@ -39,7 +39,7 @@ After assigning the directory do not change them when using the SPF since it may
 ##       This is short help information for the `installPackage` macro <a name="installpackage"></a>                     
 --------------------------------------------------------------------------------------------
- Macro to install SAS packages, version `20220420`                                          
+ Macro to install SAS packages, version `20220925`                                          
 A SAS package is a zip file containing a group                                             
 of SAS codes (macros, functions, data steps generating                                     
@@ -70,8 +70,15 @@ After assigning the directory do not change them when using the SPF since it may
                   Current default location for the framework is:  
                   `https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/`  
 - `mirror=`       Indicates which web location for packages installation is used.          
                   Value `1` indicates:                                                     
                   `https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main`             
                   Value `2` indicates:                                                     
                   `https://pages.mini.pw.edu.pl/~jablonskib/SASpublic/SAS_PACKAGES`        
                   Default value is `1`.                                                    
 - `replace=`      With default value of `1` it causes existing package file                
-                   to be replaceed by new downloaded file.                                  
+                   to be replaced by new downloaded file.                                   
 - `URLuser=`      A user name for the password protected URLs, no quotes needed.           
@@ -108,7 +115,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##       This is short help information for the `helpPackage` macro <a name="helppackage"></a>           
 -------------------------------------------------------------------------------
- Macro to get help about SAS packages, version `20220420`                      
+ Macro to get help about SAS packages, version `20220925`                      
 A SAS package is a zip file containing a group                                
 of SAS codes (macros, functions, data steps generating                        
@@ -178,7 +185,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `loadPackage` macro <a name="loadpackage"></a>            
 -------------------------------------------------------------------------------
- Macro to *load* SAS packages, version `20220420`                              
+ Macro to *load* SAS packages, version `20220925`                              
 A SAS package is a zip file containing a group                                
 of SAS codes (macros, functions, data steps generating                        
@@ -251,7 +258,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `loadPackageS` macro <a name="loadpackages"></a>          
 -------------------------------------------------------------------------------
- Macro wrapper for the loadPackage macro, version `20220420`                   
+ Macro wrapper for the loadPackage macro, version `20220925`                   
 A SAS package is a zip file containing a group                                
 of SAS codes (macros, functions, data steps generating                        
@@ -300,7 +307,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `unloadPackage` macro <a name="unloadpackage"></a>          
 -------------------------------------------------------------------------------
- Macro to unload SAS packages, version `20220420`                              
+ Macro to unload SAS packages, version `20220925`                              
 A SAS package is a zip file containing a group                                
 of SAS codes (macros, functions, data steps generating                        
@@ -365,7 +372,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##       This is short help information for the `listPackages` macro <a name="listpackages"></a>                    
 -----------------------------------------------------------------------------------------
- Macro to list available SAS packages, version `20220420`                                
+ Macro to list available SAS packages, version `20220925`                                
 A SAS package is a zip file containing a group                                          
 of SAS codes (macros, functions, data steps generating                                  
@@ -406,7 +413,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `verifyPackage` macro <a name="verifypackage"></a>         
 -------------------------------------------------------------------------------
- Macro to verify SAS package with it hash digest, version `20220420`           
+ Macro to verify SAS package with it hash digest, version `20220925`           
 A SAS package is a zip file containing a group                                
 of SAS codes (macros, functions, data steps generating                        
@@ -460,7 +467,7 @@ filename packages "C:/SAS_PACKAGES"; %* set-up a directory for packages;
 ##    This is short help information for the `previewPackage` macro <a name="previewpackage"></a>
 -------------------------------------------------------------------------------
- Macro to get previwe of a SAS packages, version `20220420`
+ Macro to get previwe of a SAS packages, version `20220925`
 A SAS package is a zip file containing a group
 of SAS codes (macros, functions, data steps generating
@@ -527,7 +534,7 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 ##      This is short help information for the `generatePackage` macro <a name="generatepackage"></a>        
 -------------------------------------------------------------------------------
- Macro to generate SAS packages, version `20220420`                            
+ Macro to generate SAS packages, version `20220925`                            
 A SAS package is a zip file containing a group                                
 of SAS codes (macros, functions, data steps generating                        
@@ -567,10 +574,15 @@ filename packages "C:/SAS_PACKAGES"; %* setup a directory for packages;
 - `sasexe=`         Location of a DIRECTORY where the SAS binary is located,
                    if null (the default) then the `!SASROOT` is used.      
- `sascfgfile=`     Location of a FILE with testing session configuration   
+- `sascfgFile=`     Location of a FILE with testing session configuration   
                    parameters, if null (the default) then no config file   
                    is pointed during the SAS invocation,                   
                    if set to `DEF` then the `!SASROOT/sasv9.cfg` is used.  
 - `delTestWork=`    Indicates if `WORK` directories generated by user tests 
                    should be deleted, i.e. the (NO)WORKTERM option is set. 
                    The default value: `1` means "delete tests work".       
                    Available values are `0` and `1`.                       
 ------------------------------------------------------------------------------- 
@@ -703,7 +715,7 @@ All files have to have `.sas` extension. Other files are ignored.
 ##      This is short help information for the `extendPackagesFileref` macro <a name="extendpackagesfileref"></a>        
 -----------------------------------------------------------------------------------------
- Macro to list directories pointed by 'packages' fileref, version `20220420`             
+ Macro to list directories pointed by 'packages' fileref, version `20220925`             
 A SAS package is a zip file containing a group                                          
 of SAS codes (macros, functions, data steps generating                                  
--- a/SPF/SPFinit.sas
+++ b/SPF/SPFinit.sas
@@ -42,7 +42,7 @@
   - to unload, or
   - to generate SAS packages.
-  Version 20220420.
+  Version 20220925.
  See examples below.
  A SAS package is a zip file containing a group of files
@@ -81,7 +81,7 @@
                                       */
 )/secure 
 /*** HELP END ***/
-des = 'Macro to load SAS package, version 20220420. Run %loadPackage() for help info.'
+des = 'Macro to load SAS package, version 20220925. Run %loadPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
  %do;
@@ -96,7 +96,7 @@ des = 'Macro to load SAS package, version 20220420. Run %loadPackage() for help
    %put ###      This is short help information for the `loadPackage` macro             #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro to *load* SAS packages, version `20220420`                              #;
+    %put # Macro to *load* SAS packages, version `20220925`                              #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -271,7 +271,7 @@ des = 'Macro to load SAS package, version 20220420. Run %loadPackage() for help
                                       */
 )/secure
 /*** HELP END ***/
-des = 'Macro to unload SAS package, version 20220420. Run %unloadPackage() for help info.'
+des = 'Macro to unload SAS package, version 20220925. Run %unloadPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
  %do;
@@ -286,7 +286,7 @@ des = 'Macro to unload SAS package, version 20220420. Run %unloadPackage() for h
    %put ###      This is short help information for the `unloadPackage` macro           #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro to unload SAS packages, version `20220420`                              #;
+    %put # Macro to unload SAS packages, version `20220925`                              #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -430,7 +430,7 @@ des = 'Macro to unload SAS package, version 20220420. Run %unloadPackage() for h
                                       */
 )/secure
 /*** HELP END ***/
-des = 'Macro to get help about SAS package, version 20220420. Run %helpPackage() for help info.'
+des = 'Macro to get help about SAS package, version 20220925. Run %helpPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
  %do;
@@ -445,7 +445,7 @@ des = 'Macro to get help about SAS package, version 20220420. Run %helpPackage()
    %put ###       This is short help information for the `helpPackage` macro            #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro to get help about SAS packages, version `20220420`                      #;
+    %put # Macro to get help about SAS packages, version `20220925`                      #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -575,7 +575,7 @@ TODO:
 - add MD5(&packageName.) value hash instead "package" word in filenames [DONE]
 */
-/* Macros to install SAS packages, version 20220420  */
+/* Macros to install SAS packages, version 20220925  */
 /* A SAS package is a zip file containing a group of files
   with SAS code (macros, functions, data steps generating 
   data, etc.) wrapped up together and %INCLUDEed by
@@ -586,6 +586,7 @@ TODO:
 %macro installPackage(
  packagesNames /* space separated list of packages names, without the zip extension */
 , sourcePath =  /* location of the package, e.g. "www.some.page/", mind the "/" at the end */
 , mirror = 1    /* indicates which location for package source should be used */
 , replace = 1   /* 1 = replace if the package already exist, 0 = otherwise */
 , URLuser =     /* user name for the password protected URLs */
 , URLpass =     /* password for the password protected URLs */
@@ -594,7 +595,7 @@ TODO:
 /secure
 minoperator 
 /*** HELP END ***/
-des = 'Macro to install SAS package, version 20220420. Run %%installPackage() for help info.'
+des = 'Macro to install SAS package, version 20220925. Run %%installPackage() for help info.'
 ;
 %if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
  %do;
@@ -609,7 +610,7 @@ des = 'Macro to install SAS package, version 20220420. Run %%installPackage() fo
    %put ###       This is short help information for the `installPackage` macro                      #;
    %put #--------------------------------------------------------------------------------------------#;;
    %put #                                                                                            #;
-    %put # Macro to install SAS packages, version `20220420`                                          #;
+    %put # Macro to install SAS packages, version `20220925`                                          #;
    %put #                                                                                            #;
    %put # A SAS package is a zip file containing a group                                             #;
    %put # of SAS codes (macros, functions, data steps generating                                     #;
@@ -641,8 +642,15 @@ des = 'Macro to install SAS package, version 20220420. Run %%installPackage() fo
    %put #                   Current default location for the framework is:                           #;
    %put #                   `https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/`        #;
    %put #                                                                                            #;
    %put # - `mirror=`       Indicates which web location for packages installation is used.          #;
    %put #                   Value `1` indicates:                                                     #;
    %put #                   `https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main`             #;
    %put #                   Value `2` indicates:                                                     #;
    %put #                   `https://pages.mini.pw.edu.pl/~jablonskib/SASpublic/SAS_PACKAGES`        #;
    %put #                   Default value is `1`.                                                    #;
    %put #                                                                                            #;
    %put # - `replace=`      With default value of `1` it causes existing package file                #;
-    %put #                   to be replaceed by new downloaded file.                                  #;
+    %put #                   to be replaced by new downloaded file.                                   #;
    %put #                                                                                            #;
    %put # - `URLuser=`      A user name for the password protected URLs, no quotes needed.           #;
    %put #                                                                                            #;
@@ -707,7 +715,26 @@ des = 'Macro to install SAS package, version 20220420. Run %%installPackage() fo
  %if %superq(sourcePath)= %then
    %do;
      %local SPFinitMirror;
      /* the defaults are: */
      %let SPFinitMirror = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/SPFinit.sas;
      %let sourcePath = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/packages/;
      %if 1 = %superq(mirror) %then
        %do;
          %let SPFinitMirror = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/SPFinit.sas;
          %let sourcePath = https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/packages/;
          %goto mirrorEnd;
        %end;
      %if 2 = %superq(mirror) %then
        %do;
          %let SPFinitMirror = https://pages.mini.pw.edu.pl/~jablonskib/SASpublic/SAS_PACKAGES/SPF/SPFinit.sas;
          %let sourcePath = https://pages.mini.pw.edu.pl/~jablonskib/SASpublic/SAS_PACKAGES/packages/;
          %goto mirrorEnd;
        %end;
      %mirrorEnd:
      %put INFO: Source path is &sourcePath.;
    %end;
  %local i;
@@ -730,7 +757,7 @@ des = 'Macro to install SAS package, version 20220420. Run %%installPackage() fo
      %do;
        /* allows to install/download the framework file like any other package */
        filename &in URL 
-          "https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main/SPF/SPFinit.sas" 
+          "&SPFinitMirror." 
          recfm=N lrecl=1;
        filename &out    
          "&firstPackagesPath./SPFinit.sas" 
@@ -923,7 +950,7 @@ des = 'Macro to install SAS package, version 20220420. Run %%installPackage() fo
 /* Macro to list SAS packages in packages folder. 
-  Version 20220420 
+  Version 20220925 
  A SAS package is a zip file containing a group 
  of SAS codes (macros, functions, data steps generating 
@@ -943,7 +970,7 @@ des = 'Macro to install SAS package, version 20220420. Run %%installPackage() fo
 %macro listPackages()/secure PARMBUFF
-des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20220420.'
+des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HELP) for help, version 20220925.'
 ;
 %if %QUPCASE(&SYSPBUFF.) = %str(%(HELP%)) %then
  %do;
@@ -958,7 +985,7 @@ des = 'Macro to list SAS packages from `packages` fileref, type %listPackages(HE
    %put ###       This is short help information for the `listPackages` macro                     #;
    %put #-----------------------------------------------------------------------------------------#;;
    %put #                                                                                         #;
-    %put # Macro to list available SAS packages, version `20220420`                                #;
+    %put # Macro to list available SAS packages, version `20220925`                                #;
    %put #                                                                                         #;
    %put # A SAS package is a zip file containing a group                                          #;
    %put # of SAS codes (macros, functions, data steps generating                                  #;
@@ -1108,7 +1135,7 @@ options ls = &ls_tmp. ps = &ps_tmp. &notes_tmp. &source_tmp.;
 /* Macro to generate SAS packages.
-   Version 20220420
+   Version 20220925
   A SAS package is a zip file containing a group 
   of SAS codes (macros, functions, data steps generating 
@@ -1135,13 +1162,16 @@ options ls = &ls_tmp. ps = &ps_tmp. &notes_tmp. &source_tmp.;
                    if null (the default) the WORK is used */
 ,sasexe=         /* a DIRECTORY where the SAS binary is located,
                    if null (the default) then the !SASROOT is used */
-,sascfgfile=     /* a FILE with testing session configuration parameters
+,sascfgFile=     /* a FILE with testing session configuration parameters
                    if null (the default) then no config file is pointed
                    during the SAS invocation,
                    if set to DEF then the !SASROOT/sasv9.cfg is used */
 ,delTestWork=1   /* indicates if `WORK` directories generated by user tests
                    should be deleted, i.e. the (NO)WORKTERM option is set,
                    default value 1 means "delete tests work" */
 )/secure minoperator
 /*** HELP END ***/
-des = 'Macro to generate SAS packages, version 20220420. Run %generatePackage() for help info.'
+des = 'Macro to generate SAS packages, version 20220925. Run %generatePackage() for help info.'
 ;
 %if (%superq(filesLocation) = ) OR (%qupcase(&filesLocation.) = HELP) %then
  %do;
@@ -1156,7 +1186,7 @@ des = 'Macro to generate SAS packages, version 20220420. Run %generatePackage()
    %put ###      This is short help information for the `generatePackage` macro         #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro to generate SAS packages, version `20220420`                            #;
+    %put # Macro to generate SAS packages, version `20220925`                            #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -1196,11 +1226,16 @@ des = 'Macro to generate SAS packages, version 20220420. Run %generatePackage()
    %put # - `sasexe=`         Location of a DIRECTORY where the SAS binary is located,  #;
    %put #                     if null (the default) then the `!SASROOT` is used.        #;
    %put #                                                                               #;
-    %put # - `sascfgfile=`     Location of a FILE with testing session configuration     #;
+    %put # - `sascfgFile=`     Location of a FILE with testing session configuration     #;
    %put #                     parameters, if null (the default) then no config file     #;
    %put #                     is pointed during the SAS invocation,                     #;
    %put #                     if set to `DEF` then the `!SASROOT/sasv9.cfg` is used.    #;
    %put #                                                                               #;
    %put # - `delTestWork=`    Indicates if `WORK` directories generated by user tests   #;
    %put #                     should be deleted, i.e. the (NO)WORKTERM option is set.   #;
    %put #                     The default value: `1` means "delete tests work".         #;
    %put #                     Available values are `0` and `1`.                         #;
    %put #                                                                               #;
    %put #-------------------------------------------------------------------------------#;
    %put #################################################################################;
    %put ;
@@ -1208,11 +1243,12 @@ des = 'Macro to generate SAS packages, version 20220420. Run %generatePackage()
    %GOTO ENDofgeneratePackage;
  %end;
-%local zipReferrence filesWithCodes _DESCR_ _LIC_ _RC_ _PackageFileref_;
+%local zipReferrence filesWithCodes _DESCR_ _LIC_ _DUMMY_ _RC_ _PackageFileref_;
 %let   zipReferrence = _%sysfunc(datetime(), hex6.)_;
 %let   filesWithCodes = WORK._%sysfunc(datetime(), hex16.)_;
 %let   _DESCR_ = _%sysfunc(datetime(), hex6.)d;
 %let   _LIC_   = _%sysfunc(datetime(), hex6.)l;
 %let   _DUMMY_ = _%sysfunc(datetime(), hex6.)_;
 /* collect package metadata from the description.sas file */
 filename &_DESCR_. "&filesLocation./description.sas" lrecl = 1024;
@@ -1221,7 +1257,10 @@ filename &_LIC_.   "&filesLocation./license.sas" lrecl = 1024;
 %if %sysfunc(fexist(&_DESCR_.)) %then 
  %do;
-    %put NOTE: Creating package metadata; 
+    %put NOTE- ;
    %put NOTE: Verifying package metadata; 
    %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^^^; 
    %put NOTE- ; 
    %local packageName        /* name of the package, required */  
           packageVersion     /* version of the package, required */
@@ -1233,6 +1272,10 @@ filename &_LIC_.   "&filesLocation./license.sas" lrecl = 1024;
           packageRequired    /* optional */
           packageReqPackages /* optional */
           ;
    %local qlenmax_fstimer_tmp;
    %let qlenmax_fstimer_tmp = %sysfunc(getoption(quotelenmax)) %sysfunc(getoption(stimer)) %sysfunc(getoption(fullstimer));
    options NOquotelenmax NOstimer NOfullstimer;
    data _null_;
      infile &_DESCR_.;
      input;
@@ -1253,6 +1296,7 @@ filename &_LIC_.   "&filesLocation./license.sas" lrecl = 1024;
        otherwise;
      end;
    run;
    options &qlenmax_fstimer_tmp.;
    /* test for required descriptors */
    %if (%nrbquote(&packageName.) = )
@@ -1318,6 +1362,105 @@ filename &_LIC_.   "&filesLocation./license.sas" lrecl = 1024;
        %abort;
      %end;
  %if %bquote(&packageRequired.) ne %then
    %do;
      /* turn off the note about quoted string length */
      %local qlenmax_fstimer_tmp;
      %let qlenmax_fstimer_tmp = %sysfunc(getoption(quotelenmax)) %sysfunc(getoption(stimer)) %sysfunc(getoption(fullstimer));
      options NOquotelenmax NOstimer NOfullstimer;
      %local tryExcept;
      %let tryExcept = 0;
      data _null_;
        rc = dosubl('options nonotes nosource;
        filename &_DUMMY_. DUMMY;
        proc printto log = &_DUMMY_.; run;' !!
       '%let SYSCC = 0;
        data _null_;
          length rq $ 164;
          do rq = &packageRequired.;
          end;
        run;' !!
       '%let tryExcept = &SYSCC.; filename &_DUMMY_. clear;');
        tryExcept = symgetn('tryExcept');
        put "NOTE: Required test: " rc= tryExcept= "(double 0 is success)";
        if tryExcept then 
          do;
            put 'ERROR: Your Required list seems to be problematic.';
            put 'ERROR- Check the description.sas file.';
            put 'ERROR- Expected form is "Quoted" Comma, ..., Separated List, e.g.';
            put 'ERROR- "SAS Component1", "SAS Component2", "SAS Component3"';
            put 'ERROR- Provided value is:';
            length R $ 32767;
            R = symget('packageRequired');
            put 'ERROR- ' R;
          end;
        else
          rc = dosubl('title; options nonotes nosource ps=max ls=99 nodate nonumber nostimer;
            data _null_;
              length rq $ 64; put "Required:";
              do rq = &packageRequired.;
                put "- " rq;
              end;
            run;');
      run;
      /* turn on the original value of the note about quoted string length */
      options &qlenmax_fstimer_tmp.;
      %if &tryExcept. %then %abort;
    %end;
  %if %bquote(&packageReqPackages.) ne %then
    %do;
      /* turn off the note about quoted string length */
      %local qlenmax_fstimer_tmp;
      %let qlenmax_fstimer_tmp = %sysfunc(getoption(quotelenmax)) %sysfunc(getoption(stimer)) %sysfunc(getoption(fullstimer));
      options NOquotelenmax NOstimer NOfullstimer;
      %local tryExcept;
      %let tryExcept = 0;
      data _null_;
        rc = dosubl('options nonotes nosource;
        filename &_DUMMY_. DUMMY;
        proc printto log = &_DUMMY_.; run;' !!
       '%let SYSCC = 0;
        data _null_;
          length rq $ 64;
          do rq = &packageReqPackages.;
          end;
        run;' !!
       '%let tryExcept = &SYSCC.; filename &_DUMMY_. clear;');
        tryExcept = symgetn('tryExcept');
        put "NOTE: ReqPackages test: " rc= tryExcept= "(double 0 is success)";
        if tryExcept then 
          do;
            put 'ERROR: Your ReqPackages list seems to be problematic.';
            put 'ERROR- Check the description.sas file.';
            put 'ERROR- Expected form is "Quoted" Comma, ..., Separated List, e.g.';
            put 'ERROR- "Package1 (X.X)", "Package2 (Y.Y)", "Package3 (Z.Z)"';
            put 'ERROR- Provided value is:';
            length R $ 32767;
            R = symget('packageReqPackages');
            put 'ERROR- ' R;
          end;
        else
          rc = dosubl('title; options nonotes nosource ps=max ls=66 nodate nonumber nostimer;
            data _null_;
              length rq $ 64; put "ReqPackages:";
              do rq = &packageReqPackages.;
                put "- " rq;
              end;
            run;');
      run;
      /* turn on the original value of the note about quoted string length */
      options &qlenmax_fstimer_tmp.;
      %if &tryExcept. %then %abort;
    %end;
  %end;
 %else
  %do;
@@ -1327,6 +1470,11 @@ filename &_LIC_.   "&filesLocation./license.sas" lrecl = 1024;
    %abort;
  %end;
 %local qlenmax_fstimer_tmp;
 %let qlenmax_fstimer_tmp = %sysfunc(getoption(quotelenmax)) %sysfunc(getoption(stimer)) %sysfunc(getoption(fullstimer));
 options NOquotelenmax NOstimer NOfullstimer;
 /* generate package fileref with MD5 to allow 
   different file reference for each package 
   while loading package with %loadPackage() macro
@@ -1493,6 +1641,9 @@ DESCRIPTION END:
 /* collect the data */
 data &filesWithCodes.;
  putlog "NOTE: Generating content dataset: &filesWithCodes..";
  putlog "NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^";
  putlog "NOTE- ";
  base = "&filesLocation.";
  length folder file lowcase_name $ 256 folderRef fileRef $ 8;
  drop lowcase_name;
@@ -1557,6 +1708,11 @@ data &filesWithCodes.;
  end;
  stop;
 run;
 %local notesSourceOptions;
 %let notesSourceOptions = %sysfunc(getoption(notes)) %sysfunc(getoption(source));
 options NOnotes NOsource;
 proc sort data = &filesWithCodes.;
  by order type file;
 run;
@@ -1582,8 +1738,13 @@ title6 "MD5 hashed fileref of package lowcase name: &_PackageFileref_.";
 proc print data = &filesWithCodes.(drop=base folderRef fileRef rc folderid _abort_ fileId);
 run;
 title;
 options &notesSourceOptions.;
 /* packages description */
 %put NOTE: Preparing description file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  infile &_DESCR_.;
  file &zipReferrence.(description.sas) encoding = &packageEncoding.;
@@ -1592,6 +1753,9 @@ data _null_;
 run;
 /* package license */
 %put NOTE: Preparing license file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 %if %sysfunc(fexist(&_LIC_.)) %then 
  %do;
    data _null_;
@@ -1632,6 +1796,9 @@ run;
  %end;
 /* package metadata */
 %put NOTE: Preparing metadata file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  if 0 then set &filesWithCodes. nobs=NOBS;
  if NOBS = 0 then
@@ -1677,6 +1844,9 @@ run;
  %ICEloadpackage(sqlinds)
 */
 %put NOTE: Preparing iceloadpackage file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  file &zipReferrence.(iceloadpackage.sas) encoding = &packageEncoding.;
  put " ";
@@ -1727,6 +1897,9 @@ run;
 /* loading package files */
 %put NOTE: Preparing load file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  if NOBS = 0 then stop;
@@ -2079,6 +2252,9 @@ data _null_;
 run;
 /* to load lazydata */
 %put NOTE: Preparing "lazydata" file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  if NOBS = 0 then stop;
@@ -2133,6 +2309,9 @@ run;
 /* unloading package objects */
 %put NOTE: Preparing unload file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  /* break if no data */
  if NOBS = 0 then stop;
@@ -2374,6 +2553,9 @@ data _null_;
 run;
 /* package preview, i.e. print out all content of the package files into the log */
 %put NOTE: Preparing preview file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  /* break if no data */
  if NOBS = 0 then stop;
@@ -2485,6 +2667,9 @@ data _null_;
 run;
 /* package help */
 %put NOTE: Preparing help file.;
 %put NOTE- ^^^^^^^^^^^^^^^^^^^^;
 %put NOTE-;
 data _null_;
  /* break if no data */
  if NOBS = 0 then stop;
@@ -2555,7 +2740,7 @@ data _null_;
    put '  end ;                                                                 ';
  %end;
-  put 'put "***"; put "* SAS package generated by generatePackage, version 20220420 *"; put "***";';
+  put 'put "***"; put "* SAS package generated by generatePackage, version 20220925 *"; put "***";';
  put 'run;                                                                      ' /;
@@ -2694,7 +2879,7 @@ data _null_;
  call execute('    put Try= " File existence in ZIP verified as: " ex;');
  call execute('  end ;');
-  call execute('  if ex then put "File " pathname "copied into the package with return code: " rc;');
+  call execute('  if ex then put "File " pathname "copied into the package with return code: " rc "(0 = success)";');
  call execute('        else do;');
  call execute('          put "ERROR: File " pathname "NOT copied into the package!" ;');
  call execute('          call symputX("createPackageContentStatus",1,"L");');
@@ -2754,7 +2939,9 @@ data _null_;
 run;
 options notes source;
 %put NOTE-;
 %put NOTE-######################################################;
 %put NOTE-;
 options &notesSourceOptions.;
 /*
 proc sql;
@@ -2768,20 +2955,28 @@ filename &zipReferrence. clear;
 /* create hash SHA256 id */
 %if %sysfunc(exist(sashelp.vfunc, VIEW)) %then
 %do;
  %put NOTE-;
  %put NOTE: Calculating SHA256 check sum.;
  %put NOTE- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^;
  %put NOTE-;
  filename &zipReferrence. "&filesLocation./%lowcase(&packageName.).zip";
  filename &zipReferrence. list;
  %local notesSourceOptions;
  %let notesSourceOptions = %sysfunc(getoption(notes)) %sysfunc(getoption(source));
  options NOnotes NOsource;
  data _null_;
    set sashelp.vfunc(keep=fncname);
    where fncname = "HASHING_FILE";
    call execute('
      data the_SHA256_hash_id;
        SHA256 = HASHING_FILE("SHA256", "&zipReferrence.", 4);
-        lable SHA256 = "The SHA256 hash digest for package &packageName.:";
+        label SHA256 = "The SHA256 hash digest for package &packageName.:";
-        put SHA256=;
+        put / @7 SHA256= / " ";
      run;');
    call execute('proc print data = the_SHA256_hash_id noobs label; run;');
    stop;
  run;
  options &notesSourceOptions.;
  filename &zipReferrence. clear;
 %end;
 /*+++++++++++++++++++++++*/
@@ -2802,6 +2997,10 @@ filename &zipReferrence. clear;
  %end;
 %put NOTE-;
 %put NOTE: Running tests.;
 %put NOTE- ^^^^^^^^^^^^^^;
 %put NOTE-;
 /* in case the packages macrovariable is multi-directory the first directory will be selected */
 data _null_;
  call symputX("packages", dequote(kscanx(resolve(symget("packages")), 1, "()", "QS")) ,"L");
@@ -2867,7 +3066,7 @@ run;
    filename sasroot "!SASROOT";
    %let SASROOT=%sysfunc(PATHNAME(sasroot));
    filename sasroot;
-    %put *&SASROOT.*;
+    %put NOTE: &=SASROOT.;
    %let SASEXE=&SASROOT./sas;
  %end;
 %else
@@ -2877,8 +3076,8 @@ run;
      %do;
        %let SASROOT=%sysfunc(PATHNAME(sasroot));
        filename sasroot;
-        %put *&SASROOT.*;
+        %put NOTE: &=SASROOT.;
-        %let SASEXE=&SASROOT./sas;   
+        %let SASEXE=&SASROOT./sas;
      %end;
    %else
      %do;
@@ -2901,29 +3100,31 @@ run;
    %GOTO NOTESTING;
  %end;
-%put * Location of the SAS binary is: ;
+%put NOTE: Location of the SAS binary is:;
-%put * &=SASEXE. ;
+%put NOTE- &=SASEXE. ;
 %put ;
 /* locate sas work */
 %let SASWORK=%sysfunc(GETOPTION(work));
-%put *&SASWORK.*;
+%put NOTE: &=SASWORK.;
 %put ;
 /* location of the config file */
 %local SASCONFIG; /* by default a local macrovariable is empty, so no file would be pointed as a config file */
-%if %Qupcase(&sascfgfile.) = DEF %then /* the DEF value points to the sasv9.cfg file in the sasroot directory */
+%if %Qupcase(&sascfgFile.) = DEF %then /* the DEF value points to the sasv9.cfg file in the sasroot directory */
  %do;
    %let SASCONFIG = -config ""&SASROOT./sasv9.cfg"";
-    %put * The following SAS config file will be used:;
+    %put NOTE: The following SAS config file will be used:;
-    %put * &SASCONFIG.;
+    %put NOTE- &=SASCONFIG.;
  %end;
-%else %if %superq(sascfgfile) NE %then /* nonempty path points to user defined config file */
+%else %if %superq(sascfgFile) NE %then /* non-empty path points to user defined config file */
  %do;
-    %if %sysfunc(fileexist(&sascfgfile.)) %then
+    %if %sysfunc(fileexist(&sascfgFile.)) %then
      %do;
        %let SASCONFIG = -config ""&SASCFGFILE."";
-        %put * The following SAS config file will be used:;
+        %put NOTE: The following SAS config file will be used:;
-        %put * &SASCONFIG.;
+        %put NOTE- &=SASCONFIG.;
      %end;
    %else
      %do;
@@ -2952,8 +3153,10 @@ libname TESTWORK "&SASWORK./testwork_&testPackageTimesamp.";
 %local dirForTest dirForTestWork;
  %let dirForTest     = %sysfunc(pathname(TEST));
  %let dirForTestWork = %sysfunc(pathname(TESTWORK));
-  %put &=dirForTest.;
+  %put ;
-  %put &=dirForTestWork.;
+  %put NOTE: &=dirForTest.;
  %put NOTE: &=dirForTestWork.;
  %put ;
 /* remember location of sessions current directory */
 filename currdir ".";
@@ -2966,14 +3169,14 @@ filename currdir list;
 %if %bquote(&packages.)= %then %let packages=&filesLocation.;
 %put NOTE- ;
 %put NOTE: The following location path for packages will be used during the testing:;
-%put       *&packages.*;
+%put NOTE- &packages.;
 /* filename packages "&packages."; */
 /* filename packages list;*/
 /* replace current dir with the temporary one for tests */
 %put NOTE- ;
-%put NOTE: changing current folder to:;
+%put NOTE: Changing current folder to:;
-%put       *%sysfunc(DLGCDIR(&dirForTest.))*;
+%put NOTE- *%sysfunc(DLGCDIR(&dirForTest.))*;
 /* turn off the note about quoted string length */
@@ -3102,13 +3305,14 @@ status=sasstat0
 WAIT
 ;
-%put %superq(STSK);
+%put NOTE: Systask:;
 %put NOTE- %superq(STSK);
 ;
 %unquote(&STSK.);
 ;
 %let TESTRC_0 = &SYSRC.;
-%put *&=sasstat0.*&=TESTRC_0.*;
+%put NOTE: &=sasstat0. &=TESTRC_0.;
 %local notesSourceOptions;
 %let notesSourceOptions = %sysfunc(getoption(notes)) %sysfunc(getoption(source));
 options NOnotes NOsource;
@@ -3121,20 +3325,20 @@ data _null_;
  input;
  if _INFILE_ =: 'WARNING:' then
    do;
-      warning+1;
+      warnings+1;
      put _N_= "**" _INFILE_;
    end;
  if _INFILE_ =: 'ERROR:' then
    do;
-      error+1;
+      errors+1;
      put _N_= "$$" _INFILE_;
    end;
  if EOF then
    do;
      put "##########################################################################" ;
-      put (_ALL_) (=/);
+      put (_ALL_) (=/ "Number of ");
-      call symputX("TESTW_0", warning, "L");
+      call symputX("TESTW_0", warnings, "L");
-      call symputX("TESTE_0", error,   "L");
+      call symputX("TESTE_0", errors,   "L");
    end;
 run;
 options &notesSourceOptions.;
@@ -3191,6 +3395,18 @@ data _null_;
  put '%loadpackage'"(&packageName.,";
  put " path=&filesLocation., lazyData=*)" /;
  /* check if work should be deleted after test is done */
  delTestWork = input(symget('delTestWork'), ?? best32.);
  if not(delTestWork in (0 1)) then
    do;
      putlog "WARNING: [&sysmacroname.] The `delTestWork` parameter is invalid.";
      putlog "WARNING- [&sysmacroname.] Default value (1) is set.";
      delTestWork = 1;
    end;
  if 0 = delTestWork then
    put "options NOWORKTERM;"/;
  /*
  put "proc printto";
  put "; run;";
@@ -3219,13 +3435,14 @@ status=sasstat&t.
 WAIT
 ;
-%put %superq(STSK);
+%put NOTE: Systask:;
 %put NOTE- %superq(STSK);
 ;
 %unquote(&STSK.);
 ;
 %let TESTRC_&t = &SYSRC.;
-%put *sasstat&t.=&&sasstat&t.*TESTRC_&t=&&TESTRC_&t*;
+%put NOTE- sasstat&t.=&&sasstat&t. TESTRC_&t=&&TESTRC_&t;
 %local notesSourceOptions;
 %let notesSourceOptions = %sysfunc(getoption(notes)) %sysfunc(getoption(source));
 options NOnotes NOsource;
@@ -3238,14 +3455,14 @@ data _null_;
  input;
  if _INFILE_ =: 'WARNING:' then
    do;
-      warning+1;
+      warnings+1;
      /*length warningline $ 1024;
      warningline = catx(',', strip(warningline), _N_);*/
      put _N_= "**" _INFILE_;
    end;
  if _INFILE_ =: 'ERROR:' then
    do;
-      error+1;
+      errors+1;
      /*length errorline $ 1024;
      errorline = catx(',', strip(errorline), _N_);*/
      put _N_= "$$" _INFILE_;
@@ -3253,9 +3470,9 @@ data _null_;
  if EOF then
    do;
      put "##########################################################################" ;
-      put (_ALL_) (=/);
+      put (_ALL_) (=/ "Number of ");
-      call symputX("TESTW_&t.", warning, "L");
+      call symputX("TESTW_&t.", warnings, "L");
-      call symputX("TESTE_&t.", error,   "L");
+      call symputX("TESTE_&t.", errors,   "L");
    end;
 run;
 options &notesSourceOptions.;
@@ -3265,10 +3482,10 @@ data test.tests_summary;
  length testName $ 128;
  do _N_ = 0 to &numberOfTests.;
    testName = symget(cats("TEST_", _N_));
-    systask  = input(symget(cats("SASSTAT", _N_)), best32.);
+    systask  = coalesce(input(symget(cats("SASSTAT", _N_)), ?? best32.), -1);
-    sysrc    = input(symget(cats("TESTRC_", _N_)), best32.);
+    sysrc    = coalesce(input(symget(cats("TESTRC_", _N_)), ?? best32.), -1);
-    error    = input(symget(cats("TESTE_", _N_)),  best32.);
+    error    = coalesce(input(symget(cats("TESTE_", _N_)),  ?? best32.), -1);
-    warning  = input(symget(cats("TESTW_", _N_)),  best32.);
+    warning  = coalesce(input(symget(cats("TESTW_", _N_)),  ?? best32.), -1);
    output;
  end;
 run;
@@ -3282,8 +3499,8 @@ title;
 /*%put _local_;*/
-%put *NOTE: changing current folder to:*;
+%put NOTE: changing current folder to:;
-%put *%sysfunc(DLGCDIR(%sysfunc(pathname(currdir))))*;
+%put NOTE- *%sysfunc(DLGCDIR(%sysfunc(pathname(currdir))))*;
 filename CURRDIR clear;
 /* turn on the original value of the note about quoted string length */
@@ -3296,6 +3513,11 @@ proc sql;
  drop table &filesWithCodes.;
 quit;
 /* turn on the original value of the note about quoted string length */
 options &qlenmax_fstimer_tmp.;
 %ENDofgeneratePackage:
 %mend generatePackage;
@@ -3375,7 +3597,7 @@ TODO: (in Polish)
                 */
 )/secure 
 /*** HELP END ***/
-des = 'Macro to load multiple SAS packages at one run, version 20220420. Run %loadPackages() for help info.'
+des = 'Macro to load multiple SAS packages at one run, version 20220925. Run %loadPackages() for help info.'
 parmbuff
 ;
 %if (%superq(packagesNames) = ) OR (%qupcase(&packagesNames.) = HELP) %then
@@ -3391,7 +3613,7 @@ parmbuff
    %put ###      This is short help information for the `loadPackageS` macro            #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro wrapper for the loadPackage macro, version `20220420`                   #;
+    %put # Macro wrapper for the loadPackage macro, version `20220925`                   #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -3477,7 +3699,7 @@ parmbuff
                                         hashing_file() function, SAS 9.4M6 */
 )/secure 
 /*** HELP END ***/
-des = 'Macro to verify SAS package with the hash digest, version 20220420. Run %verifyPackage() for help info.'
+des = 'Macro to verify SAS package with the hash digest, version 20220925. Run %verifyPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
  %do;
@@ -3492,7 +3714,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20220420. Run %
    %put ###      This is short help information for the `verifyPackage` macro           #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro to verify SAS package with it hash digest, version `20220420`           #;
+    %put # Macro to verify SAS package with it hash digest, version `20220925`           #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -3610,7 +3832,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20220420. Run %
            if SHA256 = providedHash then
              do;
-                put "NOTE: Package verification SUCCESFUL."; 
+                put "NOTE: Package verification SUCCESSFUL."; 
                put "NOTE- Generated hash is EQUAL to the provided one."; 
              end;
            else
@@ -3662,7 +3884,7 @@ des = 'Macro to verify SAS package with the hash digest, version 20220420. Run %
                                       */
 )/secure
 /*** HELP END ***/
-des = 'Macro to preview content of a SAS package, version 20220420. Run %previewPackage() for help info.'
+des = 'Macro to preview content of a SAS package, version 20220925. Run %previewPackage() for help info.'
 ;
 %if (%superq(packageName) = ) OR (%qupcase(&packageName.) = HELP) %then
  %do;
@@ -3677,7 +3899,7 @@ des = 'Macro to preview content of a SAS package, version 20220420. Run %preview
    %put ###    This is short help information for the `previewPackage` macro            #;
    %put #-------------------------------------------------------------------------------#;
    %put #                                                                               #;
-    %put # Macro to get previwe of a SAS packages, version `20220420`                    #;
+    %put # Macro to get previwe of a SAS packages, version `20220925`                    #;
    %put #                                                                               #;
    %put # A SAS package is a zip file containing a group                                #;
    %put # of SAS codes (macros, functions, data steps generating                        #;
@@ -3804,7 +4026,7 @@ des = 'Macro to preview content of a SAS package, version 20220420. Run %preview
             when empty the "packages" value is used */
 )/secure
 /*** HELP END ***/
-des = 'Macro to list directories pointed by "packages" fileref, version 20220420. Run %extendPackagesFileref(HELP) for help info.'
+des = 'Macro to list directories pointed by "packages" fileref, version 20220925. Run %extendPackagesFileref(HELP) for help info.'
 ;
 %if %QUPCASE(&packages.) = HELP %then
@@ -3820,7 +4042,7 @@ des = 'Macro to list directories pointed by "packages" fileref, version 20220420
    %put ###       This is short help information for the `extendPackagesFileref` macro            #;
    %put #-----------------------------------------------------------------------------------------#;;
    %put #                                                                                         #;
-    %put # Macro to list directories pointed by 'packages' fileref, version `20220420`             #;
+    %put # Macro to list directories pointed by 'packages' fileref, version `20220925`             #;
    %put #                                                                                         #;
    %put # A SAS package is a zip file containing a group                                          #;
    %put # of SAS codes (macros, functions, data steps generating                                  #;
--- a/packages/README.md
+++ b/packages/README.md
@@ -18,7 +18,7 @@ data class;
    WH = weight + height;
 run;
 ```
-SHA256 digest for SQLinDS: 701B69BE71B99792803BCE7718ED486259310FFB92E6D77ED1BC029D9CC67B60
+SHA256 digest for SQLinDS: 96D0EFE02DF1AE0D7D875A10CAF7EF63CDEF85DD0CF9418934BEFAF0C067D453
 [Documentation for SQLinDS](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/sqlinds.md "Documentation for SQLinDS")
@@ -59,7 +59,7 @@ data _null_;
  end;
 run;
 ```
-SHA256 digest for DFA: 6B3FB0B06B47A7EF1BB004B483B0F39B8F553F7F16D02A7E24CDE388BBA704EA
+SHA256 digest for DFA: 5BFFCE78439E1CDDCBB15C95CD287AA4195BF64BB17DDB8FE374EC3535B4F491
 [Documentation for DFA](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/dfa.md "Documentation for DFA")
@@ -84,13 +84,13 @@ SHA256 digest for DFA: 6B3FB0B06B47A7EF1BB004B483B0F39B8F553F7F16D02A7E24CDE388B
      which = 1:H:2
  );
 ```
-SHA256 digest for macroArray: DF63B0E027827A82038F1C8422787A0BC569BA93104BA1778DB6DD088A5D255C
+SHA256 digest for macroArray: ED12BC96F8A4E9E7C4D651EC1E15479DB9B55D98B274B63C507ED842081F7AB7
 [Documentation for macroArray](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/macroarray.md "Documentation for macroArray")
 ---
- **BasePlus**\[1.14\] adds a bunch of functionalities I am missing in BASE SAS, such as: 
+- **BasePlus**\[1.17\] adds a bunch of functionalities I am missing in BASE SAS, such as: 
 ```sas
 call arrMissToRight(myArray); 
 call arrFillMiss(17, myArray); 
@@ -108,7 +108,7 @@ format x bool.;
 %zipLibrary(sashelp,libOut=work)
 ```
-SHA256 digest for BasePlus: 12A9A2155D9C6F969DF0A66E3A18D0938B8194FA3AA9D70EDDE1CB71DEF9691E
+SHA256 digest for BasePlus: 56B260350FEB7D5118F581B9EFD1B9CE1F0298DCB9A4C000A7654E2FF3F0298C
 [Documentation for BasePlus](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/baseplus.md "Documentation for BasePlus")
@@ -119,7 +119,7 @@ SHA256 digest for BasePlus: 12A9A2155D9C6F969DF0A66E3A18D0938B8194FA3AA9D70EDDE1
 The dataset with functions can be shared between different operating systems
 and allows to generate macros on site without showing their code.
-SHA256 digest for GSM: E6E2A6214EE7DC6E06AA76916A68B216DD7665184E63CF2C01F487A038E71B09
+SHA256 digest for GSM: 2AEBC150FBA99A4AAB0265A21C57E89200BFD96B633B898F32743D1C8831A159
 [Documentation for GSM](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/gsm.md "Documentation for GSM")
@@ -127,6 +127,6 @@ SHA256 digest for GSM: E6E2A6214EE7DC6E06AA76916A68B216DD7665184E63CF2C01F487A03
 - **dynMacroArray**\[0.2\], set of macros (wrappers for a hash table) emulating dynamic array in the data step (macro predecessor of DFA)
-SHA256 digest for dynMacroArray: 7DA9BFDED37C18C4FB5BD7579A81A4B2578EEEF1546D1A3AB5C80DE07C88A615
+SHA256 digest for dynMacroArray: D7E0B8F85C05EBF8622204E0D2F3E990D48D0A9B3911051C3AD44DC98954DDCF
 ---
--- a/packages/SHA256_for_packages.txt
+++ b/packages/SHA256_for_packages.txt
@@ -1,3 +1,20 @@
 /* 20220830 */
 BasePlus: 56B260350FEB7D5118F581B9EFD1B9CE1F0298DCB9A4C000A7654E2FF3F0298C
 DFA: 5BFFCE78439E1CDDCBB15C95CD287AA4195BF64BB17DDB8FE374EC3535B4F491
 dynMacroArray: D7E0B8F85C05EBF8622204E0D2F3E990D48D0A9B3911051C3AD44DC98954DDCF
 GSM: 2AEBC150FBA99A4AAB0265A21C57E89200BFD96B633B898F32743D1C8831A159
 macroArray: ED12BC96F8A4E9E7C4D651EC1E15479DB9B55D98B274B63C507ED842081F7AB7
 SQLinDS: 96D0EFE02DF1AE0D7D875A10CAF7EF63CDEF85DD0CF9418934BEFAF0C067D453
 /* 20220511 */
 BasePlus: 619D4B2562F1D9E42C9C5DCB326E8F4D6A020B5D0CEE29A6174F65F8E1B0E7BD
 /* 20220509 */
 BasePlus: 4CD3926B9842925C86B80B5B47B47BEA1FB9707826B545B9B4D52AE97BC3617E
 /* 20220508 */
 BasePlus: 0331C673052D5221DA98C5CC93295634D8A0BC62C7D2FEF9D0D85B0B2DEDE4E9
 /* 20220420 */
 BasePlus: 12A9A2155D9C6F969DF0A66E3A18D0938B8194FA3AA9D70EDDE1CB71DEF9691E
 DFA: 6B3FB0B06B47A7EF1BB004B483B0F39B8F553F7F16D02A7E24CDE388BBA704EA
--- a/packages/baseplus.md
+++ b/packages/baseplus.md
@@ -45,12 +45,18 @@
  * [`%RainCloudPlot()` macro](#raincloudplot-macro)
  * [`%zipLibrary()` macro](#ziplibrary-macro)
  * [`%unzipLibrary()` macro](#unziplibrary-macro)
  * [`%LDSN()` macro](#ldsn-macro)
  * [`%LDsNm()` macro](#ldsnm-macro)
  * [`%LVarNm()` macro](#lvarnm-macro)
  * [`%LVarNmLab()` macro](#lvarnmlab-macro)
  * [License](#license)
 ---
-# The BasePlus package [ver. 1.14] <a name="baseplus-package"></a> ###############################################
+# The BasePlus package [ver. 1.17] <a name="baseplus-package"></a> ###############################################
 The **BasePlus** package implements useful
 functions and functionalities I miss in the BASE SAS.
@@ -67,7 +73,9 @@ Kudos to all who inspired me to generate this package:
 *Richard DeVenezia*, 
 *Christian Graffeuille*,
 *Allan Bowe*,
-*Anamaria Calai*.
+*Anamaria Calai*,
 *Michal Ludwicki*,
 *Quentin McMullen*.
 ---
@@ -187,7 +195,6 @@ Kudos to all who inspired me to generate this package:
 %rainCloudPlot(sashelp.cars,DriveTrain,Invoice)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ![Rain Cloud Plot](./baseplus_RainCloudPlot_Ex0_9.png)
 **Example 10**: Zip SAS library.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
@@ -196,64 +203,78 @@ Kudos to all who inspired me to generate this package:
 %unzipLibrary(%sysfunc(pathname(work)), zip=sashelp, mode=S, clean=1)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **Example 11**: Long dataset names.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data %LDSN(  work. peanut butter & jelly time with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s (drop = sex rename=(name=first_name) where = (age in (12,13,14)))  );
  set sashelp.class;
 run;
 proc print data  = %LDSN(  work. peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  );
 run;
 data MyNextDataset;
  set %LDSN(  work. peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  );
  where age > 12;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ---
 Package contains: 
-1.  macro deduplistc 
+1.   macro      deduplistc 
-2.  macro deduplistp 
+2.   macro      deduplistp 
-3.  macro deduplists 
+3.   macro      deduplists 
-4.  macro deduplistx 
+4.   macro      deduplistx 
-5.  macro functionexists 
+5.   macro      functionexists 
-6.  macro getvars 
+6.   macro      getvars 
-7.  macro qdeduplistx 
+7.   macro      ldsn 
-8.  macro qgetvars 
+8.   macro      ldsnm 
-9.  macro qzipevalf 
+9.   macro      lvarnm 
-10. macro raincloudplot 
+10.  macro      lvarnmlab 
-11. macro symdelglobal 
+11.  macro      qdeduplistx 
-12. macro unziplibrary 
+12.  macro      qgetvars 
-13. macro zipevalf 
+13.  macro      qzipevalf 
-14. macro ziplibrary 
+14.  macro      raincloudplot 
-15. format bool 
+15.  macro      symdelglobal 
-16. format boolz 
+16.  macro      unziplibrary 
-17. format ceil 
+17.  macro      zipevalf 
-18. format floor 
+18.  macro      ziplibrary 
-19. format int 
+19.  format     bool 
-20. function arrfill 
+20.  format     boolz 
-21. function arrfillc 
+21.  format     ceil 
-22. function arrmissfill 
+22.  format     floor 
-23. function arrmissfillc 
+23.  format     int 
-24. function arrmisstoleft 
+24.  functions  arrfill 
-25. function arrmisstoleftc 
+25.  functions  arrfillc 
-26. function arrmisstoright 
+26.  functions  arrmissfill 
-27. function arrmisstorightc 
+27.  functions  arrmissfillc 
-28. function bracketsc 
+28.  functions  arrmisstoleft 
-29. function bracketsn 
+29.  functions  arrmisstoleftc 
-30. function catxfc 
+30.  functions  arrmisstoright 
-31. function catxfi 
+31.  functions  arrmisstorightc 
-32. function catxfj 
+32.  functions  bracketsc 
-33. function catxfn 
+33.  functions  bracketsn 
-34. function deldataset 
+34.  functions  catxfc 
-35. function semicolonc 
+35.  functions  catxfi 
-36. function semicolonn 
+36.  functions  catxfj 
-37. format brackets 
+37.  functions  catxfn 
-38. format semicolon 
+38.  functions  deldataset 
-39. proto qsortincbyprocproto 
+39.  functions  semicolonc 
-40. function frommissingtonumberbs 
+40.  functions  semicolonn 
-41. function fromnumbertomissing 
+41.  format     brackets 
-42. function quicksort4notmiss 
+42.  format     semicolon 
-43. function quicksorthash 
+43.  proto      qsortincbyprocproto 
-44. function quicksorthashsddv 
+44.  functions  frommissingtonumberbs 
-45. function quicksortlight 
+45.  functions  fromnumbertomissing 
 46.  functions  quicksort4notmiss 
 47.  functions  quicksorthash 
 48.  functions  quicksorthashsddv 
 49.  functions  quicksortlight 
-
+*SAS package generated by generatePackage, version 20220830*
 *SAS package generated by generatePackage, version 20220420*
 The SHA256 hash digest for package BasePlus: 
-`12A9A2155D9C6F969DF0A66E3A18D0938B8194FA3AA9D70EDDE1CB71DEF9691E` 
+`56B260350FEB7D5118F581B9EFD1B9CE1F0298DCB9A4C000A7654E2FF3F0298C` 
 ---
 # Content description ############################################################################################
@@ -3497,6 +3518,420 @@ run;
 ---
 ## >>> `%LDSN()` macro: <<< <a name="ldsn-macro"></a> #######################  
 The LDSN (Long DataSet Names) macro function 
 allows to use an "arbitrary" text string to name a dataset.
 The LDSN macro has some limitation described below, to overcome them 
 another macro, with different name: LDSNM (Long DataSet Names Modified) 
 was created. See its description to learn how to use it.
 ---
 The idea for the macro came from the following story: 
 Good friend of mine, who didn't use SAS for quite some time, 
 told me that he lost a few hours for debugging because 
 he forgot that the SAS dataset name limitation is 32 bytes.
 I replied that it shouldn't be a problem to do a workaround 
 for this inconvenience with a macro and the `MD5()` hashing function. 
 I said: *The macro should take an "arbitrary string" for a dataset 
 name, convert it, with help of `MD5()`, to a hash digest, and 
 create a dataset with an "artificial" `hex16.` formated name.*
 Starting with something like this:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 data %LDSN(work. peanut butter & jelly with a hot-dog in [a box] and s*t*a*r*s (drop = sex rename=(name=first_name) where = (age in (12,13,14))) );
  set sashelp.class;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~
 the macro would do:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 %sysfunc(MD5(peanut butter & jelly with a hot-dog in [a box] and s*t*a*r*s), hex16.)
 ~~~~~~~~~~~~~~~~~~~~~~~
 and (under the hood) return and execute the following code: 
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 data work.DSN_41D599EF51FBA58_(drop = sex rename=(name=first_name) where = (age in (12,13,14))) ;
  set sashelp.class;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~
 Also in the next data step user should be able to do:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 data my_next_data_step;
  set %DSN(work. peanut butter & jelly with a hot-dog in [a box] and s*t*a*r*s);
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~
 and work without the "dataset-name-length-limitation" issue.
 ---
 See examples below for the details.
 The `%LDSN()` macro executes like a pure macro code.
 **Known "Limitations":**
 - dataset name _cannot_ contain dots (`.`) since they are used as separators!
 - dataset name _cannot_ contain round brackets(`(` and `)`) since they are used as separators
  (but `[]` and `{}` are allowed)!
 - dataset name _cannot_ contain unpaired quotes (`'` and `"`), 
  text: `a "hot-dog"` is ok, but `John's dog` is not!
 **Behaviour:**
 - dataset name text is *converted to upcase*
 - dataset name text *leading and trailing spaces are ignored*, 
  e.g. the following will give the same hash digest:
  `%ldsn(work.test)`, `%ldsn( work.test)`, `%ldsn(work.test )`,
  `%ldsn(work .test)`, `%ldsn(work. test)`, `%ldsn(work . test)`.
 - macro calls of the form:
  `data %LDSN(); run;`, `data %LDSN(    ); run;`, `data %LDSN( . ); run;` or even
  `data %LDSN( . (keep=x)); run;` are resolved to empty string, so the result is
  equivalent to `data; run;`
 ### SYNTAX: ###################################################################
 The basic syntax is the following, the `<...>` means optional parameters:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 %LDSN(
   arbitrary text string (in line with limitations)
 )
 ~~~~~~~~~~~~~~~~~~~~~~~
 The text string is concider as *"fully qualified dataset name"*, i.e. macro
 assumes it may contain library as prefix and data set options as sufix.
 See the `%LDsNm()` macro for comparison.
 ---
 ### EXAMPLES AND USECASES: ####################################################
 **EXAMPLE 1.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 options nomprint source nomlogic nosymbolgen ls = max ps = max;
 data %LDSN(  work. peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s (drop = sex rename=(name=first_name) where = (age in (12,13,14)))  );
  set sashelp.class;
 run;
 proc print data  = %LDSN(  work. peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  );
 run;
 data MyNextDataset;
  set %LDSN(  work. peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  );
  where age > 12;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ---
 ## >>> `%LDSNM()` macro: <<< <a name="ldsnm-macro"></a> #######################  
 The LDSNM (Long DataSet Names Modified) macro function 
 allows to use an "arbitrary" text string to name a dataset.
 The LDSN macro had some limitation (see its documentation), to overcome them 
 another `%LDSNM()` (Long DataSet Names Modified) macro was created.
 The main idea behind the `%LDSNM()` is the same as for `%LDSN()` - see the description there.
 ---
 The `%LDSNM()` macro works differently than the `%LDSN()` macro.
 The `%LDSN()` macro assumes that *both* libname and dataset options *are*
 be passed as elements **inside** the macro argument, together with the data set name. E.g.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data %LDSN( WORK.peanut butter & jelly with a hot-dog in [a box] and s*t*a*r*s (drop = sex) );
  set sashelp.class;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 The `%LDSNM()` macro, in contrary, assumes that both libname and dataset options are
 passed **outside** the macro parameter, i.e.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data WORK.%LDSNM( peanut butter & jelly with a hot-dog in [a box] and s*t*a*r*s ) (drop = sex);
  set sashelp.class;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This approach overcomes some limitations the LDSN has.
 The **additional** feature of the `%LDSNM()` is that when the macro is called, 
 a global macrovariable is created.
 The macro variable name is the text of the hashed data set name. 
 The macro variable value is the text of the unhashed data set name (i.e. the argument of the macro). 
 For example the following macro call:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data %LDSNM(John "x" 'y' dog);
  set sashelp.class;
  where name = 'John';
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 creates macro variable with name `DSN_BF1F8C4D6495B34A_` and with value:  `JOHN "X" 'Y' DOG`.
 The macrovariable is useful when combined with `symget()` function and 
 the `indsname=` option to get the original text string value back, 
 like in this example:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data test;
  set %LDSNM(John "x" 'y' dog) indsname = i;
  indsname = symget(scan(i,-1,"."));
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 See examples below for the details.
 ---
 The `%LDSN()` macro executes like a pure macro code.
 **Known "Limitations":**
 - dataset name _cannot_ contain _unpaired_ round brackets(`(` and `)`) 
  (but unmatched `[]` and `{}` are allowed)!
 - dataset name _cannot_ contain _unpaired_ quotes (`'` and `"`), 
  text: `a "hot-dog"` is ok, but `John's dog` is not!
 **Behaviour:**
 - dataset name text is *converted to upcase*
 - dataset name text *leading and trailing spaces are ignored*, 
  e.g. the following will give the same hash digest:
  `%ldsn(test)`, `%ldsn( test)`, `%ldsn(test )`.
 - macro calls of the form:
  `data %LDSN(); run;` or `data %LDSN(    ); run;` are resolved 
  to empty string, so the result is equivalent to `data; run;`
 - created macrovariable is _global_ in scope.
 ### SYNTAX: ###################################################################
 The basic syntax is the following, the `<...>` means optional parameters:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 %LDSNM(
   arbitrary text string (in line with limitations)
 )
 ~~~~~~~~~~~~~~~~~~~~~~~
 The text string is considered as *"only dataset name"*, i.e. the macro does not 
 assume it contains library as prefix or data set options as suffix.
 See the `%LDSN()` macro for comparison.
 ---
 ### EXAMPLES AND USECASES: ####################################################
 **EXAMPLE 1.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data %LDSNM(John "x" 'y' & dog);
  set sashelp.class;
  where name = 'John';
 run;
 data %LDSNM(John "x"[ 'y' & dog);
  set sashelp.class;
  where name = 'John';
 run;
 data %LDSNM(John "x" 'y'} & dog);
  set sashelp.class;
  where name = 'John';
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **EXAMPLE 2.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data work.%LDsNm(  peanut butter & jelly, a hot-dog in [a box], and s(*)t(*)a(*)r(*)s!!   ) (drop = sex rename=(name=first_name) where = (age in (12,13,14)))
 ;
  set sashelp.class;
 run;
 data test;
  set work.%LDsNm(  peanut butter & jelly, a hot-dog in [a box], and s(*)t(*)a(*)r(*)s!!   ) indsname=i;
  indsname=symget(scan(i,-1,"."));
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **EXAMPLE 3.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data work.%LDsNm(  . );
  set sashelp.class;
 run;
 data %LDsNm(  );
  set sashelp.class;
 run;
 data %LDsNm();
  set sashelp.class;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ---
 ## >>> `%LVarNm()` macro: <<< <a name="lvarnm-macro"></a> #######################  
 The LVarNm() macro function works like the LDSN() macro function, but for variables.
 Supported by LVarNmLab() macro function which allows to remember "user names" in labels.
 The motivation for the macro was similar to that for the LDSN() macro. 
 ---
 See examples below for the details.
 The `%LVarNm()` macro executes like a pure macro code.
 **Known "Limitations":**
 - variable name _cannot_ contain unpaired quotes (`'` and `"`), 
  text: `a "hot-dog"` is ok, but `John's dog` is not!
 **Behaviour:**
 - variable name text is *converted to upcase*
 - variable name text *leading and trailing spaces are ignored*, 
  e.g. the following will give the same hash digest:
  `%LVarNm(test)`, `%LVarNm( test)`, `%LVarNm(test )`.
 ### SYNTAX: ###################################################################
 The basic syntax is the following, the `<...>` means optional parameters:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 %LVarNm(
   arbitrary text string (in line with limitations)
 )
 ~~~~~~~~~~~~~~~~~~~~~~~
 ---
 ### EXAMPLES AND USE CASES: ####################################################
 **EXAMPLE 1.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 options ls=max;
 data test;
  %LVarNmLab( peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  )
  do %LVarNm( peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  ) = 1 to 10;
    y = 5 + %LVarNm( peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  ) * 17; 
    output;
  end;
 run;
 data test2;
  set test;
  where %LVarNm( peanut butter & jelly with a "Hot-Dog" in [a box], popcorn, and s*t*a*r*s  ) < 5;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **EXAMPLE 2.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data test3;
  %LVarNmLab() = 17;
  %LVarNm() = 17;
  %LVarNm( ) = 42;
  %LVarNm(  ) = 303;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **EXAMPLE 3.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data test3;
  %LVarNm(test) = 1;
  %LVarNm( test) = 2;
  %LVarNm(test ) = 3;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 **EXAMPLE 4.** 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
 data test4;
  array X[*] %LVarNm(some strange! name)_0 - %LVarNm(some strange! name)_10;
  do i = lbound(X) to hbound(X);
    X[i] = 2**(i-1);    
    put X[i]=;
  end;
 run;
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ## >>> `%LVarNmLab()` macro: <<< <a name="lvarnmlab-macro"></a> #######################  
 The LVarNmLab() macro function supports LVarNm() and allows to remember "user names" in labels.
 The motivation for the macro was similar one as for the LDSN() macro. 
 ---
 See examples in LVarNm() documentation for the details.
 The `%LVarNmLab()` macro executes like a pure macro code.
 **Known "Limitations":**
 - variable name _cannot_ contain unpaired quotes (`'` and `"`), 
  text: `a "hot-dog"` is ok, but `John's dog` is not!
 **Behaviour:**
 - variable name text is *converted to upcase*
 - variable name text *leading and trailing spaces are ignored*, 
  e.g. the following will give the same hash digest:
  `%LVarNmLab(test)`, `%LVarNmLab( test)`, `%LVarNmLab(test )`.
 ### SYNTAX: ###################################################################
 The basic syntax is the following, the `<...>` means optional parameters:
 ~~~~~~~~~~~~~~~~~~~~~~~sas
 %LVarNmLab(
   arbitrary text string (in line with limitations)
 )
 ~~~~~~~~~~~~~~~~~~~~~~~
 ---
 ## License ####################################################################
 Copyright (c) 2020 Bartosz Jablonski
--- a/packages/baseplus.zip
+++ b/packages/baseplus.zip
--- a/packages/dfa.md
+++ b/packages/dfa.md
@@ -52,10 +52,10 @@ Package contains:
 12.  exec       generatearrays 
 13.  clean      generatearrays
-*SAS package generated by generatePackage, version 20220420*
+*SAS package generated by generatePackage, version 20220830*
 The SHA256 hash digest for package BasePlus: 
-`6B3FB0B06B47A7EF1BB004B483B0F39B8F553F7F16D02A7E24CDE388BBA704EA` 
+`5BFFCE78439E1CDDCBB15C95CD287AA4195BF64BB17DDB8FE374EC3535B4F491` 
 ---
 # Content description ############################################################################################
--- a/packages/dfa.zip
+++ b/packages/dfa.zip
--- a/packages/dynmacroarray.zip
+++ b/packages/dynmacroarray.zip
--- a/packages/gsm.md
+++ b/packages/gsm.md
@@ -91,10 +91,10 @@ Package contains:
 Required SAS Components: 
  `Base SAS Software`
-* SAS package generated by generatePackage, version 20220420 *
+* SAS package generated by generatePackage, version 20220830 *
 The SHA256 hash digest for package GSM: 
-`E6E2A6214EE7DC6E06AA76916A68B216DD7665184E63CF2C01F487A038E71B09` 
+`2AEBC150FBA99A4AAB0265A21C57E89200BFD96B633B898F32743D1C8831A159` 
 ## >>> `%GSM()` macro: <<< <a name="gsm-macro"></a> #######################
--- a/packages/gsm.zip
+++ b/packages/gsm.zip
--- a/packages/macroarray.md
+++ b/packages/macroarray.md
@@ -75,10 +75,10 @@ Package contains:
 Required SAS Components: 
  *Base SAS Software*
-*SAS package generated by generatePackage, version 20220420.*
+*SAS package generated by generatePackage, version 20220830.*
 The SHA256 hash digest for package macroArray: 
-`DF63B0E027827A82038F1C8422787A0BC569BA93104BA1778DB6DD088A5D255C`
+`ED12BC96F8A4E9E7C4D651EC1E15479DB9B55D98B274B63C507ED842081F7AB7`
 ---
 # Content description ############################################################################################
--- a/packages/macroarray.zip
+++ b/packages/macroarray.zip
--- a/packages/sqlinds.md
+++ b/packages/sqlinds.md
@@ -46,10 +46,10 @@ Package contains:
 Required SAS Components: 
  *Base SAS Software*
-*SAS package generated by generatePackage, version 20220420*
+*SAS package generated by generatePackage, version 20220830*
 The SHA256 hash digest for package SQLinDS: 
-`701B69BE71B99792803BCE7718ED486259310FFB92E6D77ED1BC029D9CC67B60` 
+`96D0EFE02DF1AE0D7D875A10CAF7EF63CDEF85DD0CF9418934BEFAF0C067D453` 
 ---
 # Content description ############################################################################################
--- a/packages/sqlinds.zip
+++ b/packages/sqlinds.zip
Author	SHA1	Message	Date
Bart Jablonski (yabwon)	be89c6b9c6	SAS Packages Framework, version `20220925` SAS Packages Framework, version `20220925` New parameter `mirror=` added to the `%installPackage()` macro. The `mirror` indicates which web location for packages installation is used. Value `1` indicates: `https://raw.githubusercontent.com/yabwon/SAS_PACKAGES/main` Value `2` indicates: `https://pages.mini.pw.edu.pl/~jablonskib/SASpublic/SAS_PACKAGES` Default value is `1`.	2022-09-25 19:11:55 +02:00
Bart Jablonski	17b1239087	Merge pull request #50 from beauweta/patch-1 Update baseplus.md	2022-08-30 19:16:32 +02:00
Bart Jablonski (yabwon)	bbba37d8eb	The SAS Packages Framework, version `20220830`: The SAS Packages Framework, version `20220830`: - New metadata checks added for required SAS components and required SAS packages. - New parameter `delTestWork` in `%generatePackage()` macro added. It indicates if `WORK` directories generated by user tests should be deleted, i.e. the (NO)WORKTERM option is set. - Log aesthetics and readability improved in the `%generatePackages()` macro: - subtitles added in the log, - `stimer` turned off, - some notes turned off. - Generation of table with tests results updated. - Documentation updated. Packages regenerated with the new version of SPF: - BasePlus - SQLinDS - macroArray - DFA - dynMacroArray - GSM	2022-08-30 18:56:26 +02:00
Bart Jablonski	6ccc07a5bb	Add SAS Packages Framework to SAS Initiative to add SAS Packages Framework to SAS Base/Viya	2022-05-31 21:53:53 +02:00
Bart Jablonski	b5e15bda11	Add SAS Packages Framework to SAS Innitiative to add SAS Packages Framework to SAS Base/Viya	2022-05-31 21:50:58 +02:00
Bart Jablonski	160c1bc9d3	Add SAS Packages Framework to SAS Innitiative to add SAS Packages Framework to SAS Base/Viya	2022-05-31 21:49:56 +02:00
beauweta	76297dc5d8	Update baseplus.md Just rephrased a few sentences and fixed some typos. Cheers, Christian	2022-05-15 15:15:10 +12:00
Bart Jablonski (yabwon)	ea866123d9	The BasePlus package [ver. 1.17] The BasePlus package [ver. 1.17] - new macro `%LDSNM()`, which extends functionality of the `%LDSN()` was added. - documentation updated hash: 619D4B2562F1D9E42C9C5DCB326E8F4D6A020B5D0CEE29A6174F65F8E1B0E7BD	2022-05-11 23:44:34 +02:00
Bart Jablonski (yabwon)	75029a488f	The BasePlus package [ver. 1.16] The BasePlus package [ver. 1.16] - improvement to: %LDSN(), %LVarNm(), and %LVarNmLab() macros. Big thanks to Richard DeVenezia! hash: 4CD3926B9842925C86B80B5B47B47BEA1FB9707826B545B9B4D52AE97BC3617E	2022-05-09 19:00:25 +02:00
Bart Jablonski (yabwon)	642bc5ba72	The BasePlus package [ver. 1.15] The BasePlus package [ver. 1.15] - 3 new macros added: `%LDSN()`, `%LVarNm()`, and `%LVarNmLab()` hash: 0331C673052D5221DA98C5CC93295634D8A0BC62C7D2FEF9D0D85B0B2DEDE4E9	2022-05-08 19:10:55 +02:00
Bart Jablonski	6d10426474	SAS Packages Framework, version `20220420` SAS Packages Framework, version `20220420` - Changes in the `%GeneratePackage()` macro: - check for driving files existence added, - local `createPackageContentStatus` macro variable added, - if `createPackageContentStatus` is not zero an _ERROR _is printed and tests are not executed, - The `kscanx()` function and `kcountw()` function used in macros of the Framework, - Doc. updated. - Packages regenerated with new version of the SAS Packages Framework: - BasePlus - SQLinDS - macroArray - DFA - dynMacroArray - GSM	2022-04-20 22:48:09 +02:00