LOAD command

Specifies that the named module should be loaded for debugging purposes. The LOAD command enables you to debug preloaded load modules.

If you are running in Language Environment, the enclave-level load service is used to load the load module or modules. The load module or modules remain active until the current enclave terminates or you enter the CLEAR LOAD command for those load modules.

If you are not running in Language Environment, the load module or modules remain active until the debugging task terminates or you enter the CLEAR LOAD command for those load modules. If you are debugging CICS® programs, the load is done by EXEC CICS LOAD. For all other programs, the load is done by MVS™ LOAD services.

>>-LOAD--+-module_name-----------+--+-------+--;---------------><
         |    .-,-----------.    |  +-LE----+      
         |    V             |    |  '-NONLE-'      
         '-(----module_name-+--)-'                 

module_name

The name of one or more load modules to be loaded by Debug Tool.

LE

Use the Language Environment enclave-level load service to load the load module or modules. The load module or modules remain active until the current enclave terminates or you enter a CLEAR LOAD command for the load module or modules.

NONLE

Use non-Language Environment services to load the load module or modules. The load module or modules remain active until the debugging task terminates or you enter a CLEAR LOAD command for the load module or modules. For CICS programs, the load module or modules are loaded by using EXEC CICS LOAD. For all other programs, the load module or modules are loaded by using the MVS LOAD services.

Usage notes

• You can use this command in remote debug mode.
• You can enter the SET QUALIFY CU command for a program or CSECT in the load module or load modules that you just loaded unless the program is COBOL.
• If you set breakpoints in the programs or CSECTS in the module and then the same load module is loaded again, the breakpoints might not work because location of the load module has changed.
• If the module to be debugged is RESIDENT or was loaded before Debug Tool was started, you can use the LOAD command to make the module known to Language Environment.
• You cannot use this command to load a DLL.

Refer to the following topics for more information related to the material discussed in this topic.

• Related references
• Debug Tool commands supported in remote debug mode