Overview

When the document is originally scanned into Docstore the Item Reference (LREF) is not available in Aurora. In order to update the Docstore Key with the correct value when it becomes available in Aurora we have written an LREFUPD program.

What this program does is to check for any Document Keys which require updating in a specified Docstore. This program is designed to be run via the Cobwebb Job Launcher Monitor (JOBLMON) where it will run in the CPPD subsystem at a frequency defined by the "Polling interval".

This program is entirely configured by the use of Parameters which are maintained via the Work with Job Launcher.

Parameters

Configuration

1.Create the customer COBGETLREF progam. As each installation of Aurora / System 21 is different, the program that checks the PLSUPREF (Item Reference) file in Aurora will need to be complied for each customer requiring to use this functionality.

2.Create a Job Description to specify the Libraries required for the job.

3.Add an entry to the Work with Job Launcher and the define the parameters to match your Docstore. Once this entry is set to "Online" the next time you start the CPPD subsystem the Job will be launched.

4.Once the job is running, check the Joblog for any errors in your configuration. Entries prefixed LREFUPD: could be potential problems with your configuration.

Step 1 - Create the custom COBGETLREF program

We have provided the source for the program COBGETLREF in the QUSRTOOLLE source file in library CPPD. We would suggest that you compile this program into the library COBEXIT (which is the library name that is most commonly used for Cobwebb Exit Programs) over the correct Aurora library (i.e. where the PLSUPREF logical file resides).  

Note: Please do not compile it into library CPPD otherwise this will be lost when you next upgrade your Cobwebb Server software.

Step 2 - Create a Job Description to run the Job

Copy the supplied JOBLMON Job Description into COBEXIT and call it something like LREFUPD. Now you need to add the following extra libraries to the initial library list:

DOCSTORE - required as an entry is written to the Docstore Log

COBEXIT - required to call the program COBGETLREF

AULT1Fn - Aurora library where the file PLSUPREF resides.

Step 3 - Add Job Launcher entry with Parameters

You need to create a Job Launcher entry for the LREFUPD program to run using the Cobwebb Job Launcher Monitor.  This can be found from the Cobwebb Main Menu - PPD File Maintenance - Option 12. Work with Job Launcher.              

•Use Option 1 =Create to create your new entry and specify the:

oProgram to call = LREFUPD

oProgram Library = *LIBL

oPolling interval = the number of minutes / seconds you wish the Job Launcher Monitor to wait before calling the program again.

oJob Description = The Job Description you have just created e.g. LREFUPD.

oLibrary = This is the library where the above Job Description resides e.g. COBEXIT.

•Once you have created the entry you need to use 2=Revise the entry.

•Press F22 to set the Launcher Type to *REF and press F10=Update before you try to enter the parameters.

•Now press F10 to enter your Parameters. All of the parameters on the first page are mandatory.                          

•Don’t forget to page down to set the NOTFND_TXT text and NOTFND_DYS as these appear on the second page of the Parameter list.

•When you are happy use 7=Online to set the Status Online ready for the job to be run in the CPPD subsystem the next time it is started.