Subscription Service

Kourier Integrator Online Help

Subscription Service

Purpose

When a Kourier REST subscription is created, a Kourier Service named “.{gwuser}_resourceID” is created that Kourier Integrator uses to generate and send callbacks for any subscription associated with this resource for the gateway user. Multiple subscriptions for the same resource are only possible if the export data file is resolved via query parameters (e.g. {%location_CUSTOMER).

Refer to the Kourier Services Guide and the Kourier Import Services Guide for more information on the use of services to transfer data between applications.

Available Toolbar Commands

	Click the Save icon in the toolbar to save the current Service and return to the services listing.
	Click the Delete icon in the toolbar to delete the current Service. You will be prompted with a "Are you sure you want to delete?" dialog. Clicking Yes will permanently delete the Service and then return to the Services listing. Click Cancel to return to the existing Service without deleting.
	Click the Run icon in the toolbar to run the Service manually. This will save your existing Service prior to running it. Running a service will create either an update or delete payload for the resource depending on what records are in Net Change.
	Click the History icon in the toolbar to see the event history for this service. This will take you to the Event Log Listing which displays all events that have been generated for this service.
	Click the Statistics icon in the toolbar to all of the statistics for this specific service. This will take you to the Service Statistics Listing and display the statistics that have been generated for this service.
	Click the Terminate icon in the toolbar to terminate the running instance of the current Service. You will be prompted with a dialog to confirm or cancel this command. This command should be used with care as it will attempt to immediately stop the current service, which could leave any data file extracts and file updates in an incomplete state. Recovery from using this command may require manual cleanup of the affected files and will most likely require a full refresh of any data being extracted.
	Click the Help balloon to open the help for this page.

File/Key Field

KT_SERVICES/Service ID

Prerequisites

If a source DSN or target DSN is specified, it should be entered using the Data Source Names screen.

Fields

Field Name	Description - Usage - Notes
Service	The unique name for the service. Subscription services are named using the following naming convention: “.{gwuser}_resourceID”
Description	Enter a short descriptive name for this service. This name is displayed in on-line lookups.
Last Run Start	Display only field that shows the last run start date and time for this service.
Last Run End	Display only field that shows the last run end date and time for this service.
Elapsed Time	Display only field that shows the last run total elapsed time for this service.
Command	This field will contain the KMK.PUSHSUBSCRIPTION program followed by a list of Subscription IDs.
Target Queue	Contains the DSN that was automatically generated when the subscription was created.
Save Undeliverable Messages	Kourier may occasionally be unable to send an outgoing message to a target Subscription DSN. This can happen when a network is down or when a server is off-line. This can result in an undeliverable message in the queue. If this field is checked, undeliverable messages will be saved in the outbound queue until the next time Kourier attempts to resend messages to that queue's Subscription DSN. If this field is not checked, undeliverable messages will not be saved.