The SET CICSPLEX command

Define the CICSplex to connect to and use to manage applications and bundles in subsequent commands. DFHDPLOY can connect to a CICSPlex® SM CMAS at version 5.1 and above.

Options

CICSPLEX (data-value)

Specifies the CICSplex (up to 8 characters) to connect to and use for subsequent commands in the input stream.

CMAS (data-value)

Optionally specifies the CMAS (up to 8 characters) that processes DFHDPLOY commands.

Use this parameter to separate CICSPlex SM API calls over multiple CMASes within a management network. For example, you can use this parameter to distribute workload to other CMASes in addition to the maintenance point CMAS.

Note: The maintenance point CMAS must be active for DFHDPLOY to run successfully.

If this option is not specified, the CMAS that processes DFHDPLOY commands is determined in the same manner as in an EXEC CPSM CONNECT API call: typically, the most recently started CMAS within the CICSplex that is running on the same MVS image and the same version of CICSPlex SM. For more information about connecting to a CMAS, see The connection process.

Note: The DFHDPLOY JOBSTEP containing the SET CICSPLEX command must reference the same SEYUAUTH library as the CMAS within the CICSplex. If this library is not referenced, the following message is displayed:

DFHRL2004E Unable to connect to CICSPLEX(). SEYUAUTH library mismatch between DFHDPLOY and CMAS JCL.