CSDS Commands					       CNVRTDB(L)

NAME
     cnvrtdb - copy/convert the	CSDS database entries

SYNOPSIS
     cnvrtdb  [	 -if  ]	     input_database_file   [   -of   ]
     output_database_file [ -start start_entry ] [ -end	end_entry
     ] [ -- ] [	-f ] [ -ansi ]

DESCRIPTION
     cnvrtdb copies ASER  entries  of  the  Cambridge  Structural
     Database  System  from  a mounted CD-ROM to another writable
     file. cnvrtdb exits gracefully on Control-C interrupts, fin-
     ishing any	outstanding i/o	on the current ASER entry.

OPTIONS
     -if input_database
	  The database from which ASER are to be taken.	This file
	  must	be  specified on the command line.  Only the root
	  part of the database filenames should	be specified.  As
	  a  corollary,	only CSD databases that	have all three of
	  their	files in the same directory may	be used.  (To get
	  around this restriction you can set up soft links using
	  the ln(1) command).

     -of output_database
	  The name of the database to transfer the ASER	 records.
	  This	need  not  be  a  new file although existing ASER
	  entries with the  same  REFCODE  will	 be  overwritten.
	  This file must be specified on the command line.

     -start start_entry
	  The first entry to be	copied.	start_entry can	be either
	  a number specifying an index into the	input database or
	  a REFCODE. If	the refcode doesn't exist then the  first
	  entry	lexically after	the one	specified is used.  If no
	  value	is given then 1	is assumed.

     -end end_entry
	  The last entry to be copied. end_entry can either be	a
	  number specifying an index into the input database or	a
	  REFCODE. If the refcode doesn't exist	 then  the  first
	  refcode  lexically  after  the one specified is chosen.
	  If no	value is given then copying will occur to end  of
	  the database.

     -f	refcode_list
	  Copy only the	ASER entries with refcodes  specified  in
	  the  file refcode_list. REFCODEs should be separated by
	  whitespace but can appear in any order.   Non	 existant
	  entries  print  a  warning.  This  option overrides the
	  `-start' and `-end' options.

CSD System  Last change: $Date:	1998/01/14 09:56:17 $		1

CSDS Commands					       CNVRTDB(L)

     --	  Same as `-f' but REFCODEs will be  read  from	 standard
	  input.

     -reorderbytes order
	  specify the  byteorder  of  the  input  database-file's
	  integers  relative  to  the  current	machines  integer
	  representation.  order should	be permuations	of  1234.
	  e.g. 4321, 1234, 2314	etc.  This value is overridden by
	  the environment variable CSD_DB_REORDER_BYTES.

     -ansi
	  print	the output in a	groovy manner for ansi terminals.

ENVIRONMENT
     cnvrtdb recognises	the  environment  variables  CSDHOME  and
     CSDMACHINE.

     CSD_DB_REORDER_BYTES
	  Interpret input CSD databases	with an	integer	byteorder
	  specified by this environment	variable.

EXAMPLES
     DEC alpha users may,when transfering the CSDS database  from
     the  CD-ROM,  wish	to use the opportunity to change the big-
     endian format of the files	to the native little-endian  for-
     mat.  Instead of a	direct copy using cp(1)	they can use (for
     example):
     cnvrtdb $CSDHOME/CSD/AS508BE $NEWCSDHOME/csd/as508le
     If	you have a list	of refcodes in a file then try:
     cnvrtdb  $CSDHOME/CSD/AS508BE  $NEWCSDHOME/csd/as508le    -f
     refcodes

BUGS
     cnvrtdb should only be used if you	have  have  compiled  and
     linked  quest  and	 vista	with the alternative database I/O
     routines found in the directory source/clib/.  None  of  the
     distributed  executables  have  be	 linked	in such	a manner.
     Use the SAVE ASER command in quest	to create  Database  sub-
     sets in native format.

SEE ALSO
     The "Unix Installation Notes", CCDC.

CSD System  Last change: $Date:	1998/01/14 09:56:17 $		2