NX Nastran DMAP Programmer's Guide - Kxcad.net

862
DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
convert-expr Modifies the values for PROJECT, VERSION, DBSET, and qualifiers
selected by the where-expr. The format of convert-expr is:
PROJECT=project-expr;VERSION=version-expr;
DBSET=DBsetname;quali=qual-expri[;...]
For example, CONVERT (SEID=100+SEID; SPC=102).
See “WHERE and CONVERT Clauses” on page 45 for a further
discussion on WHERE and CONVERT clauses. The default action
for VERSION and PROJECT is to convert to the current version-ID
and current project-ID. But if either PROJECT or VERSION is
specified in the convert-expr, then both must be specified.
OVRWRT
NOOVRWRT
Remarks:
1. The where-expr has the following rules:
If the where-expr specifies a colname that is not assigned to the data block or
parameter then none of that data block or parameter will be equivalenced. For
example, given that SPC is not a qualifier for KGG, then the following DBEQUIV
statement will not equivalence any KGG:
DBEQUIV DATABLK=KGG WHERE(SPC=10) CONVERT(SPC=20) $
If the where-expr does not specify a colname that is assigned to the data block (or
parameter), then the current value of the qualifier is assumed. For example,
given that SEID is a qualifier for KAA, then the following DBEQUIV statements
are equivalent:
SPC=10 $
DBEQUIV DATABLK=KAA CONVERT(SPC=20) $
or
By default (i.e., NOOVRWRT), duplicate data blocks or parameters
on the created by DBEQUIV will cause a fatal message. A duplicate
means that a data block or parameter has not only the same name
but also the same qualifier values, PROJECT, VERSION, and
DBSET as the primary data block or parameter. If OVRWRT is
specified, then the primary data block is overwritten.
RESTART By default, data blocks and parameters created by DBEQUIV
cannot be output again in a subsequent DMAP module. If
RESTART is specified then the selected data blocks and parameters
may be overwritten once.
DBEQUIV DATABLK=KAA WHERE(SPC=10) CONVERT(SPC=20) $