cics-bundle:deploy

Full name:

com.ibm.cics:cics-bundle-maven-plugin:2.0.0-SNAPSHOT:deploy

Description:

This mojo deploys a CICS bundle to the specified CICS region using the CICS bundle deployment API. A matching bundle definition must be provided in the CSD in advance.

The deploy goal is not bound by default, so will not run unless specifically configured. You might choose to configure the deploy goal to run inside a specific profile, so that a developer can choose whether to deploy their bundle with a command-line parameter to switch Maven profiles.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • The goal is not marked as thread-safe and thus does not support parallel builds.
  • Binds by default to the lifecycle phase: verify.

Required Parameters

Name Type Since Description
<bunddef> String - The name of the bundle definition that will install this bundle. Must be present already in the CSD relating to the configured cicsplex/region, and must be configured with the correct bundle directory according to the bundle deployment API configuration and the name of the bundle the user is deploying.
User property is: cicsbundle.bunddef.
<csdgroup> String - The CSD group containing the bundle definition to be installed.
User property is: cicsbundle.csdgroup.

Optional Parameters

Name Type Since Description
<bundle> String - The filename of the bundle archive file to be deployed.
User property is: cicsbundle.bundle.
<cicsplex> String - Required for a CICSPlex SM environment, ignored in an SMSS environment. The name of the CICSplex the bundle should be installed into. Specifying this parameter overrides any value provided within a Maven settings server entry.
User property is: cicsbundle.cicsplex.
<classifier> String - The classifier of a bundle attached to this project which is to be deployed. If a value for the @bundle parameter is supplied, this classifier is ignored.
User property is: cicsbundle.classifier.
<insecure> boolean - When connecting to the CICS bundle deployment API, do not check that the trust chain of the host certificate is valid, do not verify that the host name of certificate matches host name of server.
Default value is: false.
User property is: cicsbundle.insecure.
<password> String - The password to authenticate with. Specifying this parameter overrides any value provided within a Maven settings server entry.
User property is: cicsbundle.password.
<region> String - Required for a CICSPlex SM environment, ignored in an SMSS environment. The name of the region the bundle should be installed into. Specifying this parameter overrides any value provided within a Maven settings server entry.
User property is: cicsbundle.region.
<serverId> String - The ID of a server configured in your Maven settings
<url> String - The CMCI URL that the CICS bundle deployment API is available on. For example `https://yourcicshost.com:9080`. Specifying this parameter overrides any value provided within a Maven settings server entry.
User property is: cicsbundle.url.
<username> String - The username to authenticate with. Specifying this parameter overrides any value provided within a Maven settings server entry.
User property is: cicsbundle.username.

Parameter Details

<bunddef>

The name of the bundle definition that will install this bundle. Must be present already in the CSD relating to the configured cicsplex/region, and must be configured with the correct bundle directory according to the bundle deployment API configuration and the name of the bundle the user is deploying.
  • Type: java.lang.String
  • Required: Yes
  • User Property: cicsbundle.bunddef

<bundle>

The filename of the bundle archive file to be deployed.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.bundle

<cicsplex>

Required for a CICSPlex SM environment, ignored in an SMSS environment. The name of the CICSplex the bundle should be installed into. Specifying this parameter overrides any value provided within a Maven settings server entry.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.cicsplex

<classifier>

The classifier of a bundle attached to this project which is to be deployed. If a value for the @bundle parameter is supplied, this classifier is ignored.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.classifier

<csdgroup>

The CSD group containing the bundle definition to be installed.
  • Type: java.lang.String
  • Required: Yes
  • User Property: cicsbundle.csdgroup

<insecure>

When connecting to the CICS bundle deployment API, do not check that the trust chain of the host certificate is valid, do not verify that the host name of certificate matches host name of server.
  • Type: boolean
  • Required: No
  • User Property: cicsbundle.insecure
  • Default: false

<password>

The password to authenticate with. Specifying this parameter overrides any value provided within a Maven settings server entry.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.password

<region>

Required for a CICSPlex SM environment, ignored in an SMSS environment. The name of the region the bundle should be installed into. Specifying this parameter overrides any value provided within a Maven settings server entry.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.region

<serverId>

The ID of a server configured in your Maven settings
  • Type: java.lang.String
  • Required: No

<url>

The CMCI URL that the CICS bundle deployment API is available on. For example `https://yourcicshost.com:9080`. Specifying this parameter overrides any value provided within a Maven settings server entry.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.url

<username>

The username to authenticate with. Specifying this parameter overrides any value provided within a Maven settings server entry.
  • Type: java.lang.String
  • Required: No
  • User Property: cicsbundle.username