Advancing Xchange Requests Using IMS Message Level Support

In addition to requests that simulate date and time substitution, you can create requests that will advance the date and time of any IMS message level support request they match.

To create Xchange Advance requests, first enter the ADVANCE primary command on the Simulated Date Time Settings screen for IMS message level support as described in Primary Commands for All Users. The Advance Request Settings screen is displayed as shown in the following figure:

Advance Request Settings Screen for IMS Message Level Support

------------------------- Advance Request Settings ---------- ROW 0001 TO 0001
Command===> ____________            Xchange Subsystem ID XG7C UP Active===> YES

Line Commands:   H - Set and Hold   R - Reset   D - Delete   V - Advance
Status Codes:    Request Type or * - Error

                                     ---Advance IOPCB--- --Advance MVS/HLL--
C A S   Owner    Req ID    Program   Days Hrs Mins Ind Days Hrs Mins Ind
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _
_ _ _ _______ ________   ________ ____ __   __   _    =___ __   __   _


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

Create Xchange Advance requests as you would any other IMS message level support request, but use the three request identifier fields—A (Activation), Req ID, and Program—as masks to match those IMS message level support requests you want to advance, and use the Advance IOPCB and Advance MVS/HLL offset fields to specify how many days, hours, and minutes you want Xchange to advance those requests forward or backward.

Fields

Use the Advance IOPCB and Advance MVS/HLL fields to specify the time interval you want Xchange to age IMS message level requests forward or backward. For example, if you type 1 in the Advance IOPCB Days field, 12 in the Hrs field, and + in the Ind field, Xchange will age all matching IMS message level requests forward 1 day and 12 hours.

Days

This field is used to enter the number of days by which to age matching requests. The default is 0000. Any numeric value is valid.

Hrs

This field is used to enter the number of hours by which to age matching requests. The default is 00. Valid entries are from 00 to 23.

Mins

This field is used to enter the number of minutes by which to age matching requests. The default is 00. Valid entries are from 00 to 59.

Ind

This field is used to specify whether to advance matching requests forward or backward. Valid entries are + (plus) to advance forward and - (minus) to advance backward. The default is + (forward). If the PREVDATE parameter is set to NO (see Task-3-2-2-Specify-Xchange-parameters), advancing the requested date and time, or offset, of an existing request prior to the current date is not allowed.

Example Advancing IMS Message Level Support Requests

In this example, two IMS message level support requests are in held status, as shown in the following figure:

IMS Message Level Support Requests Held

BMC AMI DevX Xchange --- IMS Simulated Date Time Settings --- ROW 0001 TO 0002
Command===> _____________           Xchange Subsystem ID XG7C 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   YYYY/MM/DD HH:MM:SS YYYY/MM/DD HH:MM:SS
_ N H ACMJET0   ACMJET0   XGICOB__ ____ __ __ __ __ __ ____ __ __ __ __ __
_ Y H ACMJET0   ACMJET0   XGICOBLE 2001 01 01 01 01 01 2002 02 02 02 02 02
_ _ _ _______   ________ ________ ____ __ __ __ __ __ ____ __ __ __ __ __
_ _ _ _______   ________ ________ ____ __ __ __ __ __ ____ __ __ __ __ __

Queued offset requests, like the one for XGICOB, are displayed without a specific date and time.

Important

The OFFSET primary command can be used to display the Simulated Date Time Settings screen in offset format (as shown in the IMS Message Level Support Request Showing Offsets figure), allowing you to view the offsets for the request related to program XGICOB.

IMS Message Level Support Request Showing Offsets

------------------------ IMS Simulated Date Time Settings ---- ROW 0001 TO 0001
Command===> ______________          Xchange Subsystem ID XG7C 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   XGICOB__ 1111 11   11   +    2222 22   22   +
_ _ _ ________ ________ ________ ____ __   __   _    =___ __   __   _
_ _ _ ________ ________ ________ ____ __   __   _    =___ __   __   _

The ADVANCE primary command can be entered on the IMS Simulated Date Time Settings screen shown in the IMS Message Level Support Requests Held figure to display the Advance Request Settings screen shown in the IMS Message Level Support Request Showing Offsets figure.

An Advance request is entered on the Advance Request Settings screen using the Set and Hold (H) line command, specifying that Xchange should advance the requested date and time or offset of any IMS message level support request whose request identifier fields—A (Activation), Req ID, and Program— match that set below. The IOPCB requested dates and times or offsets will be advanced by 2 days, 2 hours, and 2 minutes forward and the MVS/HLL requested dates and times or offsets will be advanced by 1 day, 1 hour, and 1 minute backward at such time when the Advance is requested. For now, the Advance request is held.

Advance Request Settings Screen

------------------------- Advance Request Settings ----------- ROW 0001 TO 0001
Command===>_____________            Xchange Subsystem ID XG7C UP Active===> YES

Line Commands:   H - Set and Hold   R - Reset   D - Delete   V - Advance
Status Codes:    Request Type or * - Error

                                     ---Advance IOPCB--- --Advance MVS/HLL--
C A S   Owner     Req ID   Program   Days Hrs Mins Ind Days Hrs Mins Ind
_ * H ACMJET0   ACMJET0   XGICOB*   0002 02   02   +    0001 01   01   _
_ _ _ ______    _______   ________ ____ __   __   _    =___ __   __   _
_ _ _ ______    _______   ________ ____ __   __   _    =___ __   __   _

The Advance line command V is entered beside this request. An asterisk (*) in the A (Activation) field indicates that both Y and N (activated and not activated) matching requests will be advanced.

Advance Request Settings Screen with V Line Command

--------------------------- Advance Request Settings --------- ROW 0001 TO 0001
Command===> ______________          Xchange Subsystem ID XG7C UP Active===> YES

Line Commands:   H - Set and Hold   R - Reset   D - Delete   V - Advance
Status Codes:    Request Type or * - Error

                                     ---Advance IOPCB--- --Advance MVS/HLL--
C A S   Owner     Req ID   Program   Days Hrs Mins Ind Days Hrs Mins Ind
V * H ACMJET0   ACMJET0   XGICOB*_ 0002 02   02   +    0001 01   01   _
_ _ _ ________ ________ ________ ____ __   __   _    =___ __   __   _
_ _ _ ________ ________ ________ ____ __   __   _    =___ __   __   _

Once completed, the IOPCB requested date and time or offset of any IMS message level support request whose request identifier fields match the Advance request masks is advanced by 2 days, 2 hours, and 2 minutes forward, as shown in the Simulated Date Time Settings Screen with Advance Request figure. Likewise, the MVS/HLL requested date and time or offset of any matching IMS message level support request is advanced by 1 day, 1 hour, and 1 minute backward, as shown in the Simulated Date Time Settings Screen with Advance Request Showing Offsets figure.

Simulated Date Time Settings Screen with Advance Request

BMC AMI DevX Xchange --- IMS Simulated Date Time Settings ---- ROW 0001 TO 0002
Command===> __________              Xchange Subsystem ID XG7C 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   YYYY/MM/DD HH:MM:SS YYYY/MM/DD HH:MM:SS
_ N H ACMJET0   ACMJET0   XGICOB__ ____ __ __ __ __ __ ____ __ __ __ __ __
_ Y H ACMJET0   ACMJET0   XGICOBLE 2001 01 03 03 03 01 2002 02 01 01 01 02
_ _ _ ________ ________ ________ ____ __ __ __ __ __ ____ __ __ __ __ __
_ _ _ ________ ________ ________ ____ __ __ __ __ __ ____ __ __ __ __ __

Simulated Date Time Settings Screen with Advance Request Showing Offsets

----------------------- IMS Simulated Date Time Settings ------ ROW 0001 TO 0002
Command===> ____________            Xchange Subsystem ID XG7C 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   XGICOB__ 1113 13   13   +    2221 21   21   _
_ _ _ ________ ________ ________ ____ __   __   _    =___ __   __   _
_ _ _ ________ ________ ________ ____ __   __   _    =___ __   __   _