SHELL 22.1

Submission Options

Submission Options

Submission Method

Submission method menu cut


Submission method menu cut


Submission method menu cut

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 LINUX 'at' command.
Batch Submit jobs into a batch queue using the LINUX '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.

You can also view and/or edit the oasys_queue file from here.

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.

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 the MPI library that the version of Ansys LS-DYNA has been built with.

MPICH2 cluster1:2
cluster2:2
cluster3
cluster4

Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"

HP MPI /
PLATFORM MPI
cluster1:2
cluster2:2
cluster3
cluster4

Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"

INTEL MPI cluster1:2
cluster2:2
cluster3
cluster4

Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"

OPEN MPI cluster1
cluster1
cluster2
cluster2
cluster3
cluster4
or cluster1 slots=2
cluster2 slots=2
cluster3
cluster4

Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"

Node List

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 Ansys LS-DYNA has been built with.This option will only be availble when submitting MPP jobs using either the Online, Background or Batch options.

MPICH2 #hosts host1 cpus(1) host2 cpus(2) ...... hostn cpus(n)
4 cluster1 2 cluster2 2 cluster3 1 cluster4 1
Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"
HP MPI /
PLATFORM MPI
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 "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"
INTEL MPI #hosts host1 cpus(1) host2 cpus(2) ...... hostn cpus(n)
4 cluster1 2 cluster2 2 cluster3 1 cluster4 1
Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"
OPEN MPI #hosts host1 cpus(1) host2 cpus(2) ...... hostn cpus(n)
cluster1,cluster1,cluster2,cluster2,cluster3,cluster4
Submit a job using 4 hosts, use 2 CPU's on "cluster1" and "cluster2" and 1 CPU on "cluster3" and "cluster4"

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 passed 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.

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).

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 Ansys 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 Ansys LS-DYNA restart and result files. If the extra time specified is unlikely to be sufficient a warning 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.

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 Ansys 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.

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 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.

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 pack_nodes)

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.

Ansys LS-DYNA Command Line Preview

command line preview section

command line preview section

Ansys LS-DYNA command line preview section lets the user view and edit the Ansys LS-DYNA command line expression and also the detailed preview for the actual LS_DYNA command-line.

The detailed preview shows the commands with their appropriate Ansys LS-DYNA syntax.

It is possible to switch between the expression and the detailed preview using the 'Expression' button.

The Ansys LS-DYNA expression allows the user to know all the Ansys LS-DYNA commands in a consise format.

The SHELL also saves the command-line expressions values from the previously completed Ansys LS-DYNA submissions.

This is for an easy and quick re-submission to Ansys LS-DYNA can be picked up using the 'Recent command-line expressions' popup menu.

command line preview section

User can use the 'Edit' button to edit the deteiled preview, this haults the SHELL operation until the edit is complete. User can edit/add/delete input and output options in the Input/Output tab using Edit button. User can also add new commands into the command line that are currently under development.

The text editor preference can be changed through 'Prefernces' button on the main window under SHELL=>System Settings=>text editor.