zowe › endevor-bridge-for-git › mapping › add-element🖨️

Add an element from up the map in your CA Endevor to your Git repository.

Usage

zowe endevor-bridge-for-git mapping add-element <context> <mapping> [options]

Positional Arguments

• context (string)

  • Git-Endevor mapping context (ID of the organization, project, team or owner of the Git repository).

• mapping (string)

  • Git-Endevor mapping name (ID of the Git repository).

Options

• --element-name | --name (string)

  • The name of the CA Endevor element you want to add.

• --element-type | --type (string)

  • The type of the CA Endevor element you want to add

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

  • The CA Endevor system where your element resides.

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

  • The CA Endevor subsystem where your element resides.

• --withDependencies (boolean)

  • If specified, the requested element will be added with dependencies (eg. COBOL copybooks).

    Default value: false

• --force-get-dependencies | --force (boolean)

  • If specified, the maximum number of dependencies will be bypassed. This only applies to the repository administrator.

    Default value: false

• --validate (boolean)

  • If specified, the requested elements will be validated against CA Endevor.

    Default value: false

• --branchId (string)

  • If specified, the requested elements will be added to the selected branch.

• --all-branches (boolean)

  • If specified, the requested elements will be added to all synchronized branches in your repository.

    Default value: false

• --file | --fn (local file path)

  • If specified, the elements to add will be read from file. Make sure that the file is in the correct format as specified in the documentation.

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

CA Endevor Bridge for Git connection options (alternatively use an 'ebg' profile)

• --protocol | --prot (string)

  • The Endevor Bridge for Git SCM protocol.

    Default value: http

    Allowed values: http, https

• --host | -H (string)

  • The Endevor Bridge for Git hostname.

• --port | -P (number)

  • The Endevor Bridge for Git port.

• --user | -u (string)

  • Endevor Bridge for Git username (your git username).

• --token | -t (string)

  • Git personal access token (it can be obtained from your Git Enterprise Server).

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

  • Reject self-signed certificates.

    Default value: false

Profile Options

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

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

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

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

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

  • Password to authenticate to service on the mainframe.

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

• Add an element 'MY-ELEMENT-TYPE / MY-ELEMENT-NAME' for your mapping 'MY-CONTEXT / MY-MAPPING':

  • zowe endevor-bridge-for-git mapping add-element MY-CONTEXT MY-MAPPING --name MY-ELEMENT-NAME --type MY-ELEMENT-TYPE Copy

• Add multiple elements for your mapping 'MY-CONTEXT / MY-MAPPING' from file:

  • zowe endevor-bridge-for-git mapping add-element MY-CONTEXT MY-MAPPING --fileName MY-FILEPATH.json Copy