CNVRT98(L)		  CSDS Commands		       CNVRT98(L)

NAME
     cnvrt98 - convert the CSDS	database entries to  October-1998
     format

SYNOPSIS
     cnvrt98  [	  - if	]    input_database_file  [   -	of   ]
     output_database_file

DESCRIPTION
     In	the Version 5.16 (October 1998)	release	of the	Cambridge
     Structural	 Database  System, minor changes were made to the
     content of	the database format (ASER), namely:

     o	   *ADATE (accession date) converted to	8 digits.

     o	   *MDATE (modification	date) converted	to 8 digits.

     These changes were	made as	part of	CCDC's Year-2000 project.
     Full  details  of	the changes are	given in the October 1998
     release notes.

     When quest	searches pre-October 1998  entries,  it	 silently
     converts  them to the new format. This process has	very lit-
     tle effect	on the performance of searches.	Even so, the CCDC
     has provided the conversion program cnvrt98.

     cnvrt98 converts ASER pre-October 1998 entries of	the  Cam-
     bridge  Structural	Database System	to the new format, saving
     them to another writable file. cnvrt98 exits  gracefully  on
     Control-C	interrupts,  finishing any outstanding i/o on the
     current ASER entry.

OPTIONS
     -if input_database
	  The database from which ASER entries 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.

ENVIRONMENT
     cnvrt98 recognises	a number of environment	 variables.  When
     the  CSDS	was  configured	 (using	config.sh) default values
     were (implicitly) assigned	 to  the  environment  variables:

CSD System  Last change: $Date:	1998/09/16 13:03:12 $		1

CNVRT98(L)		  CSDS Commands		       CNVRT98(L)

     CSDHOME  and CSDMACHINE. They can,	however, be overridden by
     explicitly	defining them within the current environment.

     CSDHOME
	  Look for auxiliary executables, scripts and  tables  in
	  the  directory  pointed  to by $CSDHOME. This	directory
	  should be accessible to all potential	users of the Cam-
	  bridge  Crystallographic Data	System and must	be acces-
	  sible	by cnvrt98.

     CSDMACHINE
	  Use the  executables	and  database  for  machine  type
	  $CSDMACHINE.	It  is possible, especially with the net-
	  work file system (NFS),  to  have  different	types  of
	  machines  accessing  the database. This variable speci-
	  fies the current machine type	to the CSDS.

SEE ALSO
     The "October 1998 Release Notes", CCDC.
     The "Unix Installation Notes", CCDC.

CSD System  Last change: $Date:	1998/09/16 13:03:12 $		2