Upgrading Standard Files from Previous Releases

  Depending on your needs, you can:

Upgrading CATDrwStandard Files to the Current XML Standard Files
Up to and including V5R8, the standard file defining standard XXX was a file named XXX.CATDrwStandard, located in install_root/reffiles/Drafting.

In V5R9, the format of the standard file was changed to XML. The standard file defining standard XXX is now a file named XXX.xml, located in install_root/resources/standard/drafting.

If you have customized or defined a CATDrwStandard file, and wish to re-use this customization in the current release, you need to convert your CATDrwStandard file into a XML file. There are 2 ways of doing this:

Manual upgrade

If the degree of customization of the standard file is small, you can start from one of the 4 pre-defined standard files (ISO, ANSI, JIS or ASME), and modify it using the standards editor (Tools > Standards). You will need to modify the parameter values, and add the styles that you had defined in the CATDrwStandard file.

Automatic upgrade

A batch utility is provided in order to automatically generate the XXX.xml file starting from a XXX.CATDrwStandard file. All the customization done on the CATDrwStandard file will be reproduced in the XML file, and all styles defined in CATDrwStandard file will be added.

The utility will also add to the XML file the new standard parameters (with default values), as well as the new pre-defined styles.

  • If you want to convert a single CATDrwStandard to the current XML format, use:
    CATAnnStandardTools MIGRATE XXX [dir]
  • If you want to convert all CATDrwStandard files to the current XML format, use:
    CATAnnStandardTools MIGRATE_ALL [dir]

For more information on using these commands on Windows and on Unix, see below.

 
The tasks below will show you how to use the standard automatic upgrade tool on Windows and on Unix.
 

Using the standard automatic upgrade tool on Windows

  1. Open an MS-DOS Window.

  2. Change to the folder in which you installed the product. 
    The default folder is \intel_a\code\\bin

  1. You have two options:

  • To generate XML files for all the CATDrwStandard files located in reffiles\Drafting, enter this command: 

CATAnnStandardTools MIGRATE_ALL [dir] 

where [dir] is an optional directory in which to write the resulting XML files. Local directory is the default.

  • To generate the XML file corresponding to one single standard, enter this command:

CATAnnStandardTools MIGRATE XXX [dir]

where XXX is the name of the standard you want to convert (ISO, ANSI...) and [dir] is an optional directory in which to write the resulting XML file. Local directory is the default.
 

Using the standard automatic upgrade tool on UNIX

  1. Open a shell command window.

  2. Change to the directory in which you installed the product. 
    The default directory is /OS_a/code/command/
    where OS_a is:

  • aix_a

  • hpux_a

  • irix_a

  • solaris_a

  1. You have two options:

  • To generate XML files for all the CATDrwStandard files located in reffiles\Drafting, enter this command: 

./catstart -run "CATAnnStandardTools MIGRATE_ALL [dir]"

where [dir] is an optional directory in which to write the resulting XML files. Local directory is the default.

  • To generate the XML file corresponding to one single standard, enter this command: 

./catstart -run "CATAnnStandardTools MIGRATE XXX [dir]"  

where XXX is the name of the standard you want to convert (ISO, ANSI...) and [dir] is an optional directory in which to write the resulting XML files. Local directory is the default.
 

Upgrading XML Standard Files from Previous Releases to the Current Level
The XML standard file has evolved in each release since V5R9. New standard parameters have been added, some have been modified, and new functionalities (such as styles) have been introduced.

If you have customized or defined an XML standard file in a previous release (i.e. a release starting from V5R9), and wish to re-use this customization in the current level, you need to upgrade your XML file. There are 2 ways of doing this:

Manual upgrade

If the degree of customization of the standard file is small, you can start from one of the 4 pre-defined standard files (ISO, ANSI, JIS or ASME), and modify it using the standards editor (Tools > Standards). You will need to modify the parameter values and customize new parameters and/or styles.

Automatic upgrade

A batch utility is provided in order to automatically generate the current XML file starting from an XML file from a previous release. All the customization done on the starting file will be reproduced in the upgraded XML file.

The utility will also add the new parameters and styles introduced in the current release (with default values) in the XML file.

  • If you want to upgrade a single XML file to the current version, use:
    CATAnnStandardTools UPGRADE XXX [dir]
  • If you want to upgrade all XML files to the current version, use:
    CATAnnStandardTools UPGRADE_ALL [dir]

For more information on using these commands on Windows and on Unix, see below.

 
The tasks below will show you how to use the standard automatic upgrade tool on Windows and on Unix.
 

Using the standard automatic upgrade tool on Windows

  1. Open an MS-DOS Window.

  2. Change to the folder in which you installed the product. 
    The default folder is \intel_a\\code\\bin

  1. You have two options:

  • To upgrade standard files for all the XML files located in install_root\resources\standard\drafting, enter this command: 

CATAnnStandardTools UPGRADE_ALL [dir] 

where [dir] is an optional directory in which to write the resulting XML files. Local directory is the default.

  • To upgrade the XML file corresponding to one single standard, enter this command:

CATAnnStandardTools UPGRADE XXX [dir]

where XXX is the name of the standard you want to convert (ISO, ANSI, MY_ISO...) and [dir] is an optional directory in which to write the resulting XML file. Local directory is the default.

The batch will first search the standard file in the directory defined by the exported variable CATCollectionStandard (e.g. set CATCollectionStandard=e:\tmp), and then, if not found, in the following directory: install_root\resources\standard\drafting.
 

Using the standard automatic upgrade tool on UNIX

  1. Open a shell command window.

  2. Change to the directory in which you installed the product. 
    The default directory is /OS_a/code/command/
    where OS_a is:

  • aix_a

  • hpux_a

  • irix_a

  • solaris_a

  1. You have two options:

  • To upgrade standard files for all the XML files located in install_root\resources\standard\drafting, enter this command: 

./catstart -run "CATAnnStandardTools UPGRADE_ALL [dir]"

where [dir] is an optional directory in which to write the resulting XML files. Local directory is the default.

  • To upgrade the XML file corresponding to one single standard, enter this command: 

./catstart -run "CATAnnStandardTools UPGRADE XXX [dir]"  

where XXX is the name of the standard you want to convert (ISO, ANSI...) and [dir] is an optional directory in which to write the resulting XML files. Local directory is the default.

The batch will first search the standard file in the directory defined by the exported variable CATCollectionStandard (e.g. export CATCollectionStandard=d/tmp), and then, if not found, in the following directory: install_root\resources\standard\drafting.