☜	OMI- Global Reference Draft MDC Standard					☞

5.3.3 Global reference

4.1 describes the environment, the global variable name (gvn), the structured system variable name (ssvn) and the lock argument (nref) that appear in many OMI messages, where they have the following form, called a global reference.

A global reference shall be a long string <LS>. Its fields shall be a character translation flag and strings containing the environment, name, and subscripts.

NOTE – The protocol does not support M[UMPS] naked references. The agent shall send full references for all operations.

The fields of the global reference and their sequence shall be:

1. Character translation: <SI> governs whether the transaction in which the global reference appears shall use the extended M[UMPS] character set profile or the server’s character set profile for the global, ssvn or nref. The selection shall govern the characters and the collating sequence of subscripts and data values appearing in the transaction. See 4.4.
   0 selects the extended M[UMPS] character set profile. 1 selects the server’s character set profile. All other values are reserved.
   NOTE – Other strings in the transaction, for example a global name, are governed by the character translation selected during the connect transaction.
2. Environment: <LS> denotes the server’s environment for this global reference. See 4.1 and 4.7.
3. Name: <SS> The name of a gvn or an nref shall contain a leading caret, and the name of an ssvn shall contain a leading caret and dollar sign as shown in 4.1.
4. Subscript(s): <SS> 0 or more subscripts. Each shall be a short string, thus limited to 255 characters. Numeric subscripts shall appear as decimal characters, not as binary numbers or other internal representation.
   NOTE – The number of subscripts is implied by the length of the entire global reference, a long string <LS>.

Figure 7 – Form of a global reference

Copyright © Standard Documents; 1977-2024 MUMPS Development Committee;
Copyright © Examples: 1995-2024 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2024 Ed de Moel.

Some specifications are "approved for inclusion in a future standard". Note that the MUMPS Development Committee cannot guarantee that such future standards will indeed be published.

This page most recently updated on 14-Nov-2023, 21:47:40.

For comments, contact Ed de Moel (demoel@jacquardsystems.com)