Skip to content

Latest commit

 

History

History
160 lines (96 loc) · 11.3 KB

README.md

File metadata and controls

160 lines (96 loc) · 11.3 KB

BMC AMI DevX Source Code Download

Overview

The Source Code Download extension allows users to download Code Pipeline(ISPW) members from the mainframe to the PC. Source can then be accessed on the PC, for example, for SonarQube analysis and reporting.

Prerequisites

The following are required to use this plugin:

Installing extensions in a Azure Devops Server Instance

Install the BMC AMI DevX Common Configuration extension and BMC AMI DevX Source Code Download extension according to the Azure Devops instructions for installing extensions.

Downloading Code Pipeline Container members

This integration allows downloading of Code Pipeline Container members from the mainframe to the PC.

While creating the new Azure pipeline, we can add a new task "BMC AMI DevX Source Code Download" by clicking + sign on Agent Job.

This BMC AMI DevX Source Code Download task has following parameters:

  • CES URL : Select a URL for Common Enterprise Services (CES). By default it is empty. Please do NOT attach any context path, it should be in the format: http://host:port.

  • Host connection : Select the host connection to be used to connect to the z/OS host.

  • Alternatively, to add a new connection, click on + New. The Host connections section of the Common configuration tab appears so a connection can be added.

  • Runtime configuration : Enter the host runtime configuration. To use the default configuration, leave the field blank.

  • Authentication : Mode of authentication i.e. either CES Token or Certificate based.

  • CES secret token: The available CES secret token to perform Code Pipeline actions for Rest API call. In this field, please pass pipeline variable name which is storing CES secret token as secret in Azure pipeline. Example $(cesToken).

  • Azure Subscription : The Azure Subscription under which Key Vault is created.

  • Key Vault : Name of Key Vault that holds the Certificate for authentication.

  • Certificate Name : Name of the certificate as uploaded in Key Vault. (PFX format is supported)

  • Source Download Location : Path to a directory in CES server to download source.

Do the following in the Filter section to identify Code Pipeline members to be downloaded:

  • Container Type list (do one of the following):

    • Assignment : Select if the specified Container name is an assignment.
    • Release : Select if the specified Container name is a release.
    • Set : Select if the specified Container name is a set.

  • Container Id : Enter the name of the container to target for the download.

  • Component Type : Optionally use to identify components of a specific type to download (such as COB, COPY, or JOB).

  • Level : Optionally use to identify components at a specific level in the life cycle to download (such as DEV1, STG1, or PRD).

  • Force download of unchanged source : Optionally use to indicate that all source matching the current filter should be downloaded, regardless of whether it has been changed recently or not. If this box is left unchecked, it will delete any files in the workspace that no longer match the filter specified above. Leaving it unchecked will also only download source that has been changed since the last time the job was run.

  • Trust all Certificates : This allows you to trust self-signed server certificates. By default set to false.\n>Enabling this is not recommended.

Click Save.

Run the job, which by default the following occurs:

  • Mainframe source is downloaded to the project's or job's workspace into a $(Code_Pipeline_Application)/MF_Source folder.

  • Folder components are downloaded into a $(Code_Pipeline_Application) folder.

  • Source is downloaded on Azure Agent at the Artifact Staging Directory $(Build.ArtifactStagingDirectory).

  • Optionally, to perform SonarQube analysis, install the SonarQube extension and refer to the documentation for the SonarQube extenion.

Downloading Code Pipeline Repository members

This integration allows downloading of Code Pipeline Repository members from the mainframe to the PC.

While creating the new Azure pipeline, we can add a new task "BMC AMI DevX Source Code Download" by clicking + sign on Agent Job.

This BMC AMI DevX Source Code Download task has following parameters:

  • CES URL : Select a URL for Common Enterprise Services (CES). By default it is empty. Please do NOT attach any context path, it should be in the format: http://host:port.

  • Host connection : Select the host connection to be used to connect to the z/OS host.

  • Alternatively, to add a new connection, click on + New. The Host connections section of the Common configuration tab appears so a connection can be added.

  • Runtime configuration : Enter the host runtime configuration. To use the default configuration, leave the field blank.

  • Authentication : Mode of authentication i.e. either CES Token or Certificate based.

  • CES secret token: The available CES secret token to perform Code Pipeline actions for Rest API call. In this field, please pass pipeline variable name which is storing CES secret token as secret in Azure pipeline. Example $(cesToken).

  • Azure Subscription : The Azure Subscription under which Key Vault is created.

  • Key Vault : Name of Key Vault that holds the Certificate for authentication.

  • Certificate Name : Name of the certificate as uploaded in Key Vault. (PFX format is supported)

  • Source Download Location : Path to a directory in CES server to download source.

Do the following in the Filter section to identify Code Pipeline members to be downloaded:

  • Stream : Enter the two- to eight-character code that defines the application structure with which the application is associated.
  • Application : Enter the container's primary application code. Containers may include components from multiple applications.
  • Subapplication : Enter the container's primary subapplication code. Containers may include components from multiple subapplications.
  • Level : Enter the life cycle level.
  • Level option list (do one of the following):
    • Selected level only : Select to display only components at the selected life cycle level in the view.
    • First found in level and above : Select to display the first version found of each component at the selected level and above. In other words, if there are multiple versions in the life cycle, display one version of the component that is the first one found at the selected level and any levels in the path above it.
  • Component types and/or Application root folder names : Optionally use to identify components and application root folders to download.
    • To download a folder that matches the name specified (and all of its contents) and download all components outside of a folder that match the specified type, enter values in both the Component types and Application root folder names fields. Enter in the Component types field the component type (such as COB, COPY, or JOB) on which to filter. Enter in the Application root folder names field the name of the folder on which to filter. For example, entering COB in the Component types field and FolderX in the Application root folder names field will download FolderX and all of its contents, as well as all of the COB files that exist outside of folders.
    • To download all components of a specified type regardless of whether they are within folders, use only the Component types field by entering the component type (such as COB, COPY, or JOB) on which to filter.
    • To download a folder that matches the name specified (and all of its contents), as well as all components that are not within a folder, use only the Application root folder names field by entering the name of the folder on which to filter.
    • To download all components and folders in the application and level selected, leave both fields empty. - To download multiple folders or types, comma-separate the values.
  • Force download of unchanged source : Optionally use to indicate that all source matching the current filter should be downloaded, regardless of whether it has been changed recently or not. If this box is left unchecked, it will delete any files in the workspace that no longer match the filter specified above. Leaving it unchecked will also only download source that has been changed since the last time the job was run.
  • Trust all Certificates : This allows you to trust self-signed server certificates. By default set to false.\n>Enabling this is not recommended.

Click Save.

Run the job, which by default the following occurs:

  • Mainframe source is downloaded to the project's or job's workspace into a $(Code_Pipeline_Application)/MF_Source folder.

  • Folder components are downloaded into a $(Code_Pipeline_Application) folder.

  • Source is downloaded on Azure Agent at the Artifact Staging Directory $(Build.ArtifactStagingDirectory).

  • Optionally, to perform SonarQube analysis, install the SonarQube extnesion and refer to the documentation for the SonarQube extension.

Product Assistance

BMC provides assistance for customers with its documentation, the BMC Support Center web site, and telephone customer support.

BMC Support Center

You can access online information for BMC products via our Support Center site at https://support.bmc.com. Support Center provides access to critical information about your BMC products. You can review frequently asked questions, read or download documentation, access product fixes, or e-mail your questions or comments. The first time you access Support Center, you must register and obtain a password. Registration is free.

Contacting Customer Support

At BMC, we strive to make our products and documentation the best in the industry. Feedback from our customers helps us maintain our quality standards. If you need support services, please obtain the following information before calling BMC's 24-hour telephone support:

  • The Azure pipeline job output that contains any error messages or pertinent information.

  • The name, release number, and build number of your product. This information is displayed in the installed extensions page. Apply filter: BMC in order to display all of the installed BMC extension.

You can contact BMC in one of the following ways:

Web

You can report issues via BMC Support Center: https://support.bmc.com.

Note: Please report all high-priority issues by phone.

Corporate Web Site

To access BMC site on the Web, go to https://www.bmc.com/. The BMC site provides a variety of product and support information.