Use the tacmd listSdastatus command to display the SDA Enablement status for a monitoring server. You can display the SDA Enablement status for a list of monitoring servers or for all monitoring servers (default action). The SDA suspend state for the hub monitoring server is also provided if the command is issued to an ITM V6.3.0 (or later) hub monitoring server. The SDA suspend state defines the SDA activity for all the monitoring servers attached to the hub monitoring server. See the tacmd suspendSda and tacmd resumeSda commands for more information.
You must log in by using the tacmd login command before running the listSdaStatus command.
| Value | Symbol (KFASDM_CONFIG_*) | Explanation | Response |
|---|---|---|---|
| 0 | ST_Success | SDA is operational. | None. |
| 1 | SDM_InitError | An error occurred while SDA was initializing, updating the SDA_STATE record, or while retrieving or processing the Suspend record. | Contact Tivoli customer support. |
| 2 | ITM_HOME_ Missing |
Indicates a non-MVS error only: on Windows - CANDLE_HOME undefined, on UNIX - CANDLEHOME undefined (possibly an installation error) | Contact Tivoli customer support. |
| 3 | MANIFEST_PATH_ Missing |
The TEMS environment variable TEMS_MANIFEST_PATH is undefined or the value is the empty string. | This variable is defined by the installation program. If the configuration file has been edited, verify that the variable still exists and identifies a valid directory. If the predefined variable was not altered, contact Tivoli customer support. |
| 4 | MANIFEST_PATH_ TooLong |
The path name specified through the TEMS_MANIFEST_PATH environment variable exceeds 512 characters. | Redefine the manifest directory at a location whose path name is less than or equal to 512 characters. |
| 5 | MANIFEST_PATH_ NotFound |
The directory specified through the TEMS_MANIFEST_PATH environment variable was not found. | This variable is defined by the installation program. If the configuration file has been edited, verify that the value identifies a valid directory. If the predefined variable was not altered, contact Tivoli customer support. |
| 6 | SDM_ENABLED_ UnknownValue |
The value assigned to the KMS_SDA environment variable is not valid. | Assign a value of either Y|y (enabled) or N|n (disabled). |
| 7 | DISTREQMGR_ InitFailed |
For remote TEMS only: the creation of the Distributed Request Monitor thread failed. | Contact Tivoli customer support. |
| 8 | NOTIFICATIONMGR_ InitFailed |
The creation of the thread to monitor the hub's TAPPLOGT table failed. In the case of a remote TEMS, this error can also occur if the creation of the thread to monitor the remote TEMS TAPPLOGT table failed. | Contact Tivoli customer support. |
| 9 | REQUESTMGRTHREAD_ NotCreated |
The creation of the Workload Manager thread failed. | Contact Tivoli customer support. |
| 10 | HUB_SDA_Disabled | For remote TEMS only: SDA has been disabled at the remote TEMS because SDA is disabled at the hub. | This is the default configuration in which the TEMS is installed. To activate SDA, enable it at the hub. |
| 11 | HUB_SDA_Error | For remote TEMS only: SDA has been disabled at the remote TEMS because SDA functions at the hub are inoperative. | Run the listSdaStatus -n *HUB command to determine the nature of the error at the hub. Then refer to this table for the appropriate response. |
| 12 | HUB_SDA_ Unknown |
For remote TEMS only: SDA has been disabled because the state of SDA at the hub is unknown> This error might indicate a communication failure with the hub. | Once the remote TEMS re-establishes the connection to the hub, the error should be resolved. If not, contact Tivoli customer support. |
| 13 | HUB_SDA_ CommFailed |
Unused. | Not applicable. |
| 14 | BROADCASTMGR_ InitFailed |
The creation of the Broadcast Manager thread failed. | Contact Tivoli customer support. |
| 15 | BROADCASTMGRTHREAD_ NotCreated |
Unused. | Not applicable. |
| 16 | SDA_No | The environment variable KMS_SDA has been set to N. | None. |
| 17 | CMS_FTO_ Configured |
For ITM v6.2.3 Fix Pack 1 or later hub only: SDA has been disabled because FTO is enabled on the hub. | Prior to ITM v6.2.3 Fix Pack 1, FTO and SDA were mutually exclusive. Select one or the other or upgrade the hub to ITM v6.2.3 Fix Pack 1 or later. |
tacmd listSdaStatus
[ {-n |--temsname} TEMS... ]
Specify one or more monitoring server names to display SDA Enablement status. If this option is not specified, the SDA Enablement status is displayed for all online monitoring servers that are able to perform SDA.
If a monitoring server specified by the –n|--temsname option is not online, is not SDA capable, or is not registered with the HUB, then a warning is displayed.
tacmd listsdastatus –n REMOTE_1 REMOTE_2 REMOTE_3
KUILSS200W: REMOTE_2 is not online and SDA enablement cannot be provided.
HUB/RTEMS STATE STATUS
REMOTE_1 ON 0
REMOTE_3 OFF 16tacmd listsdastatus –n REMOTE_A REMOTEB
KUILSS202W: TEMS name : REMOTEB is not connected to this HUB. Verify the input
is correct and retry.
HUB/RTEMS STATE STATUS
REMOTE_A ON 0tacmd listsdastatus
KUILSS203I: SDA functions are suspended.
.
HUB/RTEMS STATE STATUS
HUB_A ON 0
HUB_B ON 0
RTEMS_6.3.0 ON 0
RTEMS_6.2.3 ON 0
RTEMS_6.3.1 ERROR 18