TimeZone format requirements for ENDEVOR.cfg

Products

• Endevor

Issue/Introduction

In the ENDEVOR.cfg file, is there any other parameter/format that is allowed in timezone apart from GMT?

Environment

- Endevor

- Web Services (SOAP API)

- Tomcat Server on z/OS

Resolution

The TimeZone parameter is used only by the SOAP API, and validation there expects format GMT+00:00 or GMT-00:00 (GMT followed by offset from GMT) , for example, GMT+10:00. Anything else won't be accepted and WebServices will throw an error:
EWS1313E Incorrect TimeZone format. Correct format is GMT+00:00 or GMT-00:00

Note 01: Updating the timezone in the .cfg file won't affect the Tomcat log time.
Note 02: This parameter uses static GMT offsets which do not possess logic to transition between standard time and daylight time automatically. Manual updates are required during DST transitions if using this parameter



Regarding the timezone in REST API - please be aware that times shown in the returned data (such as last element modification, or a package execution window) will always return in the mainframe time zone, regardless of the Tomcat settings.


To control the server-side time zone of Tomcat, two updates are required. For these changes, Tomcat and Logback accept the timezone (marked in RED below) in a format from the "TZ identifier" column found here: TZ identifier.

1. Update timezone for the Tomcat logs (STDERR)
STDENV file, add:
IJO="$IJO -Duser.timezone=Australia/Sydney"

2. Update application-specific time zone (STDOUT)
$CATALINA_BASE/webapps/EndevorService/WEB-INF/classes/logback.xml,
on line 10: {HH:mm:ss.SSS,UTC}.  Change UTC to the timeZone name, i.e.: Australia/Sydney