SCANOBJ: search for sections in object files

Description

Scans object files for section names. Used to find where program subroutines have been used.

Categories

Compare & Search
Program Maintenance

Related files

SCANOBJ: Object file or BASIC source.

OBJSCAN: Assembler subroutine used for object section identification. Not required for operation.

User Instructions

SCANOBJ will find section names within a given set of object files and produce a short listing. It can search for up to 36 section names in one pass, and uses the FIND "wild-card" conventions to identify files to be searched. Non-object files are bypassed. It is typically used to find the use of subroutines in object libraries.

To use the program, enter the names of the sections to be searched for on the SECTIONS screen and press (RETURN). At the INPUT screen, enter the file name and location (or the "wild card" specification) for the object files to be searched. When all files have been specified, press PF(16) to begin processing. SCANOBJ will search the specified files, showing a count of the "hits" on the OBJCOUNT screen. From here, the user can press (RETURN) to restart or PF(16) to exit the program.

The listing produced by SCANOBJ shows the file name and location the the section name found. If more than one section was found, additional lines will be printed for that file.

Programmer Instructions

With GETPARMs for all major screens, SCANOBJ can be run completely under program control. However, due to the use of the workstation to display the file names as they are searched, it may not be used in background.

SECTIONS    Enter information and press (RETURN) to continue
            or press PF(16) to exit program.

  SCNAME01  (blank)     The eight-character section name(s)
  (through)    . . .    to be found.  Up to 36 names may be
  SCNAME36  (blank)     specified.

INPUT       Press (RETURN) to continue or PF(16) to end
            specification and begin processing.  (Note: this
            screen may be answered as many times as necessary
            to specify all files to be searched.)

  FILE      (blank)     The names and locations of the files
  LIBRARY   (blank)     to be processed.  "Wild-card" entries
  VOLUME    (blank)     may be used.  Press PF(16) to begin
                        processing.

OBJCOUNT    Press (RETURN) to run again or PF(16) to exit
            program.  (Note: this screen also displays the
            number of files found.)

BASIC and Assembler source is available.

Example of use

Use SCANOBJ to find the use of subroutines within object programs. For example, here's how you could locate all object files in the USERAIDS library that use the FIND subroutine:
1. At the SECTIONS screen, enter 'FIND' in the SCNAME01 field. Press (RETURN).

2. At the INPUT screen, select all of the files in the USERAIDS library by entering '?' in the FILE field, 'USERAIDS' in the library field, and the volume name in the VOLUME field. Press (RETURN) to accept this group.

3. At the next INPUT screen, press PF(16) to end specifications. SCANOBJ will search the library, showing the number of "hits" on the OBJCOUNT. Press PF(16) to exit the program.

4. Examine the listing produced by this search.

If desired, the search could also include other section names and libraries.

Comments

The problems running SCANOBJ under release 7 operating systems relate to its use of the FIND subroutine. If the BASIC source is available, recompile and relink to newer versions of subroutines; be sure to link to the OBJSCAN subroutine as well.