DataLocation - Specify folder where job data is stored

Description

DataLocation identifies where the job data is located.

Characteristics

Usage	Scheduler object
Read-only	Never
Data type	String or struct

Values

DataLocation is a string or structure specifying a pathname for the job data. In a shared file system, the client, scheduler, and all worker nodes must have access to this location. In a nonshared file system, only the MATLAB client and scheduler access job data in this location.

If DataLocation is not set, the default location for job data is the current working directory of the MATLAB client the first time you use findResource to create an object for this type of scheduler. All settable property values on a scheduler object are local to the MATLAB client, and are lost when you close the client session or when you remove the object from the client workspace with delete or clear all.

Use a structure to specify the DataLocation in an environment of mixed platforms. The fields for the structure are named pc and unix. Each node then uses the field appropriate for its platform. See the examples below. When you examine a DataLocation property that was set by a structure in this way, the value returned is the string appropriate for the platform on which you are examining it.

The job data stored in the folder identified by DataLocation might not be compatible between different versions of MATLAB Distributed Computing Server. Therefore, DataLocation should not be shared by parallel computing products running different versions, and each version on your cluster should have its own DataLocation.

Examples

Set the DataLocation property for a UNIX-based cluster.

sch = findResource('scheduler','name','LSF')
set(sch, 'DataLocation','/depot/jobdata')

Use a structure to set the DataLocation property for a mixed platform cluster.

d = struct('pc',   '\\ourdomain\depot\jobdata', ...
           'unix', '/depot/jobdata')
set(sch, 'DataLocation', d)

See Also

Properties

HasSharedFilesystem, PathDependencies

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS