How to Find Out What You Can Claim

This section explains what different users will see as a result of Q CLAIMLIST commands.

For this example, take the case of a database PIPE/PIPE, accessed by USERA, with two extracts. Users USERX1 and USERX2 are working on the extracts.

USERA creates a Pipe and flushes the database back to the owning database, PIPE/PIPE. The results of various Q CLAIMLIST commands by the three Users, together with the extract control commands which they have to give to make the new data available, are shown in the the image.

Notes: Q CLAIMLIST EXTRACT tells you what you can flush.

Q CLAIMLIST OTHERS tells you what you can't claim.

Querying extract claimlists

When you create an element, AVEVA E3D Design only sees it as a user claim, not an extract claim, until the element is flushed. It will then be reported as an extract claim (as well as a user claim, if it has not been unclaimed).

Note that a change in the claim status of an existing element will be shown by the appropriate Q CLAIMLIST command as soon as appropriate updates take place, but a user will have to GETWORK as usual to see the changes to the Model model data.

We recommend that:

• Before you make a user or extract claim, you should do an EXTRACT REFRESH and GETWORK.

• If you need to claim many elements to an extract, it improves performance if the elements are claimed in a single command, for example, by using a collection:

  EXTRACT CLAIM ALL FROM !COLL

Common Extract Commands

Command Syntax

>-- Q CLAIMLIST --+- OTHER -----.

                  |             |

                  |- EXTRACT ---+- OTHER --.

                  |             |          |

                  |             |- FREE ---|

                  |             |          |

                  |             ‘----------|

                  |                        |

                  |------------------------+-- DB dbname --.

                  |                                        |

                  ‘----------------------------------------+-->