For those of you who are starting your plug-in migration to RDi 7.5, here
are some starting points. Feel free to ask questions :)
As you're likely aware, RDi 7.5 moved from using an older internal version
of the RSE framework to using the one we open sourced on eclipse.org. The
open source framework goes by the name "Target Management" (
http://www.eclipse.org/dsdp/tm). This includes everything except the i5/OS
specific pieces (with are still IBM private).
Consequently we renamed the packages and re-structured the code a bit. For
7.5 we took the opportunity to also improve the i5/OS pieces since we need
to port them from the internal RSE framework to the open source framework.
You might want to start by reading the open RSE Programmers Guide:
http://dsdp.eclipse.org/help/latest/topic/org.eclipse.rse.doc.isv/guide/rse_int.html
Here are some high level pointers to get you started. Feel free to ask
additional questions as you go:
1. Everything that used to be com.ibm.etools.systems.... (the non-i5/OS
pieces) is now org.eclipse.rse....., the main plug-ins to start with are:
org.eclipse.rse.core and org.eclipse.rse.ui. You will likely want to
download the open RSE source to your workspace to look at examples and
debug it:
http://www.eclipse.org/dsdp/tm/development/cvs_setup.php (we are
using the 3.0.1 branch).
2. SystemConnection is now IHost.
3. We also changed our plug-in structure for i5/OS plugins. Here are the
main plug-ins now:
com.ibm.etools.iseries.debug
com.ibm.etools.iseries.edit
com.ibm.etools.iseries.rse.ui
com.ibm.etools.iseries.subsystems.ifs
com.ibm.etools.iseries.subsystems.qsys
com.ibm.etools.iseries.services.ifs
com.ibm.etools.iseries.services.qsys
com.ibm.etools.iseries.connectorservice
com.ibm.etools.iseries.toolbox (this didn't change from 7.1)
I've got them roughly listed in their plug-in hierarchy. The open RSE
defines (suggests?) an architecture of using a services layer that is
independent of any "RSE connection" and could be used without a connection
(these are not Web services). Subsystems use services to perform the work,
but are specific to a subsystem. Subsystems use a connector service to
manage the remote connection. Our subsystems (QSYSObjectSubSystem,
QSYSJobSubSystem, QSYSCommandSubSystem, IFSFileServiceSubSystem, and
Qshell (we reuse the open RSE subsystem for this) all use the
com.ibm.etools.iseries.connectorservice.ToolboxConnectorService connector
service which manages a Toolbox (AS400) connection.
4. ISeriesConnection is now com.ibm.etools.iseries.subsystems.qsys.api
.IBMiConnection
5. We don't use the "DataStore" and "DataElements" anymore, and instead
have proper model objects with interfaces like IQSYSObject, IQSYSProgram,
IQSYSMember, etc.. You can find these all in the
com.ibm.etools.iseries.services.qsys.api package, here is the list:
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSCommand.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDatabaseField.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDatabaseFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDatabaseFileRecordFormat.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDataFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDataMember.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDDMFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDeviceFileRecordFormat.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSDisplayFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSFactory.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSFileField.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSFileFieldFactory.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSFileRecordFormat.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSFileRecordFormatFactory.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSJob.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSJobDefinitionProperties.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSJobFactory.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSJobInternationalProperties.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSJobRunProperties.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSJobStatusProperties.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSLibrary.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSLogicalFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSMember.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSMessageDescription.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSMessageFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSModule.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSObject.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSPhysicalFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSPrinterFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSProcedure.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSProgram.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSProgramBase.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSResource.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSSaveFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSServiceProgram.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSSourceFile.java
/com.ibm.etools.iseries.services.qsys/src/com/ibm/etools/iseries/services/qsys/api/IQSYSSourceMember.java
6. There isn't a specific RSE popup menu extension point anymore. Use the
org.eclipse.ui.popupMenu extension point:
http://help.eclipse.org/ganymede/topic/org.eclipse.platform.doc.isv/reference/extension-points/org_eclipse_ui_popupMenus.html
Or the newer org.eclipse.ui.menus one:
http://help.eclipse.org/ganymede/topic/org.eclipse.platform.doc.isv/reference/extension-points/org_eclipse_ui_menus.html
I'm sure there are other things I should be adding here, but this should
get you started.
Don Yantzi
Technical Lead
Rational Developer for System i
IBM Toronto Lab
midrange.com
