zowe › endevor-bridge-for-git › build › job-submit🖨️

Build changes from git local repository in Endevor by submitting a job. It supports autogen for building dependencies using with the option of selecting autogen span. After submitting, the command 'build job-report' must be issued to finalize processing.

Usage

zowe endevor-bridge-for-git build job-submit [options]

Required Options

• --endevor-instance | --endevori (string)

  • The CA Endevor Web Services dataSource name.

• --skeleton-jcl | --sjcl (string)

  • The path of the file of skeleton JCL to submit endevor scl statements. Download it from: https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/devops/ca-endevor-integrations-for-enterprise-devops/1-0/ca-endevor-bridge-for-git/set-up-and-run-the-ca-endevor-bridge-for-git/configuration-for-build-using-zowe-cli.html

Endevor work area options

• --work-area-id | --waid (string)

  • Endevor work area ID. Name-masking is not allowed.

• --endevor-subsystem | --endevorsub (string)

  • The CA Endevor SCM build subsystem. Note: The build subsystem can be cleared without prior permission.

• --endevor-environment | --endevorenv (string)

  • The CA Endevor SCM environment where your build subsystem resides.

• --endevor-system | --endevorsys (string)

  • The CA Endevor SCM system where your build subsystem resides.

Options

• --work-dir | --wd (string)

  • The local working directory of your Git-Endevor mapping that you are building.

    Default value: ./

• --force-cleanup | --fc (boolean)

  • Starts the build process after cleaning the build subsystem.

    Default value: false

• --autogen-span | --ags (string)

  • Specifies the autogen action option to automatically generate using elements.
    The allowed values which have the following meaning:
    NONE - Generates all elements that use the component being acted upon.
    ALL - Generates using elements that are found in any System and Subsystem combinations within the Environment and Stage of the component's logical map.
    SYSTEMS - Generates using elements that are found in any System, provided the element's Subsystem name matches the name of the Subsystem of the target component.
    SUBSYSTEMS - Generates using elements from all Subsystems with the same-named System of the component specified.

    Default value: NONE
    Allowed values: NONE, ALL, SYSTEMS, SUBSYSTEMS

Endevor options (alternatively use an 'endevor' profile)

• --endevor-protocol | --endevorprot (string)

  • The CA Endevor SCM Rest API protocol.

    Default value: http

    Allowed values: http, https

• --endevor-host | --endevorh (string)

  • The Endevor Rest API hostname.

• --endevor-port | --endevorp (number)

  • The Endevor Rest API port.

• --endevor-user | --endevoru (string)

  • Mainframe (Endevor) username, which can be the same as your TSO login.

• --endevor-password | --endevorpass | --endevorpw (string)

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

• --endevor-reject-unauthorized | --endevorru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --endevor-base-path | --endevorbp (string)

  • The CA Endevor SCM Rest API base path.

    Default value: EndevorService/rest

z/OSMF connection options (alternatively use a 'zosmf' profile)

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

  • The z/OSMF server host name.

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

  • The z/OSMF server port.

    Default value: 443

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

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

• --zosmf-password | --zosmfpass | --zosmfpw (string)

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

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

  • Reject self-signed certificates.

    Default value: true

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

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

Profile Options

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

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

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

  • The name of a (zosmf) 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

Response Format Options

• --response-format-filter | --rff (array)

  • Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

• --response-format-type | --rft (string)

  • The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

• --response-format-header | --rfh (boolean)

  • If "--response-format-type table" is specified, include the column headers in the output.

Examples

• Compile the changed elements at "/endevor/ebg/repository" using work area with ID "WORKAREA1", jcl skeleton at "/endevor/jcl/jcl.txt" and existing Endevor and z/OSMF profiles:

  • zowe endevor-bridge-for-git build job-submit --skeleton-jcl /endevor/jcl/jcl.txt --work-area-id WORKAREA1 --work-dir /endevor/ebg/repository Copy

• Compile the changed elements at "/endevor/ebg/repository" using build subsystem "SUBNAME", jcl skeleton at "/endevor/jcl/jcl.txt" and existing Endevor and z/OSMF profiles:

  • zowe endevor-bridge-for-git build job-submit --skeleton-jcl /endevor/jcl/jcl.txt --endevor-subsystem SUBNAME --endevor-environment ENVNAME --endevor-system SYSNAME --work-dir /endevor/ebg/repository Copy