Environmental Variables for LS-DYNA Version ls950
=================================================

1. LSTC_FILE:  Defines the license file.
     The default filename is /usr/local/lstc/LSTC_FILE.
 
     To define the license file, use the following command:

       setenv LSTC_FILE (license file name)

2. LSTC_SECURE:  Defines the format for the license file.  
     We currently support 3 formats:  old, new or eta.   
     If you do not define this environmental variable,
     then LS-DYNA will check for all three formats.  
     However, you can force the program to to look for 
     only one type by setting this variable as follows:

       setenv LSTC_SECURE old
       setenv LSTC_SECURE new
       setenv LSTC_SECURE eta


3. LSTC_DEFGEO:  Defines the format for ASCII file DEFGEO to be 
     Chrsyler's format.  If you do not define this variable, the 
     program defaults to the standard LS-DYNA format.  
     To output Chrsyler's format do the following:

       setenv LSTC_DEFGEO chrysler


4. LSTC_OUTPUT:  Defines the format for the output files.  
     We support several formats besides the standard LS-DYNA format.  
     This variable is only of interest to specific LS-DYNA users.  
     The majority of LS-DYNA users will not need to set this variable.
     For example, to define the CDAFEM format, 

       setenv LSTC_OUTPUT cadfem

5. LSTC_FORMAT: Defines the format for the d3plot and d3thdt output files.  
     This variable allows the user to output the binary plot files 
     in ANSYS format as well as both ANYSYS and LS-DYNA format.  
     By not defining this variable the output files will be in 
     standard LS-DYNA format.  To output ANSYS format do the following:

       setenv LSTC_FORMAT ansys

    To output ANSYS and LS-DYNA format do the following:

      setenv LSTC_FORMAT taurus+ansys


    Note that the user can also control the output format with the
    *DATABASE_FORMAT command.


6. LSTC_BINARY: Define the word size of the d3plot and d3thdt files 
     to be 32 bit IEEE.  By using this option one can reduce the size 
     of the output files which are created by 64 bit machines such as
     CRAY.  By not defining this variable LS-DYNA defaults to the
     word size of the machine.  To invoke this option, do the following:

       setenv LSTC_BINARY 32ieee
 
     Note that the user also can control the output size in column 8 of
     the *CONTROL_OUTPUT command. For example,

     *CONTROL_OUTPUT
     $NPOPT NEECHO NREFUP IACCOP OPTIFS IPRINT IKEDIT IBINARY
           ,      ,      ,       ,      ,      ,     ,      1


7. LSTC_MEMORY:  Controls memory extension.  
     The user can set the default memory size by using the command line
     option "MEMORY"  There are two options with this variable.
     The "auto" option is useful for adaptive runs because it allows
     LS-DYNA to automatically extend memory.  This option is for the
     metal forming application only.  Do not use it for the crash 
     analysis. The second option "heap" was designed for CRAY computers.  
     It tells LS-DYNA to use heap memory. It means that in the
     initialization phase, LS-DYNA will shrink the heap memory to a
     minimum.

       setenv LSTC_MEMORY auto
       setenv LSTC_MEMORY heap

7. LSTC_XELENGTH: Controls minimum length of shell elements.
     If the elnegth of any shell elements is less than the defined value,
     the program will be terminated.

       setenv LSTC_ELENGTH 0.02


Performance notes for IRIX machines
===================================

LS-DYNA will perform best on IRIX machines if the command file sets
several environment variables.  Attached are the recommended sets of
variables for your command files for LS-DYNA jobs using either one or
multiple processors.  If you have questions about the "setenv" settings,
contact your local SGI representative, or Jeff Zais (jeff@sgi.com,
651-683-3656).  Many of these variables are described in the "man mp"
man pages.

Single Processor Jobs
---------------------
setenv MPC_GANG off
setenv OMP_DYNAMIC FALSE
setenv MP_SET_NUMTHREADS 1
setenv _DSM_PPM 2
setenv _DSM_PLACEMENT ROUND_ROBIN
setenv TRAP_FPE "OVERFL=ABORT; DIVZERO=ABORT; INVALID=ABORT;
INT_OVERFL=ABORT" 
ls950.IRIX64 i=r.003 memory=120000000 ncpu=-1 

Shared Memory Parallel Jobs
---------------------------
setenv MPC_GANG off
setenv OMP_DYNAMIC FALSE
setenv MP_SET_NUMTHREADS 4
setenv _DSM_PPM 2
setenv _DSM_PLACEMENT ROUND_ROBIN
setenv TRAP_FPE "OVERFL=ABORT; DIVZERO=ABORT; INVALID=ABORT;
INT_OVERFL=ABORT" 
ls950.IRIX64 i=r.003 memory=120000000 ncpu=-4 

Notes:
------
MPC_GANG off will help system throughput by disabling gang scheduling.

OMP_DYNAMIC FALSE will disable dynamic threads on IRIX 6.5 systems,
slightly improving performance.  This will have no effect on IRIX 6.4
systems.

MP_SET_NUMTHREADS should be set to the number of processors to be used
in the analysis.  It is important to set this even if you will only run
with a single processor. 

_DSM_PPM specifies the the number of processors per memory module. 
Valid values are either 1 or 2.  Setting _DSM_PPM to "2" is almost alway
best.

_DSM_PLACEMENT ROUND_ROBIN will dramatically improve performance of
shared memory parallel jobs.

Setting the TRAP_FPE variable will stop LS-DYNA with a core dump when a
floating point exception is encountered.  Should this occur, contact
LSTC.