orr_chaser

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.

Usage

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 .

 

Parameter file

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 =
pagination =

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".. .

 

Notes