---->(RAISE_WINDOW)---->
RAISE_WINDOW causes the ME Series window to rise to the top of the stack of windows de-iconifying if necessary. Using the RAISE_WINDOW command in any other display mode will have no effect. In case of MS Windows this function can be executed from an external application
->(RC_ACCURACY)---->|value|--->
RC_ACCURACY allows you to specify an accuracy value for comparison of geometry in RC_CHECK within a range of 0 to 0.000001. By default, RC_ACCURACY is set to 0.000000000001.
-> (RC_CHECK) ----+----(SOFT)-------+-- |part 1| --- |part 2| -->
| |
+---(MEDIUM)------+
| |
+----(HARD)-------+
RC_CHECK compares two parts and all their subparts and stores the result of the comparison as info texts for the parts elements.
With option SOFT, the location of geometry, texts, symbols and leader lines in the two parts is compared.
The comparison with option MEDIUM includes the comparison as it is done with option SOFT. Additionally, the properties of the geometry, texts, symbols and leader lines - linetype, color, text attributes, info texts -, and the dimensions and hatches in both parts are compared. For comparison of dimension lines, see also RC_CMP_DIMLINES.
With option HARD, all MEDIUM checks are done. Additionally, the parts structure under both parts is compared.
To specify an accuracy value for comparison of geometry, you may use the function RC_ACCURACY (see RC_ACCURACY).
->(Rc_clean_up)-----+----'TopX'---'TopY'----+--->
| |
+----'TopY'---'TopX'----+
Rc_clean_up causes the first selected part to be deleted and the second selected part to be continued with. You can now continue working on this part in the usual manner.
Additionally, SPOTLIGHT is set to ON.
---->(RC_CMP_DIMLINES)--->+---->(ON)----->+---->
| |
+---->(OFF)---->+
RC_CMP_DIMLINES controls whether RC_CHECK with option MEDIUM or HARD also compares the dimension and extension lines of two dimensions (default) or not.
->(Rc_comp)-----+----(SOFT)-------+--->
| |
+---(MEDIUM)------+
| |
+----(HARD)-------+
Rc_comp compares two parts named 'TopX' and 'TopY' and all their subparts and stores the result of the comparison as info texts for the parts elements (see also RC_CHECK). It shows the results of the comparison in user-definable colors according to the following defaults:
Blue Identical elements in 'TopX' and 'TopY' Green Differences in 'TopX' Red Differences in 'TopY'
You should use the Rc_load macro (see also Rc_load macro) to load the two files that you want to compare with the Rc_comp macro.
With option SOFT, the location of geometry, texts, symbols and leader lines in 'TopX' and 'TopY' is compared.
The comparison with option MEDIUM includes the comparison as it is done with option SOFT. Additionally, the properties of the geometry, texts, symbols and leader lines - linetype, pensize, linesize, color, text attributes, info texts -, and the dimensions and hatches in parts 'TopX' and 'TopY' are compared. With this option, the Rc_comp macro also checks if elements belong to a polyline (as created with the POLYELEM command).
With option HARD, all MEDIUM checks are done. Additionally, the parts structure under parts TopX' and 'TopY' is compared.
Rc_comp is based on the command RC_CHECK (see RC_CHECK). To specify an accuracy value for the comparison done by the command, you may use the function RC_ACCURACY (see RC_ACCURACY).
->(Rc_load)--|file 1|---|file2|-->
Rc_load loads two files, an original and a revised drawing, as subparts of parts named 'TopX' and 'TopY' that are created under the top part. The loaded subparts are put at the same location where they were when you stored them. Additionally, SPOTLIGHT is set to OFF.
->(Rc_show_diff)--->
Rc_show_diffs shows the results of the last comparison done with RC_CHECK (see also RC_CHECK or Rc_comp) in different colors according to the current Revision Checking color settings (see also Rc_upd_color_and_menu).
->(Rc_upd_color_and_menu)-----+----'Only1'--------+--->
| |
+----'Only2'--------+
| |
+----'Ident'--------+
Rc_upd_color_and_menu allows you to change the color scheme for showing the results of REVISION CHECKING in different colors. You may select to change the color used for identical elements in both parts ('Ident'), for differences in the original part ('Only1') and differences in the revised part ('Only2').
->(Rc_view)-----+----'TopX'-------+--->
| |
+----'TopY'-------+
| |
+----'Top'--------+
Rc_view causes the selected part to be viewed in the current viewport (see also VIEW). This macro offers a comfortable way to look at the visual results of Revision Checking. If you select to view Drw1 the part 'TopX' (see also Rc_load) is viewed. If you select to view Drw2, the part 'TopY' is viewed. If you select to view Both, the top part is viewed.
->(READ)->|tokentype|->|prompt|->|feedback|->|default|->|macro name|-->
|tokentype|:
+<--------------------------------------+
v |
---->+---->+-------------------------->+---->+---->
| |
+---->(LITERAL)------------>+
| |
+---->(COMMAND)------------>+
| |
+---->(FUNCTION)----------->+
| |
+---->(QUALIFIER)---------->+
| |
+---->(PSEUDO_COMMAND)----->+
| |
+---->(ARITHM_FUNCTION)---->+
| |
+---->(SYMBOL)------------->+
| |
+---->(MACRO)-------------->+
| |
+---->(STRING)------------->+
| |
+---->(NUMBER)------------->+
| |
+---->(PNT)---------------->+
| |
+---->(PNT3)--------------->+
| |
+---->(PNT_MM)------------->+
| |
+---->(PNT_PIXEL)---------->+
| |
+---->(NO_CATCH)----------->+
|prompt|:
---->+----------------------------->+---->
| |
+---->|string|---------------->+
| |
+---->(PROMPT)---->|token|---->+
| |
+---->(LAST_PROMPT)----------->+
|feedback|:
-->+------------------------------------------------------------------>+--> | | +->(RUBBER_LINE)------------>|start point|------------------------->+ | | +->(RUBBER_LINE_HORIZONTAL)->|start point|------------------------->+ | | +->(RUBBER_LINE_VERTICAL)--->|start point|------------------------->+ | | +->(RUBBER_LINE_ANG)-------->|start point|-->|angle|--------------->+ | | +->(RUBBER_BOX)------------->|corner point|------------------------>+ | | +->(RUBBER_CIRCLE_CEN)------>|center point|------------------------>+ | | +->(RUBBER_CIRCLE_2_PTS)---->|1. periph point|-->|2. periph point|->+ | | +->(RUBBER_ARC_BEG_END)----->|begin point|-->|end point|----------->+ | | +->(RUBBER_ARC_CEN_BEG)----->|center point|-->|begin point|-------->+ | | +->(RUBBER_ARC_CEN_END)----->|center point|-->|end point|---------->+ | | +->(LAST_FEEDBACK)------------------------------------------------->+
|default|:
---->+------------------------------>+---->
| |
+---->(DEFAULT)---->|token|---->+
READ (re)defines a macro. See NAME for a description of permissible macro names.
The READ request is always directed to the user. If the READ function is used within a macro, macro execution is suspended until the READ request is satisfied by entering a legal token or expression, after which the execution of the macro is resumed.
|tokentype| specifies the type of data to be entered by the user. If a token type is not specified, then only STRING, NUMBER, PNT, and PNT3 are permitted. LITERAL means that any token is accepted and directly assigned to |macro name| without being evaluated. Otherwise, the token is evaluated. If the result is a command and COMMAND was not specified in |tokentype|, macro execution is aborted and the command is executed. If the result is a function and FUNCTION was not specified in |tokentype|, the function is executed, then the READ request resumed.
2D points may be digitized. When using PNT_MM, the point is measured in tablet millimeter units (origin is the lower left corner of the tablet surface). When using PNT_PIXEL, the point is measured in display pixel units (origin is the lower left corner of the screen). When using PNT or no type specifier, the point is measured in the current model units and it is caught using the current catch mode and range (except when using NO_CATCH. Then the point is not caught at all). Also the INQ array will be filled with the viewport number (INQ 2) and viewport name (INQ 301) of the picked port.
The prompt is used as prompt for the READ request. If the prompt is omitted,
the system uses a default prompt (Enter
A feedback option may be specified. The various kinds of possible feedback and the required parameters are listed in the syntax diagram above. By using LAST_FEEDBACK the system uses the last active feedback before the READ function was invoked.
The DEFAULT option evaluates its parameter and puts the result into the keyboard entry line. Pressing RETURN will then enter the (possibly edited) value to satisfy the READ request.
Macro_name may be any identifier not reserved by the system for use with, for example, commands, functions, and options.
---->(READ_FILE)---->+--------------------->+---->|number|---->|macro name|---->
| |
+---->(BLOCK_MODE)---->+
READ_FILE reads one line of text from the specified file and assigns this line as a string to the named macro. If READ_FILE hits the end of the file, the string 'END-OF-FILE' will be assigned to the macro. If the BLOCK_MODE qualifier is present and the input is read from a pipe, additional buffering will be applied by the READ_FILE command. In this case only newline terminated strings will be returned. If no string or a non terminated string is present the string 'END-OF-FILE' will be assigned to the macro. However if the maximum buffer length of 1023 characters is reached the buffered characters will be returned even without a newline character.
--->(READ_LTAB)--|name|--+--|row|---------|col|---+--------> | | +--(TITLE)---|number|----+
READ_LTAB responds with the value in the named logical table.
|row| and |col| specify an element in the data area of the table.
TITLE and |number| specify a title string (also known as an "extra string").
The returned value may be a string or number. If no value is specified for the requested element, an empty string ("") will be returned.
Example:
Read the fourth column from the first row and assign it to the macro "my_value":
LET my_value (READ_LTAB 'mytable' 1 4)
---->(RECALL_BUFFER)---->+------>(ON)----------->+---->
| |
+------>(OFF)---------->+
| |
+------>(CLEAR)-------->+
| |
+---->|output_spec|---->+
The RECALL_BUFFER facility may save up to 63 input lines in internal memory. If more lines are typed in, the oldest are overwritten.
Options:
ON Enables saving of input lines (default).
OFF Disables saving of input lines.
CLEAR Clears the internal recall buffer memory.
output_spec Outputs the internal recall buffer memory to the
specified destination.
---->(RECALL_WINDOW)---->
RECALL_WINDOW changes the window of the current viewport to the window stored with STORE_WINDOW.
---->(REDRAW)---->
REDRAW redraws the contents of the current viewport.
,--------->-----------(UNDERLINE_SOURCE)---------|select source|-->---------------,
^ |
| ,- (UNDO)<-------, |
| | | |
->(REFLINE)->+---------->----------+--+--------->---------+->+->|select src|+->|src pnt|----+-+
| | | ^ | | |
`->(FIXED_SOURCE)-----+ +->( PARALLEL )-----+ `----->|source element|---------' |
| | | |
v +->(PERPENDICULAR)--+ |
| | | |
,----------------<----' +->(ANGLE_TO)-|ang|-+ |
| | | |
| +->(HORIZONTAL)-----+ |
| | | |
v `->(VERTICAL)-------' v
| |
| |
| |
| ,--(UNDO)<--, ,-(UNDO)<---, |
| | | | | |
`--(INVISIBLE)-+--|select src|+-|src pnt|-+-+-|select dst|-+>|dst pnt|-+-(END) |
| | | | |
`------|source element|----' `----|destination elem|---' |
|
|
|
|
|
,---------------<----------------------------------------------------------------------'
|
|
v ,--(UNDO)<------,
| | | ,--<(UNDO)---,
| | | | |
`->----+------->-------+-+---------------------+-->|select dst|+->|dst pnt|-+-(END)-+---->--
| | | | |
| | | `---->|select destination|-->--------+
+->(HORIZONTAL)-+ +->( PARALLEL )-----, |
| | | | |
+->(VERTICAL)---+ +->(PERPENDICULAR)--+ v
| | | | |
+->| point |--+ +->(ANGLE_TO)-(num)-+----->|select dst|--------------------'
| | | |
`--------<------' +->(HORIZONTAL)-----+
| |
`->(VERTICAL)-------'
This command lets you anchor a reference line between a source element and a target element. When you move the target, the reference line moves accordingly.
The reference line can be a polygon having any number of points.
FIXED_SOURCE creates a reference line in which the target is attached to source. When any modification is done on the target, the source also moves along with it but not vice-versa.
UNDERLINE_SOURCE underlines the source. This option can be used only if the source is a TEXT or a PART.
INVISIBLE makes the reference text line invisible. See SHOW_INV_RTL, DELETE_INV_RTL to make the reference line visible and delete invisible reference lines respectively.
Options PARALLEL, PERPENDICULAR, ANGLE_TO are used to set the orientation of the segments of the reference line to the source and destination.
Options HORIZONTAL, VERTICAL can also be used for setting the orientation of reference line segments. These two options can be used for all segments of the reference line.
For option ANGLE_TO, ang specifies the angle of the segment to source or target.
UNDO removes the most recent line segment.
The REFLINE command can use the SELECT function to select the source or target. Once the source or target is chosen by using SELECT function, any point on the source or target can be chosen for starting or finishing the reference line. If the source or target is a TEXT or PART then the first or last point of the reference line can lie outside the source or target.
REG_QUERY_TYPE_KEY retrieves the type for a specified value name associated with an open registry key.
Registry key is a string made up of combination of Key handle and/or Subkey and Value name.
Posible results could be "REG_SZ", "REG_EXPAND_SZ", "REG_BINARY", "REG_DWORD",
"REG_DWORD_BIG_ENDIAN", "REG_LINK", "REG_MULTI_SZ", "REG_RESOURCE_LIST",
"REG_FULL_RESOURCE_DESCRIPTOR", "REG_RESOURCE_REQUIREMENTS_LIST".
If a registry key does not exist the result is an empty string.
The most often used results are: "REG_SZ", "REG_DWORD" and "REG_BINARY".
Example:
LET Reg_type (REG_QUERY_TYPE_KEY
'HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\AppData')
Retrieved string will be "REG_SZ".
REG_QUERY_VALUE_EX retrieves the data for a specified value name associated with an open registry key.
Registry key is a string made up of combination of Key handel and/or Subkey and Value name.
Returns the string if REG_QUERY_TYPE_KEY is "REG_SZ" or number if
REG_QUERY_TYPE_KEY is "REG_DWORD".
If a registry key does not exist the result is an empty string.
Results will be valid only if REG_QUERY_TYPE_KEY is "REG_SZ" or "REG_DWORD".
Example:
LET Reg_value (REG_QUERY_VALUE_EX
'HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\AppData')
Retrieved string will be "C:\Documents and Settings\User\Application Data".
---->(REJECT_CONNECTIONS)---->
REJECT_CONNECTIONS causes the ME System to reject any additional connections. Existing connections are retained.
+<-(NEXT)<-------------------------------+
v ^
-->(RELATE)->{ele}---+->(FILE)->|file name|-------------------+->(CONFIRM)-->
| |
+->{element id}->+---------------------->+
| |
+->(FILE)->|file name|->+
{element id}
-->|element name|--+-------------------------------------------------------+-> v | +->(SEL_OLD)--+->|revision string|->|version number|-+->+ | | +->|revision string|------------------>+ | | +->|version number|------------------->+
A hierarchical relationship between the Top element and a variable number of other elements or files can be created. The first given element is the Top element. It is checked whether a relation between the top element and the given elements may be created (see also DEFINE_RELATION command).
There may be several relations between elements, which means, one element can be a component of another element more than once. However, there may be only one relationship between an element and a file.
'Filename' in the railroad diagram above refers to a file currently stored in the database in a storage area. It is the name of the file which was given at the time it was checked in or db_stored.
All elements and files must exist in the database.
element options:
security: WRITE permission for the Top element is needed.
->(RELEASE)-->+------------------+-(elem sel)-> v | +->(DEL_VERSIONS)->+
{elem sel}
-+->|element name|--------------------->+-> | | | +<--------------------+ | v v | | +-+->(SELECT)--->|expr|-+-(SCREEN)---->+ | | +->(CONFIRM)-->+
|expr|
---->|att|-------+-------->+------>|value|------> | | +->(=)--->+ | | +->(<>)-->+ | | +->(>)--->+ | | +->(<)--->+ | | +->(>=)-->+ | | +->(<=)-->+
The status of the selected elements and of all files related to them is changed to released. Released elements and the related files may not be changed.
If a file is related to different elements, it is copied and the original belongs to the element, which has just been released, and the copy is related to the other elements.
If the DEL_VERSIONS option is used, then all other versions of the revision of the element to be released are deleted. The version number of the released element will be forced to 1.
Constraints:
Only those elements may be released where:
The element must exist in the database.
For element selection, see the UPDATE_ELEMENT command.
security: SPECIAL permission is required to release the element
-->(REMOVE)--+--->{element id}-------------------------------+->(CONFIRM)->
| |
| +----------------------->+
| | |
+->(FILE)->|file name|-+-{element id}---------->+
| |
| +---------------+ |
v | | |
+->(LINKS)--->{elem sel}--->-+-{element id}->+->+
|
+--->{select}------------------------------------------------>
{elem sel}
--+->{element id}--+-->
| |
+->{select}------+
{element id}
-->|element name|--+-------------------------------------------------------+-> v | +->(SEL_OLD)--+->|revision string|->|version number|-+->+ | | +->|revision string|------------------>+ | | +->|version number|------------------->+
{select}
+<--------------------+ v | --+->(SELECT)--->|expr|-+-(SCREEN)-------->+-> | | +->(CONFIRM)------>+
{elem sel}
+<--------------------+ v | --+->(SELECT)--->|expr|-+-(SCREEN)-------------------------------------->+ | | +->(CONFIRM)------------------------------------>+
|expr|
---->|att|-------+-------->+------>|value|------> | | +->(=)--->+ | | +->(<>)-->+ | | +->(>)--->+ | | +->(<)--->+ | | +->(>=)-->+ | | +->(<=)-->+
element options:
Command to delete elements, files, or links to elements.
The elements and files must exist in the database.
Selection of elements: see UPDATE_ELEMENT command
The following diagrams illustrate how the REMOVE FILE command works in different scenarios:
BEFORE
------------- This is the current state of element- | myfile | 0 | to-file relationships to "myfile". ------------- All AFTER scenarios begin with this setup. ------------- ------------- | myfile | 1 |---------| myelement_a | ------------- -------------
------------- ------------- | myfile | 3 |---------| myelement_b | ------------- | ------------- | ------------- -----| myelement_c | | ------------- | ------------- -----| myelement_d | -------------
If you do this: REMOVE FILE 'myfile' 'myelement_c' CONFIRM
AFTER
------------- | myfile | 0 | -------------
------------- ------------- | myfile | 1 |---------| myelement_a | ------------- ------------- The effect of this command was to remove the element-to-file link ------------- ------------- between 'myfile' and 'myelement_c'. | myfile | 2 |---------| myelement_b | 'myfile' was NOT removed because it ------------- | ------------- is still related to 'myelement_b' | ------------- and 'myelement_d'. | | myelement_c | | ------------- Notice the file reference count on | ------------- this last 'myfile' is now 2. -----| myelement_d | -------------
If you do this: REMOVE FILE 'myfile' 'myelement_a' CONFIRM
AFTER
------------- | myfile | 0 | ------------- ------------- The effect of this command was to | myelement_a | remove the element-to-file link ------------- between 'myfile' and 'myelement_a'. At this point the file reference ------------- ------------- count for the middle 'myfile' was 0, | myfile | 3 |---------| myelement_b | so we also REMOVE 'myfile', as we ------------- | ------------- cannot have more than one 'myfile' | ------------- with a file reference count of 0. -----| myelement_c | | ------------- | ------------- -----| myelement_d | -------------
If you do this: REMOVE FILE 'myfile' CONFIRM
AFTER
------------- ------------- The effect of this command was to | myfile | 1 |---------| myelement_a | remove the first 'myfile' which had ------------- ------------- a file reference count of 0.
------------- ------------- | myfile | 3 |---------| myelement_b | ------------- | ------------- | ------------- -----| myelement_c | | ------------- | ------------- -----| myelement_d | -------------
security: SPECIAL permission is needed to delete an element, and WRITE access is needed to remove single files. To delete relations to other elements, WRITE permission for the parent elements are needed.
-->(REMOVE_QUERY_PAGE)->+--|query-page-name|->+-(CONFIRM)
| |
+---(ALL)------------>+
Destroy a specific named query page, if it is unsecured, or any unsecured query pages that have been created if the ALL option is used.
(REMOVE_STORAGE_AREA)---|area name |--->(CONFIRM)->
The REMOVE_STORAGE_AREA command is a maintenance command which removes the storage area. The storage area must have all CoCreate/DMS files removed. If any 'dms_map' or 'dms_map.bak' files created by the create_map utility exist they will be deleted. e.g.:
REMOVE_STORAGE_AREA 'area_name' CONFIRM
--->(REMOVE_TREE)--+-------------+-->|tree name|-->(CONFIRM)---> | | +>(RECURSIVE)-+
Remove a classification tree from the database. When the RECURSIVE option is given, the tree with all its nodes is deleted, otherwise only a tree with no user created nodes can be deleted. Removing a tree having user created nodes, without the RECURSIVE option results in an error.
A classification privilege of 1 is required to use this command.
--->(REMOVE_TREE_LINK)->{parent node}-->{child node}--->
{parent node}
---+->|name|-------------+---> | | +->(TOP)--------------+ | | +->(LAST)-------------+ | | +->(CURRENT)----------+ | | +->(BACK)-->|steps|---+
{child node}
---+->|name|-------------+--->
| |
+->(TOP)--------------+
| |
+->(LAST)-------------+
| |
+->(CURRENT)----------+
| |
+->(BACK)-->|steps|---+
| |
+->{select condition}-+
{select condition}
--->(SELECT)-+---------------+--->
v |
+->{expression}-+
^ |
+--(AND)<-------+
^ |
+--(OR)<--------+
{expression}
-->|attribute name|->+-------->+->+->|value|->+----->
| | | |
+->(=)--->+ +->(NULL)-->+
| |
+->(<>)-->+
| |
+->(>)--->+
| |
+->(<)--->+
| |
+->(>=)-->+
| |
+->(<=)-->+
Remove an existing link between a parent and a child node in the current classification tree. If the child node has only one parent node, the link can not be deleted.
An existing node can be specified by typing its name or picking it from a table. Option TOP specifies the top node of the current tree, which also is the name of the current tree. Option CURRENT specifies the current node in the history of the node queries. Option LAST gives the last current node, BACK identifies a node queried earlier by given steps in the history.
More than one child node can also be selected using the SELECT option, and the selection can be based on the nodal attributes. Wildcards are allowed inside of 'value' if the comparison value is a string and comparison operator is '=' or '<>'. Wildcard '*' is used to match an aribtrary long search pattern and '?' matches exactly one arbitrary character.
A classification privilege of 2 is required to use this command.
--->(REMOVE_TREE_NODE)-+---------------+-->{node}-->(CONFIRM)-->
| |
+->(RECURSIVE)--+
{node}
---+->|name|-------------+--->
| |
+->(TOP)--------------+
| |
+->(LAST)-------------+
| |
+->(CURRENT)----------+
| |
+->(BACK)-->|steps|---+
| |
+->{select condition}-+
{select condition}
--->(SELECT)-+---------------+-->(CONFIRM)--->
v |
+->{expression}-+
^ |
+--(AND)<-------+
^ |
+--(OR)<--------+
{expression}
-->|attribute name|->+-------->+->+->|value|->+----->
| | | |
+->(=)--->+ +->(NULL)-->+
| |
+->(<>)-->+
| |
+->(>)--->+
| |
+->(<)--->+
| |
+->(>=)-->+
| |
+->(<=)-->+
Remove nodes from the current classification tree. Option RECURSIVE removes a node and its children all the way to the leaf nodes. Any child with multiple parent nodes is not removed, but only the link is deleted. Without the RECURSIVE option, removal of a node having children results in an error. All the links to the node to be removed are deleted.
An existing node can be specified by typing its name or picking it from a table. Option TOP specifies the top node of the current tree, which also is the name of the current tree. Option CURRENT specifies the current node in the history of the node queries. Option LAST gives the last current node, BACK identifies a node queried earlier by given steps in the history.
Multiple nodes can also be selected for deletion using SELECT option, and the selection can be based on the nodal attributes. Wildcards are allowed inside of 'value' if the comparison value is a string and comparison operator is '=' or '<>'. Wildcard '*' is used to match an aribtrary long search pattern and '?' matches exactly one arbitrary character.
A classification privilege of 2 is required to use this command.
--->(REMOVE_USER)--|user_login|--(CONFIRM)-->
REMOVE_USER removes a user's access to CoCreate/DMS entirely.
|user login| is the user's login name.
An CoCreate/DMS privledge level of 1 is required to use this command.
While the commands are executing they keep a logical table "dms_su_table" filled with up-to-date information about the users' privilege level.
->(RENAME_ELEMENT)->|element name|-+----------+->|new element name|->(CONFIRM) | | +->(COPY)->+
This command renames or copies an element, including ALL revisions and versions of that element.
With the COPY option, all revs and vers of the element are copied to the new element name.
Without the COPY option, all revs and vers of the element are renamed to the new name.
The new element name must be unique and must not currently exist.
security: A PRIV level of 3 or greater and WRITE permission is needed for ALL revisions and version of the element
---->(RENAME_PART)---->|new name|---->
RENAME_PART gives a new name to the active part. The name must be a simple name, without forward slashes (/); the exception is that if you are at the top part, you can rename it to '/'.
->(RENAME_STORAGE_AREA)---|area name |---|area name |--->(CONFIRM)->
The RENAME_STORAGE_AREA command is a maintenance command which changes the storage area name. A storage area could be given a new name, e.g.:
RENAME_STORAGE_AREA 'old_area_name' 'my_new_area_name' CONFIRM
The storage area is only renamed, no files are moved.
Function: Restores the contents of (selected) viewports by drawing from the 2D data structures.
Syntax
,->-(TWO_PTS)--|point|--|point2|--------,
| |
+->-(PAN_SEL)--|point|--|screen point|--+
| |
+->-(FIT)-------------------------------+
| |
+->-(AS_DISPLAYED)----------------------+
| |
->-(RENOVATE)->-+->-(CENTER)->-|new center pnt|---------+->-,
| | |
+->-(ZOOM)->-|scale factor|-------------+ |
| | |
+->-(LAST_WINDOWS)----------------------+ |
| | |
+->-(STORE_WINDOWS)---------------------+ |
| | |
`->-(RECALL_WINDOWS)--------------------' |
|
,----------------------------------------------------'
|
| ,->-(ALL)--------->-,
| | |
| +->-|id viewport|->-+
| | |
`---------->-+->-(CURRENT)----->-+------------------>
| |
`--------->---------'
(only one viewport)
Parameters
TWO_PTS
Draws a new window with specified points as lower left and upper right corner in the specified ports.
PAN_SEL
Moves the drawing in the specified ports. The first digitized point moves to screen point.
AS_DISPLAYED
Redraws in specified ports.
FIT
Fits all of the current drawing in specified ports.
ZOOM
Scales all of the current drawing in specified ports by a given scale factor.
CENTER
Makes the indicated point the center of drawings in specified ports.
LAST_WINDOWS
Recalls the last window in specified ports.
STORE_WINDOWS
Stores the current window in specified ports.
RECALL_WINDOWS
Changes the windows in specified ports to the windows stored by
RENOVATE STORE_WINDOW.
ALL
Affects all active viewports.
CURRENT
Affects current viewport.
Description
RENOVATE works like redraw or window function affecting all specified viewports.
--->(REPEAT)--->+------->-------+->--(UNTIL)->--|boolean expression|--->
| |
| |
`--<-|token|--<-'
This construct defines a loop which is repeated until the boolean expression in the UNTIL clause evaluates to be logical true (evaluates to a non-zero value).
-->(REQUEST_PRINT_SETUP)--+-->(ON)-->+-->
| |
`-->(OFF)->'
This function let you choose whether or not the Windows Print Manager displays its own print setup dialog each time you plot or screendump to the Print Manager. If REQUEST_PRINT_SETUP is set ON, the Print Manager dialog is displayed each time you plot. You may need to supply additional information and a confirmation to this dialog before the print job is spooled. If REQUEST_PRINT_SETUP is OFF, all Print Manager dialogs are suppressed, and default values are used.
The RESET button clears all entries from the current dimension selection filter. Confirmation is required.
Use this function to give each part of your drawing a new unique part number. The new part numbers will start at ~1 and subsequently will be incremented by 1.
-->(RESET_SYSTEM)-->(CONFIRM)->
RESET_SYSTEM changes the title of current drawing to 'Untitled', changes the active part to the top of the drawing and deletes entire drawing, renames the top part of the drawing to 'Top' and invokes Reset_env macro, which resets the environment to default values.
+---(NEXT)-----+
v ^
-->(RESTORE)->|source|->++>{element id}-+->+-+-------------+-+---------------+-+
| | | | | | |
+----->(ALL)------>+ +->(DEL_OLD)->+ +->(RECURSIVE)->+ |
|
+------------------------------------------------------------------------------+
|
+-+------------------------+->+------------+->(CONFIRM)--->
| | | |
+->(AREA)->|area name|-->+ +->(SCREEN)->+
{element id}
-->|element name|--+-------------------------------------------------------+-> v | +->(SEL_OLD)--+->|revision string|->|version number|-+->+ | | +->|revision string|------------------>+ | | +->|version number|------------------->+
RESTORE recovers of archived elements and their related files from 'source' to the database. 'source' is the name of a source file (device file) where previously archived information is held. The 'source' file/device for RESTORE must be an absolute path (begin with a leading '/').
Immediately after specification of the source file, the archive is read, and a list of all elements archived in 'source' are shown in a table. The user may then select individual element names from the displayed table.
RESTORE uses the contents of 'source' to update elements in the database and copies related files to the current storage area. If an element to be restored doesn't exist in the data base, a new element will be created with the same attribute values as the restored one.
Options:
If DEL_OLD is specified, existing elements are overwritten from 'source'. Unless the option RECURSIVE is used, relationships to other elements remain unchanged.
The SCREEN option enters the built-in editor (see EDITOR) and allows you to verify the list of selected elements; any changes in the screen are ignored. With an unsuccessful exit (STOP/BREAK) from the editor nothing is restored. For each element, it is shown if it already exists in the database or not and which elements are linked to this element on the archive medium.
Element-selection:
If the command can't be completely executed, nothing is changed in the database.
Only one user may do an ARCHIVE or a RESTORE at a time. If another archive or restore is already active, no other ARCHIVE or RESTORE commands will be allowed until the running RESTORE completes.
RESTORE reads its input in the "cpio -c" format. If the source file is a device file you have to specify the raw device file name (e.g. /dev/rct/c1).
security: To restore an element which does not exist in the database, the user must have privilege-3 status. To restore an element which already exists in the database the user needs WRITE-permission for the element.
(RETAIN_RELATIONSHIP)-+---------+->(old element id)-->(new element id)--+ | | | +->(COPY)-+ +---------------------------------+ | +-----+->(parent)-+-> CONFIRM ---> | | +->(child)--+
{element id}
-->|element name|--+-------------------------------------------------------+-> v | +->(SEL_OLD)--+->|revision string|->|version number|-+->+ | | +->|revision string|------------------>+ | | +->|version number|------------------->+
{parent}
--> PARENT --+--------------------> ALL ------------------->+---->
| |
| +-<---------------------------------------+ |
| | | |
+-+-->(parent element id)-+->|quantity|->+->+->+
| |
+---> ALL ---->+
{child}
--> CHILD ---+------------------> ALL -------------------->+---->
| |
| +-<--------------------------------------+ |
| | | |
+-+-->(child element id)-+->|quantity|->+->+->+
| |
+---> ALL ---->+
Move or copy some or all of the PARENT and/or CHILD relationships from the source element to the destination element.
SEL_OLD is used to select an older version of the element. The default is the most current version.
ALL is used to specify all of the parents or children related to the old element.
Permissions for retaining relationships are the same as relating elements.
Quantity can be any positive number. If the COPY option was not chosen, quantity relationship links will be removed from the source element and moved to the destination element. The value of quantity is considered the total number of links that the destination element should have to the parent/child element after the operation. If the destination element already had a link or links to the parent/child, these links are ignored. If quantity is greater than the number of links currently linked to the source element, the result will be that the source element now has zero links. The destination element will, however, have "quantity" links.
If the COPY option was chosen, the source element will remain unchanged and the destination element will have a total of quantity relationship links.
Logical tables are used to display all the parents or children of the source element. The logical table can be modified as many times as the user would like. Only until the user has specified CONFIRM will any changes be made in the database.
If there is an unexpected system failure, all changes for the current execution of the RETAIN_RELATIONSHIP command will NOT be made.
security: Write access for the parent element, source element, and destination element is needed depending on a move or copy operation.
Description:
The REVISION CHECKING module allows you to compare similar drawings.
This facility is particularly useful in design offices where successive drawings are revised and the differences between revisions need to be identified. Instead of comparing hardcopies side-by-side, the revised drawing can be superimposed on top of the original drawing and the differences are automatically highlighted in user-definable colors.
Returns a pseudo-random number greater than or equal to zero and less than 1.
---->(ROLLBACK_WORK)---->
ROLLBACK_WORK indicates that a database transaction is to be aborted and the results of the transaction are to be removed from the database completely. Files which were written by CoCreate/DMS commands are removed, and files which were deleted are restored to their original states.
Returns the point (vector) rotated about the origin (0,0) by the given angle. As always, the current angle units are used.
,--------<-------------,
| |
+---(repeat factor)----+
| |
+-----(COPY)----->-----+
| |
+-----(DEL_OLD)-->-----'
|
-->(ROTATE)-+-+(CENTER)+--|fix point|-->-+->----|angle|---------+--------->
| | | | |
| `--------' `--|point1|--|point2|--'
|
`->(TWO_PTS)--|ref point|--|imref point|--+->-|angle|-----+--->
| |
`-|pnt1|-|pnt2|-'
ROTATE rotates the elements about a fixed point.
With CENTER, you indicate a fixed point and an angle. The angle can also be indicated with two points. In this case, the system uses the angle between the two points with respect to the fixed point.
TWO_PTS includes a MOVE as well as a ROTATE. The elements are moved from ref_point to imref_point, then rotated around imref_point as in CENTER.
Example: MODIFY ROTATE 50,50 60 (select) rotates the selected elements around the point 50,50 by the angle 60.
+------------------+---------------+
| | |
-->(ROTATE_DIM_TEXT)---v--|rotate_angle|--v--|selection|--+---->
ROTATE_DIM_TEXT rotates the identified dimension text by the given angle, but always corresponding to the original dimension text location.
When using this command, the view rotation will be preserved after the associative documentation update (ADU).
Returns the argument value rounded to the nearest integer value.
Returns a string containing number copies of the string argument.
-->(RTL_COLOR)---|color|--->
RTL_COLOR lets you change the default color of a reference line. By default, a reference line is WHITE. See COLOR for a list of colors.
---->(RTL_DST_GAP)---->
Use this function to set the reference-line space (gap) between the end of the reference line and the destination element.
-->(RTL_LINETYPE)---|linetype|--->
RTL_LINETYPE lets you change the default linetype of a reference line. By default, a reference line has linetype SOLID. See LINETYPE for a list of linetypes.
---->(RTL_OFFSET)---->
Use this function to set the length of the horizontal part of the reference line. This line:
If the size of the arrowhead is greater than the pointing-length, the horizontal part is set to 0.
If RTL_OLD_BEHAVIOUR is OFF, then horizontal part does not apear.
---->(RTL_OLD_BEHAVIOUR)--->+---->(ON)----->+---->
| |
+---->(OFF)---->+
Use this function to switch to the old-style of reference text lines.
By default is OFF.
-->(RTL_PENSIZE)---|pensize|--->
RTL_PENSIZE let you change the default pensize of a reference line. By default, a reference line has no pensize.
---->(RTL_SRC_GAP)---->
Use this function to set the reference-line space (gap) between the source and the start of the reference line.
,--------------------------------,
| |
v |
--->(RULER)-+->|point or viewport number|----+-->+-->(ON)---,
| ^ | |
+->(ALL)-------------------------+ '-->(OFF)--+-->
| |
'------------------------------->'
RULER turns the ruler on or off in the specified viewport(s) . If no viewport is specified the ruler is turned on or off in the current viewport. If the ORIGIN is active in the specified viewport(s) , it is turned off. The ruler origin and axes are determined by the input coordinate system, set by the commands beginning with "CS_". The location of the axis ticks is determined by the input coordinate system and by the ruler spacing, set by GRID_FACTOR. You can catch to a ruler tick, or to an intersection between the ruler and an element; see CATCH for details.
The drawing of the ticks is suppressed in viewports where they are too close together.
---->(RUN)---->+------------------>+---->|shell command line|---->
| |
+---->(GRAPHIC)---->+
The RUN function starts the UNIX-based shell program.
If the string 'shell command line' is empty (null string), the shell interactively requests commands from the user. Execution of the command 'exit' or input of CTRL D causes the shell to terminate.
If the string 'shell command line' is not empty, it is passed as argument to the shell program. The shell terminates automatically after execution of 'command line'.
Termination of the shell causes operation to resume at the same point where it was suspended. If no option is specified, the contents of the graphics screen is saved and alpha mode is enabled before starting the shell. If the option GRAPHIC is given, the graphics screen is not saved and alpha mode is not turned on. If the option GRAPHIC is specified, the shell command should not output anything to the alpha or graphics screen.
Example:
---->(RUN)-------->|shell command line|---->
The RUN function brings up the DOS or Windows NT operating system command line.
If the string 'shell command line' is empty (null string), the shell interactively requests commands from the user. Execution of the command 'exit' causes the shell to terminate.
If the string 'shell command line' is not empty, it is passed as argument to the shell program. The shell terminates automatically after execution of 'command line'.
Termination of the shell causes operation to resume at the same point where it was suspended.
Example:
---->(RUN_TERMINAL)---->|name|---->
The RUN_TERMINAL function can be used to restart a previously suspended terminal session.