zowe › cics-deploy › generate › bundle🖨️

Generate a CICS bundle in the working directory. The associated data is constructed from a combination of the command-line options and the contents of package.json. If package.json exists, no options are required. If package.json does not exist, both --start-script and --nodejsapp are required.

Usage

zowe cics-deploy generate bundle [options]

cics-deploy Options

• --bundle-id | -b | --id | --bundleid (string)

  • The ID for the generated CICS bundle, up to 64 characters. If no value is specified, a default value is created from the 'name' property in the package.json file in the current working directory. If the value is too long, it is truncated. If it contains characters that are not supported by CICS, each character is replaced by an X.

• --bundle-version | --bv | --bundleversion (string)

  • The major.minor.micro version number for the generated CICS bundle. If no value is specified, a default value of 1.0.0 is used.

• --nodejsapp | -n | --nj | --nja (string)

  • The ID of the generated CICS NODEJSAPP resource, up to 32 characters. If no value is specified, a default value is created from the 'name' property in package.json, or the bundleid option if specified. If the value is too long it is truncated. If it contains characters that are not supported by CICS, each character is replaced by an X.

• --start-script | -s | --ss | --startscript (string)

  • Up to 255 character path to the Node.js start script that runs when the associated bundle is enabled in CICS. If a value is not specified, a default value is created from either the 'scripts.start' property of the package.json file in the current working directory, or from the 'main' property.

• --port | -p (string)

  • The TCP/IP port number the Node.js application should use for clients to connect to. If a value is specified, it is set within the generated NODEJSAPP's profile. The Node.js application can reference this value by accessing the PORT environment variable, for example using process.env.PORT. Additional environment variables can be set by manually editing the profile.

• --overwrite | --ow (boolean)

  • Enable or disable the ability to replace existing files within a CICS bundle.

    Default value: false

• --merge | --me (boolean)

  • Enable or disable the ability to merge new resources into an existing CICS bundle manifest. Requires --overwrite to be specified.

    Default value: false

Examples

• Generate a CICS bundle in the working directory, taking information from package.json:

  • zowe cics-deploy generate bundle Copy

• Generate a CICS bundle in the working directory, based on package.json but using a bundle ID of "mybundle":

  • zowe cics-deploy generate bundle --bundle-id mybundle Copy

• Generate a CICS bundle in the working directory in which a package.json does not exist:

  • zowe cics-deploy generate bundle --bundle-id mybundle --nodejsapp myapp --start-script server.js Copy