Home

SHELL 9.4 user manual

1. 1 Main menu The directory the shell was started in is shown at the top of the menu File names can be entered relative to this directory For example if the current directory is u mid test and the job to run is in u mid test job to_run key then you can enter job to_run key and press return If the job to run is in u mid to_run key you can enter to_run key Alternatively the full path name can be entered If the file does not exist or is an invalid type i e doesn t end in k for keyword files inf for fixed format files or Ist for list files you will be propmpted to enter a file again Once a valid file has been chosen the main menu will be displayed with the full path name of the file selected shown on the right hand side 1 14 4 File Format At the main menu type in 3 and press return A menu will be displayed asking for the file format for the job Select the job format 1 Keyword 2 Fixed 3 List 1 Main menu Select the required format If List was selected and the submission type is not Queue a further menu will be displayed asking whether the jobs should be sequential or not Turn sequential submission on or off 1 Off 2 On 1 Main menu Select the required option The main menu will be displayed with the selected format shown on the right hand side Note Selecting a different job format to the current selection will clear the Input File selection Page 1 22 User manual Versio
2. All four files are read if they exist and the last preference read will be the one used so the file can be customised for a particular job or user at will Files do not have to exist in any of these locations and if none exists the programme defaults will be used On Unix and Linux HOME on Unix and Linux is usually the home directory specified for each user in the system password file The shell command printenv or on some systems setenv will show the value of this variable if set If not set then it is defined as the directory for the user The command cd pwd will show this On Windows SUSERPROFILE on Windows is usually C Documents and Settings lt user id gt Issuing the set command from an MS DOS prompt will show the value of this and other variables Generally speaking you should put e Organisation wide options in the version in 0A_ADMIN_xx and or OA_INSTALL e User specific options in HOME USERPROFILE e Project specific options in the current working directory The file contains preferences for the SHELL lines commencing shell THIS lines commencing this D3PLOT lines commencing d3plot PRIMER lines commencing primer and REPORTER lines commencing reporter All lines take the format lt preference name gt lt preference value gt The general copy of the preference file should be present in the OA_ADMIN_xx and or 0A_INSTALL directory This should contain the preferences most suitable for al
3. Default States the default value of the preference Description Provides a brief description of the function performed by this preference Active tab Highlighted in Green when the preference has been assigned a value Press this tab to activate deactivate the currently selected preference If the currently selected preference was defined in the general oa_pref file deselecting this will bring up an error message as it is not possible to deselect preferences stored in the general oa_pref file Value States the currently selected value for the preference Clicking on the arrow to the left of this box brings up a drop down menu which lists the possible values this preference can take and allows the user to select one of these values 4 2 1 4 Locking Preferences From version 9 4 onwards preferences can be locked Beside each option in the Ka preference editor is a padlock symbol If the symbol is green then the option is unlocked Active v a if it is red then it is locked If a preference option has been locked in a file that the user can not modify then an error message will be generated if the user tries to edit that option Active v l Page 4 3 Shell User manual Version 9 4 November 2009 If auser manually edits the oa_pref file to try and set an option that has been locked in another preference file then the option will be ignored in the users preference file Page 4 4 User manual Version 9 4 November 2009 Shell
4. MACHINE SPECIFIC MPP submission commands HP ALPHA dmpirun np SLSDYNA_JOB_CPUS SLSDYNA_VERSION HP PA8000 and Itanium2 HP MPI mpirun np LSDYNA_JOB_CPUS SLSDYNA_VERSION lt SLSDYNA_JOB_FILE single node mpirun f appfile multiple nodes where appfile contains h hostname_lst np 1 e MPI_WORKDIR lt workdir gt SLSDYNA_VERSION lt SLSDYNA_JOB_FILE h hostname_2nd np 2 e MPI_WORKDIR lt workdir gt LSDYNA_VERSION h hostname_3rd np 3 e MPI_WORKDIR lt workdir gt LSDYNA_VERSION h hostname_4th np 4 e MPI_WORKDIR lt workdir gt SLSDYNA_VERSION Page 2 20 User manual Version 9 4 November 2009 Shell IBM Power setenv MP_PROCS LSDYNA_JOB_CPUS setenv MP_LABELIO no setenv MP_EUILIB us setenv MP_EUIDEVICE css0 poe SLSDYNA_VERSION procs LSDYNA_JOB_CPUS hfile SLSDYNA_NODE_FILE T SGI IRIX mpirun np LSDYNA_JOB_CPUS SLSDYNA_VERSION SUN SPARC mpirun np LSDYNA_JOB_CPUS SLSDYNA_VERSION kkxkxkxkxkxkxkxkxkxkxkxkxkkxkxkxkxkxkxkxkxkxkxkxkxkxkkxkxkkkxkxkkxkxkkkxkxkkxkxkkxkxkxkkxkxkkxkxkxkkxkxkkxkxkxkkxkxkkxk kxkxkkkxkkxk kxx k THE REST OF THIS SCRIPT HAS BEEN CONFIGURED FOR SUBMITING LS DYNA JOBS TO A LINUX SYSTEM USING THE PBS QUEUEING SYSTEM YOU WILL HAVE TO MODIFY THE IFE U FOLLOWING IF YOU ARE USING A DIFFERENT QUEUEING STSTEM OR MACHINE TYPE KEKKKKKKKKKKKKKKKKKKKKKKKKK LK
5. Page 2 16 User manual Version 9 4 November 2009 Shell The following sections include examples taken from the batch file created for a job submitted to a PBS queuing system on a LINUX machine 2 5 1 Queuing Commands The Shell will automatically add queuing commands to the start of the batch file The options supported for the different queuing systems are as follows Osten nes Jens son Je o logfile o logfile o logfile o logfile emo so foero fe temonter emo start time a start time a startrime gt o start time IT limit EEE 1h_epu limit c limit Aimi HE d The log and error file output options can be disabled by setting the preference options shell queue_output_file and shell queue_error_file to FALSE Page 2 17 Shell User manual Version 9 4 November 2009 2 5 2 Environment Variables The following environment variables are automatically set up in the batch file by the Shell OA_INSTALL Full pathname of the software installation directory LSTC_FILE Full pathname of the LSTC license file If a LSTC license server is being used then this variable will replaced with the LSTC_LICENSE_SERVER LSTC_NOCLIENT and LSTC_LICENSE variables JLMLLICENSEFILE MPI version from dyna_versions file Full pathname of the directory containing the LS DYNA job Number of CPU s selected for parallel jobs LSDYNA_NODE_FILE Set to TRUE if submitting MPP jobs using a file containing the lis
6. 1 Main Menu Select the required option The main menu will be shown with the selected queue command 1 14 17 Submit Once you are happy with the options chosen at the main menu type in 99 and press enter to submit the job If output files already exist a menu asking whether to overwrite or delete them will be displayed Some output files already exist 1 Overwrite 2 Delete 3 Cancel Select the required option and if cancel was not selected the job will be submitted Page 1 27 Shell User manual Version 9 4 November 2009 1 14 18 Reset To reset the selected options to defaults at the main menu type in 88 and press enter 1 14 19 Status Kill The status of arun can be queried or killed by typing in 77 and enter at the main menu The following menu will be displayed Options Current selection 1 SW1 Write a Restart File and Terminate Off 2 SW2 Report Time and Cycle Number On 3 SW3 Write a Restart File and Continue Off 4 SW4 Write a Plot State and Continue Off 5 FILE Send Ouput from SW2 to a File Off 99 Apply 1 Main menu Select the required option to toggle what to do Select Apply to carry out the option selected Note A job must be selected before this menu can be displayed Page 1 28 User manual Version 9 4 November 2009 Shell 2 Customising the Shell This section is relevant to those responsible for installing the software suite 2 1 UNIX LINUX Insta
7. E a Version 9 4 The Software h For help and support from OASYS Ltd please contact UK Arup Group Ltd The Arup Campus Blythe Gate Blythe Valley Park Solihull West Midlands B90 8AE United Kingdom Tel 44 0 121 213 3399 Fax 44 0 121 213 3302 Email dyna support arup com Web www oasys software com dyna China Arup 39 F 41 F Huai Hai Plaza Huai Hai Road M Shanghai China 200031 Tel 86 21 6126 2875 Fax 86 21 6126 2882 Email china support arup com Web www oasys software com dyna India Arup Plot 39 Ananth Info Park Opp Oracle Campus HiTec City Madhapur Phase II Hyderabad 500081 India Tel 91 40 4436 9797 98 Email india support arup com Web www oasys software com dyna or contact your local Oasys Ltd distributor LS DYNA LS OPT and LS PrePost are registered trademarks of Livermore Software Technology Corporation User manual Version 9 4 November 2009 Shell 1 LS DYNA Environment 1 1 Introduction 1 1 1 UNIX LINUX 1 1 2 Windows 1 2 LS DYNA 1 2 1 LS DYNA version options 1 2 2 Job options 1 2 3 Parallel options 1 2 4 Submission options 1 2 5 Restarts 1 2 6 Post Processing Options 1 2 7 Submit 1 2 8 Reset 1 2 9 Status Kill 1 2 10 Cancel 1 3 PRIMER 1 3 1 Primer Options 1 4 D3PLOT 1 4 1 D3PLOT Options 1 5 T HIS 1 5 1 T HIS Options 1 6 Reporter 1 6 1 Reporter Options 1 6 2 Variables 1 6 3 LIST File Format 7 Utilities 8 Preferences
8. pack_nodes submit_shell unix_type manual_reader temp_folder string ONLINE or BACKGROUND or BATCH or QUEUE ONLINE string NQS LSF SGE PBS PBSPRO7 or PBSPRO71 NOS logical Add output file directive to job script logical Add error file directive to job script logical Add job path to output error directive in job script real Batch Queue Memory Size string WORDS or MWORDS real Batch Queue CPU Limit string SECONDS MINUTES or HOURS real Batch Queue File Space Limit 1024 string Name of LSF queuing machine logical TRUE or FALSE logical TRUE or FALSE logical TRUE or FALSE real Minimum System Time seconds string KEYWORD or FIXED string ARUP or LSTC real Job Memory Size string WORDS or MWORDS real Job CPU Limit string SECONDS MINUTES or HOURS logical TRUE or FALSE integer Binary File Size logical TRUE or FALSE logical TRUE or FALSE string TRUE or FALSE logical TRUE or FALSE string name of D3PLOT executable string name of 64 bit D3PLOT executable integer default D3PLOT version 32 or 64 string name of T HIS executable string name of 64 bit T HIS executable integer default T HIS version 32 or 64 string name of PRIMER executable string name of 64 bit PRIMER executable integer default PRIMER version 32 or 64 string name of REPORTER executable string version displayed for shell integer Maximum number of CPUS integer Maximum number of CPUs for MPP integer Default number of
9. Installation organisation 1 Introduction Up to and including release 9 3 of the software the installation was organised thus OASYS directory All executables Top level oa_pref file Job queue control files Other configuration files manuals The various user manuals d3plot_library primer_library reporter_library Scripts and macros used by the respective programmes this_library The various directories used for files were the system standard directories or hard wired to the top level OASYS directory User s home HOME USERPROFILE directory TypicallyC Documents and Typically lt username gt Settings lt username gt Temporary file TEMP directory Typically tmp or var tmp Typically C Documents and Settings lt username gt Local settings Temp Manuals SOASYS manuals SOASYS manuals directory Scripts directory OASYS lt prog gt _library sOASYS lt prog gt _library 2 Problems with the existing installation structure This organisation has been reasonably successful for single users and small organisations but it has proved unwieldy for larger organisations for the following reasons e Large organisations generally imply large networks and it is often the case that the performance of these networks can be intermittent or poor therefore it is common practice to perform an installation of the software on the local disk of each machine rather then having a single installation on
10. QSUB o job_directory jobname log PBS o job_directory jobname log QSUB o job_directory jobname log BSUB o job_directory jobname log 2 3 5 shell queue_error_file These variable controls if the Shell writes a queue directive to specify a file for errors when a job is submitted to a queueing system If this option is set to TRUE then the queue will add the following line to the top of the job submission script NQS QSUB eo QSUB o job_directory jobname err PBS PBSPRO7 PBSPRO71 PBS e job_directory jobname err QSUB e job_directory jobname err BSUB e job_directory jobname err 2 3 6 shell queue_error_path This option can be used to specify if the queue directives for the output and error files should contain the job path or not By default this option is set to TRUE Page 2 10 User manual Version 9 4 November 2009 Shell 2 3 7 shell queue_memory This variable controls the value used for the default Queue Memory limit The required value should be specified using the units defined by the shell queue_memory_units variable see Queue Memory Units A value of 0 means that the job will be submitted with a unlimited Queue Memory 2 3 8 shell queue_memory_units This variable controls whether the default Queue Memory limit is specified in words or megawords It should be set to either WORDS or MWORDS respectively 2 3 9 shell queue_cpu This variable controls the value used
11. The Options button can be used to specify options which will affect how T HIS operates when it is executed This will open up the T HIS options window which will allow T HIS command line options to be explicitly defined 1 2 6 2 Run Reporter after Analysis Setting this option to ON will cause Reporter to automatically run following termination of the analysis Selecting OFF will disable this automatic post processing The Options button can be used to set up input options for Reporter when it runs see section 1 6 1 for more details on these options 1 2 6 3 Display If you are running T HIS or Reporter automatically at the end of an analysis then this option can be used to select the machine on which T HIS and Reporter should be displayed when it runs By default this will be set to the machine you submitted the job from and will not normally need to be changed Page 1 10 User manual Version 9 4 November 2009 Shell 1 2 7 Submit Click on this button to submit the LS DYNA job using all of the options previously set Before the job is actually submitted the following checks will be carried out The input file specified exits e The Queue CPU Limit if specified is larger than the Analysis CPU Limit e The Queue Memory Limit if specified is at least 6000000 words larger than the Analysis Memory Limit e An Account name if required has been specified 1 2 8 Reset Click on this button to reset all of the submission options to th
12. 9 Manuals 10 Status 11 Support 12 Exit 13 Command Line Options 14 Command Line Submission Shell 1 14 1 How To Use The Command Line Submission Shell 1 14 2 Code Version 1 14 3 Input File 1 14 4 File Format 1 14 5 CPU Limit 1 14 6 Memory Limit 1 14 7 Increase Memory If Required 1 14 8 Filename Format 14 9 Optional Files 4 10 CPUs 1 1 1 1 1 1 1 1 fe ph ph fh pm ph fc pm pah p f pah pd mh pd mh ph mn ph p p p ph ph fm pb pb ph ph ph fc fm fc p ph p p mj ah fh DESZSZSESISESESZSESESICENENESESENENESESESESESESENSESENCHNCH hH hihihihihi hhh hihihih hhh TOTO ee eee MOON PODDODODDDDyTHHH OOOOOO OVX NUN RP HWW RRR HH OO VO OA PUNDDH m 1 1 1 1 14 11 Node Options 1 14 12 Submission Type 1 14 13 Queue CPU Limit 1 14 14 Queue Memory Limit 1 14 15 Queue Name 1 14 16 Queue Options 1 14 17 Submit 1 14 18 Reset 1 14 19 Status Kill 2 Customising the Shell 2 1 UNIX LINUX Installation 2 1 2 1 1 setenv OA_INSTALL lt option gt 2 2 2 1 2 setenv OA_ADMIN OA_ADMIN_94 lt option gt 2 2 2 1 3 setenv OASYS_LICENSE_FILE LM_LICENSE_FILE lt option gt 2 3 2 1 4 setenv LSTC_FILE LSTC_LICENSE_SERVER lt option gt 2 3 2 1 5 setenv MENU_AUTO_CONFIRM lt option gt 2 3 2 1 6 setenv FILE_EXIST_ACTION lt option gt 2 4 2 1 7 setenv ECHO_PREFERENCE lt option gt 2 4 2 2 Windows NT 2000 XP Installation 2 4 2 2 1 OASYS_LICENSE_FILE LM_LICENSE_FILE 2 4 2 2 2 OA_ADMIN OA_ADMIN_94 lt option gt 2 5 2 2 3 LSTC_FILE LSTC_LICENSE_SE
13. LSDYNA_JOB_DIR LSDYNA_JOB_FILE LAM_DIR bin lamclean LAM_DIR wipe PBS_NODEFILE MPICH 1 2 6 using ssh else if LSDYNA_MPI_TYPE MPICH then setenv MPICH_DIR usr local mpich_1 2 6 bin if e PBS_NODEFILE then cat PBS_NODEFILE set numproc cat PBS_NODEFILE wc 1 endif setenv P4_RSHCOMMAND ssh x S MPICH_DIR mpirun np numproc LSDYNA_VERSION lt LSDYNA_JOB_DIR LSDYNA_JOB_FILE HE endif HE endif HE 2 5 3 2 Example of a Windows oasys submit file The following example shows the default oasys submit file that is included with the version 9 4 software on PC platforms As MPP jobs can use either the HP MPI or MPICH MPI libraries this script shows how to submit jobs using both of them The default script is setup assuming that the different MPI libaries have been installed in the following directories MPI Directory HP MPI C Program Files Hewlett Packard HP MPI MPICH 1 2 6 C Program Files MPICH This script also shows 1 How to submit MPP jobs to either the local machine or to multiple machines using either a file containing a list of hostnames or a string containing the hostnames 2 How to pass environment variables for license options to the remote hosts via the mpirun command REM The following Environment Variables are available for this script REM REM LSDYNA_VERSION full pathname of selected LS DYNA executa
14. OA_INSTALL Previously the software used the OA_INSTALL renamed from OASYS environment variable to locate the directory the software was installed in e On Windows this is no longer required as the software can work out it s own installation directory As this environment variable is no longer required it is recommended that it is removed from machines it is currently set on as in some cases where more than one version has been installed in different directories it can cause problems e On UNIX LINUX systems the oasys_94 script that starts the SHELL automatically sets this Environment Variable and passes it to any application started from theSHELL If you run applications directly from the command line and bypass the SHELL then you should set OA_INSTALL so that the software can locate manuals and other required files OA_ADMIN_XX Users wishing to separate configuration and installation directories will be able to do so by making use of the new top levelOA_ADMIN_xx directory 3 1 Dynamic configuration using the top level oa_pref file Page A 2 User manual Version 9 4 November 2009 Shell A further improvement is that all environment variables below OA_ADMIN_xx may either be set explicitly or dynamically using the options in the oa_pref file at the top OA_ADMIN_xx level This permits parallel installations of different versions of the software to co exist with only the top level administration directory names being distinct For exampl
15. be displayed if the queue has no CPU limit then the word NONE will be displayed The default queue will be the first one listed in the oasys_queue file 1 2 4 7 Queue Options This option will only be accessible when jobs are being submitted using the Queue option It is intended to be used so that user defined queue directives can be specified rather than using the ones produced by the shell see Section 2 3 34 The options available will depend on the queue and number of cpus chosen and the contents of the oasys_queue file Selecting an option will put the additional queue directives defined in this file into the submission script If there are no options available for the selected number of cpus then the options for the next number of cpus up will be displayed e g if the number of cpus chosen is 3 but no options are defined for 3 cpus then if there are options defined for 4 cpus then the options for 4 cpus will be shown If there are no options available then the default directives produced by the shell will be used 1 2 5 Restarts 1 2 5 1 Select Restart Time This option will only be available if the analysis is not a coupled LS DYNA MADYMO3D analysis When this button is selected all input to the Shell will be frozen while a search is carried out for any restart input files that exist for the specified job When the search has been completed the window shown below with all of the available restart times will be displayed and t
16. be modified so that it references the directory in which the Shell is loaded i e if the software has been loaded in prg oasys94 executables set this line to setenv OA_INSTALL prg oasys94 executables This line should be set automatically by the installation script 2 1 2 setenv OA_ADMIN OA_ADMIN_94 lt option gt If a top level administration directory is to be used then OA_ADMIN_94 for release 9 4 must be defined for all machines on which the software is to be run This variable should be set to the full pathname of the administration directory A description of the installation organisation is given in the Appendix Page 2 2 User manual Version 9 4 November 2009 Shell 2 1 3 setenv OASYS_LICENSE_FILE _LM_LICENSE_FILE lt option gt Either OASYS_LICENSE_FILE or LM_LICENSE_FILE can be used to locate a valid license for the Oasys software It is recommended that OAS YS_LICENSE_FILE is used as this can speed up the checkout of licenses on systems where LM_LICENSE_ FILE is used to find other license servers as well 2 1 3 1 Floating Network License If you are running the software using a license server then this variable should be set to point to the license server machine using the machine s hostname ie setenv OASYS_LICENSE_FILE hostname or setenv OASYS LICENSE _FILE port hostname if you have specified a non default port for the server 2 1 3 2 Fixed Stand alone Licenses If you are using a node locked license file
17. current working directory The global preference files located in the OA_ADMIN_xx directory and installation directory are read first and then any user specific options are read from the preference file located in HOME If this variable is not set the user will not be able to set up there own user preferences 2 2 5 MENU_AUTO_CONFIRM This variable is often used when replaying command files which when recorded paused and asked the user to confirm things For example HELP and Warning messages Possible options for this variable are none overwrite and append If the variable is set true then these will not pause and will behave as if the user had pressed OK meaning that command files can play back without user intervention Page 2 5 Shell User manual Version 9 4 November 2009 2 2 6 FILE_EXIST ACTION This variable controls the action to be taken when opening a file for output and the file already exists Possible options for this variable are none overwrite and append Normally you will be prompted for the action to be taken when a file selected for output already exists However if this variable is set to overwrite or append then the relevant action will be taken automatically This is generally used when playing automatic post processing batch scripts 2 2 7 ECHO_PREFERENCE If this variable is set to 1 then any command line arguments used to start T HIS PRIMER or D3PLOT will be echoed to the screen along with any
18. find the correct Internet Explorer D3PLOT executable You are z looking for file d3plot94 exe If di Microsoft Photo Editor you can t remember where it is Microsoft PowerPoint for Windows installed use Start gt Find gt m N Files or Folders to locate it Windows Picture and Fax viewer 5 Click on OK to close the Open A WordPad With window This should start D3PLOT but at present it won t know about device type or filename so select STOP to exit VW Always use the selected program to open this kind of file Page 3 1 Shell User manual Version 9 4 November 2009 If D3PLOT doesn t start check through what you ve done and ask Oasys Ltd for help if you can t resolve the problem View Windows nt or 2000 or a Windows xp then select General View File Types Difine Files Folder Options from the menu 2 Select the File Types tab at the i top Registered file types er file types until you get to the Extensions File Types SS a te nn eee _ name you entered for ptf files NONE AudioCD e g LS DYNA complete state NONE Drive file Highlight this and select NONE DVD 9 NONE File Folder Advanced 9 NONE Folder je NONE Help and Support Center protocol ENNNNFI Intemet Shorteut z Details for AudioCD file type Opens with hange To change settings that affect all AudioCD files click Advanced Advanced 1 In th
19. for the default Queue CPU Limit The required value should be specified using the units defined by the shell queue_cpu_units variable see Queue Cpu Units A value of 0 means that the job will be submitted with a unlimited Queue CPU 2 3 10 shell queue_cpu_units This variable controls whether the default Queue CPU Limit is specified in seconds minutes or hours It should be set to either SECONDS MINUTES or HOURS respectively 2 3 11 shell queue_space This variable controls the value used for the default File Space limit The required value should be specified in Mbytes A value of 0 means that the job will be submitted with an unlimited File Space Limit 2 3 12 shell queue_machine This variable may be used to specify the name of the queuing machine used by LSF batch queues This option is passed as the m parameter to the LSF bsub command e g bsub m queue_machine 2 3 13 shell request_cpu memory_limit These variables control whether Queue CPU and Memory limits have to be specified when jobs are submitted to NQS style queues If they do have to be specified then set the relevant variable to TRUE otherwise set them to FALSE 2 3 14 shell request_space_limit This variable controls whether a Per request File Space limit has to be specified when jobs are submitted to NQS style queues If they do have to be specified then set this variable to TRUE otherwise set it to FALSE 2 3 15 shell system_cpu This variable controls the minimu
20. is for LS DYNA to write out CTF binary files when a jobs is submitted see the Job Options menu If this variable is set to FALSE then this option will be turned off by default 2 3 25 shell write_ztf By default the xshell_94 is set up so that after an LS DYNA run PRIMER is automatically run to generate a ZTF file for D3PLOT to read see the Job Options menu If this variable is set to FALSE then this option will be turned off by default 2 3 26 shell batch_display This variable can be sued to specify a UNIX DISPLAY that can be used for batch processing commands 2 3 27 shell keep_ files This variable controls whether temporary files created during the submission process and any CORE files created if a job terminates abnormally are deleted automatically If this variable is set to TRUE the files will not be deleted o kkkk 2 3 28 shell lt gt version By default the xshell_94 is set up to access and run software that uses the default program names This option allows the name of any executable to be modified as required and for the xshell_94 to be notified of this name change e g shell d3plot_version d3plot90 exe would force the version 94 Shell to run the version 9 0 copy of d3plot d3plot90 exe would have to be in the directory containing the version 94 executables On machines where both 32 and 64 bit versions of D3PLOT T HIS and PRIMER are available the names for the 64 bit versions can be modifie
21. the respective files Generate ZTF File PRIMER version IV 32bit _ 64bit Input Options Select preference file Start in P oasys93 Other Options _ Automatically EXIT after running command file _ Run PRIMER in batch mode v Use OpenGL Use X 24bit Use X bit Use Full Screen set MENU_AUTO_CONFIRM TRUE Startin Specify the directory where PRIMER will be fired up and where output files will be written to Other Options Automatically EXIT Causes PRIMER to close once the specified command file has finished running Run PRIMER in batch Starts PRIMER in batch mode a non graphical mode which accepts commands from a file specified in the Input options Use OpenGL Starts PRIMER using OpenGL graphics mode Use X 24 bit Starts PRIMER using 24bit X Windows graphics mode Use X 8 bit Starts PRIMER using 24bit X Windows graphics mode Use Full Screen Opens the PRIMER window to fill the whole screen This variable is often used when replaying command files which when recorded MENU_AUTO_CONFIRM paused and asked the user to confirm things For example HELP and Warning messages If this option is selected PRIMER will continue automatically using the default option Page 1 12 User manual Version 9 4 November 2009 Shell 1 4 D3PLOT D3PLOT r Select this option to access D3PLOT This program is a graphical post processor designed to access the binary o
22. then this variable should be set to point to the location of the license file ie setenv OASYS_LICENSE_FILE lt INSTALL_DIR gt oasys_flexlm dat 2 1 3 3 Multiple FLEXIm license files If you have other software that uses FlexLM then this Environment variable may already be set to point to a license file or a license server If this variable is already set then you may add the license server or file for this software by specifying a colon separated list of values ie setenv OASYS_LICENSE_FILE port hostnamel hostname2 2 1 4 setenv LSTC_FILE LSTC_LICENSE_SERVER lt option gt On UNIX LINUX machines LS DYNA can use either a nodelocked license or a floating license system If you are using a nodelocked license then LSTC_FILE should be set to the full pathname of the license file By default this file should be called gt LSTC_FILE and it should be located in the executables directory i e setenv LSTC_FILE OA_INSTALL LSTC_FILE If you are using the floating license system then the variables LSTC_LICENSE_SERVER LSTC_NOCLIENT and LSTC_LICENSE should be set as follows ie setenv LSTC_LICENSE_SERVER hostname where hostname is the LSTC license server setenv LSTC_NOCLIENT ON setenv LSTC_LICENSE network 2 1 5 setenv MENU_AUTO_ CONFIRM lt option gt This variable is often used when replaying command files which when recorded paused and asked the user to confirm things For example HELP and Warning messages Possible options f
23. which program they are EISHELL applicable to eans that the option has been read from your HOME USERPROFILE file i eans that the option has been read from the OA_INSTALL E queue_options file batch_type These categories can be expanded to reveal their respective preferences contracted to hide their preferences by clicking on the box to the left of the respective category alternatively use the edit drop down menu and select Expand all branches or collapse all branches gt that the option had been read from the OA_ADMIN queue_memory queue_memory_unit Preferences which aren t highlighted indicate preferences that haven t queue_cpu been set queue_cpu_units queue_space A list of all the preferences available and their default value can be found queue_machine in any oa_pref file written by the preferences editor request_cpu_limit request_memory_limi Ef a Preferences in bold type indicate preferences which haven t been assigned the default value 4 2 1 3 The preferences editor Right hand frame The right hand frame will contain information Name d3plot maximise about the currently selected preference and provides the opportunity to edit this preference Type lt logical gt Default FALSE Description Maximise window when D3PLOT starte Active V Value Name States the name of the currently selected preference Type Specifies the type of variable applicable to this preference
24. 1 2 3 1 Number of cpus This option will only be accessible if your system supports parallel versions of LS DYNA The required number of processors to run the job on can be selected using the arrow buttons The maximum number of processors that can be selected is controlled through the oa_pref file see section 2 3 The value selected will override the number of processors selected on the CONTROL_PARALLEL card in the input deck Page 1 6 User manual Version 9 4 November 2009 Shell 1 2 3 2 Consistency Flag This option controls whether parallel analyses are run with the accuracy option in LS DYNA turned ON or OFF The default is to turn the accuracy option ON which results in nearly identical results across different numbers of CPU s but a lower overall speedup in the job time The value selected will override that selected on the CONTROL_PARALLEL card 1 2 3 3 V Use Local Host Local Host This option will only be availble when submitting MPP jobs using either the Online Background or Batch options When selected the MPP jobs will be submitted using only the machine that the shell is being run on 1 2 3 4 _ Use Node File nostfile co Node File This option will only be availble when submitting MPP jobs using either the Online Background or Batch options This option can be used to select a file containing a list of Nodes and CPUS to use when submitting an MPP job The format of the file will depend on
25. 3 1 HPMPI 2 5 Customising the LS DYNA submission script The Shell generates either a UNIX CShell Bourne Shell script jobname ct1 or a DOS batch file jobname bat that contains all of the selected LS DYNA job options On UNIX systems the choice of either CShell or Bourne Shell is controlled by the shell submit_shell option in the oa_pref file In version 9 4 of the Shell the contents of these batch files can be modified by editing the oasys submit file located in the installation directory The batch file created by the submission Shell is split into 4 sections Oo Comms o o Queuing Queue commands for NQS SGE LSF and PBS queuing systems If the job is Automatically Commands not submitted to a queue then this section of the batch file will be empty generated by the Shell Environment This section of the batch file sets up a number of Environment variables The Automatically Variables first group contain information relating to license systems while the second generated by the set contain information relating to the selected version of LS DYNA and the Shell job LS DYNA This section of the batch file contains the commands that are actually used to User configurable submission run LS DYNA The contents of this section are included from a file in the installations directory Post Processing Commands for running T HIS and Reporter automatically after the Automatically Options LS DYNA job terminates generated by the Shell
26. CPUs for SMP integer Default Number of CPUs for MPP integer Maximum number of CPUs per node for MPP jobs logical Pack MPP jobs on the minimum number of nodes string CSHELL or BSHELL string SYSTEM5 or BSD string location of ADOBE ACROBAT reader logical TRUE or FALSE string PC Location to write TRUE TRUE TRUE 15000000 WORDS 0 SECONDS 1024 TRUE TRUE FALSE 90 KEYWORD ARUP 9000000 WORDS 0 SECONDS TRUE 7 FALSE TRUE FALSE d3plot94 exe d3plot94_64 exe 32 this94 exe this94_64 exe 32 primer94 exe primer94_64 exe 32 reporter94 exe 9 4 1 1 1 1 2 TRUE CSHELL SYSTEM5 acroread TRUE bat file to on aC TEMP Preferences marked with a can be read from all four directories If desired they can still be locked in the OA_ADMIN_ xx or OA_INSTALL directories using the shell syntax shell online TRUE Page 2 8 User manual Version 9 4 November 2009 Shell shell background TRUE shell batch TRUE shell queue TRUE shell default ONLINE shell batch type NOS shell queue output file TRUE shell queue error file TRUE shell queue error path TRUE shell queue memory 15000000 shell queue memory units WORDS shell queue_ cpu 0 shell queue _ cpu units SECONDS shell batch type NOS shell queue_ space 1024 shell queue_ machine shell request cpu limit TRUE shell request memory limit TRUE shell request space limit FALSE shell system_cpu 90 shell job
27. HH setenv DISPLAY FACTOR automatic setenv USERID whoami setenv LICENSE_TYPE flexlm set noglob Set EDITOR if not set to the command to invoke an external editor This EDITOR is currently used for editing comment lines in Oasys PRIMER if EDITOR then setenv EDITOR usr bin kedit LINUX setenv EDITOR usr dt bin dtpad UNIX CDE endif Environment variables for post processors If FILE_SKIP has not been set then set it to 5 SH He He HE SEH HF HF HHH if FILESKIP then setenv FILE SKIP 5 Page 2 1 Shell User manual Version 9 4 November 2009 endif MACHINE SPECIFIC LINES itiiti tiiit extra line needed for some IBM machines setenv LANG En_US Extra line needed for SUN Solaris Machines setenv LD_LIBRARY_PATH usr openwin lib Now start the main shell executable set cwd pwd setenv PWD cwd SOA_INSTALL xshell_94 exit exit exit The following parameters will require modifying in accordance with your system layout setenv OA_INSTALL lt option gt setenv OA_ADMIN OA_ADMIN_94 lt option gt optional setenv OASYS_LICENSE_ FILE LM LICENSE_FILE lt option gt setenv LSTC_FILE LSTC_LICENSE_SERVER lt option gt setenv MENU_AUTO_CONFIRM lt option gt optional setenv FILE _EXIST_ACTION lt option gt optional setenv ECHO_PREFERENCE lt option gt optional 2 1 1 setenv OA_INSTALL lt option gt The OA_INSTALL Shell variable must
28. KK KK KH IK IK KH KH A KH TH A TI FH KH A TH TA KK FH TA TI TH FH A I FH KA TH KH A A FH AK TI FH KH A IK AK KH A KH KU UO if LSDYNA_MPP TRUE then SMP LS DYNA submission LSDYNA_VERSION lt LSDYNA_JOB_DIR LSDYNA_JOB_FILE else MPP LS DYNA submission HP MPI if LSDYNA_MPI_TYPE HP MPI then setenv HPMPI_DIR opt hpmpi bin if e PBS_NODEFILE then rm rf LSDYNA_JOB_DIR appfile gt amp dev null if f PBS_NODEFILE then foreach roger cat PBS_NODEFILE echo h roger np 1 LSDYNA_VERSION gt gt LSDYNA_JOB_DIR appfile end endif endif HPMPI_DIR mpirun prot e MPI_WORKDIR LSDYNA_JOB_DIR f appfile rm rf LSDYNA_JOB_DIR appfile gt amp dev null LAM 6 5 9 using ssh else if LSDYNA_MPI_TYPE LAM659 then setenv LAM DIR usr local lam_6 5 9 bin setenv LAMRSH ssh x SLAM DIR recon v PBS_NODEFILE SLAM DIR lamboot v PBS_NODEFILE SLAM _DIR mpirun C LSDYNA_VERSION lt SLSDYNA_JOB DIR SLSDYNA_JOB FILE SLAM DIR lamclean LAM_DIR wipe PBS_NODEFILE Page 2 21 n 5 oO User manual Version 9 4 November 2009 LAM 7 0 3 using ssh else if LSDYNA_MPI_TYPE LAM703 then HE HR HE setenv LAM DIR usr local lam_7 0 3 bin setenv LAMRSH ssh x SLAM DIR recon v PBS_NODEFILE LAM_DIR lamboot v ssi boot rsh ssi boot_rsh_agent ssh x PBS_NODEFILE LAM_DIR mpirun C x LD_LIBRARY_PATH LSDYNA_VERSION lt
29. NDOWS Finally after setting up all the new A a select oi followed by OK to TEMP C Documents and Settings timothy hug dismiss the System Properties menu TMP C Documents and Settings timothy hug LM_LICENSE_FILE 7788 10 64 27 51 p oasys83 oasys_ LTSC_FILE c program filesilsdynaiLSTC_FILE NUMBER_OF_P 2 05 Windows_NT 2 3 Customising the GUI Shell The oa_pref file controls the setup of a number of the programs in the software suite Most of the programs will look for this file in the following 4 locations in the order given to allow individual users to customise the programs for their own needs The OA_ADMIN_xx directory e The directory containing the executables OA_INSTALL directory e The user s login directory The current working directory The xshell_94 Shell will look for this file in all four directories However to stop users trying to override the system settings it will only read a seletion of the shell preferences from the home and current working directory those that do not affect system settings This section only deals with the options for setting up the GUI Shell the options for the other programs are covered in the relevant manuals From v94 preferences can be locked If a preference is locked it cannot be changed in an oa_pref file in a more junior directory To lock a preference use the syntax shell rather than shell From v94 Environment variables can be
30. RVER lt option gt 25 2 2 4 HOME 2 5 2 2 5 MENU_AUTO_CONFIRM 2 5 2 2 6 FILE_EXIST_ACTION 2 6 2 2 7 ECHO_PREFERENCE 2 6 2 2 8 DISPLA Y_HEIGHT DISPLAY_WIDTH 2 6 2 2 9 Setting Environment Variables 2 6 Shell User manual Version 9 4 November 2009 2 3 Customising the GUI Shell 2 3 1 shell online shell background shell batch shell queue 2 3 2 shell default 2 3 3 shell batch_type 2 3 4 shell queue_output_file 2 3 5 shell queue_error_file 2 3 6 shell queue_error_path 2 3 7 shell queue_memory 2 3 8 shell queue_memory_units 2 3 9 shell queue_cpu 2 3 10 shell queue_cpu_units 2 3 11 shell queue_space 2 3 12 shell queue_machine 2 3 13 shell request_cpu memory_limit 2 3 14 shell request_space_limit 2 3 15 shell system_cpu 2 3 16 shell job_format 2 3 17 shell file_names 2 3 18 shell job_memory 2 3 19 shell job_memory_units 2 3 20 shell job_cpu 2 3 21 shell job_cpu_units 2 3 22 shell allow_mem_change 2 3 23 shell file_size 2 3 24 shell write_ctf 2 3 25 shell write_ztf 2 3 26 shell batch_display 2 3 27 shell keep_files 2 3 28 shell lt gt version 2 3 29 shell lt gt default 2 3 30 shell shell_release 2 3 31 shell max_cpus shell max_mpp_cpus 2 3 32 shell default_cpus shell default_mpp_cpus 2 3 33 shell max_node_cpus 2 3 34 shell pack_nodes 2 3 35 shell submit_shell UNIX LINUX only 2 3 36 shell unix_type 2 3 37 shell manual_reader UNIX LINUX only 2 3 38 shell temp_folder Wind
31. SPro 7 0 node request PBSPro 7 1 node CPU s Peg 200000 TRUE nodes 1 ppn 2 1x2 nodes 1 ppn 1 ncpus 2 select 1 select 1 nepus 2 FALSE nodes 2 ppn 1 2x1 nodes 2 ppn 1 ncpus 1 TRUE nodes 4 ppn 2 4x2 nodes 4 ppn 1 ncpus 2 select 4 ncpus 2 TRUE nodes 1 ppn 4 1 ppn 3 nodes 1 ppn 1 ncpus 4 select 1 ncpus 4 1x4 1x3 1 ppn 1 ncpus 3 1 ncpus 3 2 3 35 shell submit_shell UNIX LINUX only i FALSE nodes 8 ppn 1 8x1 nodes 8 ppn 1 ncpus 1 select 8 ncpus 8 LS DYNA jobs are submitted on UNIX LINUX systems using script files This variable can be set to either CSHELL or BSHELL to create either CSHELL or BOURNE shell scripts 2 3 36 shell unix_type This variable controls the default binary file size produced by LS DYNA The value specified gives the required file size in Mbytes 2 3 37 shell manual_reader UNIX LINUX only This option should be set to point to where a copy of the Adobe Acrobat reader software can be found on the system 2 3 38 shell temp_folder Windows only This option can be used to specify a folder that the Shell can use to create temporary files while submitting LS DYNA jobs The directory should be on a local system disk not a networked disk as some Anti Virus programs block running DOS batch files from Network Drives The default folder is C TEMP Page 2 14 User manual Version 9 4 November 2009 Shell 2 4 Adding LS DYNA versions to the Shell The list of LS DYNA versions that can be accessed thr
32. Version 9 4 November 2009 Shell 1 LS DYNA Environment 1 1 Introduction E SHELL 9 4 build 146 LS DYNA Environment 9 4 PRIMER amp Utilities Fr Preferences LS DYNA Manuals r Status Support re LB a REPORTER F 1 1 1 UNIX LINUX On UNIX LINUX the LS DYNA Environment software is accessed by typing the command oasys_94 Page 1 1 Shell User manual Version 9 4 November 2009 1 1 2 Windows GH Oasys Ltd LS DYNA Environment 9 4 gt 83 SHELL PRIMER On Windows the software is accessed via Start gt KA D3PLOT en gt Oasys Ltd LS DYNA Environmnet O T HIS fi REPORTER LMTooLs IF Manuals 1 2 LS DYNA LS DYNA This button accesses the submission menu for LS DYNA The first time this button is pressed the oa_pref file will be read and any default values set see section 4 for more details on the oa_pref file After the file has been read following menu will be displayed Page 1 2 User manual Version 9 4 November 2009 Shell W LS DYNA Submission 32 Bit LS971v7600 Serial y a E A o Keyword EE 0 Seconds y 7000 MegaWordsy ov ARUP ptt x _ Optional Files_ 1 i von Anostile A Po 00 00 Now OP Seconds gogoo Megaworas __ E SEEN 1 2 1 LS DYNA version options LS DYNA 970 v5434 LS DYNA 970 5434 The submission shell can be used to access more than one version LS DYNA 970 3858 of LS DYNA Clicking on the ta
33. _ format KEYWORD shell file names ARUP shell job_ memory 9000000 shell job memory units WORDS shell job_ cpu 0 shell job_cpu units SECONDS shell allow mem_change TRUE shell file size 7 shell write_ctf FALSE shell write ztf TRUE shell batch display shell keep files FALSE shell d3plot version d3plot94 exe shell d3plot64 version d3plot94 64 exe shell d3plot default 32 shell this version this94 exe shell this64 version this94 64 exe shell this default 32 shell primer version primer94 exe shell primer64 version primer94 64 exe shell primer default 32 shell reporter version reporter94 exe shell shell release 9 4 shell max_cpus 1 shell max_mpp cpus 1 shell default_cpus 1 shell default_mpp cpus 1 shell max_node_cpus 2 shell pack_nodes TRUE shell submit shell CSHELL shell unix type SYSTEM5 shell manual_reader acroread shell temp folder C TEMP 2 3 1 shell online shell background shell batch shell queue The XSHELL can submit LS DYNA jobs using four different options Any of these methods can be made inaccessible by setting the relevant variable to FALSE If an option is not available on a machine then the variable should also be set to FALSE shell online Allows jobs to be submitted interactively Delayed start times cannot be specified shell background Allows jobs to be submitted to background If a delayed sta
34. _ADMIN_94 optional LSTC_FILE LSTC_LICENSE_SERVER lt option gt HOME MENU_AUTO_CONFIRM optional FILE EXIST ACTION optional ECHO_PREFERENCE optional DISPLAY_HEIGHT DISPLAY_WIDTH optional We recommend that these variables are set up by a user with Administrator privileges so that they then apply to all users on the system 2 2 1 OASYS LICENSE FILE LM_ LICENSE FILE Either OASYS_LICENSE_FILE or LM_LICENSE_FILE can be used to locate a valid license for the Oasys software It is recommended that OASYS_LICENSE_FILE is used as this can speed up the checkout of licenses on systems where LM_LICENSE_FILE is used to find other license servers as well 2 2 1 1 Floating Network License If you are running the software using a license server then this variable should be set to point to the license server machine using the machine s hostname ie OASYS_LICENSE_FILE hostname or OASYS_LICENSE_FILE port hostname _ if you have specified a non default port for the server Page 2 4 User manual Version 9 4 November 2009 Shell 2 2 1 2 Fixed Stand alone Licenses If you are using a node locked license file then this variable should be set to point to the location of the license file ie OASYS_LICENSE_FILE lt INSTALL_DIR gt oasys_flexlm dat 2 2 1 3 Multiple FLEXIm license files If you have other software that uses FlexLM then this Environment variable may already be set to point to a license file or a license server If this
35. a remote disk This avoids the pauses and glitches that can occur when running executable files over a network but it also means that all the configuration files in or depending upon the top level OASYS directory have to be copied to all machines and more to the point any changes or additions to such files also have to be copied to all machines Therefore some method of decoupling the installation directory from the administration and configuration directory is required e In larger organisations the one person per computer philosophy may not apply with the consequence that users will tend to have a floating home area on a network drive and may not use the same machine every day This is not usually a problem on Unix Linux where the home directory is tied to the login name not the machine However on Windows platforms it means that 7 USERPROFILE which is typically on the local C drive of a machine is not a good place to consider as home since it will be tied to a given computer therefore a user who saves a file in his home directory on machine A may not be able to access it from machine B Therefore a more flexible definition of home is required Page A 1 Shell User manual Version 9 4 November 2009 e Ina similar vein placing large temporary files on the tmp partition Unix Linux or the C drive Windows may result in local disks becoming too full or quotas exceeded Therefore a more flexible definition of tem
36. able if the submission type is not queue and the code type is MPP If it is available then at the main menu type in 10 and press return A menu will be displayed asking for the node option Select the node option 1 Local Host 2 Node File 3 Node List 1 Main menu Select the required option If Local Host was selected the main menu will be displayed If Node File was selected a further menu will be displayed asking for the location of the file Current directory u mid test Enter the node file name 1 Main menu The directory the shell was started in is shown at the top of the menu In the same way as input files node files can be specified relative to this directory or a full path name can be entered No check is made to see if the file exists If Node List was selected a further menu will be displayed asking for a string Enter the node list string 1 Main menu Enter the text and press return The main menu will be shown with the selected option and file or node list string on the right hand side Page 1 25 Shell User manual Version 9 4 November 2009 1 14 12 Submission Type At the main menu type in 11 and press return A menu will be displayed asking for the submission type Select the submission type 1 Online 2 Background 3 Batch unavailable 4 Queue unavailable 1 Main menu Some submission types may be unavailable depending on the settings in the oa_pref file If an unavailable
37. ables are available for this script SLSDYNA_VERSION full pathname of selected LS DYNA executable SLSDYNA_MPP TRUE if MPP version selected SLSDYNA_MPI_TYPE MPI version SLSDYNA_DOUBLE TRUE if double precision version selected SLSDYNA_ONLINE TRUE if the job has been submitted ONLINE SLSDYNA_BACKGROUND TRUE if the job has been submitted to BACKGROUND SLSDYNA_BATCH TRUE if the job has been submitted using BATCH SLSDYNA_QUEUE TRUE if the job has been submitted to a QUEUE SLSDYNA_JOB_DIR full path of LS DYNA job_directory SLSDYNA_JOB_FILE filename containing LS DYNA job options SLSDYNA_JOB_CPUS number of CPU s selected SLSDYNA_USER_ID username SLSDYNA_LOCAL_HOST TRUE if submitting MPP jobs to the local machine SLSDYNA_NODE_FILE TRUE if submitting MPP jobs using a Node File SNODE_FILE filename containing node list for MPP jobs SLSDYNA_LOCAL_HOST TRUE if submitting MPP jobs using a Node List SNODE_LIST string containing node list for MPP jobs MACHINE SPECIFIC VARIABLES uncomment as required IBM AIX setenv YIELDLOOPTIME 10000000 setenv SPINLOOPTIME 1000000 setenv AIXTHREAD_SCOPE S setenv MP_PROCS LSDYNA_JOB_CPUS setenv MP_LABELIO no setenv MP_EUILIB us setenv MP_EUIDEVICE css0 SGI IRIX setenv MPC_GANG off setenv OMP_DYNAMIC FALSE setenv OMP_SET_NUMTHREADS SLSDYNA_JOB_CPUS setenv _DSM_PPM 2 setenv _DSM_ PLACEMENT ROUND_ROBIN setenv TRAP_FPE OVERFL ABORT DIVZERO ABORT INVALID ABORT INT_OVERFL ABORT
38. ata for that queue note that they must be the same as the names defined in the first block lt 1 gt and lt l gt are the number of cpus and tags to indicate the start and end of the data for that number of cpus mpp_only if this is included then the option will only be available if an MPP version of Dyna is selected display_string is the text that is displayed to the user in the popup menu on the Shell see Section 1 2 4 7 command is a queue directive specific to the queue and number of cpus up to 20 can be defined for the queue and cpu combination Up to 100 queue and cpu combinations can be defined If this block is not included in the file then the queue options popup will be greyed out and the default directives produced by the Shell will be used The third block defines queue directives that apply to all queues This block is optional lt all_queue_commands gt command PBS m abe lt all_queue_commands gt Where lt all_queue_commands gt and lt all_queue_commands gt are tags to indicate the start and end of the block of data command is a queue directive up to 20 can be defined Page 2 25 Shell User manual Version 9 4 November 2009 Example lt queue_names gt lt queue_names gt lt queue_commands gt Page 2 26 lt dyna gt lt dyna gt lt fast gt lt fast gt lt dyna gt cpu_limit none cpu_limit 3600 lt 1 gt lt 1 gt lt 2 gt lt 2 g
39. atically Increase Memory If Required If this option is selected then LS DYNA will automatically increase the amount of memory it uses if the amount specified by MEMORY LIMIT is insufficient Page 1 5 Shell User manual Version 9 4 November 2009 1 2 2 9 Optional Files FST Wetnrsn cs Clicking on the OPTIONS tab Input Files Input Options will display this menu of input none gt 2 and output options that can be Stress Initialization sif ENDTIM 0 000000 used with LS DYNA For more i z details on these options see the Interface Segment isf2 ENDCYC 0 LS DYNA User s manual VDA Geometry vda PARA 0 CAL3D Input c3d Output Files TOPAZ3D Temperature MADYMO Input File REMAP option MPP pfile Contact Force File ctf _ Interface Segment isf1 V Static Database File ztf _ Winfrith Crack file crf _ FSIFOR file ff _ bem File I 1 Binary File Size CLOSE 1 2 2 10 Output Files This option controls the names of the output files generated by LS DYNA either ARUP or LSTC can be selected With LS DYNA 970 onwards the names of the output files can also be specified using the KEYWORD_ID option where a filename prefix for all of the output files is specified within the input file If a filename prefix is specified in the input file then this option will be replaced with the prefix specified in the file Restart Dump File d3dump prefix d3dump 1 2 3 Parallel options
40. b labeled LS DYNA version will LS DYNA 960 71647 bring up this drop down menu listing the versions of LS DYNA present in the dyna_versions file Page 1 3 Shell User manual Version 9 4 November 2009 Alternatively the version of LS DYNA can be specified using the tabs to the v Single Precision right of this drop down menu _ Double Precision These tabs can be used to select the desired Precision and code type for the analysis Clicking on the tabs will cause the default LS DYNA version corresponding to the options specified to be selected The options available are described below Precision Code Type Single Precision 32 bit floating point SMP Shared memory parallel Double Precision 64 bit floating point MPP Distributed memory parallel 1 2 2 Job options 1 2 2 1 Input File Enter the name of the analysis file into the box provided Jobs may be specified in any directory by entering either the full pathname of the input file or the pathname relative to the current directory If the input file format is set to Keyword it will be assumed that the filename ends in key otherwise it will be assumed that the filename ends in inf To search for the file click on the icon to the left of the Jobname box This will bring up a standard file selector box shown below new_Ig09 key My Documents My Computer e lt e My Network P File name Files of type key Files key Cancel The
41. ble REM LSDYNA_MPP TRUE if MPP version selected REM LSDYNA_MPI_TYPE PI version REM LSDYNA_DOUBLE TRUE if double precision version selected REM LSDYNA_ONLINE TRUE if the job has been submitted ONLINE REM LSDYNA_BACKGROUND TRUE if the job has been submitted to BACKGROUND REM LSDYNA_BATCH TRUE if the job has been submitted using BATCH REM LSDYNA_QUEUE TRUE if the job has been submitted to a QUEUE REM LSDYNA_JOB_DIR full path of LS DYNA job_directory REM LSDYNA_JOB_FILE filename containing LS DYNA job options REM LSDYNA_JOB_CPUS numbert of CPU s selected REM LSDYNA_USER_ID username o gq o N N D User manual Version 9 4 November 2009 Shell LSDYNA_LOCAL_HOST TRUE if submitting MPP jobs to the local machine LSDYNA_NODE_FILE TRUE if submitting MPP jobs using a Node File NODE_FILE filename containing node list for MPP jobs R n M LSDYNA_LOCAL_HOST TRUE if submitting MPP jobs using a Node List M NODE_LIST string containing node list for MPP jobs M SMP LS DYNA submissio D V NNNHN w G A a a a a a e EM IF SLSDYNA_MPP TRUE GOTO MPP SLSDYNA_VERSIONS GOTO DONE aw MPP LS DYNA submission M Ge amp amp NAR lt Wee HP MPI using local machine JERR rd aw X set HPMPI_MPIRUN C Program Files Hewlett Packard HP MPI bin mpirun IF LSDYNA_MPI_TYPE HPMPI s
42. bmission method Submission Options _ Online Analysis Start Time 00 00 Start Day _ Delayed Queue CPU LIMIT O _ Batch Queue MEMORY LIMIT 999 00 V Queue Queue Name CPU Limit NONE Queue Options 2 CPU x 2 Nodes y Jobs may be submitted using 4 different submission methods If some of the options are not available on your system then the option will be greyed out in the submission menu and will be unselectable The parameters that can be specified under each option are different and those available under the Queue option will vary from system to system The four different submission options are Online Submit jobs interactively using an Xterm session Delayed start times cannot be specified Background Submit jobs in background If a delayed start times is specified then the job will be submitted using the Unix at command Batch Submit jobs into a batch queue using the Unix batch command Delayed start times cannot be specified Queue Submit jobs to NQE batch queues using qsub or equivalent commands Delayed start times Queue CPU Memory Limits may be specified 1 2 4 2 Analysis Start Time If a job is submitted using either the Background or Queue options it is possible to specify a time at which the job will execute The required time should be entered in the form HH MM using a 24 hour clock If no time is specified then the job will executed as soon as possible If the time specified has already been pas
43. d Variable names for any following Job Lines Any Variables defined before this Keyword are deleted 3rd Variable S VARIABLES_ADD Adds new Variables to the existing list of Variables VARIABLES ADD 1st Variable 2nd Variable 3rd Variable SREPORTER_SUMMARY Defines a set of inputs used to generate a summary report after a set of jobs have been run in LS DYNA ISREPORT_SUMMARY Input file Reporter Template 1st ariable 2nd Variable 3rd Variable All other lines are assumed to contain Job information in the following format Input file Reporter Template 1st Variable 2nd e g Define 4 variables for the following jobs VARIABLES ID X COOD Y COORD Z COORD Setup 4 jobs using the head_impact ort template with 4 variable values Chiesa impact r1 head key c templates head_impact ort RUN 1 0 03 0 050 0 06 C head_impact r2 head key c templates head_impact ort RUN 2 0 075 0 06 0 03 C head_impact r3 head key c templates head_impact ort RUN 3 0 03 0 100 0 06 Cahead_impact r4 head key c templates head_impact ort RUN 4 0 03 0 125 0 06 Define a new set of variables VARIABLES SUMMARY_ID S Add another variable VARIABLES ADD Set up a summary report REPORTER_SUMMARY c templates head_summary ort REPORTER_SUMMARY_DIR c head_impact summary Specify output file formats REPORTER_OUTPUT REPORTER HTML PDF Page 1 19 Shell User manual Version 9 4 November 2009 EXCEL This option
44. d using shell this64_version shell d3plot64_version shell primer64_version 2 3 29 shell lt gt _ default These options can be used to set the default versions of T HIS D3PLOT and PRIMER to either the 32 or 64 bit version 2 3 30 shell shell_ release By default the xshell_94 is set up to display 9 4 as the version This option allows the version number displayed to be changed if a customised installation is set up 2 3 31 shell max_cpus shell max_mpp_cpus These variable controls the maximum number of CPU s that can be selected for SMP and MPP parallel jobs Page 2 13 Shell User manual Version 9 4 November 2009 2 3 32 shell default_cpus shell default_mpp_cpus These variable controls the default number of CPU s for SMP and MPP parallel jobs 2 3 33 shell max_node_cpus This variable should be set to the number of CPUS each node has in a cluster When a MPP job is submitted to a PBS queue this variable will be used to calculate the required number of nodes that will be requested from the PBS queuing system 2 3 34 shell pack_nodes This variable is used along with shell max_node_cpus to calculate the number of nodes required when submitting a MPP job to a PBS queuing system If this is set to TRUE then the minimum number of nodes will be requested Note that if commands are specified in the oasys_queue file then the following defaults will be overidden Job max_node_cpus pack_nodes PBS node request PB
45. default search pattern will be set to key if the input file format is set to Keyword inf if it is set to Fixed and Ist if it is set to List 1 2 2 2 Input file format Keyword E Keyword Fixed The input file format may be altered between Keyword and Fixed and List If the List option is chosen a file containing a list of LS DYNA models can be selected for submitting to LS DYNA The List file can contain either just a list of LS DYNA models or it can List also contain additional information for running REPORTER automatically after the analysis terminates see section 1 6 3 for details on the List file format All ofthe jobs can be submitted either sequentially or simultaneously Page 1 4 User manual Version 9 4 November 2009 Shell 1 2 2 3 Select Files x To Run i A xX LS DYNA Input File If the input file format is set to List then a subset of the models listed in the file can be selected to be run when the List file is submitted C temp MULTI_TEMP RUN1 C1 example_head_key C temp MULTI_TEMP RUNT C2 example_head key C temp MULTI_TEMP RUNT C3 example_head key C temp MULTI_TEMP RUN1 C4 example_head_key C temp MULTI_TEMP RUN1 C5 example_head_key C temp MULTI_TEMP RUN1 C6 example_head_key vV V V Ey vV 1 2 2 4 Sequential Job Submission M Sequential Submission If a list of LS DYNA jobs is submitted using the List option then they can either be submitted sequentially one afte
46. dow is divided into EM Preferences for all programs ae aa File Edit Dismiss Help All programs ID3PLOT FIPRIMER REPORTER FA SHELL THIS Preferences 4 2 1 1 Menu Bar File Edit Dismiss Help File options File Save preferences Save current preference settings This will save the personal oa_pref file in the user s home directory Only those preferences Save preferences which differ from the preferences saved in the general oa_pref file will be E saved Exit Exit Exit the preferences editor without saving Edit options Edit Check Preferences Checks the current preferences for any errors These errors will be listed in a seperate window detailing the preferences withthe Check preferences errors and the nature of those errors Expand all branches Expands the categories in the Left hand frame Expand all branches Collapse all branches Collapses the categories in the Left hand frame Collapse all branches Reset all Resets all values Reset all to OA_INSTALL values Resets all values to the defaults stored Reset all in the main OA_INSTALL preference file Reset all to OASYS v alues Page 4 2 User manual Version 9 4 November 2009 Shell 4 2 1 2 The preferences editor Left hand frame The left hand frame will contain the names of all preferences available to R P set Preferences will be listed under the headings PRIMER D3PLOT _ File Edit T HIS REPORTER and SHELL according to
47. e Release 9 4 Release 9 5 Top level directory OA_ADMIN_94 Top level directory OA_ADMIN_95 oa_pref file in OA_ADMIN_94 contains oa_pref file in OA_ADMIN_95 contains oasys install_dir lt pathname for 9 4 oasys install_dir lt pathname for 9 5 installation gt installation gt oasys manuals_dir lt pathname for 9 4 oasys manuals_dir lt pathname for 9 5 manuals gt manuals gt oasys home_dir lt pathname for home directory gt would almost certainly be unchanged between major oasys temp dir lt pathname for temporary files gt versions although they could be different if desired Pathnames in the oa_pref file may contain environment variables which will be resolved before being applied 3 2 The hierarchy of oa_pref file reading It will be clear from the above that in a large installation the oa_pref files have a significant role Each piece of software reads them in the following order User s personal home file The rules for reading these files are e Ifa given directory does not exist or no file is found in that directory then no action is taken This is not an error e Amore recently read definition supersedes one read earlier therefore local definitions can supersede global ones unless it was locked e If two of more of the directories in the table above are the same then that file is only read once from the first instance 3 3 Locking Preference Options From version 9 4 onwards preference opti
48. e Edit File Type panel click Edit File Type 2 x on Change Icon Change Icon Actions pen New Edit Remove Set Default V Confirm open after download Always show extension Browse in same window cous Page 3 2 User manual Version 9 4 November 2009 Shell 1 Use BROWSE in the Change Change Icon Icon panel to find file d3plot94 exe 1 Then in the Edit File Type panel click on Edit to obtain the Editing action panel P oasys90 d3plot90 exe 1 The Action entry should be set to open greyed out You now need to edit the contents of the Application used box 1 Edit the existing string and add 1 at its end 2 Click on OK in the Editing action window to close and save it 3 Click on Close in the edit File Type window to close and save it 4 Click on Close in the Folder Options window to close and save it You should now find that 1 All ptf files on your system show the D3PLOT icon 2 Double clicking on any such file starts D3PLOT with the appropriate graphics driver and opens that file It is not possible to set up the filename d3plot for double clicking in this way since Windows requires filename extensions when assigning applications to files Page 3 3 Shell User manual Version 9 4 November 2009 3 1 1 2 If ptf files do currently have an application associated with them 1 In any folder window click on View Windows n
49. e same as the graphical version The menu is set out with the options on the left and the current selection on the right The options are accessed by typing the number at the prompt and pressing return This will bring up a menu with further options to make your selection To return to the main menu type in 1 and press return To quit from the program type in 1 and press return in the main menu Page 1 21 Shell User manual Version 9 4 November 2009 1 14 2 Code Version At the main menu type in 1 and press return A menu will be displayed with options for the code type Select the code type 1 SMP 2 MPP 1 Main menu Select the required code type to bring up a menu with options for the precision Select the precision 1 Single 2 Double 1 Main Menu Depending on the options chosen a menu will be displayed with the available LS Dyna code versions will differ depending on contents of dyna_versions file Select the code version 1 LS970 v6763 SP SMP RHE 3 0 2 LS970 v5434a SP SMP RHE 3 0 3 LS971 R2 v7600_1224 SP SMP RHE 4 0 4 LS971 R3_1 SP SMP 1 Main Menu Select the required code version The main menu will be displayed with the selected code version shown on the right hand side 1 14 3 Input File At the main menu type in and press return A menu will be displayed asking for the file name for the job Current directory u mid test Enter the file name for the job k
50. eir default values 1 2 9 Status Kill This option can be used to either terminate an LS DYNA analysis that is already running or to force the analysis to perform a range of tasks Clicking on this button will bring up the menu shown below displaying the possible options SA1 Write a Restart File and Terminate V SW2 Report Time and Cycle Number _ SWS Write a Restart File and Continue SVV4 Write a Plot State and Continue _ FILE Send output from SVV2 to a file CANCEL 1 2 10 Cancel Click on this button to close the submission menu and return to the main shell window without submitting an LS DYNA job 1 3 PRIMER PRIMER Select this option to access the PRIMER program This program is a graphical model editor that will position occupant models fold airbags and allow model parameters to be modified 1 3 1 Primer Options PRIMER F Options Right clicking on the Primer tab will cause an OPTIONS tab to appear Selecting this option tab will cause the following window to appear Page 1 11 Shell User manual Version 9 4 November 2009 This menu allows the user to specify an input keyword file and a primer command file which will automatically run when primer opens It also allows the user to pre select other options such as graphics options Select deselect the Input File options by clicking on the respective tag Click on the file PRIMER Command File divider icon in order to search for
51. es to be opened Each urve file should be specifed on a seperate line in the file by giving the full pathname of LOC C AST TCF Input file pecify the name of a fast tcf inp file for post processing desired data output HIS Command File pecify the name of a T HIS command file which collects and processes the desired data tart in pecify the directory where T HIS will be fired up and where output files will be written o Other Options Automatically EXIT auses T HIS to close once the specified command file has finished Run T HIS in batch mode Opens up T HIS in batch mode a non graphical mode which accepts commands from a file specified in the Input options se Graphical Displa in graphical mode OpenGL or MESA graphics can be selected se Text TTY Display Opens up T HIS in text only mode which allows the user to specify commands in the u Ndo erm na A A se Full Screen Opens the T HIS window to fill the whole screen et is variable is often used when replaying command files which when recorded paused MENU_AUTO_CONFIRM fand asked the user to confirm things For example HELP and Warning messages If this option is selected T HIS will continue automatically using the default option 1 6 Reporter REPORTER F Left click on this option to access REPORTER This program is an automatic report generator for use with LS DYNA D3PLOT and T HIS 1 6 1 Reporter Options REPORTER Options Right clicking on the REPORTER tab wi
52. et MPI_WORKDIR LSDYNA_JOB_DIR IF LSDYNA_LOCAL_HOST TRUE HPMPI_MPIRUN prot pass np SLSDYNA_JOB_CPUS LSDYNA VERSION GOTO DONE IF LSDYNA_NODE_FILE TRUE SHPMPI_MPIRUN prot pass np LSDYNA_JOB_CPUS hostfile NODE_FILE e LSTC_LICENSE_SERVER LSTC_LICENSE_SERVER lt line break gt e LSTC_LICENSE LSTC_LICENSE LSLSDYNA_VERSION GOTO DONE IF LSDYNA_NODE_LIST TRUE SHPMPI_MPIRUN prot pass np LSDYNA_JOB_CPUS hostlist NODE_LIST e LSTC_LICENSE_SERVER LSTC_LICENSE_SERVER lt line break gt e LSTC_LICENSE LSTC_LICENSE LSLSDYNA_VERSION GOTO DONE REM REM MPICH REM set MPICH_MPIRUN C Program Files MPICH mpd bin mpirun IF LSDYNA_MPI_TYPE MPICH IF LSDYNA_LOCAL_HOST TRUE SMPICH_MPIRUN np LSDYNA_JOB_CPUS localonly LSDYNA VERSION GOTO DONE IF LSDYNA_NODE_FILE TRUE SMPICH_MPIRUN np LSDYNA_JOB_CPUS logon machinefile NODE_FILE env LSTC_LICENSE_SERVER LSTC_LICENSE_SERVER lt line break gt LSTC_LICENSE LSTC_LICENSE LSDYNA_VERSION GOTO DONE IF LSDYNA_NODE_LIST TRUE SMPICH_MPIRUN logon hosts NODE_LIST env LSTC_LICENSE_SERVER LSTC_LICENSE_SERVER lt line break gt LSTC_LICENSE LSTC_LICENSE LSDYNA_VERSION GOTO DONE REM REM DONE Page 2 23 Shell User manual Version 9 4 November 2009 2 5 4 Post Processing options When a LS DYNA job is submitted using the She
53. f 0 means that the job will be submitted with a the default amount of CORE memory built into that LS DYNA The default value of 9000000 should be enough for models of up to 60000 elements 2 3 19 shell job_memory_units This variable controls whether the default Analysis Memory limit is specified in words or megawords It should be set to either WORDS or MWORDS respectively 2 3 20 shell job_cpu This variable controls the value used for the default Analysis CPU limit The required value should be specified using the units defined by the shell job_cpu_units variable see Job Cpu Units A value of 0 means that the job will be submitted with no Analysis CPU limit 2 3 21 shell job_cpu_units This variable controls whether the default Analysis CPU limit is specified in seconds minutes or hours It should be set to either SECONDS MINUTES or HOURS respectively 2 3 22 shell allow_mem_change This variable controls whether users can change the amount of CORE memory used by LS DYNA If this variable is set to FALSE then users will not be able to modify the Analysis Memory Limit and will be forced to use the default value built into LS DYNA Page 2 12 User manual Version 9 4 November 2009 Shell 2 3 23 shell file_size This variable controls the default binary file size produced by LS DYNA The value specified gives the required file size in Mbytes 2 3 24 shell write_ ctf By default the xshell_94 is set up so that the default
54. g messages If this option is selected D3PLOT will continue automatically using the default option Page 1 13 Shell User manual Version 9 4 November 2009 1 5 T HIS Left click on this option to access T HIS This program is a time history processing and graph plotting package designed to access the binary output files created by LS DYNA For more details see the T HIS Manual 1 5 1 T HIS Options Right clicking on the T HIS tab will cause an OPTIONS tab to appear Selecting this option tab will cause the following window to appear This menu allows the user to PPS E specify a fasttcf inp file or a T HIS Options T HIS command file that will be automatically run when T HIS is opened along with other T HIS options Select deselect the options by clicking on the respective tag Click on the file divider icon in order to search for the respective files lt a De Na ee m a jal ja Page 1 14 User manual Version 9 4 November 2009 Shell Input Options nput File pecify the name of the thf file for the analysis whose data you wish to process Model List File pecify the name of a file containing a list of models to be opened Each model should be specifed on a seperate line in the file by giving the full pathname to one of the output files mare u an read urve File pecify the name of the T HIS curve file to read urve List File pecify the name of a file containing a list of all the T HIS curve fil
55. he required time may be selected Page 1 9 Shell User manual Version 9 4 November 2009 Restart Files Dump Analysis Created Time Number Time By Written Written _ d3dump01 1 128774e 004 Original Run 19 35 53 06 10 2004 V d3dump02 1 231389e 004 Original Run 19 35 56 06 0 2004 d3dump03 1 354528e 004 Original Run 19 35 59 06 10 2004 d3dump04 1 47 7667e 004 Original Run 19 36 03 06 1 0 2004 Select the desired restart file and press the OK button to return to the main submission window where the screen will be updated to reflect the details of the restart file selected A check will also be carried out to see if a restart input deck exists and if one is found the user will be offered the opportunity to use it If after a restart file has been selected the user decides that he does not want to use it the restart file selection menu should be re displayed and the previously selected file should be deselected 1 2 6 Post Processing Options 1 2 6 1 Run T HIS after Analysis Setting this option to ON will cause a fasttcf inp script present in the job directory the directory containing the analysis file to be executed following termination of the job Fast tcf provides a fast automated method of post processing output data from LS DYNA by producing a set of command files for T HIS from an ASCII input file This option will only be available if there is a jobname inp file Selecting OFF will disable this automatic post processing
56. he selected option on the right hand side 1 14 8 Filename Format At the main menu type in 7 and press return A menu will be displayed asking for the filename format Select the filename format 1 ARUP ptf 2 LSTC d3plot 1 Main menu Select the required option The main menu will be displayed with the selected option on the right hand side Page 1 23 Shell User manual Version 9 4 November 2009 1 14 9 Optional Files Options Current selection SSS een Input Files 1 Stress Initialization sif off 2 Interface Segment isf2 Off 3 VDA Geometry vda off 4 CAL3D Input c3d off 5 TOPAZ3D Temperature File htf Off 6 MADYMO Input File off 7 REMAP Option off a E Output Files 8 Contact Force File ctf off 9 Interface Segment isfl off 10 Static Database File ztf On 11 Winfrith Crack File crf Off 12 FSIFOR File off Soe Szenen sans Input Options 13 ENDTIM 0 000000 14 ENDCYC 0 15 PARA 0 Binary File Size 16 Binary File Size 40 1 Main menu Options 1 12 can be toggled on and off simply by selecting them The analysis end time can be specified by selecting option 13 The following menu will be displayed Enter the end time 1 Optional files menu Enter the required end time can be an integer decimal or in the form 1 5E4 The optional files menu w
57. ill be shown with the selected end time on the right hand side The analysis end cycle can be specified by selecting option 14 The following menu will be displayed Enter the end cycle 1 Optional files menu Enter the required end cycle an integer The optional files menu will be shown with the selected end cycle on the right hand side The analysis para value can be specified by selecting option 15 The following menu will be displayed Para value 1 Zero 2 One 1 Optional files menu Select the required option The optional files menu will be shown with the selected para value on the right hand side To go back to the main menu type in 1 and press return Page 1 24 User manual Version 9 4 November 2009 Shell 1 14 10 CPUs At the main menu type in 9 and press return A menu will be displayed asking for the number of CPUs Enter the number of cpus 1 Main menu Enter the required number of CPUs an integer If the number of CPUs is too high for the code type limit is defined in oa_pref then you will be asked to enter again Once a valid number has been entered a menu will be displayed asking if the consistency flag should be on or off Turn the consistency flag on or off 1 Off 2 On 1 Main menu Select the required option The main menu will be shown with the selected number of CPUs and the consistency flag status on the right hand side 1 14 11 Node Options This option will only be avail
58. ion is not available if this panel was accessed from the LS DYNA Submit menu as REPORTER will be started automatically after each LS DYNA job has finished 1 6 1 5 Clear Panel This option can be used to quickly clear any options that have been set This option is not available if this panel was accessed from the LS DYNA Submit menu 1 6 1 6 Save List As This option can be used to save the currently defined set of REPORTER options to a new LIST file By default this option will overwrite the Input List Page 1 17 Shell User manual Version 9 4 November 2009 1 6 2 Variables This windows allows the user to define variables for Reporter Specify the variable name and its corresponding value in the relevant boxes and press ADD to add them to the list of defined variables The variables to be fed into Reporter will appear in the greyed out boxes above In order to delete one of the Variables in the list enter the variable s name in the variable box and press DELETE In order to modify one of the variables enter the variable s name into the Variable box and press Modify Once you have finished modifying all your variables press CLOSE Page 1 18 User manual Version 9 4 November 2009 Shell 1 6 3 LIST File Format The LIST file can be used to set up multiple inputs for REPORTER The LIST file format consists of lines containing either Job information or Keywords eyword S VARIABLES Defines a new list of comma seperate
59. l software users on the system An individual s specific preferences file can be stored in the individual s home area This can be used to personally customise the software to the individual s needs Whenever one of the programs whose preferences can be stored in the oa_pref file is fired up the program will take preferences first from the general preference file in the OA_ADMIN_xx directory if it exists then the OA_INSTALL directory then from the file in the user s home area then from the current working directory Preferences defined in the general oa_pref file can be modified in the user s personal file but they can t be removed by it From version 9 4 onwards preferences can be locked If a preference is locked it cannot be changed in an oa_pref file in a more junior directory To lock a preference use the syntax shell rather than shell An example of the file is shown below to illustrate the content of the file Preferences file for software Preferences for SHELL Page 4 1 Shell User manual Version 9 4 November 2009 shell queue_cpu 0 Preferences for THIS this laser_paper_size A4 Preferences for D3PLOT d3plot overlay colour grey Preferences for PRIMER primer overlay mode off 4 2 The preferences editor The editor can be accessed from within the Shell or from within D3PLOT T HIS PRIMER and REPORTER 4 2 1 The preferences editor layout The preferences editor win
60. late Defines a REPORTER template file for the job SI y default the output directory for any files generated by REPORTER will be set to the directory ontaining the input file Root Output y default the root of the input filename we will used as the default filename for any output files Filename generated by REPORTER i e rootname pdf rootname html is option can be used to setup variables for use within REPORTER see section 1 6 2 In addition to setting up options for individual LS DYNA jobs this panel can also be used to generate a summary report The options for the summary report are the same as for individual LS DYNA jobs except that the Input file is optional If this panel was accessed from the REPORTER Options 1 6 1 3 Output Formats HTML Write an HTML file after REPORTER has finished generating a report Write a PDF file after REPORTER has finished generating a report Write a Postscript file after REPORTER has finished generating a report Causes Reporter to write a PDF file once it has finished generating a report Causes Reporter to write a Powerpoint file once it has finished generating a report 1 6 1 4 Run Reporter This option starts REPORTER once for each LS DYNA job that has been defined and passes any input options that have been defined for that job to REPORTER If a set of summary report options have been defined then an additional instance of REPORTER will be started to generate the summary report This opt
61. ll automatic post processing options for Reporter and T HIS can be selected This section of the batch file contains any commands required to carry out the selected post processing options PRIMER ztf file creation data dyna94 linux_executables primer94 exe d batch ztf local test shell_test key gt shell_test ztf_log T HIS batch processing setenv MENU_AUTO_CONFIRM true data dyna94 linux_executables this90c ex d x tcf shell_test tcf maximise shell_test thf 2 6 Creating an oasys_queue file This file lists alternative batch queues and queue directives It only needs to be created for systems on which jobs can be submitted to a NOS style queue The file is in xml format with tags to define data blocks It contains three distinct blocks defining queue directives which are written for specific queues specific queue and cpu combinations and all queues There can be no blank lines in data blocks The first block defines the queue names their cpu limit and any queue directives specific to the queue This block is required lt queue_names gt lt namel gt cpu_limit 300 command PBS m abe lt namel gt lt name2 gt cpu_limit pipe lt name2 gt lt name3 gt cpu_limit none lt name3 gt lt queue_names gt Where lt queue_names gt and are tags to indicate the start and end of the block of data lt queue_names gt lt namel gt and lt namel gt are the
62. ll cause an OPTIONS tab appear Selecting this option tab will cause the following window to appear Page 1 15 Shell User manual Version 9 4 November 2009 E REPORTER Options ii 0000000000 ht ial ra tal ral m m m C m m O El m Q m lt O pore ll x I a E submit testitestist fy This menu allows the user to define multiple sets of input options for REPORTER These options can either be entered manually of they can be read from a file see section 1 6 3 for details on the LIST file format In addition to being accessed from the REPORTER Options menu this panel can also be selected from the LS DYNA Submit menu 1 6 1 1 Input List This option can be used to select a predefined LIST file containing multiple sets of inputs for REPORTER This option can not be modified if this panel was accessed from the LS DYNA Submit menu Note An attempt is made to determine a sensible name for the summary output directory based on the inputs in this file If a summary input file is given then the pathname to this is used If not then if all the individual input files have the same pathname then this is used Page 1 16 User manual Version 9 4 November 2009 Shell 1 6 1 2 Input Options Each LS DYNA job can have the following options set Input Fie ame of the LS DYNA input file for post processing This option can not be modified if this panel ed from the DYN men Wasa A DM Temp
63. llation On UNIX LINUX systems the Shell is accessed via the oasys_94 command If you have installed the software using the install script then the oasys_94 command file in the executables directory will automatically be updated to contain the correct path for the directory the software was installed in and the name of the license server for the software installation In addition to specifying the installation directory and the license server the oasys_94 command file can also be set a number of other options on UNIX LINUX systems After installing the software the oasys_94 command file should contain the following This assumes the software was loaded in a directory called prg and that the license server in a machine called atghps50 bin csh f onintr start flush Set OA_INSTALL to point to the directory containing the software setenv OA_INSTALL prg oasys94 executables Set OA_ADMIN directory setenv OA_ADMIN Set OASYS_LICENSE_FILE to either the Oasys flexlm license file or the license server e g setenv OASYS_LICENSE_FILE OA_INSTALL oasys_flexlm dat or setenv OASYS_LICENSE_ FILE hostname setenv OASYS_LICENSE_FILE atghps50 Set LSTC_FILE to either the lstc license file or the server e g setenv LSTC_FILE SOA_INSTALL LSTC_FILE e g setenv LSTC_LICENSE_SERVER hostname setenv LSTC_NOCLIENT ON setenv LSTC_LICENSE network setenv LSTC_FILE OA_INSTALL LSTC_FILE Other environment variables HHH HHHHHHHHH HHH HH H
64. m 3 1 3 To make key files open in PRIMER by double clicking on them The procedure is exactly the same as for PRIMER and must be carried out for each of the file types that you wish to process by double clicking key LS DYNA Keyword Input File The only differences are 1 File name description in the Open With window should be appropriate 2 The application to use should be primer94 exe 3 The icon to use should be primer94 exe Page 3 4 User manual Version 9 4 November 2009 Shell A Preferences The Preferences editor provides a graphical interface for viewing checking and editing your user preferences stored in your oa_pref file 4 1 The oa_pref file This file contains code specific preferences that can be used to modify the behaviour of the software suite It is optional and where entries or the whole file are omitted programs will revert to their default settings 4 1 1 oa_pref naming convention and locations The file is called oa_pref It is looked for in the following places in the order given e The optional administration directory defined by the environmental variable OA_ADMIN or SOA_ADMIN_xx where xx is the release number e The site wide installation directory defined by the environment variable OA_INSTALL e The user s home directory HOME Unix Linux or 3USERPROFILE Windows e The current working directory See Installation organisation for an explanation of the directory structure
65. m amount of system time in seconds that a job submitted to a NQS style queue will require if the queue has been set up using a Queue CPU Limit see Request Cpu Limit Request Memory Limit When a job is submitted to such a queue a system CPU time will be calculated as either 2 5 of the Analysis CPU time or the value of this variable If the difference between the Queue CPU limit and the Analysis CPU limit is smaller than this value the Queue CPU limit will automatically be increased to allow enough system time for the job to terminate normally when the Analysis CPU limit has been reached Page 2 11 Shell User manual Version 9 4 November 2009 2 3 16 shell job_format This variable controls the default file format that will be expected by LS DYNA It can be set to either KEYWORD or FIXED 2 3 17 shell file_names This variable controls the names of the output files generated by LS DYNA This variable can be set to either ARUP or LSTC With LS DYNA 970 onwards the names of the output files can also be specified using the KEYWORD_ID option where a filename prefix for all of the output files is specified within the input file 2 3 18 shell job_memory This variable controls the value used for the default Analysis Memory limit the amount of CORE memory that LS DYNA will use to store data The required value should be specified using the units defined by the shell job_memory_units variable see Job Memory Units A value o
66. n 9 4 November 2009 Shell 1 14 5 CPU Limit At the main menu type in 4 and press return A menu will be displayed asking for the job CPU limit units Select the job cpu limit units 1 Seconds 2 Minutes 3 Hours 1 Main menu Select the required units to bring up a menu asking for the job CPU limit Enter the job cpu limit 1 Main menu Enter the required limit can be an integer decimal or in the form 1 5E4 The main menu will be displayed with the selected job CPU limit on the right hand side 1 14 6 Memory Limit At the main menu type in 5 and press return A menu will be displayed asking for the job memory limit units Select the job mem limit units 1 Words 2 M Words 1 Main menu Select the required units to bring up a menu asking for the job memory limit Enter the job memory limit 1 Main menu Enter the required limit can be an integer decimal or in the form 1 5E4 If the Dyna version selected is MPP a second menu will ask for the other memory limit Enter the job memory2 limit 1 Main menu The main menu will be displayed with the selected job memory limit on the right hand side 1 14 7 Increase Memory If Required At the main menu type in 6 and press return A menu will be displayed asking if the job memory limit should be increase if required Increase the memory if required 1 Off 2 On 1 Main menu Select the required option The main menu will be displayed with t
67. names of the queues and tags to indicate the start and end of the data for that queue up to 20 can be defined cpu_limit is the cpu limit for the queue in seconds or pipe or none command is an optional queue directive specific for the queue up to 20 for each queue can be defined Page 2 24 User manual Version 9 4 November 2009 Shell The second block defines what queue options will be available to the user see Section 1 2 4 7 depending on the queue and number of cpus chosen It is intended to be used to define queue directives which define the number of nodes and cpus to use This block is optional lt queue_commands gt lt namel gt lt I gt display_string 1 CPU x 1 Node command PBS 1 nodes 1 ppn 1 namel lt 1 gt lt 2 gt display_string 2 CPU x 1 Node command PBS 1 nodes 1 ppn 2 namel lt 2 gt lt 2 gt display_string 1 CPU x 2 Node command PBS 1 nodes 2 ppn 1 namel lt 2 gt lt namel gt lt name2 gt lt 4 gt mpp_only display_string 2 CPU x 2 Node command PBS 1 nodes 2 ppn 2 name2 lt 4 gt lt name2 gt lt name3 gt lt l gt display_string 1 CPU x 1 Node command PBS 1 nodes 1 ppn 1 name3 lt 1 gt lt name3 gt lt queue_commands gt Where lt queue_commands gt and are tags to indicate the start and end of the block of data lt queue_commands gt lt name1 gt and lt namel gt are the names of the queues and tags to indicate the start and end of the d
68. ning message will be generated when the job is actually submitted to the Queue A value of 0 means that the analysis will be submitted with an unlimited Queue CPU Limit 1 2 4 5 Queue Memory Limit This option will only be accessible when jobs are being submitted using the Queue option If your system does not require Memory Limits to be specified for NQS style queues then your system manager will have disabled this option The Queue Memory Limit can be entered directly into the space provided The units used to define the Memory Limit can be switched between Words and Megawords using the toggle available The value entered defines the total amount of memory that the job will request from the system In order to allow LS DYNA to initialise this value should be set to a minimum of 5000000 words larger than the Analysis Memory Limit see section 2 3 1 If a smaller value is specified a warning message will be generated when the job is actually submitted to the Queue A value of 0 means that the analysis will we submitted with an unlimited Limit 1 2 4 6 Queue Name This option will only be accessible when jobs are being submitted using the Queue option If the system has more than one NQS style queue then the required queue may be selected from a pull down menu activated by the right hand mouse button When a queue is selected the CPU limit for that queue will be displayed alongside the queue name If the queue is a pipe queue the word PIPE will
69. oftware installation directory As the file is included after the Environment Variable section of the batch file all of the variables that are set up can be used within the include file This means that a single include file oasys submit can be configured if required which contains separate sections for SMP MPP jobs 2 5 3 1 Example of a UNIX LINUX oasys submit file The following example shows the default oasys submit file that is included with the version 9 4 software on UNIX and LINUX platforms The default script is setup to submit jobs on a LINUX machine using the PBS queueing system but it should be easy to reconfigure to other machines and queueing systems As MPP jobs can use a number of different MPI libraries on LINUX systems this script shows how to submit jobs using HP MPI LAM 6 5 9 LAM 7 0 3 and MPICH The default script is setup assuming that the different MPI libaries have been installed in the following directories MPI Directory HP MPI LAM 6 5 9 LAM 7 0 3 MPICH 1 2 6 opt hpmpi usr local llam_6 5 9 usr local llam_7 0 3 usr local mpich_1 2 6 Page 2 19 Shell User manual Version 9 4 November 2009 The following Environment Vari
70. ons can be locked If a preference option is locked in a file then that preference option will be ignored in any of the subsequent preference files that are read By locking a preference option in a file that users do not have write access to a network administrator can control what options a user can modify 3 4 Large Network Installation A typical layout of a large networked installation might be Page A 3 Shell User manual Version 9 4 November 2009 OA_ADMIN_XX Top level oa_pref file Configuration files Manuals amp scripts OA_INSTALL Local copy of executables OA_INSTALL Local copy of executables OA_INSTALL Local copy of executables Machine 1 Machine 2 Machine 3 t User 1 b b User 2 I I J Home directory OA_HOME i Home directory OA_HOME Personal oa_pref files Personal oa_pref files Personal scripts Personal scripts I l l I 4 ee m oo mom In this example preferences manuals and scripts that are placed in OA_ADMIN will be available to all users Changes to the preferences scripts etc need to be made only once in OA_ADMIN and do not need to be copied onto each local installation Page A 4
71. option is chosen you will be asked to select again If Background or Queue are chosen a further menu will be displayed asking for the submission day Select the submission day 1 Now 2 Monday 3 Tuesday 4 Wednesday 5 Thursday 6 Friday 7 Saturday 8 Sunday 1 Main menu Select the required option to bring up a menu for the start time hour Enter the start time hour 0 23 1 Main menu Enter the required hour to bring up a menu for the start time minute Enter the start time minute 0 59 1 Main menu Enter the required minute The main menu will be displayed with the selected submission type and start time if applicable on the right hand side Note If you do not want a delay choose a submission time of Now 00 00 1 14 13 Queue CPU Limit If the submission type is Queue then an option to set the queue cpu limit will be available At the main menu type in 12 and press return A menu will be displayed asking for the queue CPU limit units Select the queue cpu limit units 1 Seconds 2 Minutes 3 Hours 1 Main menu Select the required units to bring up a menu asking for the queue CPU limit Enter the job cpu limit 1 Main menu Enter the required limit can be an integer decimal or in the form 1 5E4 The main menu will be displayed with the selected queue CPU limit on the right hand side Page 1 26 User manual Version 9 4 November 2009 Shell 1 14 14 Queue Memory Limit If the submis
72. or this variable are true and false If the variable is set true then these will not pause and will behave as if the user had pressed OK meaning that command files can play back without user intervention Page 2 3 Shell User manual Version 9 4 November 2009 2 1 6 setenv FILE_EXIST_ACTION lt option gt This variable controls the action to be taken when opening a file for output and the file already exists Possible options for this variable are none overwrite and append Normally you will be prompted for the action to be taken when a file selected for output already exists However if this variable is set to overwrite or append then the relevant action will be taken automatically This is generally used when playing automatic post processing batch scripts 2 1 7 setenv ECHO_PREFERENCE lt option gt If this variable is set to 1 then any command line arguments used to start T HIS PRIMER or D3PLOT will be echoed to the screen along with any settings read from preference files 2 2 Windows NT 2000 XP Installation When the software is installed a set of icons will fe Oasys Ltd LS DYNA Environment 9 4 gt MrtlMet ann automatically be added to ziert eher c PRIMER Start gt Programs gt Oasys Ltd LS DYNA Environment 9 4 in D3PLOT 9 T HIS Gt REPORTER LMTooLs mM Manuals After loading the software the following system variables should be set up OASYS_LICENSE_FILE LM_LICENSE_FILE OA_ADMIN OA
73. ough the Shell is controlled through an ASCI file called dyna_versions Note the format of this file was changed in version 9 3 and an additional column has been inserted before the label field for MPP codes which identifies which MPI library the version has been compiled with The format for SMP versions of LS DYNA is lt Code Type gt lt precision gt lt executable gt lt label gt The format for MPP versions of LS DYNA is lt Code Type gt lt precision gt lt executable gt lt MPP Type gt lt label gt Where lt Code Is either SMP shared memory parallel SERIAL single threaded non parallel or MPP distributed Type gt memory parallel lt precision gt Is either Single 32 bit floating point or Double 64 bit floating point lt executable gt Is the full path of the executable If the full path name of the executables includes any spaces then the path must be enclosed in s lt MPP Type gt This is a string that can be used to identify the MPP library a MPP version of LS DYNA has been compiled with This column is not defined for SMP or SERIAL codes lt label gt Is the label shown in the list of LS DYNA versions displayed in the submission Shell 2 4 1 UNIX LINUX Code precision executable MPP label Type Type SMP Single dyna 1s971_s_R3_1_xeon64 redhat40 exe LS971 R3 1 SP SMP SMP Double dyna 1s971_d_R3_1_xeon64_ redhat40 exe LS971 R3 1 DP SMP MPP Single dyna mpp971_s_R3 1_Intel_linux86 64_h
74. ows only 2 4 Adding LS DYNA versions to the Shell 2 4 1 UNIX LINUX 2 4 2 WINDOWS 2 5 Customising the LS DYNA submission script 2 5 1 Queuing Commands 2 5 2 Environment Variables 2 5 3 LS DYNA submission 2 5 4 Post Processing options 2 6 Creating an oasys_queue file 2 7 Adding items to the Utilities menu 3 Additional Windows NT 2000 XP Setup 3 1 Setting File Associations 3 1 1 To make ptf files open in D3PLOT by double clicking on them 3 1 2 To make thf xtf cur and bdf files open in T HIS by double clicking on them 3 1 3 To make key files open in PRIMER by double clicking on them 4 Preferences 4 1 The oa_pref file 4 1 1 oa_pref naming convention and locations 4 2 The preferences editor 4 2 1 The preferences editor layout Installation organisation Page ii 1 Introduction 2 Problems with the existing installation structure 3 Improved Installation structure from release 9 4 onwards 3 1 Dynamic configuration using the top level oa_pref file 3 2 The hierarchy of oa_pref file reading 3 3 Locking Preference Options 3 4 Large Network Installation 2 7 2 9 2 10 2 10 2 10 2 10 2 10 2 11 2 11 2 11 2 11 2 11 2 11 2 11 2 11 2 11 2 12 2 12 2 12 2 12 2 12 2 12 2 12 2 13 2 13 2 13 2 13 2 13 2 13 2 13 2 13 2 13 2 14 2 14 2 14 2 14 2 14 2 14 2 14 2 15 2 15 2 16 2 16 2 17 2 18 2 19 2 24 2 24 N wio i PPP rrr rrRRARRRYWWY WWWNNRR RENN Re PRR User manual
75. pmpi exe HP MPI LS971 R3 1 SP MPP HP MPI MPP Double dyna mpp971_d_R3 1_Intel_linux86 64_hpmpi exe HP MPI LS971 R3 1 DP MPP HP MPI MPP Single dyna mpp971_s_R3 1_Intel_linux86 64_lam659 exe LAM659 LS971 R3 1 SP MPP LAM 6 5 9 MPP Double dyna mpp971_s_R3 1_Intel_linux86 64_lam659 exe LAM659 LS971 R3 1 DP MPP LAM 6 5 9 Would display a menu containing 6 versions of LS DYNA Page 2 15 Shell User manual Version 9 4 November 2009 2 4 2 WINDOWS Code precision executable MPP label Type Type SMP Single C LS DYNA 1s971_s_R3_1_win32_p exe Win32 SP LS971vR3 1 SMP Double C LS DYNA 1s971_d_R3_1_win32_p exe Win32 DP LS971vR3 1 MPP Single C LS DYNA mpp971_s_R3 1_win32_mpich125 exe MPICH Win32 SP LS971vR3 1 MPICH MPP Double C LS DYNA mpp971_d_R3 1_win32_mpich125 exe MPICH Win32 DP LS971vR3 1 MPICH MPP Single C LS DYNA mpp971_s_R3 1_win64_hpmpi exe HPMPI Win64 SP LS971vR3 1 HPMPI MPP Double C LS DYNA mpp971_d_R3 1_win64_hpmpi exe HPMPI Win64 SP LS971vR3 1 HPMPI If MPP jobs are going to be run across multiple machines and the LS DYNA executables are located on a network disk then the full UNC path should be specified instaed of the local drive letter Code precision executable MPP label Type Type MPP Single SERVER LS DYNA mpp971_s_R3 1_win64_hpmpi exe HPMPI Win64 SP LS971vR3 1 HPMPI MPP Double SERVER LS DYNA mpp971_d_R3 1_win64_hpmpi exe HPMPI Win64 SP LS971vR
76. porary disk area is required 3 Improved Installation structure from release 9 4 onwards In order to try to improve the situation the installation configuration from release 9 4 onwards has been changed as follows Directory Content and purpose oa_pref file option OA_ADMIN_xx Optional Top level configuration files xx 94 for release 9 4 thus OA_ADMIN_94 Admin level oa_pref file Other configuration files Timeout configuration file OA_ADMIN Optional Same as OA_ADMIN_94 If OA_ADMIN_94 is not defined then this non release specific version is checked OA_INSTALL Optional All executables oasys install_ dir Installation level oa_pref file lt pathname gt OA_MANUALS Optional Specific directory for user manuals If not defined oasys manuals_dir then will search in lt pathname gt OA_ADMIN_xx manuals xx major version number OA_INSTALL manuals OA_HOME Optional Specific home directory for user If not defined oasys home_dir will use lt pathname gt HOME Unix Linux USERPROFILE Windows OA_TEMP Optional Specific temporary directory for user If not oasys temp_dir defined will use lt pathname gt P_tmpdir Unix Linux TEMP Windows It will be clear from the table above that none of Environment variables have to be set and that all defaults will revert to pre 9 4 behaviour In other words users wishing to keep the status quo will find behaviour and layout unchanged if they do nothing
77. r the other or they can all be submitted simultaneously 1 2 2 5 CPU limit The Analysis CPU Limit can be entered directly in the space provided The units used to define the CPU limit can be switched between Seconds Minutes and Hours by using the toggle available The value entered is the actual amount of CPU time that LS DYNA will use for the analysis When this limit is reached LS DYNA will terminate the job A value of 0 means that no limit has been set and the job will run to termination 1 2 2 6 MEMORY limit The Analysis Memory Limit can be entered directly in the space provided The units used to define the Memory Limit can be switched between Words and Megawords and Automatic using the available toggle The value entered is the size of the main array declared internally within LS DYNA that is used to store data in A value of 0 means that the analysis will use the default value built into LS DYNA If a value is specified on the KEYWORD card in a input deck then that value will override all other memory definitions 1 2 2 7 MEMORY MPP only This option is only available for the MPP version of LS DYNA With the MPP version of LS DYNA more memory is required for the first CPU that initialises the model than for the other processors Generally if the first CPU requires X words of memory to initialise the job then the amount of memory required for each additional processor is X n where n is the total number of CPU s 1 2 2 8 Autom
78. rt T HIS 1 14 Command Line Submission Shell When starting the shell on a UNIX system a command line version of the submission shell is available It will start automatically if an X connection cannot be established or manually by putting cmd as a command line option i e oasys_94 cmd The following screen will be displayed in the terminal Note that it may differ slightly depending on preference settings Options Current selection LS DYNA 1 Code Version LS970 v6763 Soe A ee eS ee gen Job Options 2 Input File Nothing Selected 3 Format Keyword 4 CPU Limit 0 00 Seconds 5 Memory Limit Memoryl 40 00 MWords 6 Increase Memory If Required On 7 Filename Format Arup ptf 8 Optional Files Herrmann nn Parallel Options 9 CPUs 2 CPUs Consistency Flag On a Sahne ie gl Te te Submission Options 11 Submission Type Queue Now 00 00 12 Queue CPU Limit 0 00 Seconds 13 Queue Memory Limit Memory 150 00 MWords 14 Queue Name dyna CPU Limit 0 15 Queue Options 2 CPU x 1 Node 99 Submit 88 Reset 77 Status Kill 1 Quit The terminal window may have to be expanded for the contents to fit 1 14 1 How To Use The Command Line Submission Shell All the options available on the graphical version of the shell are available except Restart T His and Reporter options The defaults are th
79. rt times is specified then the job will be submitted using the Unix at command shell batch Allows jobs to be submitted using the Unix batch command Delayed start times cannot be specified shell queue Allows jobs to be submitted to NQE style batch queues using qsub or equivalent commands Delayed start times CPU Memory limits and accounts may be specified If shell queue is set to FALSE then sections 2 3 3 to 2 3 10 can be ignored Page 2 9 Shell User manual Version 9 4 November 2009 2 3 2 shell default This variable controls the default option that will be used to submit LS DYNA jobs It should be set to either ONLINE BACKGROUND BATCH or QUEUE to select the required default 2 3 3 shell batch_type This variable controls the type of queue the QUEUE command see shell online shell background shell batch shell queue submits the job to At present this variable may be set to NQS LSF SGE SUN GRID ENGINE PBS PBSPRO7 and PBSPRO71 Due to the limitations of some of the queuing systems not all options are available with all queue types see table below Analysis Start Available Available Available Unavailable Time 2 3 4 shell queue_output_file This variable controls if the Shell writes a queue directive to specify a file for output when a job is submitted to a queueing system If this option is set to TRUE then the queue will add the following line to the top of the job submission script
80. sed then the job will start immediately This option will not be available if the Queue option is submitting the job to a SGE queuing system 1 2 4 3 Analysis Start Day If a job is submitted using either the Background or Queue options it is possible to specify a day on which the job will execute Use the toggle to specify the day on which the job will be executed If a day is specified and no analysis start time has been set the job will be submitted with a start time of 00 01 on the required day This option will not be available if the Queue option is submitting the job to a LSF or SGE queuing system Page 1 8 User manual Version 9 4 November 2009 Shell 1 2 4 4 Queue CPU Limit This option will only be accessible when jobs are being submitted using the Queue option If your system does not require CPU Limits to be specified for NQS style queues then your system manager will have disabled this option The Queue CPU Limit can be entered directly into the space provided The units used to define the CPU Limit can be switched between Seconds Minutes and Hours using the toggle available The value entered is the total Queue CPU Limit that include the time taken to run the LS DYNA analysis and any system time required The value entered should be larger than the Analysis CPU Limit so that when the analysis finishes there is enough time to write LS DYNA restart and result files If the extra time specified is unlikely to be sufficient a war
81. settings read from preference files 2 2 8 DISPLAY HEIGHT DISPLAY_WIDTH The software uses system functions to obtain screen dimensions which are used to calculate font sizes Oasys Ltd have noticed that on some systems the screen dimensions are not reported correctly on identical systems Windows XP returned the correct dimensios while Windows Vista returned sizes approximately 20 larger If fonts used by the Oasys software appear to be the wrong size these 2 variables can be used to override the system calls to define the correct screen dimensions set DISPLAY_HEIGHT screen physical height in mm set DISPLAY_WIDTH screen physical width in mm 2 2 9 Setting Environment Variables ga To set these system variables activate the control panel using Windows NT and 2000 Start gt Settings gt Control Panel Windows xp Start gt Control Panel and then select the System Icon Windows NT Followed by the Environment tab Windows 2000 and XP Followed by the Advanced tab and then the Environment button Page 2 6 User manual Version 9 4 November 2009 Shell This will bring up the window displayed RRS ries left To set up a new Environment Variable enter the variable s name in the Variable box followed by the variable s Value in the Value Box After setting up each new Environment Variable press Set before entering the next new Environment OM U ithughes Variable OASYS P oasys90 SMS_LOCAL_DI C WI
82. sion type is Queue then an option to set the queue memory limit will be available At the main menu type in 13 and press return A menu will be displayed asking for the queue memory limit units Select the queue mem limit units 1 Words 2 M Words 1 Main menu Select the required units to bring up a menu asking for the queue memory limit Enter the queue memory limit 1 Main menu Enter the required limit can be an integer decimal or in the form 1 5E4 The main menu will be displayed with the selected queue memory limit on the right hand side 1 14 15 Queue Name If the submission type is Queue then an option to choose the queue name will be available At the main menu type in 14 and press return A menu will be displayed asking for the queue name Select the queue name 1 Dyna 2 Nastran 3 Other 1 Main Menu The options available will depend on the contents of the oasys_queue file Select the required option The main menu will be displayed with the selected queue shown on the right hand side 1 14 16 Queue Options If the submission type is Queue then an option to specify some queue options will be available At the main menu type in 15 and press return A menu will be displayed with the available commands depending on the queue and number of cpus chosen will differ depending on the contents of the oasys_queue file Select the queue command 1 2 CPUs x 1 Node 2 1CPUs x 2 Nodes
83. t lt 2 gt lt 2 gt lt 4 gt lt 4 gt lt 4 gt lt 4 gt lt 4 gt display string 1 CPU x 1 Node command PBS 1 nodes 1 ppn 1 dyna display_string 2 CPU x 1 Node command PBS 1 nodes 1 ppn 2 dyna mpp_only display _string 1 CPU x 2 Nodes command PBS 1 nodes 1 ppn 2 dyna mpp_only display _string 2 CPU x 2 Nodes command PBS 1 nodes 2 ppn 2 dyna display_string 4 CPU x 1 Node command PBS 1 nodes 1 ppn 4 dyna User manual Version 9 4 November 2009 Shell lt dyna gt lt fast gt lt fast gt lt queue_commands gt lt all_queue_commands gt lt 4 gt lt 2 gt lt 2 gt lt 2 gt lt 2 gt command PBS m abe lt all_queue_commands gt mpp_only display string 1 CPU x 4 Nodes command PBS 1 nodes 4 ppn 1 dyna display _string 2 CPU x 1 Node command PBS 1 nodes 1 ppn 2 dyna mpp_only display _string 1 CPU x 2 Nodes command PBS 1 nodes 1 ppn 2 dyna 2 7 Adding items to the Utilities menu The Utilities menu within the Xshell may be customised to contain upto 20 items The contents of this menu is controlled by a file called oasys_utilities that is located in the directory containing the version 94 executables The format of this file is lt Menu Name gt lt Program gt lt Xterm gt Where Menu Name Name to be given to the program in the menu Ac
84. t and 2000 or tools Windows XP then select Folder Options from the menu 2 Select the File Types tab at the top 3 Scroll down until you find the file type currently associated with ptf files 4 Highlight it and click on Edit T 1 2 he procedure is then the same as the above except that you are replacing Icon click on Change Icon Application click on Edit instead of defining new values If you are unsure it may be easier to Remove the current registered file type then follow the instructions in section 3 1 1 1 above 3 1 2 To make thf xtf cur and bdf files open in T HIS by double clicking on them The procedure is exactly the same as for D3PLOT and must be carried out for each of the file types that you wish to process by double clicking thf LS DYNA Time History file xtf LS DYNA Extra Time History file cur T HIS Curve file bdf T HIS Bulk Data file The only differences are 1 File name description in the Open With window should be appropriate 2 The application to use should be this94 exe 3 The icon to use should be this94 exe Note that 1 File types thf and xtf are opened in this way but no contents are read in 2 File types cur and bdf are opened and their complete contents read in LS DYNA default filenames d3thdt and xtfile cannot be set up for double click access in this way because Windows requires filenames to have extensions when assigning applications to the
85. t of nodes to use NODE_FILE Filename containing the list of nodes to use LSDYNA_NODE_LIST Set to TRUE if submitting MPP jobs using a string containing the list of nodes to use NODE_LIST String containing the list of nodes to use LSDYNA_RESTART_FILE Filename of LS DYNA restart dump file if the analysis is a restart LSDYNA_RESTART_INPUT_FILE Filename of LS DYNA restart input file if the analysis is a restart and a input file has been selected Page 2 18 User manual Version 9 4 November 2009 Shell License file variables setenv OASYS data dyna94 linux_executables setenv LSTC_FILE prg LSTC_FILE setenv LSTC_MEMORY auto setenv LM_LICENSE_FILE atuhp022 atghps03 Job variables setenv LSDYNA_VERSION data dyna94 linux_executables 1s970_s_5434_ia64_sgi_p exe setenv LSDYNA_MPP FALSE setenv LSDYNA_DOUBLE FALSE setenv LSDYNA_ONLINE TRUE setenv LSDYNA_BACKGROUND FALSE setenv LSDYNA_BATCH FALSE setenv LSDYNA_QUEUE FALSE setenv LSDYNA_JOB_DIR local test setenv LSDYNA_JOB_FILE shell_test temp setenv LSDYNA_JOB_CPUS 2 setenv LSDYNA_USER_ID rogerh setenv LSDYNA_LOCAL_ HOST FALSE setenv LSDYNA_NODE_FILE TRUE setenv NODE_FILE local test nodelist setenv LSDYNA_NODE_LIST FALSE 2 5 3 LS DYNA submission The commands to run LS DYNA are included from a user configurable file called oasys submit located in the s
86. the MPI library that the version of LS DYNA has been built with MPICH cluster1 2 cluster2 2 cluster3 cluster4 Submit a job using 4 hosts use 2 CPU s on clusterl and cluster2 and 1 CPU on cluster3 and eluster4 HPMPI clusterl 2 cluster2 2 cluster3 cluster4 Submit a job using 4 hosts use 2 CPU s on clusterl and cluster2 and 1 CPU on cluster3 and cluster4 LAM clusterl cpu 2 cluster2 cpu 2 cluster3 cluster4 Submit a job using 4 hosts use 2 CPU s on clusterl and cluster2 and 1 CPU on cluster3 and cluster4 1 2 3 5 _ Use Node List Node List This option will only be availble when submitting MPP jobs using either the Online Background or Batch options This option can be used to specify a string containing the list of Nodes and CPUS to use when submitting an MPP job The format of the sting will depend on the MPI library that the version of LS DYNA has been built with MPICH hosts host1 cpus 1 host2 cpus 2 hostn cpus n Page 1 7 Shell User manual Version 9 4 November 2009 4 clusterl 2 cluster2 2 cluster3 1 cluster4 1 Submit a job using 4 hosts use 2 CPU s on clusterl and cluster2 and 1 CPU on cluster3 and cluster4 HPMPI host1 cpus 1 host2 cpus 2 hostn cpus n cluster1 2 cluster2 2 cluster3 cluster4 Submit a job using 4 hosts use 2 CPU s on clusterl and cluster2 and 1 CPU on cluster3 and cluster4 1 2 4 Submission options 1 2 4 1 Su
87. tion The name of the program to execute Xterm Does the program require an xterm window define as YES or NO Page 2 27 Shell User manual Version 9 4 November 2009 Page 2 28 User manual Version 9 4 November 2009 Shell 3 Additional Windows NT 2000 XP Setup 3 1 Setting File Associations Under windows on PC it is possible to set up file associations so that double clicking on files automatically loades the file into the assocuiated program As part of the PC installation the following file associations will be set up automatically oti SPLOT 94 T HISO4 Cd h T H 94 key PRIMER 94 Sections 3 1 1 to 3 1 3 describe in detail how these file associations can be manually set up if required 3 1 1 To make ptf files open in D3PLOT by double clicking on them 3 1 1 1 When ptf files do not currently have an application associated with them If no application is currently associated with ptf files a double click won t work and some non specific usually windows icon will be displayed with the file Right click on any ptf file and select Open with Windows nt and 2000 or properties then press the Change tab next to Opens with Windows xp from the popup menu 1 This will bring up the Open Open With with panel 2 Type in a suitable description of p the ptf files For example p LS DYNA complete state file 3 Ensure the Always use box is ticked 4 Use the directory browsing window to
88. used and they will be expanded by the shell For example on Windows you could specify the temp folder with shell temp_folder 7 USERPROFILE my_temp_folder Any line in the oa_pref file that does not start with the string shell or shell is ignored normally comment lines will be prefixed with a for clarity The relevant sections of this file follows below Preferences file for software SHELL stuff Definition Type Valid arguments Default online logical TRUE or FALSE TRUE background logical TRUE or FALSE TRUE batch logical TRUE or FALSE TRUE queue logical TRUE or FALSE TRUE Page 2 7 Shell User manual Version 9 4 November 2009 J t t H H H H H e e e e request_memory_ limit request_space_limit HHH I I H HH H H H EFF FF EFF FF FF FF FH FF FF H HH enable_job_monitoring default batch_type queue_output_file queue_error_file queue_error_path queue_memory queue_memory_units queue_cpu queue_cpu_units queue_space queue_machine request_cpu_limit system_cpu job_ format file_names job_memory job_memory_ units job_cpu job_cpu_units allow_mem_change file_size write_ctf write_ztf batch_display keep _files d3plot_version d3plot64_ version d3plot_default this_version this64_ version this_default primer_version primer64_version primer_default reporter version shell release max_cpus max_mpp_cpus default_cpus default_mpp_ cpus max_node_cpus
89. utput files created by LS DYNA For more details see the D3PLOT Manual 1 4 1 D3PLOT Options D3PLOT r _ Options Right clicking on the D3PLOT tab will cause an OPTIONS tab to appear Selecting this option tab will cause the following window to appear This menu offers the user the opportunity to specify a ptf file that will be automatically read into D3PLOT on opening a D3PLOT command file that E D3PLOT Options Input Options will automatically be executed WM Input File ubmit test run 1 new_Ig09 ptf C by D3PLOT on opening as well as other options Select _ D3PLOT Command F I deselect the options by clicking on the respective tag Click on Y_ Start in ersion92 Net oasys92 Debug C the file divider icon in order to search for the respective files Other Options _ Automatically EXIT after running command file v Use OpenGL Use X 24bit Use X 8bit Use Full Screen set MENU_AUTO_CONFIRM TRUE Input Options Input File Specify the name of the ptf file you wish to be read into D3PLOT D3PLOT Command File Specify the name of a D3PLOT command file you wish to be executed on opening D3PLOT Start in Specify the directory where D3PLOT will be fired up and where output files will be written to Other Options This variable is often used when replaying command files which when recorded MENU_AUTO_CONFIRM paused and asked the user to confirm things For example HELP and Warnin
90. variable is already set then you may add the license server or file for this software by specifying a colon separated list of values ie OASYS_LICENSE_FILE port hostnamel hostname2 2 2 2 OA_ADMIN OA_ADMIN_94 lt option gt If a top level administration directory is to be used then OA_ADMIN_94 for release 9 4 must be defined for all machines on which the software is to be run This variable should be set to the full pathname of the administration directory A description of the installation organisation is given in the Appendix 2 2 3 LSTC_FILE LSTC_LICENSE_SERVER lt option gt On Windows machines LS DYNA can use either a nodelocked license or a floating license system If you are using a nodelocked license then LSTC_FILE should be set to the full pathname of the license file By default this file should be called LSTC_FILE and it should be located in the executables directory ie LSTC_FILE lt INSTALL_DIR gt LSTC_FILE If you are using the floating license system then the variables LSTC_LICENSE_SERVER LSTC_NOCLIENT and LSTC_LICENSE should be set as follows ie LSTC_LICENSE_SERVER hostname where hostname is the LSTC license server LSTC_NOCLIENT ON LSTC_LICENSE network 2 2 4 HOME The software suite uses a preference file to control a number of settings By default the software will look for the preference file in 4 locations the OA_ADMIN_xx directory if set the installation directory HOME and the
91. will display an optional menu of additional utility programs The exact list of programs given will depend on the options set up by the system administrator see Sect 2 7 Adding items to the Utilities menu for more information 1 8 Preferences Preferences Selecting this tab will open up the Preferences editor This is a graphical interface which allows for manual editing of the oa_pref file For more information on the Preferences editor see Section 4 1 9 Manuals En LS DYNA KEYWORD LS DYNA THEORY This option will only be available if the shell has been able to find PRIMER HTML a copy of the Adobe Acrobat software to use to display the on line manuals If the Acrobat software is available then this button will display a menu listing the manuals that are available for reading and printing PRIMER JS API D3PLOT HTML D3PLOT T HIS HTML THIS REPORTER HTML REPORTER SHELL 94 HTML SHELL 94 Release Notes FLEXIm User Guide PRIMER JS API HTML 1 10 Status This option will display information on the programs that have been licensed T 1 11 Support This option will display support contact information 1 12 Exit EXIT This option will exit from the X Windows shell Page 1 20 User manual Version 9 4 November 2009 Shell 1 13 Command Line Options These options can be used to automatically start up programs and set default values Open Submit window for job jobname NONE Start D3PLOT NONE Sta

SHELL 9.4 user manual

Contents

Download Pdf Manuals

Related Search

Related Contents