HKUTIL(1)

NAME

     hkutil - Housekeeping data extraction utility

SYNOPSIS

     hkutil [-C] day_num mnemonic_rdb_file [output_dir]
       where day_num = mission day to extract the params from
       and mnemonic_rdb_file looks like (for example):

     Mnemonic        Description     Source  Format
     --------        -----------     ------  ---------
     mkpkfmid        FmtId           MDI     %08x
     mksqid          SqID            MDI     %0x
     miaemtr         Motor Cur       MDI     %0.1f
     mipwb           BusB Cur        SC1     %0.3f
     m+5pc1n         Conv1 +5Vn      SC2     %0.3f
     m+15pc1r        Cnv1 +15Vr      SC2     %g
     m+5cm           CCD +5V         MDI     %e

       and output_dir is place to put output rdb files. Default is "."

         The -C flag will look for the hk tlm files only in the
     official CDROM files stored on /PAS1/hk. The default will be
     to use the linked files at /mdi/mdi_egse_data/log which include
     the mdi_eof hk files.

DESCRIPTION

     hkutil will extract ANALOG, DIGITAL or  REGISTER  parameters
     from the housekeeping telemetry files according to the input
     mnemonic_rdb_file for the parameter names  and  source.  The
     formatting  will be as specified in the Format column of the
     mnemonic_rdb_file, so if a value of a  format  of  %0.1f  is
     15.3 then a %08x will show as 0000000f.

EXAMPLES

     >hkutil 1117 hk.extract.rdb hk
     Opened the mnemonic table: hk.extract.rdb
     Tlm file opened: /PAS1/hk/mdi_hk12/60230403.d01
     Tlm file opened: /PAS1/hk/svm_hk1/96012303.dat
     Tlm file opened: /PAS1/hk/svm_hk2/96012303.dat
     Tlm file opened: /PAS1/hk/svm_hk4/96012303.dat
     Opened output table: hk/mdi_hk_1117.rdb
     Opened output table: hk/sc1_hk_1117.rdb
     Opened output table: hk/sc2_hk_1117.rdb
     Opened output table: hk/sc4_hk_1117.rdb
     Opened Lockheed History Database: /home/soi/CM/tables/hk_dbase

     There are 17 MDI mnemonics in the list. Now scanning tlm...
     *****   MDI Housekeeping Packet Count Info      *****
     11514 packets observed with a break down as follows:
     0 fill
     Success writing AT: hk/mdi_hk_1117.rdb

     There are 2 SC1 mnemonics in the list. Now scanning tlm...
     *****   SC1 Housekeeping Packet Count Info      *****
     5762 packets observed with a break down as follows:
     0 fill
     Success writing AT: hk/sc1_hk_1117.rdb

     There are 14 SC2 mnemonics in the list. Now scanning tlm...
     *****   SC2 Housekeeping Packet Count Info      *****
     5762 packets observed with a break down as follows:
     0 fill
     Success writing AT: hk/sc2_hk_1117.rdb

     There are 2 SC4 mnemonics in the list. Now scanning tlm...
     *****   SC4 Housekeeping Packet Count Info      *****
     5762 packets observed with a break down as follows:
     0 fill
     Success writing AT: hk/sc4_hk_1117.rdb

FILES

     Outputs files in "." or the given ouput_dir. Will output  an
     rdb   file   for   each   of   the   Source   types  in  the
     mnemonic_rdb_file for which valid parameters were extracted.

AUTHOR

     Jim Aloise

HISTORY

     1997-09-04

SEE ALSO