CADev - CometAnywhere Remote Development
From CometWiki
Contents[hide] |
Overview
CADev consists of a suite of programs that provide a facility for editing and compiling IB programs over a CometAnywhere connection. That is, .IBS source files that previously could only be edited and compiled on a computer hosting Comet can now be edited and compiled remotely across a network or the Internet. This is accomplished by maintaining identical copies of an .IBS source file at both the host and remote computers. When a request is made to compile the remote version of a file, it is first copied back to the host computer and then the appropriate commands are sent to the host computer to compile the file.
Special Considerations
Because CADev will be monitoring all of the files in the "Local Storage Folder" on the remote computer it is necessary that only CADev known files reside in that folder. If new a file is detected by CADev the user will be asked to identify the file so it can be synchronized with the host. This is handy when intentionally adding new files to the program you're working on. This can also be accomplished by right-clicking the "Comet" pane and choosing "Create New File." If CADev detects a new file and you do not designate a corresponding "Comet" file then that file will be deleted from the "Local Storage Folder." A undesired side affect of this behavior is caused when UltraEdit saves changes to a file and renames the original file for backup purposes (<filename>.bak). CADev will think you've added a new file and you will be asked to identify a corresponding Comet file. To avoid this problem we recommend that you configure UltraEdit (Advanced Menu -> File Handling -> Backup) to store backup files in an alternate location.
Using CADev
Using CADev is pretty simple. Log onto the target CometAnywhere host computer and acquire access to the Comet directories required to edit and compile the .IBS source files you wish to work with (see Note below). Now you will run the Comet program CADev (lives in REL) which will launch a surrogate program CADev.exe (a Windows program) on the remote computer. CADev will hide the session window (configurable) and present a new window that will be used to select the host files that will be edited remotely. A one-to-one relationship exists and must be maintained between the CometAnywhere session and CADev program. Therefore if one terminates the other will no longer be usable without reestablishing the connection. Once you exit CADev all files contained in the "Local Storage Folder" will be deleted. Only one CADev session is allowed to run on a CometAnywhere computer at a time.
The CADev window consists of three panes. The left or "Ready" pane contains a list of the files that have been designated for remote editing. Files in this list will be monitored for changes and synchronized as required by UltraEdit. The center or "QDir" pane lists the Comet directories that are currently accessed at the host computer. The third or "Comet" pane contains a list of the text files in the selected Comet directory that are available for remote editing. Double-clicking a file in the Comet pane (or right-clicking and choosing "Prepare to edit") will cause that file to be added to the Ready pane. As each file is added to the Ready pane, it will be copied from the host computer to the remote computer. To view the local copy of files that are currently being maintained by CADev you can click on the "View" menu and choose "View Local Storage."
Once a file has been added to the Ready pane it may be edited with UltraEdit. You can load a file into UltraEdit in any conventional way. The easiest is by simply double-clicking the file in the Ready pane which will cause the file to be loaded into UltraEdit. You may now edit the file as you normally would. When you click the compile button in UltraEdit a command is issued to CADev to copy all modified files back to the host computer in preparation for compilation. Once all files have been copied to the host computer, the appropriate command is issued to Comet to start the compile, returning the results in the output pane of UltraEdit.
CADev provides visual indication of the status of any file listed in the Ready pane. If a file is currently unmodified it will show a green check mark next to it. If a file has been modified it will show a purple triangle next to it. As a file is being copied to or from the host computer it will show a animated arrow pointing in the direction of the copy.
Note: Unlike using UltraEdit locally where Comet sessions are created (and destroyed) on the fly each time a compile command is issued, CADev requires a persistent CometAnywhere session.
System Requirements
Host Computer:
Comet version 2011.451 or higher (Comet32 or Comet16)
CometAnywhere (2 sessions recommended but will work with just 1)
REL version 11.10 or higher
Remote Computer:
CometAnywhere connection to the aforementioned host computer.
UltraEdit® Professional Text Editor