Masking engine and HFS dataset support (KBA8136)
KBA
KBA# 8136
Issue
The Masking engine is unable to access HFS datasets on a mainframe system (z/OS).
Prerequisites
Masking engine, mainframe with FTP/SFTP access
Applicable Delphix Versions
- Click here to view the versions of the Delphix engine to which this article applies
-
Major Release All Sub Releases 6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.2.1, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.6.1, 6.0.7.0, 6.0.8.0, 6.0.8.1, 6.0.9.0, 6.0.10.0 5.3
5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0, 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0 5.2
5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1
5.1
5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0
5.0
5.0.1.0, 5.0.1.1, 5.0.2.0, 5.0.2.1, 5.0.2.2, 5.0.2.3, 5.0.3.0, 5.0.3.1, 5.0.4.0, 5.0.4.1, 5.0.5.0, 5.0.5.1, 5.0.5.2, 5.0.5.3, 5.0.5.4
Resolution
The Masking engine is unable to access HFS at this time via FTP/SFTP.
However, it should be possible to access the HFS datasets via NFS, if your mainframe is running the NFS server service:
https://www.ibm.com/docs/en/zos/2.3.0?topic=customization-configuring-zos-nfs-server
Configuring the NFS mount point and connector on the Masking engine:
https://maskingdocs.delphix.com/Connecting_Data/Managing_Remote_Mounts/
Troubleshooting
HFS expects to list the dataset without any leading forward slash ('/').
While you can input just a dataset name in the Masking engine FTP or SFTP connector, testing the connector will fail with a similar stack:
Caused by: org.apache.commons.vfs2.FileSystemException: Expecting / to follow the hostname in URI "ftp://ftp_host:21'HFS_DATASET_NAME'".
Notice the single quotes (') between the HFS dataset name.
Trying to use single or double quotes results in an error similar to the following: Please enter path without special characters.
Using a forward slash fails because the FTP server is unable to locate the HFS dataset.
Related Articles
The following articles may provide more information or related information to this article:
- N/A