Difference between revisions of "SAS"

Revision as of 19:44, 10 June 2022

Description

SAS is a commercial integrated system for statistical analysis, data mining, and graphics as well as many enterprise oriented additional features. SAS cost and the breadth of SAS features means that both a significant monetary investment and a substantial time investment are required to master it. SAS 9.3 Documentation is vast. For research purposes the SAS 9.3 User's Guide is a thorough reference for the functions and procedures you may need to do the statistical analysis using SAS.

Environment Modules

Run module spider sas to find out what environment modules are available for this application.

System Variables

HPC_SAS_DIR - installation directory

Additional Information

Commands

SAS has a number of options:

-nodms : This stops SAS from using its GUI capability and goes into a text only mode.
-filelocks fail : This causes SAS to stop and print out an error when multiple sas processes try to use the same file.
-nonews: Prevents SAS from printing a useless header to the output.
-memsize xxxxM - specifies the total amount of memory that is available to each SAS session, and places an enforced limit on the amount of virtual memory that SAS can dynamically allocate at any one time.
-realmemsize xxxxM - sets the recommended upper limit on working memory for procedures that can use both memory and utility disk space, such as PROC SUMMARY and PROC SORT, so that they can avoid virtual memory thrashing.
-work $TMPDIR - the directory where SAS should store its temporary files. Using $TMPDIR will allow your program to run much faster and prevent any network-related file access issues that SAS is prone to run into.
-sysin file : Designate a file for SAS to load as its input.

Batch Submission

To do a batch submission of a SAS script use the -sysin command line option and write all of your SAS commands in a file. In this way you can submit jobs to the batch queue system to run your jobs on the cluster.

-work directory

SAS is a mature product with a long history behind it. In a modern high-performance environment it means that additional actions need to be taken to mitigate potential issues stemming from SASs focus on filesystem I/O instead of using memory.

Interactive Use

See GUI_Programs to learn how to run the Graphical SAS interface for short debugging sessions.

PBS Script Examples

Sample Job Script

#!/bin/bash
#
#SBATCH --name=sas_job
#SBATCH --output=sas_%j.out
#SBATCH --mail-type=END,FAIL #Only email summary and failure reports
#SBATCH --mail-user=your_email_address   # Where to send mail	
#SBATCH --ntasks=1                    # Run on a single CPU
#SBATCH --mem=1gb                  # Memory limit
#SBATCH --time=01:00:00          # Run for up to one hour
date;hostname;pwd

module load sas

sas -memsize 1024M -nodms -nonews -work $TMPDIR -filelocks none -sysin sas.inp

@@ Line 1: / Line 1: @@
 __NOTOC__
 __NOEDITSECTION__
-[[Category:Software]][[Category:Statistics]]
+[[Category:Software]][[Category:Statistics]][[Category:Data Analysis]]
 <!-- ########  Template Configuration ######## -->
 {|
@@ Line 7: / Line 7: @@
 |{{#vardefine:app|sas}}
 |{{#vardefine:url|http://www.sas.com/}}
-<!--Compiler and MPI settings - OPTIONAL -->
-|{{#vardefine:intel|}} <!-- E.g. "11.1" -->
-|{{#vardefine:mpi|}} <!-- E.g. "openmpi/1.3.4" -->
-<!--Choose sections to enable - OPTIONAL-->
-|{{#vardefine:mod|1}} <!--Present instructions for running the software with modules -->
 |{{#vardefine:exe|1}} <!--Present manual instructions for running the software -->
 |{{#vardefine:conf|}} <!--Enable config wiki page link - {{#vardefine:conf|1}} = ON/conf|}} = OFF-->
@@ Line 23: / Line 18: @@
 <!--Description-->
 {{#if: {{#var: url}}|
-{{App_Description|app={{#var:app}}|url={{#var:url}}}}|}}
+{{App_Description|app={{#var:app}}|url={{#var:url}}|name={{#var:app}}}}|}}
 SAS is a commercial integrated system for statistical analysis, data mining, and graphics as well as many enterprise oriented additional features. SAS cost and the breadth of SAS features means that both a significant monetary investment and a substantial time investment are required to master it. [http://support.sas.com/documentation/onlinedoc/stat/index.html#stat93 SAS 9.3 Documentation] is vast. For research purposes the [http://support.sas.com/documentation/cdl/en/statug/63962/HTML/default/viewer.htm#titlepage.htm SAS 9.3 User's Guide] is a thorough reference for the functions and procedures you may need to do the statistical analysis using SAS.
-<!--Location-->
+<!--Modules-->
-{{App_Location|app={{#var:app}}|{{#var:ver}}}}
+==Environment Modules==
-==Available versions==
+Run <code>module spider {{#var:app}}</code> to find out what environment modules are available for this application.
-* 9.2.
+==System Variables==
-* 9.3 (default, supported).
+* HPC_{{uc:{{#var:app}}}}_DIR - installation directory
-<!-- -->
+<!--Additional-->
-{{#if: {{#var: mod}}|==Running the application using modules==
+{{#if: {{#var: exe}}|==Additional Information==
-{{App_Module|app={{#var:app}}|intel={{#var:intel}}|mpi={{#var:mpi}}}}|}}
-{{#if: {{#var: exe}}|==How To Run==
 ===Commands===
 SAS has a number of options:
 * -nodms : This stops SAS from using its GUI capability and goes into a text only mode.
-* -filelocks none : This causes SAS to not use filelocking.
+* -filelocks fail : This causes SAS to stop and print out an error when multiple sas processes try to use the same file.
 * -nonews: Prevents SAS from printing a useless header to the output.
 * -memsize xxxxM - [http://support.sas.com/documentation/cdl/en/hostunx/63053/HTML/default/viewer.htm#n09y5anvvpzrmnn0ztkyf59qgzvr.htm specifies the total amount of memory that is available to each SAS session, and places an enforced limit on the amount of virtual memory that SAS can dynamically allocate at any one time].
@@ Line 50: / Line 44: @@
 ===Interactive Use===
-To connect to a test node, for example test01, where you can run the graphical interface to SAS use the following or a similar command
+See [[GUI_Programs]] to learn how to run the Graphical SAS interface for short debugging sessions.
- ssh USER@test01.ufhpc -o ForwardX11=yes -o ForwardX11Trusted=yes -o ProxyCommand='ssh USER@submit.hpc.ufl.edu exec nc test01 %p'
-or add the following to your ~/.ssh/config file:
- Host test01
-    User USER
-    KeepAlive yes
-    ProxyCommand ssh USER@submit.hpc.ufl.edu exec nc test01 %p
-    ForwardX11 yes
-    ForwardX11Trusted yes
-where USER is your username. After editing ~/.ssh/config you can just run the following command to connect:
- ssh test01
-Once connected run
- module load sas
- sas
 |}}
 {{#if: {{#var: conf}}|==Configuration==
 See the [[{{PAGENAME}}_Configuration]] page for {{#var: app}} configuration details.|}}
 ==PBS Script Examples==
-===Sample Job Script Ver 9.2===
+===Sample Job Script===
-<pre>
-#!/bin/bash
-#
-#PBS -N Research
-#PBS -o market.out
-#PBS -e market.err
-#PBS -m abe
-#PBS -M <EMAIL ADDRESS>
-#PBS -l nodes=1:ppn=1
-#PBS -l pmem=1gb
-#PBS -l walltime=01:00:00
-module load sas/9.2
-cd /scratch/ufhpc/
-sas -memsize 1024M -nonews -nodms -work $TMPDIR -filelocks none -sysin sas.inp
-</pre>
-===Sample Job Script Ver 9.3===
 <pre>
 #!/bin/bash
 #
-#PBS -N Research
+#SBATCH --name=sas_job
-#PBS -o market.out
+#SBATCH --output=sas_%j.out
-#PBS -e market.err
+#SBATCH --mail-type=END,FAIL #Only email summary and failure reports
-#PBS -m abe
+#SBATCH --mail-user=your_email_address   # Where to send mail
-#PBS -M <EMAIL ADDRESS>
+#SBATCH --ntasks=1                    # Run on a single CPU
-#PBS -l nodes=1:ppn=1
+#SBATCH --mem=1gb                  # Memory limit
-#PBS -l pmem=1gb
+#SBATCH --time=01:00:00          # Run for up to one hour
-#PBS -l walltime=01:00:00
+date;hostname;pwd
 module load sas
-cd /scratch/hpc/USERNAME
 sas -memsize 1024M -nodms -nonews -work $TMPDIR -filelocks none -sysin sas.inp
 </pre>
-{{#if: {{#var: policy}}|==Usage policy==
+{{#if: {{#var: policy}}|==Usage Policy==
 WRITE USAGE POLICY HERE (perhaps templates for a couple of main licensing schemes can be used)|}}
 {{#if: {{#var: testing}}|==Performance==