GatewayWatch messages
During normal operation, the gateway generates GatewayWatch messages and sends them to the ObjectServer. These messages inform the ObjectServer how the gateway is running.
The following table describes the GatewayWatch messages that the Java Gateway for ServiceNow generates. These GatewayWatch messages relate to the gateway's interaction with ServiceNow.
GatewayWatch message |
Description |
Triggers/causes |
|---|---|---|
Problem while querying ServiceNow for updates: exception |
While the gateway is running, it connects to and queries the ServiceNow server for alerts, in this case updates to ServiceNow target table records. This is an indication back to the ObjectServer that there is some issue with the gateway. |
This GatewayWatch message gets sent to the ObjectServer when the gateway update query to the ServiceNow server fails. The exception specifies a message that describes why this particular update query failed. For example:
|
Target connection restored |
A transient problem with communication to the ServiceNow instance has been resolved or no longer exists. |
This GatewayWatch message gets sent to the ObjectServer when the transient problem with communication to the ServiceNow instance has been resolved or no longer exists. |
Target connection down |
A prolonged interruption with the ServiceNow REST service is occurring. |
This GatewayWatch message gets sent to the ObjectServer when a ServiceNow REST service occurs. |
|
Create failed: user is unauthorised by ServiceNow. Update failed: user is unauthorised by ServiceNow. Journal failed: user is unauthorised by ServiceNow. |
The operations has failed because the gateway user account is not authorized to access ServiceNow. |
This GatewayWatch message gets sent to the ObjectServer when the user account expires or is no longer active. If OAuth 2.0 authentication is used, the OAuth endpoint may be no longer active or removed from the application registry. |