Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Using IMS Message Level Support with Date/Time Offset


In addition to standard Xchange IMS requests used to specify a particular date and/or time, you can create IMS requests based on a fixed offset from the current date and time when the IMS transaction is started.

To create Xchange IMS date/time offset requests, first enter the OFFSET primary command on the IMS Simulated Date Time Settings screen as described in Primary Commands for All Users. The screen is redisplayed in IMS date/time offset format as shown in the following figure:

IMS Simulated Date Time Settings Screen in Offset Format

 -------------------- IMS Simulated Date Time Settings -------- ROW 0001 TO 0001
Command===>                         Xchange Subsystem ID XG40 UP Active===> YES
Line Commands:   H - Set and Hold   P - Permanent   R - Reset   D - Delete
                 J - Jobname   A - Activate   I - Inactivate
Status Codes:    Request Type  or  * - Error

                                     -------IOPCB-------  ------MVS/HLL------
C A S   Owner     Req ID   Program   Days  Hrs  Mins Ind  Days  Hrs  Mins Ind
_ N H  ACMJET0   ACMJET0   XGICOBLE  0100  00   00   +    0100  00   00   +
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _
_ _ _  ________  ________  ________  ____  __   __   _    =___  __   __   _

    PF1 HELP  PF2 COPYRIGHT/TRADE SECRET NOTICE  CLEAR EXIT  PF7 BWD PF8 FWD

Create Xchange requests as you would using the standard IMS format, but use the IOPCB and MVS/HLL fields to specify how far in the future or past you want Xchange to simulate. Other fields, status codes, and commands are the same as those described in Using-IMS-Message-Level-Support.

Fields

Use the IOPCB and MVS/HLL fields to specify how far into the future or past you want Xchange to simulate the date and time for a request. For example, if you type 364 in the IOPCB Days field, 23 in the Hrs field, 59 in the Mins field, and + in the Ind field of an IMS request, Xchange will substitute a date and time nearly one year into the future for the specified program or job.

The same constants fields are provided under two headings, IOPCB and MVS/HLL. The date/time offset values under the IOPCB heading are substituted for the IOPCB values of the specified program or job. Those under the MVS/HLL heading are used to exchange other MVS and high-level language TIME services calls. The MVS/HLL fields default to the corresponding values entered in the IOPCB fields, as indicated by the equal sign (=) in the first position of the MVS/HLL Days column. The following descriptions apply to both the IOPCB and MVS/HLL constants fields.

The S portion of the C/A/S field is display-only. You can type data into all other fields.

Tip

Only those fields unique to Xchange’s IMS date/time offset format are described in this section. For descriptions of other fields, see Fields.

Days

The number of days into the future or past that you want Xchange to simulate. Valid entries are from 0 to 9999. The default is 0.

Hrs

The number of hours into the future or past that you want Xchange to simulate. Valid entries are from 0 to 23. The default is 0.

Mins

The number of minutes into the future or past that you want Xchange to simulate. Valid entries are from 0 to 59. The default is 0.

Ind

Used to indicate the direction, future or past, that you want Xchange to simulate. Valid entries are + (plus) for an offset into the future and - (minus) for an offset into the past. The default is +. If the PREVDATE parameter is set to NO (see Task 3.2.2: Specify Xchange parameters), date/time offsets into the past are not allowed.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*