swirl
Guide to OmniMark 7   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
 
 

FTPConnection

 

 

The FTPConnection OMX component allows you to create a connection to an FTP server. Once that connection is made, you can send data to and retrieve data from the FTP server.

The OmniMark FTP dynamic link library file ("omftp.dll" or "omftp.so") creates the FTPConnection OMX component. The related include file ("omftp.xin") defines the interface to that component. To use FTPConnection OMX components in your program, you must include the following declaration and include statement in your program:

     include "omftp.xin"

Within your program, you can create as many instances of the FTPConnection OMX component as you require by declaring global and local variables of type "FTPConnection". For example:

     include "omftp.xin"

     global FTPConnection my-ftp-1
     global FTPConnection my-ftp-2

     process
        local FTPConnection my-ftp-3
        local FTPConnection my-ftp-4

Once you have declared your FTPConnection OMX variables, you can use them in the FTPConnectionOpen function from the OmniMark FTP library to create connections to FTP servers. For example:

     include "omftp.xin"

     process
        local FTPConnection my-ftp-connection

        set my-ftp-connection to FTPConnectionOpen server   "banzai.com"
                                                   user     "buckaroo"
                                                   password "watermelon"

Assuming that no errors occur when establishing the connection to the FTP server, you can now send data to and receive data through the connection by using the other functions in the OmniMark FTP library.

The FTPConnection OMX component is not copyable. This means that when you set the value of one FTPConnection OMX variable to the value of another FTPConnection OMX variable, you end up with two variables pointing at the same external object. You are able to manipulate both variables, but you are performing those manipulations on the same FTP connection, whether you use the original FTPConnection OMX variable or its copy.

   
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]

OmniMark 7.1.2 Documentation Generated: June 28, 2005 at 5:45:15 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © Stilo Corporation, 1988-2005.