InfoConnect for Unisys
Attachmate.Reflection.Emulation.IbmHosts Namespace / IFileTransfer Interface / Xfr400StartRecord Property


In This Topic
    Xfr400StartRecord Property
    In This Topic
    Use this property to skip a given number of records at the start of a file before sending the file to the AS/400.
    Syntax
    'Declaration
     
    
    Property Xfr400StartRecord As Integer
    'Usage
     
    
    Dim instance As IFileTransfer
    Dim value As Integer
     
    instance.Xfr400StartRecord = value
     
    value = instance.Xfr400StartRecord
    int Xfr400StartRecord {get; set;}

    Property Value

    The range of values is 1-32768. The default is 1, which means the entire file is sent to the host. Specifying 2 means that the first record in the file will be skipped (not sent to the host), and so on.

    For example, if you have an Excel spreadsheet that contains header information in the first line, you can skip this line before transferring this file. Changing this property from the default (1) is especially useful if this header information causes a problem for an AS/400 program that analyzes the uploaded data.

    Exceptions
    ExceptionDescription
    This exception is thrown when you modify an InfoConnect property that has been secured via the Permissions Manager, or if such a modification requires Administrator privileges.
    Thrown if the set parameter is outside the range of valid values.
    Remarks

    If you transfer a file to the AS/400 and then later attempt to transfer that same file to the AS/400 while specifying a start record greater than the number of records contained in it, the transfer will fail and the original file is preserved on the AS/400.

    This property affects AS/400 data transfer and is only relevant for 5250 sessions.

    See Also