Skip to main content

%MV.File

class %MV.File extends %Library.RegisteredObject

Property Inventory

Method Inventory

Properties

property %Account as %String;
Property methods: %AccountDisplayToLogical(), %AccountGet(), %AccountIsValid(), %AccountLogicalToDisplay(), %AccountLogicalToOdbc(), %AccountNormalize(), %AccountSet()
property %BSCAN as %String [ MultiDimensional ];
Simpler index functions such as BSCAN, expect the file variable to track the last index access. In order to allow this, we store these in an array, subscripted by index name. The top level is used to track when BSCAN walks over the global itself, instead of an index.
Property methods: %BSCANDisplayToLogical(), %BSCANGet(), %BSCANIsValid(), %BSCANLogicalToDisplay(), %BSCANLogicalToOdbc(), %BSCANNormalize(), %BSCANSet()
property %COSName as %String;
Property methods: %COSNameDisplayToLogical(), %COSNameGet(), %COSNameIsValid(), %COSNameLogicalToDisplay(), %COSNameLogicalToOdbc(), %COSNameNormalize(), %COSNameSet()
property %CasePreserveName as %String;
Case preserving form of file name
Property methods: %CasePreserveNameDisplayToLogical(), %CasePreserveNameGet(), %CasePreserveNameIsValid(), %CasePreserveNameLogicalToDisplay(), %CasePreserveNameLogicalToOdbc(), %CasePreserveNameNormalize(), %CasePreserveNameSet()
property %ClassName as %String;
Property methods: %ClassName(), %ClassNameDisplayToLogical(), %ClassNameGet(), %ClassNameIsValid(), %ClassNameLogicalToDisplay(), %ClassNameLogicalToOdbc(), %ClassNameNormalize(), %ClassNameSet()
property %ClassNamespace as %String;
Namespace for Class
Property methods: %ClassNamespaceDisplayToLogical(), %ClassNamespaceGet(), %ClassNamespaceIsValid(), %ClassNamespaceLogicalToDisplay(), %ClassNamespaceLogicalToOdbc(), %ClassNamespaceNormalize(), %ClassNamespaceSet()
property %DictFlag as %Integer [ InitialExpression = 0 ];
Property methods: %DictFlagDisplayToLogical(), %DictFlagGet(), %DictFlagIsValid(), %DictFlagLogicalToDisplay(), %DictFlagNormalize(), %DictFlagSet()
property %FileName as %String;
Property methods: %FileNameDisplayToLogical(), %FileNameGet(), %FileNameIsValid(), %FileNameLogicalToDisplay(), %FileNameLogicalToOdbc(), %FileNameNormalize(), %FileNameSet()
property %FireTriggers as %Integer [ InitialExpression = 0 ];
This boolean flag indicates that the MVFIO routines must process trigger calls when it is set to TRUE. The trigger routine itself will clear this flag to call back in to MVFIO to process the operation then set it back to TRUE when the operation is complete. This allows Pre and Post operations to exist for an MVFIO function without interfering with the indexing routine calls.
Property methods: %FireTriggersDisplayToLogical(), %FireTriggersGet(), %FireTriggersIsValid(), %FireTriggersLogicalToDisplay(), %FireTriggersNormalize(), %FireTriggersSet()
property %Global as %String;
Property methods: %GlobalDisplayToLogical(), %GlobalGet(), %GlobalIsValid(), %GlobalLogicalToDisplay(), %GlobalLogicalToOdbc(), %GlobalNormalize(), %GlobalSet()
property %IOTable as %String;
IO table used for reading or writing to the files in this directory
Property methods: %IOTableDisplayToLogical(), %IOTableGet(), %IOTableIsValid(), %IOTableLogicalToDisplay(), %IOTableLogicalToOdbc(), %IOTableNormalize(), %IOTableSet()
property %IndColl as %String;
$LIST of index collations that can be used by index functions
Property methods: %IndCollDisplayToLogical(), %IndCollGet(), %IndCollIsValid(), %IndCollLogicalToDisplay(), %IndCollLogicalToOdbc(), %IndCollNormalize(), %IndCollSet()
property %IndFlag as %Boolean [ InitialExpression = 0 ];
Flag to determine if index names/collations has been loaded yet
Property methods: %IndFlagDisplayToLogical(), %IndFlagGet(), %IndFlagIsValid(), %IndFlagLogicalToDisplay(), %IndFlagNormalize(), %IndFlagSet()
property %IndMV as %String;
String of index MV flags (0->S,1->M) that can be used by index functions
Property methods: %IndMVDisplayToLogical(), %IndMVGet(), %IndMVIsValid(), %IndMVLogicalToDisplay(), %IndMVLogicalToOdbc(), %IndMVNormalize(), %IndMVSet()
property %IndNames as %String;
$LIST of index names that can be used by index functions
Property methods: %IndNamesDisplayToLogical(), %IndNamesGet(), %IndNamesIsValid(), %IndNamesLogicalToDisplay(), %IndNamesLogicalToOdbc(), %IndNamesNormalize(), %IndNamesSet()
property %IndexCollation as %Integer [ InitialExpression = 0 ];
A select list can represent an index. An index stores the actual keys as oppposed to the key values returned by READNEXT in collated encoding sequence such as MV R or SPACE (equivlant to MV L) etc. This property defines the collation in use for the index.
Property methods: %IndexCollationDisplayToLogical(), %IndexCollationGet(), %IndexCollationIsValid(), %IndexCollationLogicalToDisplay(), %IndexCollationNormalize(), %IndexCollationSet()
property %IndexName as %String;
When the file variable is produced as a result of OPENINDEX then the index that was opened is stored here for future use by any select lists. Note that at the moment index storage is restricted to the default of ^INDEXGLOBAL("indexName",... and we may need to review this, though it is unlikely to be an issue
Property methods: %IndexNameDisplayToLogical(), %IndexNameGet(), %IndexNameIsValid(), %IndexNameLogicalToDisplay(), %IndexNameLogicalToOdbc(), %IndexNameNormalize(), %IndexNameSet()
property %IndexRoutine as %String;
Property methods: %IndexRoutineDisplayToLogical(), %IndexRoutineGet(), %IndexRoutineIsValid(), %IndexRoutineLogicalToDisplay(), %IndexRoutineLogicalToOdbc(), %IndexRoutineNormalize(), %IndexRoutineSet()
property %IndexType as %Integer [ InitialExpression = 0 ];
Property methods: %IndexTypeDisplayToLogical(), %IndexTypeGet(), %IndexTypeIsValid(), %IndexTypeLogicalToDisplay(), %IndexTypeNormalize(), %IndexTypeSet()
property %IsBinary as %Boolean [ InitialExpression = 0 ];
Property methods: %IsBinaryDisplayToLogical(), %IsBinaryGet(), %IsBinaryIsValid(), %IsBinaryLogicalToDisplay(), %IsBinaryNormalize(), %IsBinarySet()
property %IsTranslated as %Boolean [ InitialExpression = 1 ];
Property methods: %IsTranslatedDisplayToLogical(), %IsTranslatedGet(), %IsTranslatedIsValid(), %IsTranslatedLogicalToDisplay(), %IsTranslatedNormalize(), %IsTranslatedSet()
property %LockName as %String;
Property methods: %LockNameDisplayToLogical(), %LockNameGet(), %LockNameIsValid(), %LockNameLogicalToDisplay(), %LockNameLogicalToOdbc(), %LockNameNormalize(), %LockNameSet()
property %Namespace as %String;
Property methods: %NamespaceDisplayToLogical(), %NamespaceGet(), %NamespaceIsValid(), %NamespaceLogicalToDisplay(), %NamespaceLogicalToOdbc(), %NamespaceNormalize(), %NamespaceSet()
property %Options as %String;
Options (from attribute 6)
Property methods: %OptionsDisplayToLogical(), %OptionsGet(), %OptionsIsValid(), %OptionsLogicalToDisplay(), %OptionsLogicalToOdbc(), %OptionsNormalize(), %OptionsSet()
property %SectionName as %String;
Section Name when not the default data section
Property methods: %SectionNameDisplayToLogical(), %SectionNameGet(), %SectionNameIsValid(), %SectionNameLogicalToDisplay(), %SectionNameLogicalToOdbc(), %SectionNameNormalize(), %SectionNameSet()
property %StorageType as %Integer [ InitialExpression = $$$MVFIOTypeUndef ];
Property methods: %StorageTypeDisplayToLogical(), %StorageTypeGet(), %StorageTypeIsValid(), %StorageTypeLogicalToDisplay(), %StorageTypeNormalize(), %StorageTypeSet()
property %TargetAccount as %String;
Property methods: %TargetAccountDisplayToLogical(), %TargetAccountGet(), %TargetAccountIsValid(), %TargetAccountLogicalToDisplay(), %TargetAccountLogicalToOdbc(), %TargetAccountNormalize(), %TargetAccountSet()
property %TargetFileName as %String;
Property methods: %TargetFileNameDisplayToLogical(), %TargetFileNameGet(), %TargetFileNameIsValid(), %TargetFileNameLogicalToDisplay(), %TargetFileNameLogicalToOdbc(), %TargetFileNameNormalize(), %TargetFileNameSet()
property %TriggerOperations as %Integer [ InitialExpression = 0 ];
This integer flag stores a number of bits indicating which, if any MVFIO operations must operate trigger subroutines. If the bit corresponding to the operation at hand is set, and the trigger processing is not currently executing then a specific COS routine entry point will be be queued up by the MVFIO C routine and the processing function will DISP to it.
Property methods: %TriggerOperationsDisplayToLogical(), %TriggerOperationsGet(), %TriggerOperationsIsValid(), %TriggerOperationsLogicalToDisplay(), %TriggerOperationsNormalize(), %TriggerOperationsSet()
property %TriggerRoutine as %String;
Stores the name of the generated COS routine (including namespace) that must be called if this file descriptor is subject to any of the file trigger processing options described below. How this works is that when a file is opened the FireTriggers flag is set (if there are ANY triggers). When any MVFIO routine is called it checks to see if this flag is set and if it is, then it checks to see if there are triggers for this specific operation (may do this the other way around). If both tests pass then control is transferred to the named COS routine TriggerRoutine. The first thing the entry point for the particular IO function does is turn that flag off. It is then free to call the BASIC subroutines pre and post operation and call back in to the MVFIO system to do the actual operation (which will this time not fire the COS routine).
Property methods: %TriggerRoutineDisplayToLogical(), %TriggerRoutineGet(), %TriggerRoutineIsValid(), %TriggerRoutineLogicalToDisplay(), %TriggerRoutineLogicalToOdbc(), %TriggerRoutineNormalize(), %TriggerRoutineSet()

Methods

method %OnClose() as %Status
Inherited description: This callback method is invoked by the %Close() method to provide notification that the current object is being closed.

The return value of this method is ignored.

method Close() as %Status
method Dump() as %Status
method UnlockAll() as %Status

Inherited Members

Inherited Methods

FeedbackOpens in a new tab