Configuration steps to set up job tracking

To update the runtime repository with the Output Manager job status, you enable a setting in the Vista Plus Output Manager output connector.

To receive job status notifications and trigger custom actions, such as sending emails or updating SAP Delivery Manager, you must also set up a Service Request input connector and a MessageIN Event.

Prerequisites for receiving job status notifications

•	The Vista Plus Output Manager web service is running.

•	A service gateway application is running in your application domain.

•	The repositorytopjobcompletionservice.xml file exists in the packages folder in the working directory of the service gateway.

When you create a new service gateway, this file is automatically copied to the packages folder. If you have an existing service gateway without this file, you can manually copy it from the StreamServe installation directory. Windows paths:

–	Source: <StreamServe installation directory> \applications\management\<version>\etc\config\<version> \STRSSG\packages\repositorytopjobcompletionservice.xml

–	Destination: <ManagementGateway root directory>\<version> \root\applications\<service gateway application name>\wd\packages\

To update the runtime repository with the Output Manager job status

Note:

These steps assume the Output Manager connector is already set up.

1	In the Vista Plus Output Manager output connector, enable the following options:

–	In the Callback Notifications box, click True.

–	In the External Job Completion box, click True.

To create custom actions based on job status notifications

1	In the Vista Plus Output Manager output connector, set up the following properties in the Platform or runtime configuration:

a	In the Callback Notifications box, click True.

b	In the Callback Service Name box, enter the service name of the Service Request input connector that receives the notifications. See step 2 below.

c	In the External Job Completion box, click True or False.

2	Add a Service Request input connector to your Project.

a	In the Request type list, click Notification.

b	In the Service name box, enter the Callback Service Name you entered in step 1.

3	Add the VPOMJobNotification SXD file to the resource set. This file is found in the following directory:

<OpenText StreamServe installation directory>\
Applications\StreamServer\<Version>\Tools\System\data\sxd

4	Add a MessageIN Event to your Project.

5	Connect the SXD file to the MessageIN Event.

6	The action you want to trigger determines what additional configuration you must make in the Project.

Job variables are found in the env field of the MessageIN Event. To retrieve job variables you can create a script function in a function file and import it to the resource set. For an example, see Function to retrieve the job variables.

Example 47

Function to retrieve the job variables

CodePage UTF8

func GetVPOMJobVariable ()

{

StrTok(#2, ";", $attr);

$size = ArraySize($attr);

for ($i = 0; $i < $size; $i++) {

		StrTok($attr[$i], "=", $pair);

		if ($pair[0] = #1) {

			return $pair[1];

		}

	}

}