Remove agents from ESP

Products

• ESP Workload Automation

Issue/Introduction

Removing obsolete Agents from COMMQ file.

I do a F ESP,ESPCOM DEST(-) LIST and see several Servers/Agents no longer defined.

Is there a process that removes these entries from ESP or the ESPCOM display?

Environment

Release: All Supported Releases of ESP
Component: Workload Automation System Agent

Cause

Obsolete Agents to be removed from AgentDef and clean ESP COMMQ file.

Resolution

To clean up obsolete agents, a CQFORMAT is required on the MASTER only. There is no need to stop and perform this on Proxies or Workstation Server. 

In order to perform a CQFORMAT, please take the following steps:

  1) Stop the SHADOW so it will not take over as MASTER;
  2) Stop the MASTER
  3) Restart the MASTER with the CQFORMAT. 

Note:  Please choose a time when there is lowest processing to Agents. Unprocessed and unsent messages will be lost.

As the best practice, the command below should be issued against the agent BEFORE it's removed:
OPER ESPCOM DEST(agent_name) FLUSH

or:
/F master_stc,ESPCOM DEST(agent_name) FLUSH

Additional Information

Information can be found in the Broadcom Documentation:

Start ESP