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.

List of DLL Functions (2.6.F)


The List of DLL Functions screen (2.6.F) displays the list functions that make up a DLL. It can be used to select/deselect a DLL function (actually the underlying CSECT) in the same manner as the List of CSECTs (2.6.1) screen. It can also be used to set a breakpoint at the beginning of a DLL function (similar to the INTERCEPT command on the List of CSECTs screen) and to transfer to the Source Listing (2.L) Screen and position the listing at the start of the function indicated.

Important

If a CSECT contains more than one function (as is possible with Assembler, C, and PL/I), all functions in that CSECT are selected. Also, setting a breakpoint in a DLL function and/or viewing the source of a DLL function automatically selects that function.

Access this screen by typing F on the CSECT/Function Display Menu (2.6), or type =2.6.F in the COMMAND field.

List of DLL Functions Screen (2.6.F)

------------------------- List of DLL Functions (2.6.F) -------------------C123
COMMAND ===>                                                   SCROLL ===> CSR
MODULE: CW@DLL   CSECT: Invoke_C          COMPILED: 01 MAY 2006 - 08:07:07

LINE COMMANDS:  S (Select)  D (Deselect)  B (Before)  V (View Source)
LOADED FROM LIBRARY: XD.TEST.R81.LOADLIB
CMD  FUNCTION                           CSECT            LISTING  SEL   LANG
---------------------------------------------------------------------- ------
 _   Call_A_2nd_ASM_DLL_Routine         CWADLL           CWADLL   NO    HLASM
 _   Do_A_PLI_DLL_Function              DLLPLIB          CWPDLL   NO    PLI
 _   Do_C_2nd_DLL_Function              CWZDLL_F         CWZDLL   NO    C
 _   Exec_3rd_C_DLL_Test                CWZDLL_F         CWZDLL   NO    C
 _   Invoke_COBOL_DLL_Function          Invoke_C         CWCDLL1  NO    COBOL
 _   Perform_ASM_DLL_Function           CWADLL           CWADLL   NO    HLASM
 _   Perform_C_DLL_Function             CWZDLL_F         CWZDLL   NO    C
 _   Try_A_2nd_COBOL_DLL_Call           Try_A_2n         CWCDLL2  NO    COBOL
 _   Yet_A_2nd_PLI_DLL_Routine          DLLPLIB          CWPDLL   NO    PLI
     **END**


Input Fields

MODULE

Field used to show the name of the current application program. For a DLL, this defaults to the first physical CSECT in the DLL load module for which source is available. Access to the source listing for the DLL function is available by entering the DLL name in the MODULE field at the top of the screen and transferring to the Source Listing (2.L) screen.

CMD

This field is used to select and deselect DLL functions. The following line commands are valid on this screen:

  • S: Select this DLL function. After you press Enter, the SEL field shows a value of YES for the DLL function that was selected. When a DLL function has been selected, an entry is made in the CSECT selections table. When you select a DLL function, all DLL functions in that CSECT are selected. This entry appears on the CSECT Selections (2.6.2) screen.
  • D: Remove the selection of this DLL function. A value of NO appears in the SEL field for this DLL function after you press Enter and deletes the entry from the CSECT Selections screen. When you deselect a DLL function, all DLL functions in that CSECT are deselected.
  • B: Select the DLL function and set a breakpoint at the entry point for that DLL function.
  • V: Transfer to the 2.L screen and position at the beginning of the source for the specified DLL function.

Output Fields

FUNCTION

This field shows the functions in the DLL.

CSECT

This field shows the names of all CSECTs contained in the DLL module.

LISTING

This field allows you to specify the listing name by overtyping the current value if it differs from the CSECT name.

SEL

This field shows the status of the DLL. Possible values are:

  • NO: DLL function is not selected.
  • YES: DLL function is selected.
  • EXCLUDED: CSECT containing the DLL functions was excluded on the 9.5 screen and cannot be selected. The CMD field is protected from input.

LANG

This field shows the language for the specified DLL functions.

 

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