Creating z/OS component version using the v2 package format#

Starting with HCL™ Launch version 7.0.5, you can create IBM z/OS® component versions from a new package version called version 2 or v2. You can create v2 component versions using the command.

Currently, the artifacts are compressed at the partitioned data set (PDS) level and stored as binary files in Codestation, Nexus, or Artifactory. This condition makes HCL Launch z/OS versions unique because distributed systems packages are stored at the artifact level and not at the folder level.

The cp command is enhanced in USS to provide a way to copy artifacts to and from MVS without losing meta relations like ALIAS. The HCL Launch v2 package format utilizes the enhanced cp command to package versions as-is and store them in Codestation, Nexus, or Artifactory.

You can benefit from several advantages by using the v2 package format:


You can create component versions from the v2 package by using either of these methods:

For example, use either of the following commands to create a new component version in the CICSModules component: createzosversion2 -c CICSModules -v fixbug100 -s /u/ucduser/build/shiplist.xml createzosversion -zpv v2 -c CICSModules -v fixbug100 -s /u/ucduser/build/shiplist.xml


The buztool properties file#

Copying files from MVS to USS and back requires that you know the content type of the artifact. HCL Launch must determine whether the artifact is an executable file (like a loadlib file) or a binary file (like a DBRM file), or a text file (like a COBOL program). To do this, a property file must be passed as input to the buztool command with the -prop <property-file> parameter. This file contains the deployType to copyType mapping. Any number of unique deploy types can be mapped to any of the copy types: load, binary, or text. Deploy types must be prefixed with the deploytype parameter. Uncomment the parameters you want to use. Below is an example of the buztool properties file:

# This property file contains Deploy Type and Copy Type mappings.
# Deploytypes must be prefixed with "deploytype."
# Example:
# -------
# If deployType is "CICSDBRM", a BINARY dataset then add entry as below
# deploytype.CICSDBRM=BINARY
# If deployType is "CICSLOAD", an EXECUTABLE then add entry as below
# deploytype.CICSLOAD=EXEC
# If deployType is "CICSLIB", a TEXT dataset then add entry as below
# deploytype.CICSLIB=TEXT
# * Property file will have below entries.
#  Add deploytypes to the list as needed.
# ----
# * DeployType is unique in the property file i.e., each deployType is
#   assigned to only one copyType.
# * All the lines in the properties file starting with "#" are comments
#   and can be kept as is for reference.

Parent topic: Creating z/OS component versions