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.

Milestone 7: Enabling Xchange SVCs

This milestone contains tasks for enabling an Xchange SVC for Enhanced STCK Support and STCKSYNC macro support and another Xchange SVC for Enhanced STCKE Support and STCKE macro support. These are two separate and distinct SVCs. They are described in more detail in the following tasks:

The roles involved are: 

  • Xchange Installer 
  • z/OS System Programmer.

Starting Xchange as a started task

Starting Xchange as a started task automatically executes the product at IPL and uses no initiators. Also, started tasks are not constrained by batch performance values.

To execute Xchange from the operator console as a started task, you will place the procedure shown in the following figure in the appropriate procedure library (PROCLIB). Be sure to include the TIME=1440 parameter shown to prevent the job from exceeding the CPU time limit (MVS abend S322).

Sample Command Procedure to Initiate Xchange

//XCHANGE PROC
//IEFPROC EXEC PGM=XGMMAIN,TIME=1440,
// PARM='SVCNUM=???,RUNTYPE=INSTALL,SVCENM=???,RUNETYP=INSTALL,SVCENM=???,RUNETYP=INSTALL'
//STEPLIB DD DSN=CPWR.MLXGnnn.SLXGAUTH,DISP=SHR
//XGSAV001 DD DSN=customer.saverest.file,DISP=SHR

In the example shown in the previous figure, you must provide the following information:

Tasks

Complete the following tasks to enable Xchange SVC support.

Task 7.1: Enable SVC for enhanced STCK and STCKSYNC macro support

Xchange provides support for enhanced STCK Support for date/time simulation of Assembler STCK operation code and STCKSYNC macro support. STCK and STCKSYNC support are implemented with one SVC. The SVC is installed as part of the Xchange startup JCL.

  1. Consult your site's system programmer for an available SVC number between 200 and 255.
    Ensure the SVC number chosen will not be used by any other product.
  2. Edit the JCL shown in the Sample Command Procedure to Initiate Xchange figure, replacing the ??? values on the field SVCNUM with the SVC number.
  3. Specify INSTALL or REFRESH for RUNTYPE.
    Use INSTALL unless specifically told to use REFRESH by Xchange Customer Solutions. When INSTALL is used, a check is done to see if the SVC is installed. If it is not installed, Xchange will dynamically install the specified SVC. The SVC will remain installed until the next system IPL. Between IPLs, using INSTALL during the startup of Xchange ensures that the SVC is installed.
  4. When you are ready to start Xchange, submit the revised JCL.

Using STCKSYNC support

STCKSYNC support is required with CICS region support. The activation of STCKSYNC support is done during the startup of Xchange. By enabling the Xchange SVC for Enhanced STCK Support, you also enable STCKSYNC support. See Task 10.2: Enable CICS region support for additional information.


Task 7.2 Enable SVC for Enhanced STCKE and STCKE macro support

Xchange provides support for Enhanced STCKE Support for date/time simulation of Assembler STCKE operation code and STCKE macro support. The SVC is installed as part of the Xchange startup JCL.

  1. Consult your site's system programmer for an available SVC number between 200 and 255. 
    Ensure the SVC number chosen will not be used by any other product.
  2. Edit the JCL shown in the Sample Command Procedure to Initiate Xchange figure, replacing the ??? values on the SVCENM field with the SVC number.
  3. Specify INSTALL or REFRESH for RUNETYP. Use INSTALL unless specifically told to use REFRESH by Xchange Customer Solutions. When INSTALL is used, a check is done to see if the SVC is installed. If it is not installed, Xchange will dynamically install the specified SVC. The SVC will remain installed until the next system IPL. Between IPLs, using INSTALL during the startup of Xchange ensures that the SVC is installed.
  4. When you are ready to start Xchange, submit the revised JCL.

Important

If Xchange  is started without installing the SVC, any zapped modules using Enhanced STCK or STCKE Support will fail with an Sf xx  abend, where  xx  is the hex representation of the SVC number used in the zap

For information on how to use Enhanced STCK or STCKE Support, see User Guide.

Using Enhanced STCKE support

Enhanced STCKE support is required for systems running z/OS 2.3 and above that also need to have the zap to LE module CEEPLPKA applied for any of the following reasons:

  • CICS region support,
  • Db2 stored procedure support, or
  • If Xchange will be working with date/time calls in an IMS MPR that specifies a pre-load of CEELRRIN.


 

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