Booking Commands

The following calls are used to load and book the parameters, test definitions, histogram definitions, and report templates. The application must establish the histogramming area with HLIMIT or HLIMAP before the histograms are booked.

  character *(*) filename
  character *(*) histname
  integer*4 id
  integer*4 ierr

  ierr=thload(filename)
  ierr=thbook()
  ierr=thwhalias(filename)
  id = thgetid(histname)

The thload routine loads all of the blocks of parameters, tests and histograms contained in a single file. This file may have any number of blocks of separate types. Several calls to thload may be made to load definitions contained in several files. The loading does not actually set parameter values or book tests or histograms, but merely makes a copy of the files in memory. A single call to thbook will then book all of the blocks that have been loaded and not yet booked. After booking, the routine thwhalias may be used to write a file of PAW alias commands that the user may load into PAW so that histograms can be refered to by name rather than by id number.