IBM® z/OS® directories and data sets

To deploy applications to an IBM® z/OS® environment, the user accounts on the agent computer must have adequate access permissions. You must also identify specific directories and data sets to the authorized program facility.

The agent user account must have access to the following UNIX™ directories and files, and MVS™ data sets.

The access permissions are set up when you install the agent. If you use a different user account to run the agent, the access permissions must be set correctly for that account.

Table 1. Agent user account permissions
Directories, files, and data sets Required access permissions
The /tmp directory or the agent/var/temp directory. RW
The agent/conf directory RW
The agent/var/work directory. RW
The agent/var/repository directory. The directory to store artifacts in CodeStation. R
The agent/var/deploy directory. The directory where backup data and deployment results are stored . RW
The agent/var/log/ispf directory. The directory where ISPF gateway log files are stored. RW
The agent/var/log/ispf/WORKAREA directory. The directory where ISPF gateway stores work files during execution RW
The HLQ.SBUZAUTH, HLQ.SBUZEXEC, HLQ.SBUZMENU, and HLQ.SBUZSAMP data sets R
The user account that runs buztool.sh must have access to the following UNIX directories and files, and MVS data sets.
Table 2. Deployment tools user account permissions
Directories, files, and data sets Required access permissions
The agent/var/repository directory. The directory to store artifacts in CodeStation. RW
The agent/var/log/ispf directory. The directory where ISPF gateway log files are stored RW
The HLQ.SBUZAUTH, HLQ.SBUZEXEC, HLQ.SBUZMENU, and HLQ.SBUZSAMP data sets R
The agent/conf/agent directory. RW

Changing ownership to Started Task ID

After an agent is installed, the owner of agent directories and files is changed to a Started Task ID. Modify the group of agent directories and files such that all the user IDs of the group are allowed to create z/OS component versions.

To change owner and group, chown and chgrp can be used respectively on the agent directory and applied recursively.