Previous Topic: The Web Engine and Its Cache

Next Topic: How to Modify HTML Templates

The pdm_webcache Utility

Use the pdm_webcache utility to remove one or more HTMPL forms from the web engine cache. This forces the web engine to fetch these forms from the disk the next time they are used, allowing changes to forms to take effect.

pdm_webcache [-f form-name] [-g form-group] [-i interface] [-p process] [-v]
-f form-name

Specifies the name of the form to be removed from the cache, such as detail_cr.htmpl. You can use '%' (or '*') as a wildcard character to select more than one form. For example, the specification:

-f detail%

selects all detail forms.

This argument is optional. If it is omitted, all forms in the cache are selected.

-g form-group

Specifies the name of the form group to be removed from the cache, such as Analyst. You can use '%' (or '*') as a wildcard character to select more than one form group. For example, the specification:

-g Anal%

selects all form groups beginning with "Anal”.

This argument is optional. If it is omitted, all form groups in the cache are selected.

-i interface

Specifies the name of the web interface to be removed from the cache, such as analyst, customer, or employee. You can use '%' (or '*') as a wildcard character. For example, the specification:

-i a%

selects the analyst interface.

This argument is optional. If it is omitted, all interfaces in the cache are selected.

-p process

Specifies the name of the web engine process whose cache is to be modified, such as web:local.

This argument is optional. If it is omitted, all web engines are selected.

-v

Specifies verbose output. When this argument is specified, pdm_webcache lists the full name of every form removed from the cache, in the form:

interface:form-group:form-name

This argument is optional. If it is omitted, pdm_webcache reports only a count of forms removed from each web engine's the cache.