User's Guide

PROCLIB

Display the location of all programs called by a TAE procedure.

Function:

Lists the library location of each program called by a TAE procedure. PROCLIB aids the user in verifying which programs are being called and from which library.

Parameters:

PROCNAME
Procedure name. The name of the procedure to be checked. PROCNAME should not include the .pdf extension or any subcommands specification.

PRINT(TERM)
Output destination. The destination of the report containing the library locations of the called programs.


  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent
               to the user-supplied file with the 
               extension ";prt".

Example:

  1. LAS> proclib procname=myproc print=term

    The procedure MYPROC is scanned for calls to TAE functions. The location of MYPROC and a list of the TAE functions and the library in which they are found is printed to the user's terminal.

Description/Algorithm:

PROCLIB saves the current value of $APLIB, searches the $APLIB list for the first occurrence of PROCNAME, then generates a temporary copy of PROCNAME with an "x" appended to the end. The new file name is entered into a testing utility. Command lines, comments, and shell calls are ignored - The specified procedure's SETLIBs are implemented. The $APLIB is searched in a top down fashion for the location of the called processes or procedures. This location is output to the device specified by PRINT. The original $APLIB is restored. PROCLIB will ignore all subcommands.

Nonfatal Error Messages:

  1. [proclib-getlbs] Error retrieving library

    A nonfatal error was encountered retrieving the location of a called procedure. Check to see if the call is to a imbedded process. Processing continues.

  2. [proclib-nopr] No programs called

    The procedure does not contain calls to other applications. Processing continues and output is generated.

Fatal Error Messages:

  1. [proclilb-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.

  2. [proclib-body] No body in procedure

    The specified procedure does not have a valid body structure for a procedure pdf. Verify that the specified procedure is a valid procedure pdf and re-run.

  3. [proclib-close] Error closing file

    Memory may have been corrupted somewhere, contact the system administrator.

  4. [proclib-getlb] Error finding PROCNAME

    The specified procedure cannot be found. Verify PROCNAME is correct and re-run.

  5. [proclib-print] Error printing file to destination

    An error occurred while executing FILEUTIL. Contact the system administrator.

  6. [proclib-retrv] Error retrieving called procedure list

    An error occurred while retrieving the list of called procedures. Examine PROCNAME.pdf and re-run.

  7. [proclib-rparm] Error returning parameter to TAE

    An error was encountered while trying to return a parameter to TAE. Contact the system administrator.

  8. [proclib-outnm] Error generating output file name

    A fatal error was encountered generating the output file. Contact the system administrator.

User Notes:

  1. PROCLIB traces the entire procedure, including all subcommands. Specifying a subcommand will not reduce the tracing time.

  2. PROCLIB does not recursively trace procedures within the specified procedure. The user is responsible for running PROCLIB for each procedure, if desired.

  3. PROCLIB does not search for procedures in the TAE system library, $TLIB.

  4. The following is a sample of the output generated by PROCLIB:

    
    Procedure:
    /sg2/csb/prolib/las/v6_0/test/run/app/ccttipsp
    
    Calls:
         /sg2/csb/prolib/las/v6_0/test/run/app/tmgbl
         /sg2/csb/prolib/las/v6_0/test/run/app/tipsp
         /sg2/csb/prolib/las/v6_0/baseline/run/app/fileutil