This method transfers a file from the mainframe host to the PC.

Namespace: JollyGiant.Emulation
Assembly: JGSComdotNet (in JGSComdotNet.dll) Version: 1.0.0.0 (1.0.0.0)

Syntax

C#
StatusCode Receive( string cmdline )

Visual Basic (Declaration)
Function Receive ( _ cmdline As String _ ) As StatusCode

Visual C++
StatusCode Receive( String^ cmdline )

JavaScript
function Receive(cmdline);

Parameters

cmdline
Type: System...String
RECEIVE command parameters (see remarks).

Return Value

The StatusCode indicating the result of the operation.

This can be one of the following values:

Status code	Description
WHLLPARAMETERERROR	Parameter error or Data Length is zero or greater than 128.
WHLLFTXCOMPLETE	The file transfer completed (synchronous mode only).
WHLLFTXSEGMENTED	Transfer completed with one or more segmented records (synchronous mode only).
WHLLSYSERROR	The method failed due to a system error.
WHLLTRANSABORTED	The file transfer was aborted either by the user, or (if a timeout was set with SetSessionOptions(String, Int32%)) because the timeout period expired.
WHLLINVALIDFUNCTIONNUM	Invalid function number.
WHLLFILENOTFOUND	PC file not found.
WHLLACCESSDENIED	Access denied to PC file.
WHLLMEMORY	Insufficient memory.
WHLLINVALIDENVIRONMENT	Invalid environment.

Remarks

The 'cmdline' string should contain the RECEIVE command parameters that you would normally enter at the TSO 'ready' prompt.

For example, to send the file SLR REPORT from the CMS host to a file named 'sales.rpt' on your PC, using a session with the ID of "E:"

PC_FILE ID:HOST FILE NAME (OPTIONS

SALES.RPT E:SLS REPORT (ASCII CRLF

Examples

Transfer a file named 'sales.rpt' from the to a CMS file 'SLS REPORT', using a session with ID 'E':

C#

string cmdline = @"sales.rpt E:SLS REPORT (ASCII CRLR";
StatusCode code = Receive(cmdline);
if (code == WHLLFTXCOMPLETE)
{
    // transfer completed successfully
}
else
{
    ReportError(code);
}

See Also

IFileTransfer Interface
JollyGiant.Emulation Namespace

Send comments on this topic to Jolly Giant Software

Copyright 2009 by Jolly Giant Software, Inc.

Browser not supported