Merging HBOOK files into a new file

CALL HMERGE (NFILES,CHFIN,CHFOUT)

Action: Merges two or more HBOOK files with identical objects and directories into a new file. Histograms are added and Ntuples are combined. Works for CWN's and RWN's.

Input parameter description:

NFILES

Number of input files to be merged.

CHFIN

Character array (eg. CHARACTER*8 CHFIN(10) for 10 files whose names are not longer than 8 characters) containing the name(s) of the file(s) to be merged.

CHFOUT

Character variable with the name of the output file.

CALL HMERGIN

Action: Identical to HMERGE but the routine prompts interactively for the names of the input and output files. The PAW command NTUPLE/HMERGE

Scratching histogram in a file

CALL HSCR (ID,ICYCLE,CHOPT)

Action: Scratch (delete) a histogram from the current directory in the direct access file.

Input parameters:

ID

Histogram identifier. ID=0 means scratch all histograms in the current directory.

ICYCLE

Cycle number. If ICYCLE=0 then all cycles are deleted.

CHOPT

Character variable specifying options selected.

' '

Only possible value (not used at present)

Close a file

CALL HREND (CHTOP)

Action: Closes a direct access file if is not needed anymore or when the options 'N' or 'U' are specified in HRFILE.

Input parameter:

CHTOP

Character variable specifying the name of the top directory associated with the file to be closed. This should correspond to the name declared with HRFILE. After this call, the system bank associated to this file is deleted. The call to HREND is obligatory when the file has been modified.

Remark:

A Fortran CLOSE statement should follow a call to HREND.