Files must have read and write access.
This tool requires that the files have read and write access. It will quietly fail if it is not.
In addition to normal file system permisison one may set with chmod, it also requires the file be uncompressed and not have any filters applied.
# OK unix% /bin/ls -l acis_evt.fits -rw-r--r-- 1 user group 5209 Jan 31 08:20 acis_evt.fits unix% acis_clear_status_bits acis_evt.fits # BAD unix% acis_clear_status_bits acis_evt1.fits.gz unix% acis_clear_status_bits acis_evt1.fits[ccd_id=3] unix% chmod a-w acis_evt.fits unix% acis_clear_status_bits acis_evt.fits
To verify that the tool has worked properly, users can check for the CLSTBITS keyword. If it was not present in the input file then it will be present in the output file if the tool ran correctly.
unix% dmkeypar acis_evt.fits CLSTBITS echo+ 11111111011000000011111111000001