Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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..::.StringRECEIVE 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 codeDescription
WHLLPARAMETERERRORParameter error or Data Length is zero or greater than 128.
WHLLFTXCOMPLETEThe file transfer completed (synchronous mode only).
WHLLFTXSEGMENTEDTransfer completed with one or more segmented records (synchronous mode only).
WHLLSYSERRORThe method failed due to a system error.
WHLLTRANSABORTEDThe file transfer was aborted either by the user, or (if a timeout was set with SetSessionOptions(String, Int32%)) because the timeout period expired.
WHLLINVALIDFUNCTIONNUMInvalid function number.
WHLLFILENOTFOUNDPC file not found.
WHLLACCESSDENIEDAccess denied to PC file.
WHLLMEMORYInsufficient memory.
WHLLINVALIDENVIRONMENTInvalid environment.


Remarks

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

...

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.

...