Subscribe

You can track all active APARs for this component.

APAR status

Closed as program error.

Error description

The Tivoli Storage Manager Server can hang during shutdown
processing, after an administrator issues the HALT command.
For example:
TSM:TSMSERVER> HALT
ANR2017I Administrator SERVER_CONSOLE issued command: HALT
ANR1912I Stopping the activity log because of a server
shutdown.
< HANG >
Without administrator intervention, the dsmserv process will
continue to run. High CPU utilization can be seen during
the hang. Forcibly killing the dsmserv process is required
to stop it.
The cause of this hang is an unexpected volume history file
format. The volume history file may be in an unexpected or
invalid format for a V6 server (for example, in a V5 format).
The location of the volume history file is defined by the
VOLUMEHISTORY option within the dsmserv.opt options file.
Customer/L2 Diagnostics:
A VOLHST trace will show the following behavior:
12:17:30.355 &#65517;53&#65529;&#65517;output.c&#65529;&#65517;7271&#65529;&#65517;PutConsoleMsg&#65529;:ANR2017I
Administrator SERVER_CONSOLE issued command: HALT ~
12:17:30.359 &#65517;1&#65529;&#65517;icvolhst.c&#65529;&#65517;5645&#65529;&#65517;icSavePre63VolHistFiles&#65529;:
starting
12:17:30.359 &#65517;1&#65529;&#65517;icvolhst.c&#65529;&#65517;5682&#65529;&#65517;icSavePre63VolHistFiles&#65529;:
Reached the first stanza or file is empty
12:17:31.195 &#65517;12&#65529;&#65517;output.c&#65529;&#65517;7271&#65529;&#65517;PutConsoleMsg&#65529;:ANR1912I
Stopping the activity log because of a server shutdown.~
< HANG >
Dumping the active threads for the dsmserv process will show
a thread similar to the following (example is from pstack
on Linux):
read.read()
filbuf.__filbuf()
fgets.fgets()
icvolhst.icSavePre63VolHistFiles()
admstart.StartServer()
admstart.admStartServer()
dsmserv.main()
procstack on aix will show:
read()
__filbuf()
fgets()
icSavePre63VolHistFiles()
StartServer()
admStartServer()
main()
__start()
Initial Impact:
Medium
Tivoli Storage Manager Versions Affected:
All V6.3 Tivoli Storage Manager servers.
Additional Keywords:
ZZTSM63 TSM HANG HUNG VOL HIST VOLHIST VOLUME HISTORY HALT
STOP TSMHALT LOOP LP ICSAVEPRE63VOLHISTFILES STOPPED LOOPED
| MDVREGR 6.3.3.0-TIV_5698MSV | (IC83120)

Local fix

Rename the existing volume history file at the filesystem layer
and create a new one using the BACKUP VOLHIST command.