IBM Support

Manual restart of monitor required when recycling CL/SuperSession

Question & Answer


Question

I'm running CL/SuperSession with the HelpDesk Facility. Every time I recycle CL/SuperSession, I have to manually restart the monitor, even though the HelpDesk documentation indicates that the monitor and logger should start automatically. I know that the TLVLOG contains error messages, and I saw several that involve the HelpDesk. I would like to know if these messages indicate that there is a problem, and if so, how to correct the problem?

Here are some of the messages the I've seen:

 KLVDF001 MESSAGE FROM DIALOG KLHUSRVR  
 'IPC DEQUEUE HDMON.HDCMDQ failed rc=-12'  
 KLVDF001 MESSAGE FROM DIALOG KLHUSRVR'  
 HelpDesk Server for HDMON Ended at xx:xx
 KLVDF001 MESSAGE FROM DIALOG KLHDMON  
 'HELPDESK Monitor Terminating'  
 KLVDF001 MESSAGE FROM DIALOG KLHDLOGR   
 'IPC DESTROY HD.LOGQ failed rc=12'  
 KLVDF001 MESSAGE FROM DIALOG KLHDLOGR   
 DETACH failed rc=12'
 KLVDF001 MESSAGE FROM DIALOG KLHDLOGR  
 'HELPDESK Logging Terminated'

Answer

The HelpDesk Monitor operates with an Internal Process Queue (IPC), and several uniquely-named tables.

If either of the HelpDesk dialogs KLHDMON or KLHDLOGR - the monitor and logger - are inadvertently started more than once, then the second started task will not be able to access the needed resources or create tables with the appropriate names, as the names are already in use by the first invocation. Since the second dialog did not successfully start, it will 'tidy up' before ending, by closing any open tables and dequeuing any lingering messages from the IPC. In doing so, the cleanup routines of the second dialog invoked actually terminate the first dialog, which was previously running without any trouble.

There may be some subtle hints in the TLVLOG that elude to the fact that a dialog has been invoked twice:

KLVDF001 MESSAGE FROM DIALOG KLHUSRVR
'TBSORT HDMON.THRESHLD rc=20'
This message indicates that the named table is already open.

KLVDF001 MESSAGE FROM DIALOG KLHDLOGR
'KLHDLOGR TBCREATE failed rc=12'
This message indicates that the table creation failed because the table name is already in use.

Once you suspect that the dialogs are started more than once, you can check the TLVLOG for the invocations:

    NTD KLHDLOGR     for the logger task  
    NTD KLHDMON      for the monitor task

Remove the second invocation from any automation or calling initialization dialogs.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSSN2Z","label":"IBM CL\/SuperSession for z\/OS"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CL/SS CLSS

Document Information

Modified date:
06 May 2015

UID

dwa1182032