IBM Support

CH15: The CICS Time Machine

Downloadable files


SupportPac CH15, the CICS Time Machine, is a tool that makes it easier for you to test time dependent CICS applications. This SupportPac supports CICS TS 4.1 through 5.3.

Download Description

The CICS Time Machine is a tool that makes it easier for you to test time dependent CICS applications. It gives you the ability to change the time and date used by your CICS application programs, enabling you to test how the applications will behave at particular times or dates in the future, or in the past. The date and time can be set to specific values or the time can be adjusted by a positive or negative delta.

The CICS Time Machine uses XEIIN, XEIOUT and XPCFTCH, Global User Exit programs to create a virtual 'application' time zone for applications within a CICS Transaction Server for z/OS (CICS TS) region, while the rest of the z/OS image and the CICS software itself still use the real 'system' time. The exit programs provide conversion between the two time zones where times are passed from CICS to the application and vice-versa.

It is recommended that the CICS Time Machine be used only in test environments.

Possible Uses

  • Testing function that runs at an unsociable time of day
  • Testing applications whose operation will change on a certain date because of new legal regulations
  • Testing the effect of communications between CICS systems in different time zones

Example Usage
This CTMC transaction is designed be run from a 3270-type terminal with a 24 x 80 screen. It provides a very simple method of changing the date and time, as shown by the screen image below.

To change the date or time, simply modify the relevant input fields and press Enter. If a valid date and time are entered, the display will change to show 'System is using MODIFIED date/time'. If any of the fields are invalid, the fields in error will be highlighted and an error message will be displayed.

To resume using the current date and time (MVS system) in your CICS system, press PF6. The display will change to show 'System is using CURRENT date/time'.

Skill Level Required

The following skill levels are recommended for anyone using this SupportPac:

  • CICS Application Programming - intermediate skill
  • CICS System Programming - intermediate skill
  • Knowledge of your system and applications - intermediate skill

What's New (release 2.5)?

  • Added support for CICS Transaction Server for z/OS (CICS TS) V5.3.

New in release 2.4
  • Added support for CICS TS V4.2, V5.1, and V5.2.
  • Tested against all releases of CICS TS from V4.1 onwards.
  • Removed support for CICS TS V3.1, and V3.2 (as these releases are out of service).
  • Removed the release independent loadlib. 0ne individual load library for each CICS TS version is provided.

Author: Peter Klein (originally Steve Collins), CICS Development, IBM Deutschland GmbH (Mainz).
Category: 2
Released: 05May95
Last Updated: 11Mar16
Current Version: 2.5


The SupportPac requires CICS Transaction Server for z/OS V4.1 or later.

Installation Instructions

To download the SupportPac:

  1. Click on the FTP link below and save the compressed file to your local machine.
  2. Extract the saved file to a temporary directory on your local machine. This will create the necessary installation, documentation, and license files.
  3. Follow the instructions in the included documentation to complete installation of this SupportPac on your host system.
ch15.pdf (User Guide) US English 169028

Download package

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options 24 Mar 16 US English 263743 HTTP

Technical support

Terms and Conditions
SupportPacs in this category are available at no charge to all licensed users of the CICS family products on the platforms specified in the SupportPac description. These SupportPacs are provided "AS-IS" (under the terms and conditions of the IBM International License Agreement for Non-Warranted Programs and of the associated License Information and other documentation). The terms and conditions of this license DO NOT provide for any entitlement to defect correction.

To determine if you want to use this SupportPac, read the accompanying license file.

Other CICS SupportPacs
To view the complete portfolio of CICS SupportPacs, go to the CICS SupportPacs Home Page

Product Alias/Synonym

CICS/TS CICS TS CICS Transaction Server

Document information

More support for: CICS Transaction Server

Software version: 4.1, 4.2, 5.1, 5.2, 5.3, 5.4

Operating system(s): z/OS

Reference #: 4009281

Modified date: 05 September 2017

Translate this page: