• Overview
  • Documentation
  • Version history

Description

The External Artifact Repository plug-in downloads artifacts from a Nexus or JFrog Artifactory repository into an HCL Deploy z/OS type component.

The zOS External Artifact Utility plug-in includes steps to integrate with external repositories like Nexus or JFrog for zOS. 

This plug-in includes the following steps: 

  • Download Artifacts for zOS External Repo
  • Create a Merged Version for JFrog Artifactory
  • Create a Merged Version for Nexus

Quick Info

Product icon

Product

HCL DevOps Deploy (HCL Launch)
Plugin type icon

Type

plugin
Compatibility icon

Compatibility

HCL Launch version 7.3.2.8 and later, HCL Deploy version 8.0.1.3 and later
created by icon

Created by

HCLSoftware

Published Date

Last Updated

Summary

The External Artifact Repository plugin automates the downloading of z/OS artifacts from a Nexus or JFrog Artifactory repository.

This plugin includes one or more steps, click Steps for step details and properties.

Installation

See Installing plugins in HCL Deploy (Launch) for installing and removing plugins.

Version history details:

Version Notes
13
  • Create a merged version from a given set of versions.
  • Renamed plugin to zOS External Artifacts Utility.
  • Fixes '400:File not found' issue when validating checksum file.
  • Added support for creating a merged version for package format v2.
12 Added support for token for artifactory
11 Added support to verify checksum of component versions
10 Added support to handle AT_TLS configuration for external servers. Fix Jettison Vulnerability Enhancement to Download artifacts without credentials.
9 Minor Improvements and upgraded log4j
8 Added support to run with insecure connection
7 Added support to run this from non zOS agent Minor improvements for new package format
6 Added support to run this from non zOS agent
5 Enhancement to extract files for package format v2
4 Implemented the proxy changes for artifactory server
3 Implemented the api key changes for artifactory server
2 PH20336 - Fixed the default value for extRepoURL and changed the plugin to fail when it is not able to download artifacts
1 Used to download artifacts from external repository like NEXUS/ARTIFACTORY and then we can use Deploy Data Sets step to do zOS deployment.

Usage

Use this plugin to automate downloading of z/OS artifacts from a Nexus Artifactory or JFrog repository to z/OS. The artifacts can then be deployed using the Deploy Dataset step of the zOS Utility plugin.

To create the z/OS component version, use the buztool.sh command from job control language (JCL) or from the z/OS UNIX System Services command line. You must specify the -ar parameter on the command. This parameter provides details about the artifactory needed to upload artifacts. The link from the external artifact repository is stored as a component version property, named extRepoURL. The property is used to download the artifacts.

For additional information, see Creating z/OS component versions in the product documentation.

Step palette

To access this plugin in the palette, click Repositories > Artifact > zOS ExternalArtifactsDownload.

Steps

The following process steps are available in the External Artifact Repository plugin.

Download Artifacts for zOS External Repo

Download a z/OS package from an external artifact repository. The repository can be either a Nexus or Artifactory repository.

Input properties for the Download Artifacts step
Name Type Description Required
Repository URL String The URL of the repository. Yes
User Name String The user name used to authenticate with the repository. Yes
Repository Password String The password used to authenticate with the repository. Yes
Artifactory api key/ Token String The api key used to authenticate with the artifactory repository. No

Create a Merged Version for JFrog Artifactory

Create a merged version for JFrog artifactory from a set of existing versions in external repository

Name Type Description Required
Merged Version Name String Merged Version Name Yes
Component Name String Component Name Yes
Versions To Merge String List of version names to be merged. Separate version names with a newline. Yes
Repository URL String The URL of the external artifact repository. Yes
Repository String Repository name Yes
Repository User Name String Username to be used for authentication. Yes
Repository Password/API Key/Token String Password or API-Key or Token to be used for authentication. Yes

Create a Merged Version for Nexus

Create a merged version for Nexus from a set of existing versions in external repository

Name Type Description Required
Merged Version Name String Merged Version Name Yes
Component Name String Component Name Yes
Versions To Merge String List of version names to be merged. Separate version names with a newline. Yes
Repository URL String The URL of the external artifact repository. Yes
Repository String Repository name Yes
Raw Directory String Raw Directory Yes
Repository User Name String Username to be used for authentication. Yes
Repository Password/API Key/Token String Password or API-Key or Token to be used for authentication. Yes

Hidden input properties:

  • Select the Proxy checkbox to enable proxy connection to artifactory using passed Proxy Host and Port. Proxy does not work for Nexus.
  • Review with your security administrators before allowing insecure connection. The feature is disabled by default.
  • When the USE_ATTLS property is set to TRUE, the plug-in will not handle encryption and relies on the server's AT_TLS to encrypt the network communication with the external repository. The default value is FALSE.

devops-deploy-ExtArtRepo-13.1179643.zip

Uploaded: 01-Aug-2025 11:09

Release Notes:

  • Create a merged version from a given set of versions.
  • Renamed plugin to zOS External Artifacts Utility.
  • Fixes '400:File not found' issue when validating checksum file.
  • Added support for creating a merged version for package format v2.

devops-deploy-ExtArtRepo-13.1178924.zip

Uploaded: 07-Jul-2025 07:33

Release Notes:

  • Create a merged version from a given set of versions.
  • Renamed plugin to zOS External Artifacts Utility.
  • Fixed '400:File not found' issue when validating checksum file

launch-extartrepo-12.1176020.zip

Uploaded: 28-Apr-2025 12:14

Release Notes:

  • Added support for token for artifactory.

launch-extartrepo-12.1174510.zip

Uploaded: 28-Mar-2025 08:09

launch-extartrepo-10.1162509.zip

Uploaded: 11-Oct-2023 16:04

launch-extartrepo-9.1140093.zip

Uploaded: 19-Aug-2022 09:50

Release Notes:

  • Minor Improvements and upgraded log4j.

launch-extartrepo-8.1101664.zip

Uploaded: 11-Mar-2021 09:55

Release Notes:

  • Added support to run with insecure connection.

Related Plugins