General Job Submission Script Requirements

When running a design study, the Design Manager server passes specific instructions to each design simulation. These instructions are communicated via files that are written to the temporary directory .mdxruntime that is located in the same directory as the project artifact directory. When a design simulation is submitted to the cluster scheduler, the Design Manager server executes the user job submission script in the temporary directory .mdxruntime/$project/$study/$design. The .mdxruntime/$project/$study/$design directory contains all the files that Design Manager requires to execute the design simulation.

The Design Manager server does not interact with the job scheduler on your cluster. For this reason, in the job submission script, you must read the following files from .mdxruntime/$project/$study/$design and redirect them to the Design Manager server:

• dm_design_execute_options.txt

  This file contains additional command line options, such as license details, and other options that you define in the design study settings.

• dm_design_output_info.msg

  This file contains the name of the log file that Design Manager expects to be available when the design simulation executes.

Within your job submission script, you must change to the job working directory and read these two files using the cat command.

#!/bin/tcsh -f

# Change directory to job working directory 
# Note: The respective command depends on your batch management system, such as PBS.
# ----------------------------------
cd $PBS_O_WORKDIR 

# Design Manager definitions
# ----------------------------------
# dm_design_execute_options.txt contains starccm+ command line arguments.
# dm_design_output_info.msg contains log output file name to dump.

set STARTCASE=`cat dm_design_execute_options.txt`
set CASELOG=`cat dm_design_output_info.msg`

# Set STAR-CCM+ installation directory
# ----------------------------------
set STARCCMHOME=[STAR-CCM+_INSTALL_DIR]   #[STAR-CCM+_INSTALL_DIR]: set absolute path to the STAR-CCM+ installation directory on the cluster

# Call STAR-CCM+
# ----------------------------------
$STARCCMHOME/star/bin/starccm+ \
  -rsh ssh \
  -batchsystem pbs \
  $STARTCASE \
  >>& $CASELOG