Reflection
Xfr400StartRecord Property


Attachmate.Reflection.Emulation.IbmHosts Assembly > Attachmate.Reflection.Emulation.IbmHosts Namespace > IFileTransfer Interface : Xfr400StartRecord Property
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
Attachmate.Reflection.SecuredSettingException This exception is thrown when you modify a Reflection property that has been secured via the Permissions Manager, or if such a modification requires Administrator privileges.
System.ArgumentOutOfRangeException 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