When the hrnspset utility is done, the spin process determines how many journal accumulations exist. If the limit is exceeded (default is 3), spin03 uses the hrntlmrg (Journal Merge) utility to merge the journal accumulations, as shown in the following diagram:
Journals must be large enough so they do not fill too often during the day, but they must also be small enough that the contents of a full journal can be saved before the other journal fills up. Experiment to find a good journal size for your system. As a guideline, try sizing your journals to hold about four hours of work (that is, a journal fills up in about four hours under average conditions).
There is a minimum size for journals: the journal should have at least as many pages as there are resident pages defined in the crparm file. Both formatting and opening fail if the journal has fewer pages than the minimum size, as determined by the current value of the RESIDENTPAGES Data Object Broker parameter.
If a journal fills before the other journal is available, the Data Object Broker abends and displays a message indicating that the journal is unavailable.
Upon the restart of the Data Object Broker under this condition, the Data Object Broker reruns the spin job on the journal that is currently active. If the original problem that caused the filling up of the journal is not corrected before restart, the Data Object Broker shuts down again. It is therefore necessary to correct whatever condition caused the other journal to be unavailable before restarting the Data Object Broker. To retain the journal data, spin the journals manually using the hrnspjex utility before restarting the Data Object Broker.
TIBCO Object Service Broker for Open Systems Utilities for information on using the hrnspjex and hrntlmrg utilities.
If a spin job fails, a spinlog.nnn file is created, where nnn matches the TIBCO Object Service Broker Data Object Broker log file (hrncr.nnn) number in use when the error occurred. The log contains the date and time of the error along with any messages from the hrnspjex and/or hrnspset utilities. Messages concerning any errors encountered in the following are available in the Data Object Broker log:
In the illustration in Journal Spin Process Illustration, several exit codes are included. They correspond to the following conditions: