(PowerShell) Co:Z SFTP Binary File Download (from z/OS IBM Mainframe)

Demonstrates how to download a binary file, such as a .zip, from a Co:Z SFTP server on a z/OS IBM Mainframe.

Note: This requires Chilkat v9.5.0.76 or greater.

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

$sftp = New-Object Chilkat.SFtp

# Connect to the SSH server.  
$hostname = "sftp.example.com"
$port = 22
$success = $sftp.Connect($hostname,$port)
if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

$success = $sftp.AuthenticatePw("myLogin","myPassword")
if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

$success = $sftp.InitializeSftp()
if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

# To download a binary file from the Co:Z SFTP server, 
# we must switch to binary mode in the following unconventional way.
# We pretend to fetch a directory listing for "/+mode=binary"
# This has the effect of putting the server in binary mode for transfers.
$handle = $sftp.OpenDir("/+mode=binary")
if ($sftp.LastMethodSuccess -ne $true) {
    $($sftp.LastErrorText)
    exit
}

# Download the "directory listing" (but it's not actually a directory listing, and we'll just discard it.)
$dirListing = $sftp.ReadDir($handle)
if ($sftp.LastMethodSuccess -ne $true) {
    $($sftp.LastErrorText)
    exit
}

# Close the directory handle:
$success = $sftp.CloseHandle($handle)
if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

# Download the binary file:
$localFilePath = "c:/temp/test.zip"
$remoteFilePath = "test.zip"
$success = $sftp.DownloadFileByName($remoteFilePath,$localFilePath)
if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

$("Success.")