Refreshing the model element status

CICS® DA indicates the last known status of a model element in one of two ways: In the model tree and the visualization views, the status is indicated by a decorator on the element icon. The decorator overlays the model element icon, and indicates whether the model element is running (The active status decorator) or stopped (The stopped status decorator). In the resource editors, the last known status is shown in the Status field. The Status field is refreshed when the editor opens. You can manually refresh the status of one or more model elements.

About this task

The status that is shown is the last known status. CICS DA does not refresh the status automatically. You must manually run refresh status.

You can refresh the status for one or more of the following model elements:
  • CICS Address Space, for example a CICS region or a CMAS.
  • WebSphere® MQ sub component
  • DB2® sub component
  • MVS™ Image; refresh all address spaces in the MVS Image
  • Sysplex; refresh all address spaces in all MVS Images in the sysplex
  • DA Server connection; refresh all address spaces in the model

Procedure

In the DA Explorer view or a visualization view, locate the model element for which you want to refresh the status. You can select multiple model elements with Ctrl+click. Right-click the element or elements, and click Refresh Status.

Alternatively, if you are viewing the element in the editor view, you can click the Refresh Status icon The Refresh Status icon.

Results

The status is refreshed. A message is shown in the CICS Explorer® status bar while the refresh takes place.
Note: The CICS DA server gets the latest status only if the status is expired. There is a parameter, com.ibm.cph.server.jobstatus.expiretime, in the CICS DA server properties file that defines the lifetime of the status. If a refresh request arrives while the status is still active, the status request is not actioned. This parameter defaults to 30 seconds, and is defined during the CICS DA server configuration. For more information about your local value, contact your system administrator.