HIST: Write histogram file

Unless the NOPH card is included in the card file (see below), 1- and 2-dimensional histograms are printed out to the log file in the program termination phase (i.e., after return from QUTERM; see 3.4 and 3.5.4).

The HIST data card is necessary for writing histograms and Ntuples to a histogram file which can be used in a subsequent interactive session (PAW). Users who want to write files larger than the maximum default size of 64 Mbytes must give appropriate NREC and RECL parameters in their HIST Card , see below .

Format

HIST `data-set-name | parameters'

data set name

see 4.1.1.

Default file format

HIS

parameters (optional) :

UPDA

Update existing histograms. Can be used deliberately if a previous job terminated due to time limit etc. but ...

CAUTION

with this option, the old histogram file will be overwritten (even on DEC).

NOOV

Overwrite protection (see 4.1.4). Cannot be used with UPDA.

On DEC/VMS :

Unnecessary.

On UNIX :

Strongly recommended.

DISP

Returns the resulting Histogram File to the original computer from which the ALPHA job was submitted. Must be used if you are running ALPHA in batch on a UNIX platform using alpharun,see App. C on p. .

NREC nmax

Sets the maximum number of records in the file to 'nmax'. If parameter NREC is missing, or if 'nmax' is missing or not in the range 100-100000, the default of 16000 records is used. The NREC parameter cannot be used with the UPDA parameter.

RECL nwords

Specifies the record length in the file to be 'nwords'. If parameter RECL is missing, or if 'nwords' is missing or not in the range 1-999999, the default record length is used. The default record length is 1024 if the UPDA parameter is missing. If the UPDA parameter is present, the default record length is 0 to let ZEBRA try to determine the record length from the file itself (if ZEBRA fails to determine the record length, ALPHA retries with RECL=1024; if the file can still not be opened the user must specify explicitely the record length that was used to create the file).

Only one histogram file can be specified using the HIST card. If you need several output files, use the standard HBOOK4 input / output routines and book Ntuples with different ZEBRA directory names. The directory name used by ALPHA is `//ALPHA'.