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.

Starting Xchange

This topic provides instructions for starting Xchange as a batch job or as a started task.

Important

For the Xchange subsystem to properly detect job starts and completions, your site must run with the MVS system commands MONITOR JOBNAMES and MONITOR SESS. Consult your site’s MVS system programmer.

Starting Xchange as a Batch Job

Starting Xchange as a batch job provides a convenient way to test new releases of the product. Be sure to include the TIME=1440 parameter shown to prevent the job from exceeding the CPU time limit (MVS abend S322).

The following figure details sample JCL to initiate Xchange as a submitted job. This JCL is contained in XGSTART in CPWR.MLXGnnn.SLXGCNTL:

Sample Batch Execution JCL (XGSTART)

//* ==> INSERT JOB CARD HERE
//*
//*********************************************************************
//* XCHANGE USER: *
//* *
//* YOU CAN USE THIS JCL TO ACTIVATE YOUR XCHANGE SUBSYSTEM. *
//* *
//* ADD A VALID JOB CARD. *
//* *
//* OPTIONALLY, CODE THE PARM='SVCNUM=???,RUNTYPE=INSTALL' *
//* (WHERE ??? IS THE XCHANGE SVC NUMBER.) THE PARM IS REQUIRED TO *
//* INSTALL / ACTIVATE THE XCHANGE SVC (NECESSARY FOR STCKSYNC *
//* AND ENHANCED STORE CLOCK SUPPORT). - SEE 'ENABLING XCHANGE * 
//* SVC' FOR FURTHER INFORMATION ON THE PARM FIELDS. * 
//* *
//* OPTIONALLY, CODE THE PARM='SVCENM=???,RUNETYP=INSTALL' *
//* (WHERE ??? IS THE XCHANGE SVC NUMBER.) THE PARM IS REQUIRED TO *
//* INSTALL / ACTIVATE THE XCHANGE SVC (NECESSARY FOR ENHANCED *
//* STORE CLOCK EXTENDED SUPPORT). THESE PARM FIELDS CAN BE *
//* INCLUDED ON THE PARM WITH THE PARM FIELDS FOR STCKSYNC *
//* SUPPORT. - SEE 'ENABLING XCHANGE SVC FOR FURTHER INFORMATION * 
//* ON THE PARM FIELDS. *
//* *
//* OPTIONALLY, CODE 'SUFFIX=????' ON ONE OF THE PARMS PROVIDED TO *
//* OVERRIDE THE DEFAULT XCHANGE BMC AMI COMMON MAINFRAME SERVICES *
//* CONTROLLER (CMSC) PARM MEMBER, WHERE ???? SPECIFIES A *
//* 4-CHARACTER SUFFIX OF THE XCHANGE CMSC PARMLIB MEMBER INCLUDING *
//* TRAILING SPACES IF NECESSARY. *
//* *
//* OPTIONALLY, UNCOMMENT THE "//*CWSC???? DD DUMMY" STATEMENT IF *
//* YOU WISH TO OVERRIDE THE DEFAULT CMSC IN WHICH XCHANGE WILL *
//* RETRIEVE PARAMETERS, WHERE ???? SPECIFIES THE 4-CHARACTER CMSC *
//* IDENTIFIER FOR THE CMSC ADDRESS SPACE IN WHICH XCHANGE WILL *
//* RETRIEVE PARAMETERS. *
//* *
//* USE ISPF 'CHANGE ALL' TO REPLACE CPWR TO THE HIGH-LEVEL DSN *
//* NODE OF YOUR APF AUTHORIZED XCHANGE LOAD LIBRARY. *
//* *
//* USE ISPF 'CHANGE ALL' TO REPLACE 'CUSTOMER.SAVEREST.FILE' WITH *
//* THE FILE DSN YOU WISH TO USE WITH XCHANGE. THIS *
//* DATASET WAS CREATED USING 'ALLOCSAV' JCL. *
//* *
//* SUBMIT THE JOB. *
//*********************************************************************
//*
//XCHANGE EXEC PGM=XGMMAIN,
//* PARM='SUFFIX=????',
//* PARM='SVCNUM=???,RUNTYPE=INSTALL',
//* PARM='SVCNUM=???,RUNTYPE=INSTALL,SUFFIX=????',
//* PARM='SVCENM=???,RUNETYP=INSTALL',
//* PARM='SVCENM=???,RUNETYP=INSTALL,SUFFIX=????',
//* PARM='SVCNUM=???,RUNTYPE=INSTALL,SVCENM=???,RUNETYP=INSTALL',
//* PARM='SVCNUM=???,RUNTYPE=INSTALL,SVCENM=???,RUNETYP=INSTALL,S+ 
//* UFFIX=????', 
// TIME=1440
//*
//STEPLIB DD DSN=CPWR.MLXGnnn.SLXGAUTH,DISP=SHR
//*
//XGSAV001 DD DSN=CUSTOMER.SAVEREST.FILE,DISP=SHR
//*
//*CWSC???? DD DUMMY
//


For more information about the optional PARM fields used to install and activate STCKSYNC, STCKE, and Enhanced STCK, STCKE, and STCKF Support, see Enabling-Xchange-SVC.

In the example shown in the Sample Batch Execution JCL (XGSTART) figure, you must provide the following information:

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, 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'
//STEPLIB DD DSN=CPWR.MLXGnnn.SLXGAUTH,DISP=SHR
//XGSAV001 DD DSN=customer.saverest.file,DISP=SHR

For more information on the optional PARM fields used to install and activate STCKSYNC, STCKE, and Enhanced STCK, STCKE, and STCKF Support, see Enabling-Xchange-SVC.

In the example shown in the Sample Command Procedure to Initiate Xchange figure, you must provide the following information:

 

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