Understanding the requesterTimeZone element

When the multi time zone deployment feature is enabled, users can employ the requesterTimeZone element within the request and response framework to define the time zone from which a request originates.

The requesterTimeZone parameter is a child element in the DWLControl business object. Users can pass this element in transaction requests to indicate the time zone from which the request originates. The value of this element is a valid time zone code. requesterTimeZone is an optional element.

You can set default requester time zone value in the configuration parameters for this feature (for details, see Configuring the multi time zone deployment feature). Even if this default value is set, any value included in the requesterTimeZone element overrides it. If no value for requesterTimeZone is included in a request, then the default value will be used. If neither the default value nor the requesterTimeZone value is set, then the application uses the application server time zone. The following matrix illustrates the precedence:

Table 1. Precedence of time zone values
requesterTimeZone element	Default time zone	Application server time zone	Time zone value used by the application
Included in request	Not configured	Configured	requesterTimeZone
Included in request	Configured	Configured	requesterTimeZone
Not included in request	Configured	Configured	Default time zone
Not included in request	Not configured	Configured	Application server time zone

Sample request and response XML

The following XML sample shows the requesterTimeZone element in a pagination request:

<DWLControl>
   <requesterName>cusadmin</requesterName>
   <requesterLanguage>100</requesterLanguage> 
   <requesterTimeZone>EST</requesterTimeZone>
</DWLControl>

The following XML sample shows the response to the request:

<DWLControl>
   <requesterLanguage>100</requesterLanguage> 
   <requesterLocale>en</requesterLocale> 
   <requesterName>cusadmin</requesterName> 
   <requestID>10026111</requestID>
   <requesterTimeZone>EST</requesterTimeZone>
   <availableResultsCount>3</availableResultsCount>
</DWLControl>