Using Additional Features › Register Source Program Listings

Register Source Program Listings

If you use PROTSYM or CA Endevor with footprinting enabled to store program listings, you do not have to manually register any listings. Simply enable the dynamic registration support. For more information, see the Installation Guide,"Customization", under the section heading Set Up Profile Parameters.

Even if you use dynamic registration support, review the Compile the Program section. You must set compilation options as indicated for the various languages regardless of the repository used for the listing.

By registering source program listings, you allow CA Mainframe Application Tuner to relate program activity to high-level language statements, instead of only CSECT offsets. When you register a program, you are requesting a routine to read the listing of the compiled program and create a table, which is used during interactive analysis.

You can register a program online with the TSO Client, or offline by using the sample batch registration procedure hilevel.TNBATREG. You set up the batch registration procedure during installation by using the product customization facility.

When registering a program online through the TSO Client, you can choose to register the listings locally or globally. A listing that is registered locally is available only to the TSO Client that performed the program registration; a listing that is registered globally is available to all users. If a listing is registered both locally and globally, CA Mainframe Application Tuner selects one, based on the following rules:

• If the monitor you are analyzing is a global monitor, CA Mainframe Application Tuner looks for a global registration. If one is not found, and dynamic registration support is enabled, CA Mainframe Application Tuner looks for a listing in the repository that is defined in the global profile parameters. Otherwise, CA Mainframe Application Tuner issues a message.
• If the monitor you are analyzing is local to the TSO Client, CA Mainframe Application Tuner looks for a local registration. If a local registration is not found, CA Mainframe Application Tuner looks for a global registration for that program. If no registration is found, and dynamic registration support is enabled, CA Mainframe Application Tuner looks for a listing in the repository that is defined in the local profile parameters. Otherwise, CA Mainframe Application Tuner issues a message.

You can register program listings for Assembler, COBOL, PL/1, NATURAL, Fortran, IBM C/C++, and SAS C. There are two steps for registering program listings:

• Compiling the program
• Registering the listings