FILO : Output files

Event output is controlled by the FILO card and by the subroutine QWRITE (see 13.2). The data set name and options are given on the FILO card. Calling QWRITE writes the current event to the output file. The COPY card (see 4.1.7) may also be used to write events to a file. If a FILO card is given, all run records will be written out by default (see ALLR, NORU, and SELR below).

Format:

FILO `data-set-name | parameters'

data set name

same as on FILI cards; see examples in 4.1.2.

File format

NATIVE, EPIO, or EDIR

parameters:

(optional)

label

if the output is on cartridge or DLT, will be the magnetic label for this tape. Usually set as ALDATA for POTs,DSTs,MINIs and to KINDATA for KINGAl outputs.

ALLR

write all run records to the output file (Default when writing output POTs/DSTs). Must be used if you intend to read the output file/EDIR with the QFND option for real data of 1993 and after (QFNDIP needs special banks from the run header).

NORU

write no run records to the output file.

SELR

write run records as soon as the first event record corresponding to it is written (default when writing a MINI). It can be used if few events are selected from a large data sample; without this option, the output file may consist mainly of run records. With SELR, only run records which are followed by event records are written. DO NOT use this option if you write an output EDIR !

SREC

write all ``special'' records to the output file. Without this card, all records which are neither event nor run records will not be written.

NOOV

simple-minded protection against involuntarily overwriting data sets. If this parameter is given AND the output data set already exists, the program will stop. Note that problems with overwriting do not arise on the VAX.

DISP

The DISPose option ensures that your EPIO output file will be sent back to the UNIX platform from which you have sent your ALPHA batch job.

Examples:

FILO `abc.native | SELR | NATIVE | NOOV' The 2nd ``NATIVE'' is redundant; see 4.1.2.

FILO `mydata.epio | EPIO | DISP' The output EPIO file will be sent back to the computer where you run alpharun.

FILO `ALDATA | EPIO | CART AT1234.45.AL' The output EPIO file will be written on file 45 of the DLT tape AT1234 with ANSI label ALDATA. This is valid at CERN only. Please see with your system administrator if this syntax for tapes/DLTs works on your computer, if you are working in a Homelab.

More than one FILO card is not accepted. If you want to write on several output units simultaneously, use the standard BOS routines.

The output event type (POT, DST, MINI - see 4.1.1) is the same as the input event type unless the MINI card is given (see below). Event directories can be created from any input event type (see 4.1.5).