MATLAB tasks scheduled by IBM Spectrum Symphony support

Integrating IBM® Spectrum Symphony with MATLAB allows the Parallel Computing Toolbox to be used with IBM Spectrum Symphony using the generic scheduler interface.

This feature is applicable to IBM Spectrum Symphony. For supported MATLAB versions, see the IBM Spectrum Symphony connector for MATLAB section in Supported add-on features and integrations.

Limitations

  1. All jobs created from the same scheduler object use the same application to run MATLAB tasks.
  2. All MATLAB worker nodes must have the same installation path, and ClusterMatlabRoot must be set properly for the scheduler object.

Prerequisites

Before you enable MATLAB tasks, ensure you have met the following prerequisites:
  1. On the client node, install MATLAB Parallel Computing Toolbox Package to submit MATLAB jobs.
  2. On IBM Spectrum Symphony compute hosts, install MATLAB Distributed Computing Server (MDCS) to run MATLAB jobs.

MATLAB scripts

After you have installed IBM Spectrum Symphony Developer Edition, the MATLAB scripts are available under the following paths:
  • Windows: %SOAM_HOME%\integration\Matlab\version\
  • Linux®: $SOAM_HOME/integration/Matlab/version
The Matlab directory include the following scripts:
destroyJobFcn.m
This function is required for the generic scheduler. It destroys a job on the scheduler. Use this as the DestroyJobFcn for your generic scheduler object.
distributedSubmitFcn.m
This function is required for the generic scheduler. It submits function for distributed jobs. Use this as the SubmitFcn for your generic scheduler object.
extractJobId.m
Gets the scheduler's job ID from the submission output.
getJobStateFcn.m
This function is required for the generic scheduler. It ges the job state from the scheduler. Use this as the GetJobStateFcn for your generic scheduler object
getSubmitString.m
Gets the submission string for the scheduler.
workerDecodeFcn.m
This function is required for the generic scheduler. It is available only in %SOAM_HOME%\integration\Matlab\R2008b\ directory as it is only used for MATLAB R2008B on Windows. It decodes for the worker.

For more details about these files, refer to the help and comments included in the files themselves.