## 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 Endevor Web Services Endevor configuration 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 Endevor SCM build subsystem. Note: The build subsystem can be cleared without prior permission.

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

  - The Endevor SCM environment where your build subsystem resides.

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

  - The 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 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 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`

- 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`