STANDARD DATA DICTIONARY #8993.1 -- XULM LOCK MANAGER PARAMETERS FILE 3/24/25 PAGE 1
STORED IN ^XLM(8993.1, (1 ENTRY) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 8.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This is the parameter file for the Kernel Lock Manager. It should contain only one entry.
CROSS
REFERENCED BY: SITE NAME(B), VARIABLE NAME(C)
INDEXED BY: SYSTEM LOCK & GLOBAL LOCK? (AC)
LAST MODIFIED: NOV 8,2019@11:22:42
8993.1,.01 SITE NAME 0;1 POINTER TO INSTITUTION FILE (#4) (Required)
INPUT TRANSFORM: S:+$$SITE^VASITE X=+$$SITE^VASITE
LAST EDITED: AUG 29, 2012
HELP-PROMPT: Enter the institution name of your site.
DESCRIPTION: This identifies the site for which the parameters in this file apply to.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 8993.1^B
1)= S ^XLM(8993.1,"B",$E(X,1,30),DA)=""
2)= K ^XLM(8993.1,"B",$E(X,1,30),DA)
8993.1,1 APPLICATION STATUS 0;2 SET
'e' FOR ENABLED;
'd' FOR DISABLED;
LAST EDITED: JUL 18, 2012
HELP-PROMPT: Enter the application status.
DESCRIPTION:
This field controls whether the application can be used or not.
8993.1,3 NODES 3;0 Multiple #8993.11
DESCRIPTION: This is the list of nodes that make up the system. For example, if this is a system that runs on
two nodes, there should be two entries in this multiple.
8993.11,.01 NODES 0;1 FREE TEXT (Required) (Multiply asked)
INPUT TRANSFORM: K:$L(X)>60!($L(X)<1) X
LAST EDITED: OCT 24, 2012
HELP-PROMPT: Enter the name of a node on your system. Answer must be 1-60 characters in length.
DESCRIPTION: This field will identify a node that makes up a part of the system.
While logged onto a node, its name can be obtained by entering at the MUMPS prompt: W
##class(%SYS.System).GetInstanceName()
In the following example the node is named ISFKDASVR.
NXT>W ##class(%SYS.System).GetInstanceName() ISFKDASVR
CROSS-REFERENCE: 8993.11^B
1)= S ^XLM(8993.1,DA(1),3,"B",$E(X,1,30),DA)=""
2)= K ^XLM(8993.1,DA(1),3,"B",$E(X,1,30),DA)
8993.11,.02 TCP/IP ADDRESS 0;2 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>40!($L(X)<7) X
LAST EDITED: OCT 10, 2012
HELP-PROMPT: Enter the TCP/IP Address of the node in the format nn.nn.nn.nn.
DESCRIPTION: This is the TCP/IP address of the node. It will be used to communicate with the M-TO-M Broker
running on that node.
8993.11,.03 BROKER PORT 0;3 NUMBER (Required)
INPUT TRANSFORM: K:+X'=X!(X>65535)!(X<1)!(X?.E1"."1.N) X
LAST EDITED: OCT 14, 2012
HELP-PROMPT: Enter the port number for either the RPC Broker or the M-TO-M Broker running on this node. Either
port can be used, but the RPC Broker port is recommended.
DESCRIPTION: This is the port number that the RPC Broker or M-TO-M Broker is listening on for this node and IP
address. Either port can be used, but hte RPC broker port is recommended.
8993.11,.04 SHORT DISPLAY NAME 0;4 FREE TEXT
INPUT TRANSFORM: K:$L(X)>8!($L(X)<1) X
LAST EDITED: OCT 24, 2012
HELP-PROMPT: If the node's name is over 8 characters, you may enter a shortened name here, to be used when the
display is limited to 8 characters.
DESCRIPTION: If the node name is over 8 characters, only the last 8 characters will appear at times in the
Lock Manager display screens. If that is not acceptable, a shortened version may be entered in
this field, and it will appear in the display when a space is limited to 8 characters.
CROSS-REFERENCE: 8993.11^C
1)= S ^XLM(8993.1,DA(1),3,"C",$E(X,1,30),DA)=""
2)= K ^XLM(8993.1,DA(1),3,"C",$E(X,1,30),DA)
This is index is used to find link all nodes that make up the production system.
8993.1,4 PARAM FILE LAST EDITED 0;4 DATE
INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 13, 2012
HELP-PROMPT: The date the parameter file was last edited.
EXECUTABLE HELP: D HELP^AYILOCKH
8993.1,4.5 LAST EDITED BY 0;7 POINTER TO NEW PERSON FILE (#200)
LAST EDITED: MAR 13, 2012
HELP-PROMPT: The name of the person who last edited the file.
8993.1,5 SYSTEM LOCKS 2;0 Multiple #8993.15
LAST EDITED: JUN 13, 2012
DESCRIPTION: This multiple contains system locks that should generally be screened from view. System locks
include those for Kernel, MailMan, Cache, HL7, VDEF, and other infrastructure type applications.
IDENTIFIED BY: SYSTEM LOCK(#.02)
8993.15,.01 VARIABLE NAME 0;1 FREE TEXT (Required) (Multiply asked)
INPUT TRANSFORM: K:$L(X)>12!($L(X)<1) X
LAST EDITED: OCT 15, 2012
HELP-PROMPT: Enter the variable name of the data structure that is locked, 1-12 characters. Do not include
the '^' prefix. For example, if the lock is on ^TMP($J), enter TMP.
DESCRIPTION: This field contains the variable name of the locked data structure.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 8993.15^B
1)= S ^XLM(8993.1,DA(1),2,"B",$E(X,1,30),DA)=""
2)= K ^XLM(8993.1,DA(1),2,"B",$E(X,1,30),DA)
CROSS-REFERENCE: 8993.1^C
1)= S ^XLM(8993.1,"C",$E(X,1,60),DA(1),DA)=""
2)= K ^XLM(8993.1,"C",$E(X,1,60),DA(1),DA)
Cross-reference used to set up ignored locks in VistA Lock Manager.
8993.15,.02 SYSTEM LOCK 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>200!($L(X)<1) X
LAST EDITED: AUG 23, 2012
HELP-PROMPT: Enter the locked data structure, fully or partially, up to 240 characters, of an
infrastructure-type application that can usually be ignored by users of the Lock Manager. Do not
include '^'.
DESCRIPTION: This is a string that matches or partially matches entries in the lock table held by
infrastructure software such as the Kernel or HL7. It will be used to identify locks held by
system-oriented applications as opposed to user-oriented applications.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
RECORD INDEXES: AC (#1556) (WHOLE FILE #8993.1)
8993.15,.03 GLOBAL LOCK? 0;3 SET (Required)
'0' FOR NO;
'1' FOR YES;
LAST EDITED: JUL 18, 2012
HELP-PROMPT: Is this lock on a global?
DESCRIPTION: The .01 field is prohibited from containing a '^' in its value, so this field is necessary to
indicate whether or not the lock is on a global or local variable.
RECORD INDEXES: AC (#1556) (WHOLE FILE #8993.1)
8993.1,6 NETWORK LATENCY DELAY 0;6 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>15)!(X<0)!(X?.E1"."1N.N) X
LAST EDITED: SEP 17, 2011
HELP-PROMPT: Type a number between 0 and 15. This is the number of seconds to wait to allow all nodes to report
data back to the program which requested it.
DESCRIPTION: Some networks are slower than others and consequently some data is sent back slower than other
nodes. Because of this, some lock reports may not arrive with all others and not be indexed
correctly for display.
8993.1,7 USE ABBREVIATED MENU? 0;8 SET
'0' FOR NO;
'1' FOR YES;
LAST EDITED: APR 03, 2012
HELP-PROMPT: Enter 1 or Y to use an abbreviated menu for lock selection or 0 or N to use the full menu.
DESCRIPTION: This controlls whether the site uses an abbreviated menu of four options as opposed to the full
menu of twelve options.
8993.1,8 ABBREVIATED MENU DEFAULT # 0;9 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>3)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: APR 11, 2012
HELP-PROMPT: Enter the default selection for the abbreviated menu. If this field is left blank it will default
to 3. [Numeric, between 1 and 3].
8993.1,9 FULL MENU DEFAULT # 0;10 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>11)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: APR 11, 2012
HELP-PROMPT: Enter the default selection for the abbreviated menu. If this field is left blank, it will
default to 11. [Numeric, between 1 and 11].
FILES POINTED TO FIELDS
INSTITUTION (#4) SITE NAME (#.01)
NEW PERSON (#200) LAST EDITED BY (#4.5)
Subfile #8993.15
Record Indexes:
AC (#1556) RECORD REGULAR IR SORTING ONLY WHOLE FILE (#8993.1)
Short Descr: Used for matching entries to the lock table.
Description: This cross-reference is used to quickly find if an entry in the lock table is a system lock as opposed to an
application lock.
Set Logic: S ^XLM(8993.1,"AC",X(3),DA(1),DA)=""
Kill Logic: K ^XLM(8993.1,"AC",X(3),DA(1),DA)
Whole Kill: K ^XLM(8993.1,"AC")
X(1): SYSTEM LOCK (8993.15,.02) (Len 30) (forwards)
X(2): GLOBAL LOCK? (8993.15,.03) (forwards)
X(3): Computed Code: S X=$S(X(2):"^",1:"")_X(1)
(Subscr 1)
INPUT TEMPLATE(S):
XULM EDIT PARAMETERS OCT 24, 2012@19:49 USER #0
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):