osf_create

Usage:

% osf_create -p pathfilename -f filename [-t type] [-n number] [-c column -s status]

p : name of the path file. This does not include the directory specification. The path is assumed to be in opus_definitions_dir. No default.

f : name of the observation or fileset. This is often the root name of an exposure, but might be the rootname of any dataset. No default.

t : datatype of the dataset. This is usually the instrument, but might also be 'ANC' for ancilliary data or 'OMA' for grand mamas. Default = 'ZZZ'.

n : the DCF number - or any 3 digit number to distinguish (and sort) the observation status files. Default = '000'.

c : the column in the observation status file. This is a two character field. The column identifier must exist in the pipeline.stage file. Default = (first column). More than one -c option may be specified.

s : status letter to be placed in the field. Default = 'P'. More than one -s option may be specified.

Returned status value is: '0' on success, '1' on general failure, or '2' on failure due to a persistent file lock.

% osf_create -p blue.path -f N42T3TAUQ -t NIC -n 107 -c DP -s P

results in an Observation Status File (OSF) called something like

34041E70-P_______________________.N42T3TAUQ______________-NIC-107-____

created in the OPUS_OBSERVATIONS_DIR directory as defined in the path file OPUS_DEFINITIONS_DIR:blue.path.