Professional Documents
Culture Documents
Mastercam X
Transition Guide
December 2005
Rev. 1.02
UG_TransitionGuide.book Page ii Thursday, December 8, 2005 5:40 PM
IMPORTANT NOTICE! PLEASE READ THIS STATEMENT AND THE SOFTWARE LICENSE AGREEMENT
COMPLETELY BEFORE USING THIS SOFTWARE.
BY CONTINUING TO USE THIS SOFTWARE, YOU (EITHER AN INDIVIDUAL OR
A SINGLE ENTITY) INDICATE YOUR INTENTION TO BE BOUND BY AND
ACCEPT THE TERMS AND CONDITIONS OF THIS SOFTWARE LICENSE. IF
YOU DO NOT AGREE TO THESE TERMS AND CONDITIONS, YOU MAY NOT
ACCESS OR OTHERWISE USE THIS SOFTWARE AND WILL IN FACT BE
PROHIBITED FROM DOING SO. THIS COMPUTER SOFTWARE MAY BE USED
ONLY PURSUANT TO THE TERMS AND CONDITIONS SET FORTH BELOW,
AND SOLELY IN CONJUNCTION WITH THE ACCOMPANYING SECURITY
MECHANISM (UNLESS OTHERWISE SPECIFIED IN THE "EXCEPTIONS TO
SECURITY MECHANISM REQUIREMENTS" SECTION OF SUCH TERMS AND
CONDITIONS) WHICH MUST BE PRESENT ON YOUR COMPUTER (OR
NETWORK AS APPLICABLE) AT ALL TIMES DURING SUCH USE.
Read This If You Have Received This Software From A Third Party: If you
received this Software from someone other than an authorized CNC Software,
Inc. reseller, you do NOT have a legal software license. (For example, if you
acquired this Software simply by buying a machine or Software from the former
owner or from an auction, you do not have a valid license.) You should contact
CNC Software, Inc. (860-875-5006) in order to obtain a new and valid license.
Use of this Software without a valid software license is unlawful, a violation of
the Copyright Act and may expose you to criminal liability under 17 United
States Code Sec. 506, including fines and damages.
Software License If you have paid a license fee, CNC Software, Inc. ("CNC") a Connecticut
corporation with its principal place of business at 671 Old Post Road, Tolland,
Connecticut, 06084 hereby grants to you a non-exclusive, non-transferable
license (the "License") to use this software program (the "Software") and its
accompanying documentation (and, if applicable, to permit your authorized
employees to use them), solely in accordance with the terms and conditions of
this Software License Agreement . You may use the Software solely for your
internal business purposes and solely in conjunction with the accompanying
hardware or software device, method, scheme or other security measure
provided by CNC which allows a user to access the Software and prevents
unauthorized access to the Software (the "Security Mechanism"). The Software,
any updates to the Software (including any that you download through the
Internet), and the Documentation shall hereinafter collectively be referred to as
the "Software" and are all governed by this License.
Restrictions You may not use the Software without a Security Mechanism provided by CNC
or CNCs suppliers. When CNC or CNCs suppliers provide you with a single-user
Security Mechanism, the Software may only be used (in executable code form
only) on a single computer to which the Security Mechanism is physically
attached. In the event CNC or CNCs suppliers provide you with a multiple-user
Security Mechanism for use over an internal network (a "Network Security
Mechanism"), the Software may be used: (a) in executable code form only; (b)
only on end-user computers that are connected to the internal network to which
the Network Security Mechanism is attached; and (c) only by the number of
UG_TransitionGuide.book Page iii Thursday, December 8, 2005 5:40 PM
users and accessed by the number of end-user computers for which licenses
were purchased and as further allowed by the Network Security Mechanism. You
may physically transfer the Software from one computer equipped with a single-
user Security Mechanism to another only if the Security Mechanism is included
in the transfer and is installed with the new computer.
11
You shall not: (a) copy (except as provided below), adapt, modify the Software;
(b) publish, display, disclose or create a derivative work from the Software or any
part thereof; (c) de-compile or translate, disassemble, create or attempt to
create, by reverse engineering or otherwise, the source code form of the Software
from the executable code of the Software; (d) remove any proprietary notices,
12
labels or marks from the Software; (e) sell, rent, lease, distribute or otherwise
transfer or provide all or any part of the Software to any person or entity without
the prior written consent of CNC; (f ) use the Software to provide outsourcing,
service bureau, time sharing or other services to any third party; or (g)
sublicense, assign, delegate or otherwise transfer your rights in the Software,
13
under the Software License Agreement or any of the related rights or obligations
for any reason without the prior written consent of CNC. You shall not
14
circumvent, bypass, modify, reverse engineer, disassemble, disable, alter,
enhance or replicate the function of the Security Mechanism in any manner
whatsoever. Any attempt to do so shall result in automatic termination of this
License without prejudice to all other legal rights and remedies of CNC.
Copying Restrictions You may make one (1) copy of the Software for backup or archival purposes,
Non Transferable
provided that you reproduce all proprietary notices of CNC on any such copy.
You may not transfer or assign the Software or this Software License Agreement
or any rights or obligations hereunder. Any attempt to do so will automatically
15
terminate this License without the need for notice. This termination is without
prejudice to all other legal rights and remedies of CNC.
Intellectual Property Rights The Software is and includes intellectual property of CNC. All associated
intellectual property rights, including, without limitation, worldwide patent,
trademark, copyright and trade secret rights, are reserved. CNC retains all right,
16
title and interest in and copyrights to the Software, regardless of the form or
media in or on which the original or other copies may subsequently exist. This
Software License Agreement shall not constitute a sale of the Software and no
title or proprietary rights to the Software are transferred to you hereby. You
acknowledge that the Software is a unique, confidential and valuable asset of
17
CNC, and CNC shall have the right to seek all equitable and legal redress, which
may be available to it for the breach or threatened breach of this Software
License Agreement including, without limitation, injunctive relief.
Unauthorized copying of the Software or failure to comply with the above
restrictions shall result in automatic termination of this License and this
Software License Agreement without prejudice to all other legal rights and
18
remedies of CNC.
19
Confidentiality You acknowledge that the Software contains proprietary trade secrets of CNC
and you hereby agree to maintain the confidentiality of the Software using at
least as great a degree of care as you use to maintain the confidentiality of your
own most confidential information. You agree to reasonably communicate the
terms and conditions of this Software License Agreement to those persons
employed by you who come into contact with the Software, and to use
reasonable best efforts to ensure their compliance with such terms and
conditions, including, without limitation, not knowingly permitting such
persons to use any portion of the Software for the purpose of deriving the source
110
code of the Software or defeating the Security Mechanism.
UG_TransitionGuide.book Page iv Thursday, December 8, 2005 5:40 PM
Enforcement Obligations In the event you become aware that any person or entity in your employ or
under your control in a manner not authorized by this Software License
Agreement is using the Software, you shall immediately use reasonable best
efforts to have such unauthorized use of the Software immediately cease. You
shall promptly notify CNC in writing of any unauthorized use of the Software of
which you become aware.
Limited Warranties CNC WARRANTS THAT THE MEDIA ON WHICH THE SOFTWARE IS
DISTRIBUTED WILL BE FREE OF DEFECTS IN MATERIAL OR WORKMANSHIP
FOR A PERIOD OF THIRTY (30) DAYS AFTER PURCHASE. THE FOREGOING
LIMITED WARRANTY EXCLUDES DEFECTS ARISING OUT OF ACCIDENT,
NEGLECT, MISUSE, FAILURE OF ELECTRIC POWER AND CAUSES OTHER
THAN ORDINARY AND AUTHORIZED USE. EXCEPT FOR THE FOREGOING
LIMITED WARRANTY, THE SOFTWARE IS PROVIDED "AS IS, WITH ALL
FAULTS." YOUR SOLE REMEDY AND CNCS SOLE OBLIGATION HEREUNDER
SHALL BE, AT CNCS SOLE OPTION, REPLACEMENT OF THE DEFECTIVE
MEDIA OR REFUND OF THE PURCHASE PRICE OF THE SOFTWARE. ANY USE
BY YOU OF THE SOFTWARE IS AT YOUR OWN RISK. THIS LIMITED
WARRANTY IS THE ONLY WARRANTY PROVIDED BY CNC REGARDING THE
SOFTWARE. TO THE MAXIMUM EXTENT PERMITTED BY LAW, CNC
DISCLAIMS ALL OTHER WARRANTIES OF ANY KIND, EITHER EXPRESSED OR
IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. CNC IS
NOT OBLIGATED TO PROVIDE ANY UPDATES TO THE SOFTWARE. SHOULD
THE SOFTWARE PROVE DEFECTIVE FOLLOWING ITS PURCHASE, YOU (AND
NOT CNC, ITS DISTRIBUTOR, OR RETAILER) ASSUME THE ENTIRE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION AND ANY
INCIDENTAL OR CONSEQUENTIAL DAMAGES.
Note on Documentation: While CNC makes every effort to ensure that its
Documentation for the Software is accurate and up-to-date, it cannot guarantee
the Documentation at all times represents the latest operation and functionality
of the Software. The content of the "Getting Started Guide," "User Manual" and
other documentation for the Software is provided for informational purposes
only. The content of the Documentation may be changed without notice to you.
CNC expressly disclaims any warranty or representation that the
Documentation is an accurate and/or current reflection of the Softwares
operation and performance.
Limitation of Liability
IN NO EVENT WILL CNC, OR ITS EMPLOYEES, SHAREHOLDERS,
DISTRIBUTORS OR SUPPLIERS BE LIABLE TO YOU FOR ANY INDIRECT,
INCIDENTAL, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT
LIMITATION, SPECIAL, PUNITIVE OR EXEMPLARY DAMAGES FOR LOSS OF
BUSINESS, LOSS OF PROFITS, BUSINESS INTERRUPTION, OR LOSS OF
BUSINESS INFORMATION) ARISING OUT OF OR IN CONNECTION WITH THIS
SOFTWARE LICENSE AGREEMENT OR THE SUBJECT MATTER HEREOF EVEN
IF CNC HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. CNCS
ENTIRE LIABILITY WITH RESPECT TO ITS OBLIGATIONS UNDER THIS
SOFTWARE LICENSE AGREEMENT OR OTHERWISE SHALL NOT EXCEED THE
AMOUNT OF THE LICENSE FEE PAID BY YOU FOR THE SOFTWARE. SOME
JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF
IMPLIED WARRANTIES OR LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL
DAMAGES, SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY
TO YOU.
Indemnification You shall indemnify and hold harmless CNC, its officers, directors, employees,
suppliers and agents from and against all losses, settlements, claims, actions,
UG_TransitionGuide.book Page v Thursday, December 8, 2005 5:40 PM
Termination
individual or any entity, other than the school that originally received this
Software.
This Software License Agreement is effective until terminated. You may
13
terminate this Software License Agreement at any time by returning to CNC all
copies of the Software under your control and by returning the Security
Mechanism to CNC. CNC may terminate this Software License Agreement if
CNC determines, in its sole discretion, that you have violated the terms of this
Software License Agreement. Upon termination of this Software License
14
Agreement, you agree to immediately return to CNC all copies of the Software,
return the Security Mechanism to CNC, and certify to CNC in writing that all
known copies, including backup copies, have been returned. All provisions
relating to confidentiality, proprietary rights, indemnification and non-
disclosure shall survive the termination of this Software License Agreement. You
15
may not transfer this Software to the purchaser of any equipment on which the
Software may be resident. You may not transfer this Software via liquidation,
bankruptcy, auction, close of business, or any other method that does not
involve an authorized Mastercam reseller. This License is for you alone. In the
event you breach the provisions of this Section, CNC shall be entitled to
liquidated damages in the amount of Fifteen Thousand Dollars ($15,000), plus
16
its reasonable attorneys fees and court costs.
General This Software License Agreement shall be construed, interpreted and governed
by the laws of the state of Connecticut, without regard to conflicts of law
provisions. The sole jurisdiction and venue for any litigation arising from or
related to this Software License Agreement or the subject matter hereof shall be
17
in an appropriate state or federal court located in Hartford, Connecticut. You
hereby submit to the personal jurisdiction of the Federal District Court for the
District of Connecticut and to the Superior Court of the State of Connecticut.
This Software License Agreement shall constitute the entire agreement between
you and CNC with respect to the subject matter hereof. Any waiver or
18
modification of this Software License Agreement shall be valid only if it is in
writing and signed by both parties hereto. If any part of this Agreement is found
19
invalid or unenforceable by a court of competent jurisdiction, the remainder of
this Agreement shall be interpreted so as to reasonably effect the intention of the
parties.
U.S. Government Restricted The Software provided hereunder is a "commercial item," as that term is defined
Rights in 48 C.F.R. 2.101, consisting of "commercial computer software" and
"commercial computer software documentation," as such terms are used in 48
C.F.R. 12.212. Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through
227.7202-4, the Software made available to the United States of America, its
110
agencies and/or instrumentalities, is provided with only those rights set forth in
this Agreement. Use, duplication or disclosure of the Software by the
government is subject to the restrictions as set forth in subparagraph (c)(1) and
UG_TransitionGuide.book Page vi Thursday, December 8, 2005 5:40 PM
Contents
Section 1:
Before You Begin .......................................................................... 1
Section 2:
Converting Settings and Libraries ....................................... 11
2.1 / File types and locations ........................................... 11
2.1.1 / Libraries that can be migrated ................................. 11
2.1.2 / Configuration files ..................................................... 12
Section 3:
Posts and Machine Definitions ............................................ 33
3.1 / Updating posts ............................................................. 33
3.1.1 / Automatically creating machine
and control definitions from posts ...................................... 36
3.1.1.1 / Machine definitions created by UpdatePost ...... 36
3.1.2 / Finding and fixing conversion errors........................ 37
3.1.2.1 / Uncertain variable type errors .............................. 39
3.1.3 / Converting a V9 post: Example ................................ 39
3.1.3.1 / New header line ..................................................... 40
3.1.3.2 / Pre-defined variables and post blocks
end with $ ............................................................................. 40
3.1.3.3 / e$ (EOB) required at end of output lines ............. 40
3.1.3.4 / New parameters for fstrsel tables ....................... 41
3.1.3.5 / Characters "+", "-", and "." no longer
allowed in variable or post block names ........................... 41
3.1.3.6 / Numbered questions no longer used .................. 42
3.1.3.7 / New headers and organization for post text ....... 42
3.1.4 / Configuring machine and control definitions .......... 44
3.1.4.1 / Using Mastercams default machine
and control definitions with your converted post ............. 44
3.1.4.2 / Editing a machine definition to use tool
and material libraries ............................................................ 46
3.1.4.3 / Editing a control definition to use
a wire power settings library ............................................... 47
3.1.4.4 / Editing a machine definition to use
Mastercam X coolant options ............................................. 48
3.1.4.5 / Editing a wire machine definition to
use flushing options ............................................................. 50
3.1.4.6 / Editing the control definition to use
C-Hooks for Agie Wire EDM machines .............................. 53
3.1.4.7 / Editing a control definition to use
operation defaults and libraries ......................................... 54
3.1.4.8 / Selecting your default machines .......................... 55
3.1.4.9 / Migrating aggregate tooling components
for router ............................................................................... 57
3.1.5 / Converting setup sheets ........................................... 62
3.1.6 / Inch and metric machine definitions ....................... 62
Contents ix
Section 4:
Updating parts and machining jobs.................................... 71
4.1 / Converting parts .......................................................... 71
4.1.1 / What happens when you convert a file? ................. 71
4.1.2 / Converting files in batch mode ................................ 72
4.1.3 / Machine compatibility ............................................... 73
4.1.3.1 / Severe incompatibility ........................................... 74
4.1.3.2 / Minor incompatibilities ......................................... 75
4.1.3.3 / Axis combinations ................................................. 77
4.1.3.4 / Vertical turret lathes (VTLs) .................................. 78
4.1.3.5 / Home positions in Mill/Router parts .................... 80
UG_TransitionGuide.book Page x Thursday, December 8, 2005 5:40 PM
Section 1:
Before You Begin
This guide is designed to help current Mastercam users recreate their
current work environmentand their current jobs and partsas
quickly as possible. Some of the topics this covers include:
Migrating your current libraries, tools, and defaults to your
new Mastercam X installation.
Converting and updating your post processors.
Creating your first machine definitions so that they work
with your current libraries and parts.
Updating your .config files.
Converting your parts.
Since every Mastercam user has different needs and migration
requirements, weve prepared a series of checklists that walk you
through the migration process. These are designed so that you only
need to complete (and read about) tasks that are relevant to you.
Complete the tasks on the checklists in the order in which they are
presented and simply skip over those tasks which do not apply to you.
The checklists are organized into two pairs of worksheets. For any
Mastercam workstation, you should only need to complete one work-
sheet from each pair. From each set, choose the worksheet that
matches your situation.
Choose a Libraries and Settings worksheet based on which
version of Mastercam you are upgrading from. The migration
procedures are different if you are not running Version 9.
Choose a Posts and Machine Definition Worksheet based on
where you will be getting your initial machine definitions
and posts, either from your reseller, or generated from your
current posts with the UpdatePost utility.
Complete one set of worksheets for each Mastercam X workstation. If
you need more copies, the worksheets are available in printable form
in a PDF file, Migration_Worksheets.pdf, which is installed in the
\Documentation folder where you installed Mastercam X.
Revision 1.02Changes have been made throughout to include
requirements and procedures for upgrading to Mastercam X Wire
from previous Mastercam versions.
UG_TransitionGuide.book Page 2 Thursday, December 8, 2005 5:40 PM
For sections with separate M-L-R-W columns, repeat each procedure for each installed product (Mill/Lathe/
Router/Wire). Sections marked All only need to be completed once even if you upgrade more than one Master-
cam product.
I. Installation M L R W
1. Are you installing to a new PC? Identify current libraries (page 11) and
posts (including .TXT files) that you
want to move to the new workstation.
Copy them to a working folder on new
PC.
For sections with separate M-L-R-W columns, repeat each procedure for each installed product (Mill/Lathe/
Router/Wire). Sections marked All only need to be completed once even if you upgrade more than one Master-
cam product.
I. Installation M L R W
1. Are you installing to a new PC? Identify current libraries (page 11) and
posts (including .TXT files) that you
want to move to the new workstation.
Copy them to a working folder on new
PC.
2. Install Mastercam. See the Mastercam X Installation (All)
Guide.
Complete the steps on this worksheet if your reseller is supplying your initial set of machine and control defini-
tions and posts.
I. Copy files to your workstation (All products)
1. Copy to \CNC_MACHINES folder in Copy machine and control definitions
your Mastercam installation folder. for all products into same folder.
M L R W
2. Copy posts to \POSTS folder. Each product has its own \POSTS
folder.
II. Edit machine and control definitions to use migrated libraries (All products)
These steps are optional. Complete them if you want your machine and control defi-
nitions to use the libraries you migrated from your current Mastercam workstation.
1. If desired, edit machine definition to Repeat for each machine definition.
use migrated libraries as defaults.
1a. Set default tool library for machine. See Section 3.1.4.2 on page 46.
1b. Set default material library for See Section 3.1.4.2 on page 46.
machine.
1c. Set default power settings library See Section 3.1.4.3 on page 47.
(Wire only)
2. If desired, edit control definition to use Repeat for each control definition.
migrated libraries as defaults.
2a. Set default toolpath defaults file See Section 3.1.4.6 on page 53.
(.defaults).
2b. Set default operations library See Section 3.1.4.6 on page 53.
(.operations).
III. Edit configuration files
These steps are optional. Complete them if you want Mastercam to automatically
load selected machines by default. Repeat this section for inch and metric .config
files.
1. Select default machine to load when See Section 3.1.4.8 on page 55.
starting Mastercam.
2. Select a default machine for each prod- Section 3.1.4.8 on page 55.
uct.
IV. Convert setup sheet files M L R W
1. If desired, convert setup sheets (.set See Section 3.1.5 on page 62.
files).
Youre now ready to convert your current See Section 4.1 on page 71.
parts and machining jobs!
UG_TransitionGuide.book Page 8 Thursday, December 8, 2005 5:40 PM
UG_TransitionGuide.book Page 9 Thursday, December 8, 2005 5:40 PM
Complete the steps on this worksheet if you will be using the UpdatePost utility to convert your existing posts
and automatically generate machine and control definitions.
I. Preparation (All products)
1. Locate and organize the posts you want Organize them in folders by product
to convert. type and version. For each post,
include the PST/PSB and TXT files in
the same folder.
2. Start UpdatePost. See Section 3.1 on page 33.
III. Review log and correct post errors See Section 3.1.2 on page 37.
1. If desired, edit configuration file to point Repeat for inch and metric .config files.
to your new machine & control defini-
tions.
1a. Select default machine to load See Section 3.1.4.8 on page 55.
when starting Mastercam.
1b. Select a default machine for each See Section 3.1.4.8 on page 55.
product.
Youre now ready to convert your current See Section 4.1 on page 71
parts and machining jobs!
UG_TransitionGuide.book Page 11 Thursday, December 8, 2005 5:40 PM
Section 2:
Converting Settings and Libraries
Use this section as a guide to migrating your current settings and
libraries to your new Mastercam X installation. CNC Software under-
stands that many of our current users have invested a substantial
amount of time and energy in developing their tool and material
libraries, toolpath and operation defaults, and operation libraries to
meet their own preferences and customer requirements. To help
make this process as smooth as possible, Mastercam X includes a
migration utility to convert these files from Version 9. If you are
upgrading from Version 8 or earlier, this section includes procedures
for manually converting the libraries. It concludes with procedures
for setting up your configuration files to point to the converted
libraries instead of the default libraries that have been installed with
Mastercam X.
The procedures in this section have been designed to coordinate with
the Libraries and Settings worksheets found at the front of this
Guide. Follow the worksheets to ensure that you only complete the
procedures necessary for your workstation and that they are
completed in the proper order.
The rest of this chapter contains procedures and notes to help you
convert the files and configure Mastercam to use them instead of the
system defaults installed with Mastercam X.
Table 1: Mastercam libraries and settings
File Type Version 9 Mastercam X
Toolpath and extension .DF9 .defaults
operation
defaults location \mcam9\mill\ops \mcamx\mill\ops
typical Defaults.DF9, Mill_inch.defaults,
name Defaultsm.DF9 Mill_mm.defaults
Tool libraries extension .TL9 .tools
location \mcam9\mill\tools \mcamx\mill\tools
typical Tools.TL9, Mill_inch.tools,
name Tools_mm.TL9 Mill_mm.tools
You still need separate configuration files for inch and metric
operations.
Just like in earlier versions, you can still create as many
different configuration files as you want for special needs or
custom applications.
There is no way to automatically convert or migrate configuration
files from older versions of Mastercam, except by editing them indi-
vidually. The System Configuration dialog box (Settings, Configura-
tion) in Mastercam X includes many, but not all, of the configuration
settings from earlier versions of Mastercam. The following table
shows where to find all of your current configuration settings.
Table 2: Configuration settings
Current configuration tab Mastercam X configuration topic
Allocations Not used in Mastercam X
Tolerances Settings, Configuration > Tolerances
topic
Communications Moved to control definition. Select default
communications package on Start/Exit
topic.
Files Settings, Configuration > Files topic
Plotter settings Not used in Mastercam X; use standard
Windows drivers instead
Pen attributes Settings, Configuration > Printing topic
Toolbar/Keys Moved to separate, expanded functions:
Settings, Customize to create and
edit toolbars, drop-down menus, right-
mouse menu
Settings, Key Mapping for key-
board shortcuts
Settings, Toolbar States to show/
hide toolbars for each product
NC Settings Settings, Configuration > Files topic;
some settings moved to control definition
CAD Settings Settings, Configuration > CAD Settings;
individual topics for drafting settings and
globals
Start/Exit Settings, Configuration > Start/Exit topic
Screen Settings, Configuration > Screen, Colors,
Chaining, Shading topics
UG_TransitionGuide.book Page 14 Thursday, December 8, 2005 5:40 PM
Note: If the target directory already contains files with the same
name as the files you are converting, they will be overwritten
without warning.
Later, you will edit your configuration and control definition files to
use your converted .defaults files instead of the system defaults.
UG_TransitionGuide.book Page 16 Thursday, December 8, 2005 5:40 PM
6 Navigate to the folder that contains the defaults files that you
want to convert and select the desired file.
Note: Lathe users may see a dialog box about axis combinations.
If you do, click OK to close it.
7 After the file has been opened, you should see all the default
operations in the Toolpath Manager.
UG_TransitionGuide.book Page 17 Thursday, December 8, 2005 5:40 PM
Note: The rules for custom tool geometry are the same in
Mastercam X as for Version 9.
Note: If the target directory already contains files with the same
name as the files you are converting, they will be overwritten
without warning.
Convert the tool library to a text file with your earlier version
of Mastercam and use Mastercam X to create a tool library
from it.
Each technique is described below. These techniques will also work
with Version 9 tool libraries, if you do not want to use the automatic
import feature.
2 Make sure that you are running in the proper mode, inch or
metric. (Choose Settings, Configuration from the menu and
select the proper .config file.)
3 From the Machine Type menu, select the default machine
definition for the product whose tool library you are
converting.
MILL DEFAULT.MMD
LATHE DEFAULT.LMD
ROUTER DEFAULT.RMD
4 Select File, New from the menu to create an empty file and
machine group.
5 Select File, Open from the menu.
Note: Your Mastercam display will not change, since the tool defi-
nitions arent visible in the graphics window.
Repeat this process for each tool library that you want to convert.
Make sure that each time you start out with a machine group whose
product type matches the tool library you are converting.
6 Navigate to the folder which contains the desired text file and
select it.
7 Mastercam prompts you to enter a name for the converted
library. Mastercam will create a new library from the text file
instead of adding the tools to the currently open library.
UG_TransitionGuide.book Page 23 Thursday, December 8, 2005 5:40 PM
TIP: Read the online help in the Tool Manager to learn how to
copy tools from one library to another.
8 Repeat this procedure for each text file that you want to
convert to a library.
9 Use the Tool Manager to open the new libraries and edit any
tool definitions.
Note: If the target directory already contains files with the same
name as the files you are converting, they will be overwritten
without warning.
Note: If the target directory already contains files with the same
name as the files you are converting, they will be overwritten
without warning.
LATHE DEFAULT.LMD
ROUTER DEFAULT.RMD
3 Select File, New from the menu to create an empty file and
machine group.
4 Select File, Open from the menu.
Note: If the target directory already contains files with the same
name as the files you are converting, they will be overwritten
without warning.
Later, you will edit your configuration and control definition files to
use your converted .operations files instead of the system defaults.
6 Navigate to the folder that contains the defaults files that you
want to convert and select the desired operation library.
7 You should see all the operations in the Toolpath Manager.
2 Choose Files from the list at the left of the dialog box.
3 In the File usage section, select the type of library that you
have converted.
5 Repeat steps 3 and 4 for each converted library that you want
to use as a default.
UG_TransitionGuide.book Page 31 Thursday, December 8, 2005 5:40 PM
6 Click the Save button when youve selected all the libraries
that you wish to use as defaults.
7 Repeat this procedure for your metric .config file. (If you
normally work in metric, repeat for your inch .config file.)
2.3 C-Hooks
In general, your current C-Hooks will not work with Mastercam X.
Some of the key changes that C-Hook developers will need to accom-
modate include:
Microsoft Visual C/C++ V7.1 is now a requirement.
Access to Mastercam functionality is now provided through
.LIBs instead of .OBJs.
Many variable types have changed.
C-Hooks that use legacy Mastercam menus need to have
their interface rewritten to use modal or modeless dialog
boxes.
Mastercam X includes a C-Hook Wizard that you can use to build a
skeleton C-Hook, which can then be customized to meet your specific
needs.
Section 3:
Posts and Machine Definitions
Use this section as a guide to upgrading your current post processors
so that they work with Mastercam X, and to understand some of the
many important differences introduced in the MP language. While
this is not intended to be a complete Mastercam X post reference, it
should help you understand some of the changes that occur when
your post is converted.
The UpdatePost utility that is supplied with Mastercam X can be used
to create a complete set of a machine definition, a control definition,
and a post from your current post. Many users will find this a conve-
nient way to get up and running quickly. Other procedures tell you
how to edit the newly created machine and control definitions to
work with the libraries that you migrated in the previous chapter, so
that as much as possible of your current Mastercam workstation is
transferred to Mastercam X.
The procedures in this section have been designed to coordinate with
the Posts and Machine Definition worksheets found at the front of
this Guide. Follow the worksheets to ensure that you only complete
the procedures necessary for your workstation and that they are
completed in the proper order.
A complete reference to the post parameters in Mastercam X is
installed in your \documentation folder when you install Mastercam.
It includes several examples of how to access the important new
parameters for machine definitions, control definitions, and machine
groups.
The following table lists the input and output files for different post
types.
Table 3: UpdatePost input and output files
Input files Output files
Mypost.pst, Mypost.pst, Mypost.pst_v9
Mypost.txt
Optional: UpdatePostX.log, Mypost.mmd,
Mypost.control
Mypost.pst, Mypost.psb, Mypost.pst, Mypost.pst_v9
Mypost.txt Mypost.psb, Mypost.psb_v9
Optional: UpdatePostX.log, Mypost.mmd,
Mypost.control
Mypost.psm, Mypost.psm, Mypost.psm_v9
Mypost.txt
Optional: UpdatePostX.log, Mypost.mmd,
Mypost.control
Router posts will output .rmd files instead of .mmd. Lathe posts will out-
put .lmd files, and Wire posts will output .wmd files.
X Running UpdatePost
This identifies all the post text entries that are used for that control
definition. Mastercam writes a new header each time you configure
the post for a new control definition and appends it to the .PST file
UG_TransitionGuide.book Page 43 Thursday, December 8, 2005 5:40 PM
The first part of the header comes from the Control type field in the
Control Definition Manager:
The second part of the header matches the name of the .control file in
which the control definition is stored:
The post text defaults are stored under a similar header with
DEFAULT as the control name:
[CTRL_MILL|DEFAULT]
This lets you store a set of default text values for each control type.
When you convert a post with UpdatePost, Mastercam creates the
control definition header and copies the information from your orig-
inal .TXT file to it. Your .TXT file is no longer used and will not be
copied to the destination folder. Mastercam also creates a DEFAULT
header populated with your original post text entries, so that they will
be the defaults for any new control definitions you create with the
post.
To edit the post text, use the Text page in the Control Definition
Manager.
[CTRL_MILL|DEFAULT]
[misc integers]
1. "Work Coordinates [0=G50,1=HOME,2=G54's]"//2
2. "Can Cycle G101 - G103 [0=OFF, 1 and -1=ON]"
3. "Reference Return [0=G28, 1=G30]"
UG_TransitionGuide.book Page 44 Thursday, December 8, 2005 5:40 PM
Note: In the Work coordinates lines, the //2 at the end of the
line is a default value. See the online help for the Misc Int/Real
Values page in the Control Definition Manager to learn more.
tions. You can manually configure it to use your converted post. If you
wish to take this approach, consider the following points:
The control definition created by UpdatePost is customized
with all of the numbered questions from your existing post. If
you use Mastercams default definitions, you will need to
recreate this manually.
If you are modifying one of Mastercams default machine or
control definitions, it is a good practice to save it with a new
name instead of overwriting the default definition. (Use the
Save As function inside the Machine Definition Manager or
the Control Definition Manager.)
To use one of your converted posts with a different machine and
control definition, follow this general outline.
Note: You may get a message that says you are editing the disk
copy of the machine definition. Click OK to continue.
Note: Only users of Agie wire EDM machines that use the Agievi-
sion control will need to perform this procedure.
4 Under Select items file name, click the file cabinet button,
navigate to the \mcamx\chooks directory, and select the
agie.dll C-Hook.
6 Under Select items file name, click the file cabinet button,
navigate to the \mcamx\chooks directory, and select the
agiereg.dll C-Hook.
UG_TransitionGuide.book Page 54 Thursday, December 8, 2005 5:40 PM
5 Click the file cabinet button and choose the desired file.
UG_TransitionGuide.book Page 55 Thursday, December 8, 2005 5:40 PM
For example, if the only mill in your shop is a Haas VR8, you might
want to make that your default mill instead of Mastercams generic
mill machine definition so that it is automatically selected whenever
you run Mastercam Mill.
These preferences are stored in your configuration (*.config) file.
Complete the following procedures if you want to use any of your new
machine definitions as defaults.
2 Select HD9toGMD.dll.
UG_TransitionGuide.book Page 58 Thursday, December 8, 2005 5:40 PM
3 Select the desired .HD9 file, and enter the name of the
component library you want to create.
3 The left side of the window lists the component groups from
the default component library. Click the Open button in the
Component File section.
UG_TransitionGuide.book Page 59 Thursday, December 8, 2005 5:40 PM
4 Open the .GMD file created from your .HD9 file. Mastercam
will have automatically copied it to your \CNC-MACHINES
folder when you ran the C-Hook.
The new library and its components should display like in
the following picture.
Note: After clicking the Select Post(s) button, select All files (*.*)
from the Files of type list so that you can select the .set files.
Setup sheets in Mastercam X still use the .set extension, so your new
setup sheet will have exactly the same name as the old one.
Mastercam will create a backup copy of your original file with a
different extension.
Recall that each .control file can .control file which contains the desired control definition
have several control definitions the post processor (.pst, .psm, .psb)
based on different post proces-
sors. It doesnt matter if they are stored in the same folder or not.
2 Start the Control Definition Manager from the Machine
Type menu.
7 Click Add files and select the desired post processor from the
network location. Click OK.
8 Select the network post from the Post processors drop-down
menu.
X Copying data from the old control definition to the new one
Now that youve created a new control definition that points to the
post on the network, you need to copy the control definition settings
from the original control definitionthe one that points to the local
copy of the post processorto the new one. The data that youll be
copying are the values from all the control definition pages (except for
the Operation Defaults page and the Text page).
1 Go to any data pagefor example, Tolerancesand right-
click. (Right-click in a gray area, not inside a field.)
UG_TransitionGuide.book Page 67 Thursday, December 8, 2005 5:40 PM
From post.
3 Select the post that contains the original post text. This can
be either the network copy or the local copy.
4 Mastercam will display the names of all the control
definitions to which the post has been added. Select the
name of your original control definition and click OK.
4 Click the Post processors drop list. The local copy should no
longer be visible, just the network copy.
2 If your part file already has an active machine group, you will
first see an alert message about editing the current machine
definition; click OK to continue.
3 Click the Open button and navigate to the network location
where you copied the machine definition.
UG_TransitionGuide.book Page 70 Thursday, December 8, 2005 5:40 PM
6 Select the network folder with the new .control file and click
OK.
7 Select the new .control file. Make sure that you see the
network path as shown below.
8 Select the new post processor. Make sure that you see the
network path as shown below.
Section 4:
Updating parts and machining jobs
Mastercam X is designed to smoothly import and convert your
current parts so that you can easily keep working on your current
jobs. It includes an import utility (File, Import directory) that lets you
convert parts in batch mode, or you can import individual files.
However, many users will find it more convenient to convert parts
one at a time, as they are required.
The most important part of importing a part from an earlier version of
Mastercam is creating a machine group to hold the toolpaths and
assigning a machine and control definition to it. The following
sections tell you more about how this is done and issues that might
arise.
new file. The path for the new NC file is specified in the
control definition.
The post selection in the original file is discarded. The new
post selection will be the post assigned to the default
machine definition.
Mastercam validates each operation against the default
machine definition. (See Machine compatibility on
page 73.) For Lathe parts, Mastercam automatically assigns
axis combinations based on the turret and spindle settings in
the source file.
Your original parts are completely unchanged.
How does Mastercam know which machine definition to use?In
the Files page of the System Configuration dialog box, Mastercam lets
you specify a default machine definition for each product. These are
saved to the .config file, so you can have different default machine
definitions for different configuration files. When you convert a file,
Mastercam figures out which product it was created with and auto-
matically assigns the default machine definition for the proper
product type.
If you wish, you can change this behavior. The Files page of the
System Configuration dialog box also includes an option to Apply last
machine definition.
If you are converting many files, print this report or copy it to another
document so you can refer to it later. Close this dialog box and the
Replace Group Machine Warning dialog box to proceed with the
conversion.
When Mastercam creates the machine group for this file, it will not
use the incompatible machine definition. Instead, it creates a special
machine group based on its system defaults. Note that no post has
been assigned:
You will first see the following message while converting the file.
Click the Parameters icon to review the changes, then click the
Regenerate button on the Toolpath Manager toolbar to regenerate
the toolpath.
UG_TransitionGuide.book Page 77 Thursday, December 8, 2005 5:40 PM