Skip to main content
Delphix

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