Translate page

IFile Transfer.Send Method

Owned by Julio Rios (Unlicensed)
Last updated: Apr 11, 2017
1 min read


Transfers a file from the Windows computer to the mainframe host.

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

Syntax

C#
StatusCode Send(
	string cmdline
)
Visual Basic (Declaration)
Function Send ( _
	cmdline As String _
) As StatusCode
Visual C++
StatusCode Send(
	String^ cmdline
)
JavaScript
function Send(cmdline);


Parameters

cmdline
Type: System...String
SEND 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 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 SEND command parameters that you would normally enter at the TSO 'Ready' prompt.

For example, to send the file SALES.RPT from your PC to the CMS file SLS REPRT A on the host session with the short name session ID of "E:"

PC_FILE ID:HOST FILE NAME (OPTIONS

SALES.RPT E:SLS REPRT A (ASCII CRLF

Examples

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

C#

string cmdline = @"sales.rpt E:SLS REPORT (ASCII CRLR";
StatusCode code = Send(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.