%SYS.Namespace
abstract persistent class %SYS.Namespace extends %Library.Persistent
SQL Table Name: %SYS.Namespace
Method Inventory
Methods
Return information about a namespaces default global and routine database
On Input:
Namespace - Namespace to obtain information about. Can be either a real namespace
or an implied namespace
DontConnect - If the namespace's default database is a remote database mounted across ECP,
then if set to 1, and the remote database is not mounted, we will not try to mount it (default = 0).
Returns an array of information about the default global and routine databases. Info("GlobalDB","System") - name of system default global directory resides on. Info("GlobalDB","Directory") - Name of default global directory. Info("GlobalDB","Resource") - Name of resource attached to the directory. Info("GlobalDB","ReadOnly") - 0/1 is the database mounted read only. Info("GlobalDB","Mounted") - 0/1 is the database mounted. Info("GlobalDB","Status") - 1 = Success, %Status if any kind of error. Info("RoutineDB","System") - name of system default routine directory resides on. Info("RoutineDB","Directory") - Name of default routine directory. Info("RoutineDB","Resource") - Name of resource attached to the directory. Info("RoutineDB","ReadOnly") - 0/1 is the database mounted read only. Info("RoutineDB","Mounted") - 0/1 is the database mounted. Info("RoutineDB","Status") - 1 = Success, %Status if any kind of error.
Returns an array of information about the default global and routine databases. Info("GlobalDB","System") - name of system default global directory resides on. Info("GlobalDB","Directory") - Name of default global directory. Info("GlobalDB","Resource") - Name of resource attached to the directory. Info("GlobalDB","ReadOnly") - 0/1 is the database mounted read only. Info("GlobalDB","Mounted") - 0/1 is the database mounted. Info("GlobalDB","Status") - 1 = Success, %Status if any kind of error. Info("RoutineDB","System") - name of system default routine directory resides on. Info("RoutineDB","Directory") - Name of default routine directory. Info("RoutineDB","Resource") - Name of resource attached to the directory. Info("RoutineDB","ReadOnly") - 0/1 is the database mounted read only. Info("RoutineDB","Mounted") - 0/1 is the database mounted. Info("RoutineDB","Status") - 1 = Success, %Status if any kind of error.
classmethod GetGlobalDest(Namespace As %String = $namespace, Global As %String = "^", Subscript As %String = "") as %String
Returns the system^directory where ^[Namespace]Global(Subscript) is mapped to.
If Subscript is missing, it returns the location for ^[Namespace]Global.
If Global is missing, it returns the default global location for Namespace.
This API support multi-level subscripts mapping, for example, pass "abc",1,2 in Subscript will check the destination of Global("abc",1,2).
If the system is the same as the local system, then system is set to "".
This API support multi-level subscripts mapping, for example, pass "abc",1,2 in Subscript will check the destination of Global("abc",1,2).
If the system is the same as the local system, then system is set to "".
Return information about a namespaces default global database.
Parameters:
Namespace - Namespace to obtain information about. Can be either a real namespace or an implied namespace. Real namespace must be in uppercase.
DontConnect - If the namespace's default database is a remote database mounted across ECP, then if set to 1, and the remote database is not mounted, we will not try to mount it (default = 0).
Return Values:
Returns an array of information about the default global database.
Info("System") - name of system default global directory resides on.
Info("Directory") - Name of default global directory.
Info("Resource") - Name of resource attached to the directory.
Info("ReadOnly") - 0/1 is the database mounted read only.
Info("Mounted") - 0/1 is the database mounted.
Info("Status") - 1 = Success, %Status if any kind of error.
This also returns a second level of subscript with the same values, but subscripted by "GlobalDB" and "RoutineDB". This allows us to return info about the default Routine database for the namespace e.g.
Info("GlobalDB","System")
Info("RoutineDB","System")
If an implied namespace is passed in, ^SERVER^DIR, and the SERVER is the local system, then the database is treated as a local database, and Info("System") will be returned as "".
Parameters:
Namespace - Namespace to obtain information about. Can be either a real namespace or an implied namespace. Real namespace must be in uppercase.
DontConnect - If the namespace's default database is a remote database mounted across ECP, then if set to 1, and the remote database is not mounted, we will not try to mount it (default = 0).
Return Values:
Returns an array of information about the default global database.
Info("System") - name of system default global directory resides on.
Info("Directory") - Name of default global directory.
Info("Resource") - Name of resource attached to the directory.
Info("ReadOnly") - 0/1 is the database mounted read only.
Info("Mounted") - 0/1 is the database mounted.
Info("Status") - 1 = Success, %Status if any kind of error.
This also returns a second level of subscript with the same values, but subscripted by "GlobalDB" and "RoutineDB". This allows us to return info about the default Routine database for the namespace e.g.
Info("GlobalDB","System")
Info("RoutineDB","System")
If an implied namespace is passed in, ^SERVER^DIR, and the SERVER is the local system, then the database is treated as a local database, and Info("System") will be returned as "".
Returns the system^directory where Package is mapped to in this Namespace.
If Package is missing, it returns the default package location for Namespace.
If the system is the same as the local system, then system is set to "".
classmethod GetRoutineDest(Namespace As %String = $namespace, Routine As %String = "", Type As %String = "INT") as %String
Returns the system^directory where Routine is mapped to in this Namespace.
If Routine is missing, it returns the default routine location for Namespace.
The allowed types are: INC, INT, MAC and OBJ.
If the system is the same as the local system, then system is set to "".
The ListAll method quickly returns a list of all the
namespaces in the current process.
The parameter array is a local array
name passed by reference. On return from ListAll, the subscripts
of the array parameter will be the namespace names of
the current process. Each subscripted entry in array
will contain the empty string.
When ConvertImplicit is true, it will convert the '@' in implicit namespace to '^'.
The default value of ConvertImplicit is true when it is not specified.
Each explicit namespace is returned using the local namespace name as the subscript string. Each implicit namespace is returned using a subscript string that contains a caret ^, followed by the system name, followed by another caret ^, followed by the name of directory containing the database file. If the implicit namespace is local then the system name is the empty string and the subscript string starts with two adjacent carets ^^.
Queries
Returns a list of namespaces defined on the system.
Parameters:
Remote - 0/1 whether to return any remotely mapped namespaces or not.
DontConnect - 0/1 whether to connect to remote system or not if a connection has not been made yet.
Return values:
Status - (0/1) Whether the namespace is available or not.
If the Status returned is 1, the default global database for the namespace is either mounted, or not mounted yet. If 0, then the database has been dismounted.
Remote - (0/1) Whether the namespace is mapped to a remote ECP system.
Parameters:
Remote - 0/1 whether to return any remotely mapped namespaces or not.
DontConnect - 0/1 whether to connect to remote system or not if a connection has not been made yet.
Return values:
Status - (0/1) Whether the namespace is available or not.
If the Status returned is 1, the default global database for the namespace is either mounted, or not mounted yet. If 0, then the database has been dismounted.
Remote - (0/1) Whether the namespace is mapped to a remote ECP system.
Indexes
index (IDKEY on ) [IdKey, Type = key];
Index methods: IDKEYCheck(), IDKEYDelete(), IDKEYExists(), IDKEYOpen(), IDKEYSQLCheckUnique(), IDKEYSQLExists(), IDKEYSQLFindPKeyByConstraint(), IDKEYSQLFindRowIDByConstraint()
Inherited Members
Inherited Methods
- %%CLASSNAMELogicalToStorage()
- %%CLASSNAMEStorageToLogical()
- %AddToSaveSet()
- %AddToSyncSet()
- %BMEBuilt()
- %BuildIndicesAsync()
- %BuildIndicesAsyncResponse()
- %CheckConstraints()
- %CheckConstraintsForExtent()
- %ClassIsLatestVersion()
- %ClassName()
- %ComposeOid()
- %ConstructClone()
- %Delete()
- %DeleteExtent()
- %DeleteId()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Exists()
- %ExistsId()
- %Extends()
- %GUID()
- %GUIDSet()
- %GetLock()
- %GetParameter()
- %GetSwizzleObject()
- %Id()
- %InsertBatch()
- %IsA()
- %IsModified()
- %IsNull()
- %KillExtent()
- %KillExtentData()
- %LoadFromMemory()
- %LockExtent()
- %LockId()
- %New()
- %NormalizeObject()
- %ObjectIsNull()
- %ObjectModified()
- %Oid()
- %OnBeforeAddToSync()
- %OnDeleteFinally()
- %OnDetermineClass()
- %OnOpenFinally()
- %OnSaveFinally()
- %Open()
- %OpenId()
- %OriginalNamespace()
- %PackageName()
- %PhysicalAddress()
- %PurgeIndices()
- %Reload()
- %RemoveFromSaveSet()
- %ResolveConcurrencyConflict()
- %RollBack()
- %Save()
- %SaveDirect()
- %SaveIndices()
- %SerializeObject()
- %SetModified()
- %SortBegin()
- %SortEnd()
- %SyncObjectIn()
- %SyncTransport()
- %UnlockExtent()
- %UnlockId()
- %ValidateIndices()
- %ValidateObject()
- %ValidateTable()
Storage
Storage Model: Storage (%SYS.Namespace)
^SYS.NamespaceD(ID) |
= | %%CLASSNAME
|