• Antelope Release 5.5 Mac OS X 10.8.5 2015-04-21

 

NAME

convert_comm - convert original comm table to new schema

SYNOPSIS

convert_comm [-inv] database

SUPPORT


Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.

FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.

DESCRIPTION

After January 2009, I changed the schema extension definiton of the comm table, to better support additional applications and track additional information. The new schema has expanded field length for the commtype and provider as well as the additional fields: dutycycle, power, and equiptype. Because schema extensions do not support versioning, the schema extension/table name was kept the same and the convert_comm script was written to help anyone else who may have chosen to use this schema extension.

The program convert_comm reads the old format comm table, and creates a comm table with the commtype and provider fields extended and fills in the new fields with whitespace. The original comm table is saved with a suffix of "-". The new format comm table replaces database.comm.

convert_comm converts a single comm table at a time and does not have to be run in the particular directory where database.comm resides.

OPTIONS

EXAMPLE



% convert_comm -i db/usarray
: convert db/usarray.comm ? n

% convert_comm -v usarray 
converting usarray.comm

SEE ALSO

comm(5)
mk_dbops(1)

BUGS AND CAVEATS

The following error message can be ignored:
2009-048 22:50:04 perl *complain*: Table 'db.comm' has invalid length 4758.
2009-048 22:50:04 perl *complain*: If more than one process is writing to this database,
  **please** turn on locking in the descriptor file.
Not thoroughly tested. Odd things may happen if the descriptor file basename differs from the basename of the comm table that is found by following the dbpath.

AUTHOR

Jennifer Eakins
Antelope User Group Contributed Software
Printer icon