zowe › cics-deploy › push › bundle🖨️

Push a CICS bundle from the working directory to a target CICSplex.

Usage

zowe cics-deploy push bundle [options]

cics-deploy Options

• --name | -n (string)

  • Required. Specifies the name of the CICS BUNDLE resource (up to 8 characters) to deploy or undeploy.

• --target-directory | --td | --targetdir | --target-dir (string)

  • Specifies the target zFS location in which the CICS bundle is to be created (up to 255 characters). This parameter defaults to the value specified in the cics-deploy profile.

• --cicsplex | --cp (string)

  • Specifies the CICSplex (up to 8 characters) to target. This parameter defaults to the value specified in the cics-deploy profile.

• --scope | --sc (string)

  • Specifies the name of the CICS System, or CICS System Group (up to 8 characters) to target. This parameter defaults to the value specified in the cics-deploy profile.

• --csd-group | --cg | --csdgroup (string)

  • Specifies the CSD group (up to 8 characters) for the bundle resource. If a bundle is deployed, a definition is added to this group. If a bundle is undeployed, then the definition is removed from this group. The definition is added or removed from the CSD of each system that is specified by the --scope option. The --csd-group and --res-group options are mutually exclusive.

• --res-group | --rg | --resgroup (string)

  • Specifies the BAS resource group (up to 8 characters) for the bundle resource. If a bundle is deployed, a resource is defined in the BAS data repository. If a bundle is undeployed, the definition is removed. The --csd-group and --res-group options are mutually exclusive.

• --cics-hlq | --cq | --cicshlq (string)

  • Specifies the high-level qualifier (up to 35 characters) at which the CICS datasets can be found in the target environment. This parameter defaults to the value specified in the cics-deploy profile.

• --cpsm-hlq | --cph | --cpsmhlq (string)

  • Specifies the high-level qualifier (up to 35 characters) at which the CPSM datasets can be found in the target environment. This parameter defaults to the value specified in the cics-deploy profile.

• --description | --desc (string)

  • An optional value that specifies a description of the bundle definition (up to 58 characters).

• --job-card | --jc | --jobcard (string)

  • Specifies the job card to use with any generated DFHDPLOY JCL. Use this parameter if you need to tailor the job card and you have not set the --cics-deploy-profile option. You can separate multiple lines of the jobcard with \n.

    Default value: //DFHDPLOY JOB DFHDPLOY,CLASS=A,MSGCLASS=X,TIME=NOLIMIT

• --timeout | --to (number)

  • An optional numerical value that specifies the maximum amount of time in seconds (1 - 1800 inclusive) for the DFHDPLOY command to complete. If not specified DFHDPLOY will use its default of 300 seconds.

• --target-state | --ts | --targetstate (string)

  • Specifies the target state for the deployed bundle.

    Default value: ENABLED
    Allowed values: DISABLED, ENABLED, AVAILABLE

• --verbose | -v (boolean)

  • Enable or suppress verbose output from the DFHDPLOY tool.

    Default value: false

• --overwrite | --ow (boolean)

  • Enable or disable the ability to replace an existing bundle directory or bundle on the remote system.

    Default value: false

Zosmf Connection Options

• --zosmf-host | --zh (string)

  • The z/OSMF server host name.

• --zosmf-port | --zp (number)

  • The z/OSMF server port.

• --zosmf-user | --zu (string)

  • Mainframe (z/OSMF) user name, which can be the same as your TSO login.

• --zosmf-password | --zpw (string)

  • Mainframe (z/OSMF) password, which can be the same as your TSO password.

• --zosmf-reject-unauthorized | --zru (boolean)

  • Reject self-signed certificates.

• --zosmf-base-path | --zbp (string)

  • The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

z/OS Ssh Connection Options

• --ssh-host | --sh (string)

  • The z/OS SSH server host name.

• --ssh-port | --sp (number)

  • The z/OS SSH server port.

• --ssh-user | --su (string)

  • Mainframe user name, which can be the same as your TSO login.

• --ssh-password | --spw (string)

  • Mainframe password, which can be the same as your TSO password.

• --ssh-private-key | --spk (string)

  • Path to a file containing your private key, that must match a public key stored in the server for authentication

• --ssh-key-passphrase | --skp (string)

  • Private key passphrase, which unlocks the private key.

• --ssh-handshake-timeout | --sht (number)

  • How long in milliseconds to wait for the SSH handshake to complete.

CICS Connection Options

• --cics-host | --ch (string)

  • The CMCI server host name.

• --cics-port | --cpo (number)

  • The CICS server port.

• --cics-user | --cu (string)

  • Mainframe (CICS) user name, which can be the same as your TSO login.

• --cics-password | --cpw (string)

  • Mainframe (CICS) password, which can be the same as your TSO password.

• --cics-reject-unauthorized | --cru (boolean)

  • Reject self-signed certificates.

• --cics-protocol | --cpr (string)

  • Specifies CMCI protocol (http or https).

    Allowed values: http, https

Profile Options

• --cics-deploy-profile | --cics-deploy-p (string)

  • The name of a (cics-deploy) profile to load for this command execution.

• --zosmf-profile | --zosmf-p (string)

  • The name of a (zosmf) profile to load for this command execution.

• --ssh-profile | --ssh-p (string)

  • The name of a (ssh) profile to load for this command execution.

• --cics-profile | --cics-p (string)

  • The name of a (cics) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --host | -H (string)

  • Host name of service on the mainframe.

• --port | -P (number)

  • Port number of service on the mainframe.

• --user | -u (string)

  • User name to authenticate to service on the mainframe.

• --password | --pass | --pw (string)

  • Password to authenticate to service on the mainframe.

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

Examples

• Push a CICS bundle from the working directory by using default cics-deploy, cics, ssh and zosmf profiles:

  • zowe cics-deploy push bundle --name EXAMPLE --target-directory /u/example/bundles Copy

• Push a CICS bundle from the working directory by using specific zosmf, ssh & cics-deploy profiles:

  • zowe cics-deploy push bundle --name EXAMPLE --target-directory /u/example/bundles --zosmf-profile testplex --cics-deploy-profile devcics --ssh-profile ssh Copy

• Push a CICS bundle from the working directory replacing any bundle of the same name that is already deployed:

  • zowe cics-deploy push bundle --name EXAMPLE --target-directory /u/example/bundles --overwrite Copy