Main Content

gcmr

Get current mapreducer configuration

Description

mr = gcmr returns an object representing the current global execution environment for mapreduce.

  • If no global execution environment exists, then gcmr calls mapreducer to set the global execution environment to be the default.

  • If a global execution environment currently exists, then gcmr returns the last visible MapReducer object created.

    When you create a MapReducer object using mapreducer, the object sets the global execution environment. The global execution environment persists even if the object representing it is later deleted.

  • If the global execution environment is deleted or invalid, then gcmr returns the next visible MapReducer object available. For example, delete(gcmr) deletes the current global execution environment.

The gcmr function defines the global execution environment for mapreduce, and is most likely used with Parallel Computing Toolbox™, MATLAB® Parallel Server™, or MATLAB Compiler™.

If you do not specify a configuration to use in your call to mapreduce, then by default mapreduce uses the configuration returned (or generated) by gcmr.

mr = gcmr('nocreate') returns the current global execution environment for mapreduce, if one already exists. If no global execution environment exists, then gcmr returns [].

Tips

  • If you have Parallel Computing Toolbox, see the mapreducer (Parallel Computing Toolbox) function reference page for related information.

  • If you have MATLAB Compiler, see the mapreducer (MATLAB Compiler) function reference page for related information.

Extended Capabilities

Version History

Introduced in R2014b