Skip to Content
Information
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 the Batch Facility

Xchange's batch facility lets you insert steps in your batch jobs that will exchange the date and time for selected steps or the entire job. By including Xchange steps directly in your jobs, you can easily manage and maintain a large number and variety of date/time exchanges.

An Xchange I000 message is placed in the JES2 job log the first time during program execution that Xchange simulates a date or time for a job step. The same message is sent to your terminal, but might not be seen unless you update your TSO profile. To enable viewing of I000 messages, type TSO PROFILE WTPMSG on the TSO COMMAND line and press Enter.

If only one Xchange batch step is included in your job:

  • The Xchange step must come before the job steps it specifies.
  • A fully qualified stepname can be entered for the STEP parameter.

If you include multiple Xchange batch steps in your job:

  • Each Xchange step must come before the job steps it specifies.
  • Fully qualified stepnames should not be used.
  • Only the last Xchange step executed will have an entry or entries on the Simulated Date Time Settings screen.

You can use the batch facility by simply inserting the following Xchange batch steps as required in the application job that you want to affect.

Xchange Batch Steps

//*
//STEPNAME EXEC PGM=XGCBATCH,PARM=’request’
//STEPLIB  DD DSN=CPWR.MLXGnnn.SLXGLOAD,DISP=SHR
//SYSPRINT DD   SYSOUT=*
//*

Replace CPWR with the high-level qualifier chosen for your site. You must also provide information for the PARM='request' variable according to the syntax shown in either Batch Facility Request Parameter Syntax for Fixed Date and Time for fixed date and time or Batch Facility Request Parameter Syntax for Date/Time Offset for date/time offset.

Warning

Important

Do not mix fixed date and time keywords (DATE, TIME, and TOD) with date/time offset keywords (DAYS, HRS, MINS, and IND) in a single request.

Batch Facility Request Parameter Syntax for Fixed Date and Time

worddav285e0a404be6d14144374b2ea8057780.png

Batch Facility Request Parameter Syntax for Date/Time Offset

worddavd31080d31f4e048af7a24c6264412550.png

This section contains the following topics:

 

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

BMC AMI DevX Xchange 17.02