| Table of Contents |
|---|
| Note | ||
|---|---|---|
| ||
Nach Fertigstellung muss diese Seite in das Produkt-Wiki verschoben werden |
What can TIM do for you?
TIM is a piece of software on your IBM i designed to make installing and keeping up-to-date of Toolmaker's software on your IBM i as simple and easy as it is on your smartphone.
...
The main menu lets you execute all tasks with and for TIM. (On a German system you would GO TIM).
The most important options here are:
...
Of course, when the product is not yet installed on your IBM i, you need an INSTALL_PRODUCT, too.
Start the INSTALL_PRODUCT order
Use option 2 (or F11 from the TIM Status Screen) and select INSTALL_PRODUCT to start the installation of a new product or a major update:
TIM will download the most current info files and let you select one:
Now, TIM downloads some documentation that might be handy.
Finally you are asked when to install the software:
When you select option 3=Immediately, nothing will happen, because you haven't started the subsystem yet (Option 26 from TIM's main menu)TIM will start installing (or updating) the software right away. In this case you must make sure that none of the software's resources are blocked, i.e. by a user using it.
When you select option 1 or 2 and start the subsystem, TIM will download the files that it needs for the installation immediately but wait with delay the actual installation until the time that you give.
| Note | ||||
|---|---|---|---|---|
| ||||
Remember: regardless of the option you use, you must start the TIM subsystem. As long as the subsystem is inactive, nothing will happen. |
Now, take a look at option 1 of go back to TIM's main menu :
...
and select option 1=Display status TIM
You will find your order in status "NEW" but in the lower section the three "Current Work" lines are yet empty.
Also, TIM informs you in the upper part that "The sub system TMSTIM is not started". So, we need to start the subsystem.
Start the TIM subsystem ("TMSTIM")
In order to do this go back to TIM's main menu and select option 26:
This will start the subsystem and TIM will start working.
Now, select option 1 again to get back into the status display.
Now the message in the upper sections says SBS TIM is active, which is, what we want:
First, the still is no activity to be observed in the lower Current Work section. Please be patient.
After a couple of minutes press F5.
If you have waited long enough, you will see some activity go on. If not, wait longer and press F5 again.
Now the Remark column has gone to -active- and in the lower section you see that the activity has started.
By pressing F5 every now and then you will see changes in this progress information.
- Phase 1 - Product Check running
- Restore of objects
- Migration of objects
- ...
- Phase 2 - Installation is in process
- Checking locks
In "real life" you will probably leave TIM alone at this state and come back after a while to look at the results.
Installation complete
When the installation finishes completely then the status display will show this (this screenshot has been taken after a different installation, so please do not worry about the product name differing from the previous screen shots):
- The status of each of the orders has gone to FINISHED
- The Remark has gone to REMOVE active. This means that you can now remove the order (TIM will not do that automatically) any time that it suits you.
| Note | ||||
|---|---|---|---|---|
| ||||
As long as the order is not removed you can do a rollback to go back to the previous version. The order RECOVER_PRODINSTALL will accomplish this. So you will probably wait a couple of days before you remove an order, to make sure that the new version works satisfactorily. |
This completes a normal installation:
- fresh installation of a product that was not installed on your IBM i before
- update installation of a new version, for example
- 4.28 → 5.00
- 5.50 → 5.51
Next we will look at the installation of a PTF, like: 5.51.01 → 5.51.02
Installing a PTF (i.e. 5.51.01 → 5.51.02)
Installing a PTF for an existing installation is basically the same as installing a product. You only use the order type INSTALL_PTF instead of INSTALL_PRODUCT.
You start from TIMs main menu. Then you can either start the order directly with option 2-Create TIM order, or you can go to the status display and start the order using F11.
In this example we choose to go via the status display: select option 1-Display status TIM of the main menu (GO TIMENG)
This will take you to TIM's status display:
Press F11 to start the new order:
Select INSTALL_PTF from the list of options:
From the list of software products select the product for which you want (or have been told by Hotline) to install the PTF:
In this example we select INFOSTA, because at the time that this document is written, this system (DEAET03) is in need for a PTF for the Infostore App. This must not necessarily be true for your system.
From the list of available PTFs select the one desired:
You can now see that the system downloads some documentation
The next steps are identical with the ones for a PRODUCT_INSTALL.
You choose when to install (immediately, at a given time, hold until started) - and then you start the subsystem (if not started yet)
After some minutes you will see that TIM starts working:
And when the PTF-installation is completed it will show this accordingly:
This completes the PTF-Installation. You may remove the order by issuing a REMOVE_ORDER for this order.
| Note | ||||
|---|---|---|---|---|
| ||||
As long as the order is not removed you can do a rollback to go back to the previous version. The order RECOVER_PTF will accomplish this. So you will probably wait a couple of days before you remove an order, to make sure that the new version works satisfactorily. |
Dealing with issues
What happens, when someone is using the software during installation?
During installation noone can/should use the software, because there are objects that need to be exchanged/deleted, etc. So TIM checks whether any of the objects are in use and if so, tells you about it.
It quits all activity and tells you to press F10 for more information:
Press F10 and see, what's the problem:
TIM will inform you in the Errorcode-column of the nature of the issue that caused the interruption.
There are various different Errorcodes, in this case it is ERR_INUSE, which means that there is still job hanging on to objects that need replacement, etc.