Command Line Submission SHELL
Command Line Submission SHELL
When starting the SHELL on a LINUX 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_22 cmd'. The following screen will be displayed in the terminal: (Note that it may differ slightly depending on preference settings)
|
-------------------- SHELL 22.1 (build xxxx) ----------------------------------- |
| Options | Current selection |
|
-------------------- Ansys LS-DYNA --------------------------------------------- |
| (1) | Code Version | LS970 (v6763) |
|
-------------------- Job Options ----------------------------------------------- |
|
(2) |
Input File | *** Nothing Selected *** |
| (3) | Format | Keyword |
| (4) | CPU Limit | 0.00 Seconds |
| (5) | Memory Limit | Memory1 40.00 MWords |
| (6) | Memory2 Limit (OFF) | Memory1 40.00 MWords |
| (7) | Increase Memory If Required | On |
| (8) | Filename Format | Arup '.ptf...' |
| (9) | Optional Files |
|
-------------------- Parallel Options ------------------------------------------ |
| (10) | CPUs | 2 CPUs, Consistency Flag On |
|
-------------------- Submission Options ---------------------------------------- |
| (12) | Submission Type | Queue, Now 00:00 |
| (13) | Queue CPU Limit | 0.00 Seconds |
| (14) | Queue Memory Limit | Memory 150.00 MWords |
| (15) | Queue Name | DYNA, CPU Limit: 0 |
| (16) | 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.
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 the same as the graphical version. The menu is set out with the options on the lefts 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.
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 Ansys 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
(-2) Local LS-DYNA Exe
Select the required code version. The main menu will be displayed with the selected code version shown on the right hand side.
Input File
At the main menu type in '2' 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*). (-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 *.lst* 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.
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.
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.
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 (Current Selection: 40)
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 memory limit on the right hand side.
Memory2 Limit
At the main menu type in '6' and press return. Please note that the units for MEMORY2 is the same as that entered for MEMORY, also this option is only valid for MPP and HYBRID versions of Ansys LS-DYNA.
In Ansys LS-DYNA the MEMORY2 input is optional (uses the value set for MEMORY if this option is not set) so the user is first displayed with a menu to switch this option ON/OFF.
Turn on the value for memory2? (Current Selection: 0)
(1) Off (2) On (-1) Main Menu
If turned On, the user is displayed with a second menu to enter the required limit (can be an integer, decimal, or in the form 1.5E4).
Enter the job memory2 limit. (-1) Main menu (Current Selection: 40)
The main menu will be displayed with the selected job memory2 limit on the right hand side.
Increase Memory If Required
At the main menu type in '7' 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 the selected option on the right hand side.
Filename Format
At the main menu type in '8' 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.
Optional Files
| Options | Current selection |
|
-------------------------- 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 |
| (8) | MPP pfile | Off |
| (9) | GMINP (.gm) | Off |
|
-------------------------- Output Files ------------------------- |
| (10) | Contact Force File (.ctf) | Off |
| (11) | Interface Segment (.isf1) | Off |
| (12) | Static Database File (.ztf) | On |
| (13) | Winfrith Crack File (.crf) | Off |
| (14) | FSIFOR File | Off |
| (15) | GMOUT (.gm) | Off |
| (16) | CPM Interface Force File | Off |
| (17) | DEM Interface Force File | Off |
| (18) | FSILNK file (.fsl) | Off |
| (19) | PBM Interface Force File (.pbm) | Off |
| (20) | D3PART File (.d3part) | Off |
| (21) | BEM File (.bem) | Off |
| (22) | General Print File (.root) | Off |
|
-------------------------- Input Options ------------------------ |
| (31) | ENDTIM | 0.000000 |
| (32) | ENDCYC | 0 |
| (33) | PARA | 0 |
| (34) | NCSP | 0 |
| (35) | CASE | Off |
| (36) | MCHECK | Off |
| (37) | LONG | Off |
| (38) | BIGID | Off |
| (39) | JOBID | Off |
| (40) | PGPKEY | Off |
| (41) | INIT | Off |
| (42) | D3PROP | Off |
|
-------------------------- Binary File Size --------------------- |
| (50) | Binary File Size | 1024 |
|
(-1) |
Main menu |
Options 1 - 50 can be toggled on and off simply by selecting them.
The analysis end time can be specified by selecting option 31. 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 will be shown with the selected end time on the right hand side.
The analysis end cycle can be specified by selecting option 32. 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 33. 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.
Options 34 - 41 require a user input name (if the option is turned ON). The following menu will be displayed:
Current option name:
Enter the new option name: (-1) Main menu (keep the current option name)
The analysis ncsp value can be specified by selecting option 42. the following menu will be displayed:
Enter the ncsp value. (-1) Optional files menu
Enter the required ncsp value (an integer). The optional files menu will be shown with the selected ncsp value on the right-hand side.
To go back to the main menu type in '-1' and press return.
CPUsAt the main menu type in '10' 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
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. |
Node OptionsThis option will only be available if the submission type is not queue and the code type is MPP. If it is available then at the main menu type in '11' and press return. A menu will be displayed asking for the node option:
Select the node option
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
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. |
Submission TypeAt the main menu type in '12' and press return. A menu will be displayed asking for the submission type:
Select the submission type
Some submission types may be unavailable depending on the settings in the oa_pref file. If an unavailable 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
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. |
Queue CPU LimitIf the submission type is Queue then an option to set the queue cpu limit will be available. At the main menu type in '13' and press return. A menu will be displayed asking for the queue CPU limit units:
Select the queue cpu limit units
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. |
Queue Memory LimitIf the submission type is Queue then an option to set the queue memory limit will be available. At the main menu type in '14' and press return. A menu will be displayed asking for the queue memory limit units:
Select the queue mem limit units
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. |
Queue NameIf the submission type is Queue then an option to choose the queue name will be available. At the main menu type in '15' and press return. A menu will be displayed asking for the queue name:
Select the queue name
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. |
Queue OptionsIf the submission type is Queue then an option to specify some queue options will be available. At the main menu type in '16' 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
Select the required option. The main menu will be shown with the selected queue command.
|
SubmitOnce 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
Select the required option and if cancel was not selected the job will be submitted. |
ResetTo reset the selected options to defaults at the main menu type in '88' and press enter.
|
Status / KillThe status of a run 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 | Off |
| (3) SW3 : | Write a Restart File and Continue | Off |
| (4) SW4 : | Write a Plot State and Continue | Off |
| (5) SW5 : | Interactive graphics and real time visualization | Off |
| (6) SW7 : | Turn off real time visualization | On |
| (7) SW8 : | Interactive 2D rezoner for solid elements and real time visualization. | Off |
| (8) SW9 : | Turn off real time visualization (for option SW8) | Off |
| (9) FILE : | Send Ouput from SW2 to a File | Off |
| (10) SWA : | Flush ASCII file buffers | Off |
| (11) SWB : | Write a DYNAIN File and Continue | Off |
| (12) SWC : | Write a DYNAIN and a Restart File and Continue | Off |
| (13) SWD : | Write a DYNAIN and a Restart File and Terminate | Off |
| (14) SWE : | Terminate explicit dynamic relaxation and proceed with the transient analysis | Off |
| (15) CONV : | Temporarily override nonlinear convergence tolerances | Off |
| (16) ITER : | Enable/Disable output of binary plot database "d3iter" after each equilibrium iteration | Off |
| (17) LPRINT: | Enable/Disable output of equation solver memory, cpu requirements | Off |
| (18) NLPRINT: | Enable/Disable output of nonlinear equilibrium iteration information | Off |
| (19) PROF : | Output current timing information to messag (SMP) or prof.out (MPP). | Off |
| (20) STOP : | Halt execution immediately, closing open files | Off |
| (21) ENDTIME : | Change the termination time to | 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.