Rational Developer for System z - enabling a full CICS Explorer experience
JoeWinchester 110000DQA0 Comments (3) Visits (5123)
This blog entry is about how to surface the full CICS Explorer experience inside RD/z 8.0.3. You can do this by adding the lin
to the eclipse.ini file used to launch RD/z, making sure it's after the -vmargs line.
If you're using a language other than English, Simplified Chinese, or Japanese, the extra bits that you surfaced such as CICS definitions are not going to be translated as we only supply three languages (i.e. not German, French, etc...)
This was going to be my shortest ever blog entry, so if you're good with that information then instead of reading the rest of this entry you can power up RD/z, see the CICS SM perspective with the full list of definitions, see the operations menu, see the CICS SM Administration perspective. Go have fun being a power RD/z CICS Explorer user and make yourself a cup of tea/coffee/hot chocolate with the time you saved reading the rest of this blog.
If you're reading this bit then you want to know a bit more, in which case I commend you, however don't blame me if by the time you get to your favourite coffee/tea shop it's closed. Having the full CICS Explorer inside RD/z is so powerful I wouldn't blame you for working right through lunch and dinner.
Enough chit chat and jibber jabber Joe - st
The CICS Explorer is based around the Eclipse framework, which amongst other things, allows plugins created by different folks to be aggregated together to form an integrated workbench. We, IBM, use this to deliver value in plugins for our tools which you can install into the CICS Explorer and through new perspectives, views, wizards, and menu options, can perform tasks such as threadsafe analysis, problem determination, and so forth.
Rational Developer for System z for Java (RD/z) is another really great IBM product which lets developers write application code for z/OS runtimes, including CICS, with powerful source code editors, compilers, debuggers, and a huge list of features that you really need to take a look at if you haven't already seen already.
When we first started developing the CICS Explorer it made a lot of sense to include it with RD/z. Both are built using Eclipse technology so it's fairly easy to do. We talked to a number of users at the time though who were a little worried about the power of the CICS Explorer, which lets you create definitions in a CSD, install them into a region, kill tasks - the stuff system programmers like doing - being available to developers. We also got feedback that the CICS Explorer contains a lot of resources and that some of those resources have a lot of attributes which aren't really that interesting to application developers. What RD/z users wanted was to not have any access to the CSD (or CPSM DREP for BAS customers) and instead have a way to create requests for definitions that a system programmer would action to create the real definition "I'd like a program definition but it's up to you to create the name, just make sure it always run on the QR TCB".
RD/z therefore themes the CICS Explorer for application developers. There are no views for definitions, as developers should create these using the Application Deployment Manager (ADM) component which is the "Hey sysprog - I need 10 of these", although the ability to connect to a region is still available, it's restricted to just those resources that make sense to developers, so there's no TCP/IP services or MQ Connection Statistics for example. There is no definitions menu, there is no CICS SM perspective (which only makes sense if you want to fiddle about with how your CICSPlex is defined, something developers don't really do in their day job), and the CICS operations menu is a subset of everything the raw CICS explorer includes.
This works great, until one of two things happen. Either the developer using RD/z is the person who is also the system programmer, or until a tool, such as a CICS or Problem Determination tool, is installed into RD/z which needs some of the CICS Explorer hidden in RD/z.
To surface the full CICS Explorer experience inside RD/z 8.0.3, you need to add some lines into the eclipse.ini file in the folder where the eclipse.exe was installed. On my PC my shortcut for RD/z points to C:\Program Files (x86
The line to add to the file is
Once you've put the line there, RD/z now has a full operations menu on the CICS SM perspective for all resources as well as the definitions menu, and there is the CICS SM Administration perspective.
Back to the .ini file - if you were paying attention, you'll have noticed that as well as the sm.u
Note that the reason we don't enable these by default is different to the reason we don't enable the CICS Expl
Also note, if you are using a language other than US English, Simplified Chinese, or Japanese, and you enable the full CICS Explorer or the z/OS pieces, then these are not going to be translated. RD/z translates into more languages than the CICS Explorer so if, for example, you're a German user (Guten Tag meine deutschen Freunde), then all the other bits of RD/z are going to be in German except for the CICS Explorer bits that you surfaced by hacking your .ini file.