Register the Module

Using Additional Features › Export a Monitor Data Set › Register IBM C/C++ Listings with Language Environment Support › Register the Module

Register the Module

The output listing from the final link-edit of the load module needs to be registered in order to successfully register CSECT listings. The MAP option must be used to obtain a map of generated CSECT names.

Generated CSECT names are linked to the actual CSECT listing based on the CSECT length. If more than one CSECT has the same length, the incorrect CSECT listing might be used.

Select the Registration option.
Select option C1 - IBM/C from the Program Listing Registration menu.
The Registered Listings: IBM/C panel displays.
Issue the MODule primary command.
The Registered Listings: Modules panel displays.
Issue the ADD primary command.
Specify the data set information for the Link-edit output listing.
If the module listing is in a PDS, a list of members displays from which you can select the correct member.
Press Enter to register the listing.
A message indicates whether the module has been registered successfully and you can return to the Registered Listings: IBM/C panel to register the CSECT listings that are included in the registered module normally. There are a few considerations:
- If a CSECT cannot be found in the load module listing, the Completion field indicates this situation, and the CSECT is not registered. Verify that the correct CSECT or Module listings are being used.
- If a data set contains multiple CSECT listings, or if multiple listing members are processed (using the 'REGister All' command), each listing is registered by using the same module.
- A new command has been added to the 'Member List' panel. Use the REGister all command to register all members that are displayed on the panel.
- For Language Environment C++ listings, all CSECTs will be registered by using the same module. You will only need to specify the module name.
To select the language of the program that you want to register, type the code in the Option field.
To select the listing manager that you want to register, type the first two letters of the manager. The listing manager indicates where the listings reside.
- PDs - Listings are stored in PDSs or PDSEs.
- DDio - Program listings are stored in the Compuware Common Services DDIO file. You must know the name of the listing and the DDIO file in which it resides before you can register the program.
- Only COBOL listings can be registered from DDIO files.
- ENdevor - Program listings are stored and managed by CA Endevor. You must know which member and library the program listing is in before it can be registered.
- PAnvalet - Program listings are stored and managed by CA Panvalet. You must know which member and library the program listing is in before it can be registered.
- PRotSym - Program listings are stored and managed by ProtSym. You must know which member and library the program listing is in before it can be registered.
- LIbrarian - Program listings are stored and managed by CA Librarian. You must know which member and library the program listing is in before it can be registered.
- CHangeman - Program Listings are stored and managed by Serena Changeman. You must know the Changeman Link Library where the SERCOPY program is located (default: 'serena.CHGMAN.LINKLIB', where serena is the high-level qualifier), the listing data sets, and member name where the program listings are stored.
Depending on the language you select and the listing manager, a panel showing all COBOL, Assembler, PL/1, Fortran, IBM C/C++, NATURAL, or SAS C programs that are currently registered with CA Mainframe Application Tuner displays. From this panel, you can either add new listings or delete old listings. If you add a listing that already exists, the new listing replaces the existing listing.
Press Enter to register the listings. A message indicates when the registration is complete.

Example: Registering COBOL listings

Select Option C and any one of the listing managers.
Press Enter.
The Registered Listings: COBOL panel displays.
```
CA MAT -------- Registered Listings: COBOL      ------------- ROW 0 to 0 of 0
 COMMAND ===>                                                  SCROLL ===> CSR

 Primary commands: ADD, REBuild, ADDHelp

 Line commands: B - Browse  R - Register  D - Delete

 LC CSECT    Type   Dataset name

    ________ ______ ______________________________________________________
 >------------------------------------------------------------------------------
 ********************************* END OF TABLE ********************************
```
The commands available for the Registered Listings panel are described next.

ADD

Registers a new listing.

CA Mainframe Application Tuner prompts for the data set in which the listing resides.

REBuild

Registers all listings that are displayed in the Administration panel.

This command is helpful when working with a larger application.

ADDHelp

Invokes the content-sensitive Help application to update or create a Help entry for the selected content.

Browse

Displays the registered listing.

Register

Reregisters the listing.

Use this option if you modify a program after registering it with CA Mainframe Application Tuner.

Delete

Deletes the listing registration table for the selected program.

The fields on the Registered Listings panel are described next.

CSECT

Displays the CSECT name of the program that you have registered.

The name is extracted from the listing and might not be the member name of the listing data set.

Type

Displays the compiler type that created the listing.

data set name

Displays the data set name where the program listing resides.

VOLSER

Displays the Volume serial number of the listing data set.

The serial number displays only for uncataloged data sets.

CompDate

Displays the date that the listing was compiled.

This date is extracted from the listing.

CompTime

Displays the time that the listing was compiled.

This date is extracted from the listing.

Listing Manager

Listing manager in which the program listing resides.
On the COMMAND line, type ADD.

Press Enter.

The COBOL Map Resolution panel displays.

Each listing manager has its own map resolution panel.

 CA MAT ----------------- COBOL Map Resolution ------------------------
 COMMAND ===>

 Specify Listing Dataset(s) below:
    Project ===>
    Group   ===>          ===>          ===>          ===>
    Type    ===>
    Member  ===>

 Other partitioned or sequential dataset:
    Dataset name   ===>
    Volume serial  ===>         (If not cataloged)


 Press ENTER key to select members
 Enter END command to cancel.

PDS only: if you select the PDS listing manager, type the name of the data set containing the listings and press Enter.

The Member List panel for PDS displays.

CA MAT ------------------------- Member List -------------- ROW 1 to 21 of 28 COMMAND ===> SCROLL ===> CSR Dataset: TUN.TEST.COB2LIST Line commands: S - Select B - Browse Change Change LC Name Completion VV MM Created Date Time User ________ _________________________ __ __ ________ ________ ______ ____ >------------------------------------------------------------------------ - __ ACCT00 __ ACCT00# __ ACCT01 __ ACCT02 __ CAC080 __ COBDIV00

Type S next to the source module names that you want to register with CA Mainframe Application Tuner and press Enter.
A message indicates when the listing has been registered. It might take several seconds for the source member to complete registration.

The fields in the Member List panel are described next.
Name

Displays the name of the member in the listing data set.

This name is specified during the execution of the compiler on the SYSPRINT DD statement.

Completion
Displays the status of the listing registration.

The text can be one of the following statements
- Successfully registered
- Not a program listing
- No offset map found
VV

Displays the version level for the member when changed with ISPF EDIT.

If the member was not changed by using ISPF EDIT, this field is blank.

MM

Displays the modification level for the member when changed with ISPF EDIT.

If the member was not changed by using ISPF EDIT, this field is blank.

Created

Displays the time this member was created by using ISPF EDIT.

If the member was not created by using ISPF, this field is blank.

Change Date

Displays the date the member was last modified or created by using ISPF EDIT.

If the member was not created or modified by using ISPF EDIT, this field is blank.

Change Time

Displays the time the member was last modified or created by using ISPF EDIT.

If the member was not created or modified by using ISPF EDIT, this field is blank.

User

Displays the TSO user ID of the user that created or last modified this member by using ISPF EDIT.

If the member was not created or modified by using ISPF EDIT, the field is blank.

Size

Displays the number of lines that the member currently contains.

If the member was not changed by using ISPF EDIT, this field is blank.

Init

Displays the initial size of the member when it was created by using ISPF EDIT.

If the member was not created by using ISPF EDIT, this field is blank.

Mod

Displays the number of lines that are marked as modified when using ISPF EDIT.

If the member was not changed by using ISPF EDIT, this field is blank.

DDIO, ProtSym, Panvalet, Librarian, CA Endevor, or ChangeMan: If you select Option C and the DDIO, ProtSym, Panvalet, Endevor, Librarian or ChangeMan listing manager, a COBOL Map Resolution panel similar to the example shown following displays.

 CA MAT ------------------- COBOL Map Resolution      --------------- 
 COMMAND ===>                                                        
                                                                           
 Specify DDIO listing data set and member below:                        
   Listing data set choice  ===>    (1 through 8)                       
               Member name  ===>                                          
                                                                           
       Listing data sets 1  ===>                                          
                         2  ===>                                           
                         3  ===>                                           
                         4  ===>                                           
                         5  ===>                                           
                         6  ===>                                           
                         7  ===>                                           
                         8  ===>                                           
                                                                           
 Press ENTER to register listing                                         
 Enter END to cancel

Specify the data set that contains the program listing and press Enter.
It might take several seconds for the source member to complete registration.

Tell Technical Publications how we can improve this information