Milestone 6: Enabling Language Environment support

This milestone contains tasks for enabling Language Environment (LE) in Xchange for CICS region support, Db2 support, IMS message level support, PL/I support, and C support.

The roles involved are: Xchange Installer.

Task 6.1: Enable LE for CICS region support

If your site does not require date/time exchanges for LE programs under Xchange CICS region support, you may skip this task and continue with Task-6-2-Enable-LE-for-Db2-support.

Language Environment/CICS Dependency Information

Xchange supports Language Environment (LE). Ensure that your site is current on z/OS, CICS, and LE maintenance before attempting to use Language Environment with Xchange.

Task 6.1.1: Apply CEEPLPKA zap

A zap to LE module CEEPLPKA is required if you want to exchange LE in CICS at the region level. The zap is necessary because LE gets initialized in a way that circumvents the normal dynamic hooking of LE by Xchange. To enable this support, perform the following steps:

1. We recommend that a copy of load module CEEPLPKA be placed in its own library and this zap be applied to that copy.

2. Run the job contained in data set CPWR.MLXGnnn.SLXGCNTL member XGZLE370. Follow the directions contained in the comments of the job.

   Warning

   Important

   For customers running z/OS 3.1 and above, the zap to LE module CEEPLPKA is located in data set CPWR.MLXGnnn.SLXGDATA member XGZPLE31. For customers running z/OS 2.3 and above, the zap to LE module CEEPLPKA is located in data set CPWR.MLXGnnn.SLXGDATA member XGZPLE23. These zaps work in conjunction with Xchange‘s Enhanced STCKE support. For more information on Xchange SVC, see Milestone-7-Enabling-Xchange-SVCs. The zap must be edited to specify the assigned user SVC number to be used by Xchange‘s Enhanced STCKE support.

3. Place the library with the zapped version of CEEPLPKA in the DFHRPL DD of the CICS region that is to be exchanged. This library must be concatenated before the normal LE SCEERUN library. Only use this zapped copy of CEEPLPKA when Xchange is required in a CICS region.

Task 6.2: Enable LE for Db2 support

If your site does not require date/time exchanges for LE programs under Xchange Db2 stored procedure support, you may skip this task and continue with Task-6-3-Enable-Enterprise-PL-I-DATE-or-DATETIME-built-in-function-support.

A zap to LE module CEEPLPKA is required if you want to exchange date/time calls from within Db2 stored procedures. The zap is necessary because LE gets initialized in a way that circumvents the normal dynamic hooking of LE by Xchange.

To enable LE for Db2 support, perform the following steps:

1. We recommend that a copy of load module CEEPLPKA be placed in its own STEPLIB/JOBLIB and this zap be applied to that copy.

2. Run the job contained in data set CPWR.MLXGnnn.SLXGCNTL member XGZLE370. Follow the directions contained in the comments of that job. This STEPLIB/JOBLIB must be concatenated before the normal LE SCEERUN library in both the Db2 WLM JCL and the JCL invoking the Db2 application. Only use this zapped copy of CEEPLPKA when Xchange is required from within the execution of the Db2 stored procedure.

   Warning

   Important

   For customers running z/OS 2.3 and above, the zap to LE module CEEPLPKA is located in data set CPWR.MLXGnnn.SLXGDATA member XGZPLE23. This zap works in conjunction with Xchange's Enhanced STCKE support. For more information on Xchange SVC, see Milestone-7-Enabling-Xchange-SVCs. The zap must be edited to specify the assigned user SVC number to be used by Xchange's Enhanced STCKE support.

3. Whenever maintenance is applied to LE, make a new copy of CEEPLPKA and reapply this zap to that new copy.

   Warning

   Important

   If Xchange will be working with LE date/time calls in an IMS message processing region (MPR) that specifies a pre-load of CEELRRIN, you must have the Xchange zap to CEEPLPKA in the STEPLIB concatenation before the SCEERUN library. If you created a zapped CEEPLPKA module in Task-6-1-Enable-LE-for-CICS-region-support, you can use that same zapped CEEPLPKA module in this step. An alternative solution is to remove CEELRRIN from the pre-load list.

Task 6.3: Enable Enterprise PL/I DATE or DATETIME built-in function support

Xchange supports both the DATE and DATETIME built-in functions of Enterprise PL/I.

• If your site does not require date/time exchanges for the Enterprise PL/I DATE or DATETIME built-in functions, you may skip this step and continue with Task-6-4-Enable-C-time-and-gettimeofday64-function-support.
• If your site is using the Enterprise PL/I DATE or DATETIME built-in function without any date/time patterns, you may skip this step and continue with Task-6-4-Enable-C-time-and-gettimeofday64-function-support. An example without a date/time pattern is DATETIME(). An example with a date/time pattern is DATETIME(YYYYMMDD).

A zap to LE module CEEEV003 is required if you want to exchange the Enterprise PL/I DATE or DATETIME built-in functions while using date/time patterns. To enable this support, perform the following steps:

1. We recommend that a copy of the load module CEEEV003 be placed in its own library and this zap be applied to that copy. CEEEV003 can be found in the LE SCEERUN library.
2. This zap works in conjunction with Xchange's Enhanced STCK support or Xchange's Enhanced STCK and Enhanced STCKE support. For more information, see Milestone-7-Enabling-Xchange-SVCs.
3. Run the job contained in data set CPWR.MLXGnnn.SLXGCNTL member XGZENTPL. Follow the directions contained in the comments of the job. Editing of CPWR.MLXGnnn.SLXGDATA member XGZAPPLI or XGZAPP23 is required in order to supply the user SVC numbers to be used by Xchange's Enhanced STCK or Xchange's Enhanced STCK and Enhanced STCKE Support, respectively.

4. Concatenate the library with the zapped version of CEEEV003 before the normal LE SCEERUN library. Only use this zapped copy of CEEEV003 when Xchange is required to support the PL/I DATE or DATETIME built-in function.

   Warning

   Important

   Whenever maintenance is applied to LE, make a copy of CEEEV003 and reapply this zap to that new copy.

Task 6.4: Enable C time() and gettimeofday64() function support

If your site does not require date/time exchanges for the C time() or gettimeofday64() function, you may skip this step and continue with Milestone-7-Enabling-Xchange-SVCs.

A zap to LE module CEEEV003 is required if you want to exchange the C time() and gettimeofday64() functions.

To enable this support, perform the following steps:

1. We recommend that a copy of the load module CEEEV003 be placed in its own library and this zap be applied to that copy. CEEEV003 can be found in the LE SCEERUN library.
2. This zap works in conjunction with Xchange's Enhanced STCK support or Xchange's Enhanced STCK and Enhanced STCKE support. See Milestone-7-Enabling-Xchange-SVCs.
3. Run the job contained in data set CPWR.MLXGnnn.SLXGCNTL member XGZENTPL. Follow the directions contained in the comments of the job. Editing of the CPWR.MLXGnnn.SLXGDATA member XGZAPPLI or XGZAPP23 is required in order to supply the user SVC numbers to be used by Xchange's Enhanced STCK or Xchange's Enhanced STCK and Enhanced STCKE Support, respectively.
4. Concatenate the library with the zapped version of CEEEV003 before the normal LE SCEERUN library. Only use this zapped copy of CEEEV003 when Xchange is required to support the C time() or gettimeofday64() function.