Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

gcmr

Get current mapreducer configuration

Syntax

mr = gcmr
mr = gcmr('nocreate')

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® Distributed Computing 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 function reference page for related information.

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

Introduced in R2014b

Was this topic helpful?