Advancing Xchange Requests Using the ISPF Interface
In addition to requests that simulate date and time substitution, you can create pattern job requests to advance the date and time or the offset of existing Xchange requests.
To create Xchange Advance requests, first enter the ADVANCE primary command on the Simulated Date Time Settings screen as described in Primary Commands. The Advance Request Settings screen as shown in the following figure is displayed:
Advance Request Settings Screen for the ISPF Interface
COMMAND ===> SCROLL ===> CSR
System ID: AC12
Line Commands: H - Set and Hold R - Reset D - Delete V - Advance
Status Codes: Q - Queued * - Error
-- Advance --
Filter: ******** ******** ******** ******** **** ** ** *
C/S Owner Jobname Stepname Procstep Program Days Hrs Mins Ind
_ ________ ________ ________ ________ ____ __ __ _
_ ________ ________ ________ ________ ____ __ __ _
Create Xchange Advance requests as you would using the standard or offset ISPF interface, but use the Advance fields to specify how many days, hours, and minutes to advance Xchange Date/Time and Offset requests forward or backward.
Advancing Xchange Requests Using the ISPF Interface - Line Commands
Type line commands under the C portion of the C/S field (see Fields). The following line commands are available on the Advance Request Settings screen:
H | Sets and holds a pattern job request by adding it to the request table. Requests remain staged until you delete them using the D (Delete) line command. |
R | Resets a pattern job request. This command deletes an existing pattern job request, then adds the pattern job request back into the request table. The R command allows you to modify the values in the Advance Days, Hours, Minutes, and Indicator fields of an existing pattern job request. No other fields can be modified using the R command. A request owned by a different user ID can only be reset by an Xchange administrator. For information on designating Xchange administrators, see Task-8-3-5-Designating-Xchange-administrators. |
D | Deletes an existing pattern job request. A request owned by a different user ID can only be deleted by an Xchange administrator. For information on designating Xchange administrators, see Task-8-3-5-Designating-Xchange-administrators. |
V | Advances the requested date and time or offset of all queued Date/Time and Offset requests that match the staged Advance request by the number of days, hours, and minutes specified in the Advance fields forward or backward as specified by the Indicator field. This command deletes all matching Date/Time and Offset pattern job requests along with their completed entries, then adds the pattern job requests back into the request table. No fields other than the Line Command need to be entered to advance a staged request. A request owned by a different user ID can only be advanced by an Xchange administrator. For information on designating Xchange administrators, see Task-8-3-5-Designating-Xchange-administrators. |
Advancing Xchange Requests Using the ISPF Interface - Fields
Jobname
The name of the MVS job or jobs for which to advance the requested system date and time, or offset.
Advance Days
The number of days you want Xchange to advance the requested date and time or offset of existing requests. Valid entries are from 0 to 9999. The default is 0.
Advance Hours
The number of hours you want Xchange to advance the requested date and time or offset of existing requests. Valid entries are from 0 to 23. The default is 0.
Advance Minutes
The number of minutes you want Xchange to advance the requested date and time or offset of existing requests. Valid entries are from 0 to 59. The default is 0.
Advance Indicator
This field is used to specify whether to advance the requested date and time, or offset, of existing 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 of Advancing the Requested Date and Time or Offset of Existing Requests
In this example, two pattern job requests were queued, corresponding jobs were successfully executed, and Xchange substituted the date and time, or offset, as requested (see the following figure). Queued offset requests, like the fourth one as following figure, are displayed without a specific date and time.
Advancing Pattern Job Requests – First Screen
COMMAND ===> SCROLL ===> PAGE
System ID: CW40
Type Legal on the command line for Copyright/Trade Secret Notice Information
Line Commands: S - Set H - Set and Hold R - Reset D - Delete A - Set Active
Status Codes: Q - Queued P - Pending A - Active E - Executing * - Error
C - Completed N - Not Active X - Queued Exec D/T
Filter: ******** ******** ******** ******** * **** ** ** ** ** **
C/S Owner Jobname Stepname Procstep Program GHD YYYY/MM/DD HH:MM:SS Jobno
_ Q PPRJETO PPRJETOD *_______ *_______ *_______ N 2022 02 02 02 02 02
_ C PPRJETO PPRJETOD *_______ *_______ *_______ N 2022 02 02 02 02 02 44406
_ C PPRJETO PPRJETOD GO______ _______ XGBASM__ N 2022 02 02 02 02 02 44406
_ Q PPRJETO PPRJETOO *_______ *_______ *_______ N ____ __ __ __ __ __
_ C PPRJETO PPRJETOO *_______ *_______ *_______ N 2019 09 29 01 15 55 44407
_ C PPRJETO PPRJETOO GO______ _______ XGBASM__ N 2019 09 29 01 15 55 44407
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
_ ________ ________ _______ ________ _ ____ __ __ __ __ __
******************************** BOTTOM OF DATA ********************************
Advancing Pattern Job Requests – Second Screen
COMMAND ===> SCROLL ===> PAGE
System ID: CW40
Line Commands: S - Set H - Set and Hold R - Reset D - Delete A - Set Active
Status Codes: Q - Queued P - Pending A - Active N - Not Active * - Error
- Constants -
Filter: ******** ******** ******** ******** * **** ** ** *
C/S Owner Jobname Stepname Procstep Program GHD Days Hrs Mins Ind
_ Q PPRJETO PPRJETOD *_______ *_______ *_______ N 1111 11 11 +
_ ________ _______ ________ ________ _ ____ __ __ _
_ ________ _______ ________ ________ _ ____ __ __ _
The ADVANCE primary command can be entered on the Simulated Date Time Settings screen shown in Advancing Pattern Job Requests – First Screen figure to display the Advance Request Settings screen shown in the following figure:
Advance Request Settings Screen
COMMAND ===> SCROLL ===> PAGE
System ID: CW40
Line Commands: H - Set and Hold R - Reset D - Delete V - Advance
Status Codes: Q - Queued * - Error
-- Advance --
Filter: ******** ******** ******** ******** **** ** ** *
C/S Owner Jobname Stepname Procstep Program Days Hrs Mins Ind
_ Q PPRJETO PPRJETO* *_______ *_______ *_______ 0090 04 30 +
_ ________ ________ ________ ________ ____ __ __ _
_ ________ ________ ________ ________ ____ __ __ _
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 request whose pattern job request matches that set below by 90 days, 4 hours, and 30 minutes forward at such time when the Advance is requested. For now, the Advance request is staged.
The Advance line command V is entered beside this request.
Advance Request Settings Screen with V Line Command
COMMAND ===> SCROLL ===> PAGE
System ID: CW40
Line Commands: H - Set and Hold R - Reset D - Delete V - Advance
Status Codes: Q - Queued * - Error
-- Advance --
Filter: ******** ******** ******** ******** **** ** ** *
C/S Owner Jobname Stepname Procstep Program Days Hrs Mins Ind
V Q PPRJETO PPRJETO* *_______ *_______ *_______ 0090 04 30 +
_ ________ ________ ________ ________ ____ __ __ _
_ ________ ________ ________ ________ ____ __ __ _
Once completed, the requested date and time or offset of any request whose pattern job request matches is advanced by 90 days, 4 hours, and 30 minutes forward as shown in Simulated Date Time Settings Screen with Advance Request and Simulated Date Time Settings Screen with Advance Request Showing Constants figures.
Simulated Date Time Settings Screen with Advance Request
COMMAND ===> SCROLL ===> CSR
System ID: AC12
Type Legal on the command line for Copyright/Trade Secret Notice Information
Line Commands: S - Set H - Set and Hold R - Reset D - Delete A - Set Active
Status Codes: Q - Queued P - Pending A - Active E - Executing * - Error
C - Completed N - Not Active
Filter: ******** ******** ******** ******** * **** ** ** ** ** **
C/S Owner Jobname Stepname Procstep Program GHD YYYY/MM/DD HH:MM:SS Jobno
_ Q PPRJET0 PPRJET0D *_______ *_______ *_______ N 2022 05 03 06 32 02
_ Q PPRJET0 PPRJET0O *_______ *_______ *_______ N ____ __ __ __ __ __
_ ________ ________ ________ ________ _ ____ __ __ __ __ __
_ ________ ________ ________ ________ _ ____ __ __ __ __ __
Simulated Date Time Settings Screen with Advance Request Showing Constants
COMMAND ===> SCROLL ===> CSR
System ID: AC12
Line Commands: S - Set H - Set and Hold R - Reset D - Delete A - Set Active
Status Codes: Q - Queued P - Pending A - Active N - Not Active * - Error
- Constants -
Filter: ******** ******** ******** ******** * **** ** ** *
C/S Owner Jobname Stepname Procstep Program GHD Days Hrs Mins Ind
_ Q PPRJET0 PPRJET0O *_______ *_______ *_______ N 1201 15 41 +
_ ________ ________ ________ ________ _ ____ __ __ _
_ ________ ________ ________ ________ _ ____ __ __ _