The orr_chaser script produces 1st, 2nd, and 3rd Claims Letters for any outstanding Orders. The 3rd Claims Letter is a cancellation of the Order.
By default, a Claims Letter is sent 28 days after either the Order or the previous Claims Letter has been sent. It is possible to change this interval in the parameter file. The number of days elapsed before sending each Claims Letter is specified in the parameter file via the "chaser1", "chaser2", and "chaser3" parameters.
Claiming can be prevented if a report has been received from the Supplier within the number of days specified via the exclude_report_days parameter.
The script's source code is located in /usr/opt/blcmp/talis/mis/orr_chaser. To run in the script log on as report or talis and enter the following command:
report -porr_chaser -a<filename> -d<database> -h<help> -n<order number> -o<output filename> -r<report directory> -s<data directory> -t<letter type>
Standard script arguments are described here. The remaining arguments for this script are described in the following table.
Argument |
Description |
-n |
This optional argument specifies the Order Number(s) to be processed. If multiple Order Numbers are specified, these must be separated by a comma, for example "-nQA12345678,QA23456789". This argument cannot be used on the same command line as the "-t" argument . The "chaser" and the "exclude_report_days" parameters in the parameter file are ignored when the "-n" argument is used. |
-t |
This optional argument specifies the Claim Letter types to be output. Valid options are 1, 2 and 3. If multiple letter types are specified, they must be separated with a comma. If "-t" is not specified, the default is taken as producing all Letter Types (i.e. 1, 2 and 3). The "-t" argument cannot be used with the "-n" argument . |
The parameter file is held in the /usr/opt/blcmp/talis/mis/param directory. The following additional parameters are included:
Parameter |
Description |
exclude_report_days |
The "exclude_report_days" parameter prevents a Claim Letter being sent if a report has been received from the Supplier within the number of days specified. It must be set between 0 and 999 days. The default value is 0 days. This parameter is ignored when the "-n" argument has been specified. |
chaser 1, chaser 2, chaser 3 |
The default setting for each chaser parameter is 28 days. If any or all of the chaser parameters are not specified in the parameter file, they will automatically default to 28 days. Any or all of the values for "chaser1", "chaser2" or "chaser3" parameters can be changed but must be set to an integer value between 0 and 999. For example: chaser1 = 28 would send first chaser report 28 days after the Order has been sent, if no items have been received. chaser2 = 28 would send the second chaser 28 days after the first chaser has been sent, if no items have been received. chaser3 = 28 would send the third chaser 28 days after the second chaser has been sent, if no items have been received. |
pagination |
pagelength = These above parameters allow pagination to be achieved in one of two ways. The default, when neither parameter is specified or pagination = formfeed, is the insertion of a form feed character at the end of each letter. This gives control of the page length to the printer. This method is good for "standard" pagelengths such as A4. The alternative method is pagination=linefeed. This achieves a new page by outputting blank lines to fill a page to the length specified in "pagelength=xx".. . |
The Library address appearing on the Chaser Letter is derived in one of two ways.
The address can be inserted into the "format.pl" to be printed as seen. The default "format.pl" has included the Address as "LocationAddressLine1", "LocationAddressLine2" and so on; these variables can be amended to that of the preferred Library address.
The second approach allows each Chaser Letter to have a different Library address. The address is derived from the LOCATION_ADDRESS table, based on the create location of the Order. This will be the default method of producing the Address on the Chaser Letters.
If one central delivery address is required, but the Orders are placed from different Sites, then the location address variables in the "format.pl" should be replaced by the actual name and address of the preferred Library address.