This documentation applies to the 8.1 version of Service Request Management, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

Prefetch components

The prefetch.pl utility uses the following components:

Component

Description

StartServlet

Contains the main code

prefetchConfig.xml

Main configuration file found in <midTierInstall>/WEB-INF/classes

prefetchConfig.xsd

XML schema definition (XSD) for the .xml file, found in the <midTierInstall> folder


The format of the prefetch.pl utility configuration file is as follows:

Section

Example code

Header


<?xml version="1.0" encoding="UTF-8"?> <midtier-prefetch-config  xmlns="http://www.bmc.com/remedy/midtier/700">

Authentication — One or more users that determines the permission-type cache. No password is required.


<prefetch-user>
	<user-name>SupportUser</user-name>
	<locale>en_US</locale>

Server, applications and forms — Applications can contain 0+ forms. Forms can exist individually at a server level.


<prefetch-server>
	<server-name>arserver</server-name>
	<prefetch-app>
		<app-name>Sample</app-name>
		<prefetch-form>
		<form-name>Home Page</form-name>
		</prefetch-form>
...
...
</prefetch-app>
	<prefetch-form>
		<form-name>Home Page</form-name>
		</prefetch-form>
	</prefetch-server>
</prefetch-user>

Footer


</midtier-prefetch-config>

Note the following usage issues:

  • Forms are cached differently, depending upon whether they are accessed using a call to the application (/arsys/apps/<ARServer>/<appName>/ <formName>) or the forms directly (/arsys/forms/<ARServer>/<formName>). For environments where either call is possible, both methods should be covered in the .xml file:
    ... <prefetch\-server> <serverName>ServerName</server\-name> <prefetch\-app> <app\-name>AppName</app\-name> <prefetch\-form> <form\-name>FormName</form\-name> </prefetch\-form> </prefetch\-app> </prefetch\-server> <prefetch\-server> <server\-name>ServerName</server\-name> <prefetch\-form> <form\-name>FormName</form\-name> </prefetch\-form> </prefetch\-server> ...
  • Specifying an application without at least one form causes the mid tier to cache all of the forms in that application.
    .... <prefetch\-server> <server\-name>ServerName</server\-name> <prefetch\-app> <app\-name>AppName</app\-name> </prefetch\-app> </prefetch\-server> ...
  • You can see the prefetch activity in the mid tier logs in the following situations:
    • The performance category is selected.
    • The Log Level is set to Fine.
      
      Apr 12, 2007 1:05:57 PM com.remedy.arsys.prefetch.PrefetchTask run
         INFO: START prefetch
         Apr 12, 2007 1:06:14 PM com.remedy.arsys.goat.Form get
         FINE: Form: Constructing for missing key Form:atlwin01/AR System User Preference
         Apr 12, 2007 1:06:17 PM com.remedy.arsys.goat.Form <init>
         FINE: API form time = 2735
         Apr 12, 2007 1:06:17 PM com.remedy.arsys.goat.Form get
         FINE: Form: Construction for key Form:atlwin01/AR System User Preference took 2765
         Apr 12, 2007 1:06:17 PM com.remedy.arsys.goat.Form$CachedFieldMap <init>
         FINE: Form.CachedFieldMap: Constructing for missing key atlwin01/AR System User Preference/Admin
         Apr 12, 2007 1:06:17 PM com.remedy.arsys.goat.Form$CachedFieldMap <init>
         FINE: API field key time = 31
         Apr 12, 2007 1:06:22 PM com.remedy.arsys.goat.Form$CachedFieldMap <init>
         FINE: API field time = 4797
         ...
         ...
         FINE: Using the preference server atlwin01 form AR System User Preference for user Demo
         Apr 12, 2007 1:06:22 PM com.remedy.arsys.goat.Form get
         FINE: Form: Constructing for missing key Form:atlwin01/Sample:Classes
         Apr 12, 2007 1:06:24 PM com.remedy.arsys.goat.Form <init>
         FINE: API form time = 2031
         ...
      
         Apr 12, 2007 1:06:30 PM com.remedy.arsys.goat.field.FieldGraph instantiateFields
         FINE: FieldGraph: Populated fields/workflow for key Admin|atlwin01/Sample:Classes/536880381/N, took 5438
         Apr 12, 2007 1:06:30 PM com.remedy.arsys.goat.Globule init
         FINE: Globule: Compressed data type text/html; charset=UTF-8 - was 17445 bytes, now 3718 bytes
         Apr 12, 2007 1:06:30 PM com.remedy.arsys.goat.ActiveLink getBound
         FINE: COMPILE formactivelink time = 0
         Apr 12, 2007 1:06:30 PM com.remedy.arsys.goat.ActiveLink getBound
         FINE: COMPILE formactivelink time = 0
         Apr 12, 2007 1:06:31 PM com.remedy.arsys.goat.menu.Menu getMenuFromServer
         FINE: API Get Menu time = 421
         Apr 12, 2007 1:06:31 PM com.remedy.arsys.goat.Globule init
         FINE: Globule: Compressed data type text/js; charset=UTF-8 - was 5967 bytes, now 1972 bytes
         Apr 12, 2007 1:06:31 PM com.remedy.arsys.prefetch.PrefetchWorkerImpl fetchForUser
         FINE: successful prefetch - server:atlwin01||form:Sample:Classes||username:Demo||appname:Sample||view:null||locale:en_US||timezone:null took 8687 milliseconds.
         Apr 12, 2007 1:06:31 PM com.remedy.arsys.goat.Form get
         FINE: Form: Constructing for missing key Form:atlwin01/AR Sample Application: Console
         ...
         ...
         Apr 12, 2007 1:06:31 PM com.remedy.arsys.prefetch.PrefetchTask run
         INFO: END prefetch

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments