Deprecated

NOTE: These releases are deprecated in favor of the metaport releases: https://github.com/ZOSOpenTools/metaport/releases

Getting the new zopen package manager onto your z/OS system

Changes in this release:

• zopen now includes usage analytics: https://zosopentools.github.io/meta/#/Guides/Analytics
• Various fixes:
  • zopen install --select and --all were broken and now functional
  • zopen install can now report package caveats at the end of the install: #693

Getting Started

Use the quick start guide.

v0.8.1 - zopen package manager

Getting the new zopen package manager onto your z/OS system

Changes in this release:

• zopen upgrade meta will now automatically refresh your zopen-config.
• zopen init --re-init will now default to your $ZOPEN_ROOTFS file system location
• Several zopen man pages have been updated and also available online here
• The kill no such process message is now fixed
• Several issues fixed related to zopen query, zopen list and zopen clean
• Updates to the zopen release JSON API, zopen_releases.json
  • Use ETag vs Last modified to check if zopen_releases.json is updated
  • Domain to remote json changed from http://zosopentools.github.io/ to raw.githubusercontent.com
• and much more!

Getting Started

Note: In the documentation that follows, text inside < ... > indicates a value you need to provide, e.g. <z/OS system> would be replaced with the name of the z/OS system you are using.

To get started, you need to get the meta-0.8.1.pax.Z to your z/OS system. Here is one approach:

• log on to your desktop system
• download the meta-0.8.1.pax.Z file by clicking on the file in the assets below
• open a terminal window on your desktop
• cd into the directory you downloaded the file to
• sftp <z/OS system>
• log in if required
• put meta-0.8.1.pax.Z
• quit

Setting up your environment

The following environment variables are required:

export _BPXK_AUTOCVT=ON
export _CEE_RUNOPTS="$_CEE_RUNOPTS FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)"
export _TAG_REDIR_ERR=txt
export _TAG_REDIR_IN=txt
export _TAG_REDIR_OUT=txt

Also, make sure the character device $SSH_TTY is untagged or you may experience unexpected behaviour. Run chtag -r $SSH_TTY to remove any tags.

Installing

• ssh <z/OS system> or enter tso omvs if running under ISPF from any ISPF panel command field.
• cd into the directory you transferred the pax.Z file to
• pax -rf meta-0.8.1.pax.Z # extract the pax
• After this step, you may delete the meta-0.8.1.pax.Z file
• cd meta-0.8.1
• . ./.env
• zopen init # Follow the instructions. If you are installing to an existing zopen location, specify it in the prompt
• You can now safely remove meta-0.8.1.pax.Z and the meta-0.8.1 directory
• Source the .zopen-config, using the dot (.) operator, as instructed in the last line from the zopen init output.
• zopen list # list the available tools, this will list 100+ tools available under z/OS Open Tools
• zopen install git

Upgrading zopen

• You can use zopen upgrade to upgrade meta
• zopen upgrade meta

v0.8.0 - Introducing the new zopen package manager

UPDATE: New zopen framework is now available!

Getting the new zopen package manager onto your z/OS system

Note: In the documentation that follows, text inside < ... > indicates a value you need to provide, e.g. <z/OS system> would be replaced with the name of the z/OS system you are using.

To get started, you need to get the meta-0.8.0.pax.Z to your z/OS system. Here is one approach:

• log on to your desktop system
• download the meta-0.8.0.pax.Z file by clicking on the file in the assets below
• open a terminal window on your desktop
• cd into the directory you downloaded the file to
• sftp <z/OS system>
• log in if required
• put meta-0.8.0.pax.Z
• quit

Setting up your environment

The following environment variables are required:

export _BPXK_AUTOCVT=ON
export _CEE_RUNOPTS="$_CEE_RUNOPTS FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)"
export _TAG_REDIR_ERR=txt
export _TAG_REDIR_IN=txt
export _TAG_REDIR_OUT=txt

Also, make sure the character device /dev/tty is untagged or you may experience unexpected behaviour. Run chtag -r /dev/tty to remove any tags.

Installing

• ssh <z/OS system> or enter tso omvs if running under ISPF from any ISPF panel command field.
• cd into the directory you transferred the pax.Z file to
• pax -rf meta-0.8.0.pax.Z # extract the pax
• After this step, you may delete the meta-0.8.0.pax.Z file
• cd meta-0.8.0
• . ./.env
• zopen init # Follow the instructions. If you are installing to an existing zopen location, specify it in the prompt
• Source the .zopen-config, using the dot (.) operator, as instructed in the last line from the zopen init output.
• zopen list # list the available tools, this will list 100+ tools available under z/OS Open Tools
• zopen install git

Upgrading zopen

• You can use zopen upgrade to upgrade meta
• zopen upgrade meta # Note: if you have an older version of meta, you will need to remove the .pinned file from your zopen file system: find $zopen_rootfs -name ".pinned", then remove the .pinned entries.

v1.0.0-deprecated (this is the now deprecated zopen-setup)

Setting up your z/OS Open Tools environment

Getting zopen-setup.sh to your z/OS system

Note: In the documentation that follows, text inside < ... > indicates a value you need to provide, e.g. <z/OS system> would be replaced with the name of the z/OS system you are using.

To get started, you need to get the zopen-setup program to your z/OS system. Here is one approach:

• log on to your desktop system
• download the zopen-setup file by clicking on the file in the assets below
• open a terminal window on your desktop
• cd into the directory you downloaded the file to
• sftp <z/OS system>
• log in if required
• put zopen-setup
• quit
• ssh <z/OS system>
• log in if required
• cd $HOME
• chmod u+x zopen-setup # mark the program executable

If you don't have ssh, scp, sftp access to your z/OS system, we would encourage you to set it up.
It will be much easier to work with USS using ssh, scp, and sftp.

Running zopen-setup

• cd $HOME
• mkdir <directory>
• export ZOPEN_GITHUB_OAUTH_TOKEN to your github personal access token.
• ./zopen-setup <directory> # directory is the location the boot tools will be installed to. It should have at least a few GB of free storage.

Next Steps

You will now have a starter development environment available. To access the starter tools including curl, git, and gzip:

• cd $HOME/zopen/boot
• . ./.bootenv # add meta, curl, git, and gzip to your PATH (don't forget the leading '.' which sources the script)

Downloading Binaries from z/OS Open Tools

Now that you have basic tools on your z/OS system, you can use cURL to download a pax file for the tool you want.

To get the pax file, go to:

• https://github.com/ZOSOpenTools/<package>/tags and click on the tag (release) you want. The top-most is the latest. Some tools have stable versions, e.g. https://github.com/ZOSOpenTools/gitport/releases/tag/stable is the git stable release.
• cd into $HOME/zopen/prod
• Cut and paste the instructions the command to download, unpax, and set up the new tool

If you expect to download a number of different tools, we encourage you to use zopen download. You can learn more from our documentation about the different tools. And - you already have them on your system - they are in the meta package.

Now that you have your development environment, learn more from our documentation