CosFileTransfer_FileTransferSession(3erl)		     Erlang Module Definition			 CosFileTransfer_FileTransferSession(3erl)

NAME

       CosFileTransfer_FileTransferSession - This module implements the OMG CosFileTransfer::FileTransferSession interface.

DESCRIPTION

       To get access to the record definitions for the structures use:
       -include_lib("cosFileTransfer/include/*.hrl").

EXPORTS

       '_get_protocols_supported'(FTS) -> Return

	      Types  FTS = #objref
		     Return = [#'CosFileTransfer_ProtocolSupport'{protocol_name=Type, addresses=[Address]}]
		     Type = Address = string()

	      This read only attribute returns the protocols supported by the target object.

       set_directory(FTS, Directory) -> Return

	      Types  FTS = Directory = #objref
		     Return = ok | {'EXCEPTION, E}

	      Invoking	this  operation  will change the current working directory of the target object's associated file system. If fail to do so
	      the appropriate exception is raised.

       create_file(FTS, FileNameList) -> Return

	      Types  FTS = #objref
		     FileNameList = [string()]
		     Return = File | {'EXCEPTION, E}
		     File = #objref

	      This operation creates a File Object representing a file which may or may not exist. For this operation to  be  independent  of  the
	      working directory the supplied FileNameList must represent the absolute name.

       create_directory(FTS, FileNameList) -> Return

	      Types  FTS = #objref
		     FileNameList = [string()]
		     Return = Directory | {'EXCEPTION, E}
		     Directory = #objref

	      This operation creates a new directory in the target objects associated file systems domain. If fail to do so an exception is raised
	      but, if successful, a Directory object representing the new directory is returned.

       get_file(FTS, FileNameList) -> Return

	      Types  FTS = #objref
		     FileNameList = [string()]
		     Return = FileWrapper | {'EXCEPTION, E}
		     FileWrapper = #'CosFileTransfer_FileWrapper'{the_file = File file_type = Type}
		     File = #objref
		     Type = nfile | ndirectory

	      This operation, creates a FileWrapper which represents a file or directory, and should be  independent  of  the  working	Directory,
	      i.e., a full path name must be supplied. Furthermore, the file or directory represented by the FileNameList must exist.

       delete(FTS, File) -> Return

	      Types  FTS = File = #objref
		     Return = ok | {'EXCEPTION', E}

	      This  operation removes the file or directory, represented by the File object, from the target objects associated file system. If it
	      is a non-empty directory or non-existing file or directory an exception is raised.

       transfer(FTS, SourceFile, DestinationFile) -> Return

	      Types  FTS = SourceFile = DestinationFile = #objref
		     Return = ok | {'EXCEPTION', E}

	      If the target object's and the DestinationFile's associated FileTransferSession's support the same protocol(s) this  operation  will
	      copy  the file represented by the SourceFile from the target object's file system to a file in the destination FileTransferSession's
	      file system. The file is represented by the DestinationFile object and may not exist. This operation must be invoked  on	the  File-
	      TransferSession associated with the SourceFile object.

       append(FTS, SourceFile, DestinationFile) -> Return

	      Types  FTS = SourceFile = DestinationFile = #objref
		     Return = ok | {'EXCEPTION', E}

	      This operation behaves almost like the transfer/3 operation. The difference is that the DestinationFile must exist since the Source-
	      File will be appended to the DestinationFile .

	      Currently, it is not possible to use this operation when the target object represents FTP.

       insert(FTS, SourceFile, DestinationFile, Offset) -> Return

	      Types  FTS = SourceFile = DestinationFile = #objref
		     Offset = long()
		     Return = ok | {'EXCEPTION', E}

	      This operation behaves almost like the append/3 operation. The difference is that the SourceFile will be inserted into the  Destina-
	      tionFile Offset bytes from the start of the file.

	      Currently, it is not possible to use this operation when the target object represents FTP.

       logout(FTS) -> ok

	      Types  FTS = #objref

	      This operation terminates the target object and closes the connection to the file system it represents.

Ericsson AB						      cosFileTransfer 1.1.10			 CosFileTransfer_FileTransferSession(3erl)