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.

Code Debug IMS detach region facility

When using Code Debug in an IMS environment, there can be times when you need to force the end of an Code Debug test; e.g., a programmer goes home without ending the test. In some releases of IMS, the TSO ID cannot be cancelled while the IMS MPP/BMP/IFP region is still active.

For this case and others, a batch job executing the detach utility program ADSIM012 can be run to force the end of a user's Code Debug IMS MPP, BMP, or IFP test. If desired, the TSO ID can be dropped at this time.

Set up the batch job to execute the ADSIM012 program as shown as follows:

//XXX JOB...
//DETACH EXEC PGM=ADSIM012,
// PARM='...'
//STEPLIB DD DISP=SHR,DSN=CPWR.XT.SLXTLOAD

PARM is where you specify the jobs to be cancelled and is entered as follows:

  1. To detach a single job name TSOUSR1, enter:
    PARM='TSOUSR1'
  2. To detach multiple job names TSOUSR1 and BATCHJB1, enter:
    PARM='TSOUSR1,BATCHJB1'
  3. To detach all Code Debug IMS dependent region tasks, enter:
    PARM='ALLXPED'
Warning

Important

If you do not know the job names, run the ADSIM012 program without a parameter string to obtain a list of each Code Debug job or TSO session that is currently connected to the IMS control region. Alternatively, the operator can enter /DIS A on an IMS terminal to get the active job names. The job name for any Code Debug test region running in TSO is the user's TSO ID.

The ADSIM012 program can also be run as a CLIST in the TSO foreground. To get status messages at the terminal, specify WTPMSG on the TSO PROFILE command as shown in the sample CLIST as follows:

PROFILE WTPMSG
CALL 'CPWR.XT.SLXTLOAD(ADSIM012)' 'parm'

Where parm can be a single job name, multiple job names, or ALLXPED as described above.

Warning

Important

The ADSIM012 program will not detach Code Debug regions running in XPBYPASS mode because of the risk of abending the control region with a U113. Regions running in XPBYPASS mode should be cancelled the same way that a non-Code Debug region is cancelled.

To be effective, the ADSIM012 program must run in the same system where the IMS control region is running.

Because this method forces a termination of the Code Debug test session, there may be an abend on the TSO session (in Code Debug) while getting out of the test. This abend should not adversely affect any subsequent Code Debug tests.

The ADSIM012 program will not detach Code Debug regions in which the Code Debug TCB handling the STIMER loop is rendered inactive because you pressed the Attn key. However, normal IMS shutdown procedures (i.e., /STOP REG, /STOP REG ABDUMP, /STOP REG CANCEL) for these Code Debug regions will work.


 

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

BMC AMI DevX Code Debug for TSO and IMS 17.02