Google
 

Trailing-Edge - PDP-10 Archives - BB-PBQUC-BM_1990 - help/cref.hlp
There are 47 other files named cref.hlp in the archive. Click here to see a list.
CREF command

The CREF command runs the CREF program, which produces cross-reference
listings from files of type .CRF.


Format

     @CREF destination-filespec=source-filespec /switch(es)

     where:

     destination-filespec     is the name of the  file  or  device  to
                              which  you  want  to  send the processed
                              contents of the .CRF file.
                                   Default - LPT:

     source-filespec          is the name of the .CRF file you want to
                              process.
                                   Default - the names of all files of
                                             type .CRF produced during
                                             the   current    terminal
                                             session

     /switch        is one or more keywords from the following list.


                        CREF Program Switches


     /A             Advances magnetic tape reel by one file.  You  can
                    type  this  switch  more  than once in the command
                    string.

     /B             Backspaces magnetic tape reel by  one  file.   You
                    can type this switch more than once in the command
                    string.

     /C             Cancels the processing of  any  switches  in  your
                    SWITCH.INI file.

     /D             Restores the processing of any default switches in
                    your SWITCH.INI file.

     /H             Types the CREF help file.   /H  is  illegal  in  a
                    SWITCH.INI file.

     /K             Suppresses  Regular  Symbol  Table  in  the   CREF
                    listing.

     /M             Suppresses OPDEF/Macro Table in the CREF listing.

     /O             Includes the Op Code Table in the CREF listing.

     /P             Preserves an input file with the file type .CRF or
                    .LST.   These  types  of  input files are normally
                    deleted.

     /R             Requests the line number at which the CREF listing
                    is  to  start.  CREF types out "RESTART LISTING AT
                    LINE:", after which you type the line  number  and
                    press  RETURN.   If you use an indirect file, CREF
                    looks for the number in the indirect file.  /R  is
                    most   useful   for  physical  (non-spooled)  line
                    printers, and is illegal in a SWITCH.INI file.

     /S             Suppresses the program listing and lists only  the
                    tables you select.

     /T             Skips to the logical end of the magnetic tape.

     /W             Rewinds the magnetic tape.

     /Z             Zeroes  the  DECtape   directory.    This   is   a
                    historical switch, and is illegal.


Characteristics

     Current .CRF Files

          If you have  files  of  type  .CRF  produced  by  LOAD-class
          commands during the current terminal session, the unmodified
          command CREF produces  listings  of  them  and  deletes  the
          files.   By  supplying  an argument of the form shown in the
          Format section above, you can copy the listing for a current
          .CRF  file  to  another  file  or  device.   To run the CREF
          program yourself when you have current .CRF files, give  the
          command R CREF instead.

     .CRF Files From a Previous Session

          If your only files of type .CRF (created by the CREF program
          or  one  of  the LOAD-class commands) were produced during a
          previous  terminal  session,  the  command  CREF  puts  your
          terminal at command level in the CREF program, symbolized by
          an asterisk (*).  Thus it is equivalent  to  the  command  R
          CREF  in this case.  See Hints - Further Information, below,
          for advice on how to proceed.


Hints

     Producing .CRF Files

          You can produce cross-reference files by including the /CREF
          switch  in  any  LOAD-class  command  that actually causes a
          compilation (i.e., is not  prevented  from  doing  so  by  a
          /RELOCATABLE  switch  or  by the existence of current object
          files).

     Preserving .CRF Files After Processing

          Give the /P switch immediately after  the  CREF  command  to
          preserve  .CRF  files.   Ordinarily  they  are deleted after
          being sent to an output device or copied into another file.

     Further Information

          For  more  detailed  information,  see  the   TOPS-20   User
          Utilities Guide.


Effect on Memory and Terminal

     The CREF command replaces the contents of  any  unkept  forks  in
     memory  with the CREF program and leaves your terminal at TOPS-20
     command level, or at command level within  CREF  (denoted  by  an
     asterisk prompt [*]).


Related Commands

     LOAD-class commands     for producing .CRF files


Examples

     1.  Give the CREF command to obtain a listing of your .CRF file.

         @CREF
         CREF:   TESTF1

     2.  Compile two FORTRAN  programs,  using  the  /CREF  switch  to
         produce  .CRF  files.   Then  give the CREF command to obtain
         listings of these, and use the /P switch to preserve the .CRF
         files.

         @COMPILE /CREF TESTF1.FOR, TESTF2.FOR
         FORTRAN: TESTF1
         MAIN.
         FORTRAN: TESTF2
         MAIN.
         @CREF/P
         CREF:   TESTF1
         CREF:   TESTF2

     3.  Determine what .CRF files you have, then mount a tape.   Give
         the  CREF command, and once within the CREF program, have the
         cross-reference listing produced  from  one  of  these  files
         copied   onto  tape.   (The  .CRF  files  are  not  processed
         automatically when you give the  CREF  command  because  they
         were produced during a previous terminal session.)

         @DIRECTORY *.CRF

            PS:<LATTA>
          TESTM1.CRF.2
          TESTM2.CRF.1

          Total of 2 files
         @MOUNT TAPE CRFMAC:/WRITE-ENABLED
         [Mount Request CRFMAC Queued, Request-ID 128]
         [Tape set CRFMAC, volume CRFMAC mounted]
         [CRFMAC defined as MT3:]
         @CREF

         *MT3:=TESTM2
         [CRFXKC 4K core]
         *^C
         @DISMOUNT TAPE CRFMAC:
         [Tape dismounted, logical name CRFMAC: deleted]