The class <class>SYSTEM.MV</class> provides access to MV system level functions and elements for COS and MVBASIC programmers. More...

Inheritance diagram for MV:

[legend]

Collaboration diagram for MV:

[legend]

Static Public Member Functions
_.Library.String	ConvAnalyze (_.Library.String code)
	The class <class>SYSTEM.MV</class> provides access to MV system level functions and elements for COS and MVBASIC programmers. More...

_.Library.Boolean	InputDataOnly (_.Library.Boolean DataOnlyFlag)
	This method sets or clears a flag that controls whether INPUT commands. More...

_.Library.String	IteratorGet (_.Library.Integer attrNo)
	The method gets contents of the specified attribute, current value, current subvalue from @Record. More...

	IteratorInit ()
	The Initializer for iterating through values and subvalues in conjunction with A and F correlatives. More...

_.Library.Boolean	IteratorTest ()
	The method tests to see if there are more values to process as indicated by. More...

_.Library.String	StackGetCOS ()
	Get the COS shell recall stack.

_.Library.String	StackGetMV ()
	Get the MV shell recall stack.

_.Library.Boolean	StackSetCOS (_.Library.String arg)
	Set the passed string as the COS shell recall stack.

_.Library.Boolean	StackSetMV (_.Library.String arg)
	Set the passed string as the MV shell recall stack.

_.Library.Integer	TCL2Next ()
	Call this method to get the next Item ID from the TCL II processed command line. More...

	buildMVClassXref (_.Library.ObjectHandle classDef, _.Collection.AbstractArray ClassXref)
	Build a cross reference of a MV class for maintenence purposes.

_.Library.String	camelCaseName (_.Library.String input)
	Given an MV identifier name of some sort in input, such as a file name. More...

	createMVProperty (pname, pord, _.Library.ObjectHandle classDef, _.Collection.AbstractArray ClassXref)
	Method designed for use in PROTOCLASS to generate a property defined by the MV DICT item. More...

	decomposeStatus (_.Library.Integer sc)
	If an error occurred in a call to an object or class, you can. More...

	deleteMVProperty (pname, _.Library.ObjectHandle classDef, _.Collection.AbstractArray ClassXref)
	Method designed for use in PROTOCLASS to delete a property and maintain the cross reference.

_.Library.String	fileDescClassName (_.MV.File fdsc)
	Given an open file descriptor in fdsc, this method will suggest a valid name for a. More...

_.Library.String	fileDescDataGlobal (_.MV.File fdsc)
	Given an open file descriptor, this method will return the fully qualified. More...

	generateItypeMethods (_.Library.ObjectHandle classDef)
	This method will search a class for properties that are defined as itypes and. More...

_.Library.ObjectHandle	getPrimaryMVClass (_.MV.File fdsc, _.Library.Boolean createFlg, _.Library.String NewName)
	Given an open file descriptor, this method will return the class. More...

_.Library.String	newUniqueGlobal (_.Library.String prefix)
	Supplies the next available unique global name using the same. More...

	parseDict (_.MV.File dict, _.Library.String record, _.Library.String name)
	Parses the supplied DICT entry record as element name More...

_.Library.Status	setPortNumber (_.Library.Integer portNo)
	Given a port number supplied by the caller, this function will set the. More...

_.Library.String	validCacheName (_.Library.String input)
	Given an MV identifier name of some sort in input, such as a file name. More...

Static Public Member Functions inherited from Help
_.Library.String	Help (_.Library.String method)
	This is a helper class that is used by the various SYSTEM classes to provide a Help method. More...

Detailed Description

The class <class>SYSTEM.MV</class> provides access to MV system level functions and elements for COS and MVBASIC programmers.

This class should always be used in preference to direct access to the internals of the MV implementation, as it is guranteed to be in sync with any underlying structural changes.

NEVER try to access MV elements at their base system level as upward compatiblity is not guranteed and this can in fact be dangerous.

COS language methods and programs should access this class using the special $System object:

Set cosName = $System.MV.validCacheName("MVFILE.$TRANGEN4M3")

MVBASIC programmers should access this class using the "%SYSTEM.MV" method:

cosName = "%SYSTEM.MV"->validCacheName("MVFILE.$TRANGEN4M3")

Member Function Documentation

◆ ConvAnalyze()

_.Library.String ConvAnalyze ( _.Library.String code )

static

The class <class>SYSTEM.MV</class> provides access to MV system level functions and elements for COS and MVBASIC programmers.

This class should always be used in preference to direct access to the internals of the MV implementation, as it is guranteed to be in sync with any underlying structural changes.

NEVER try to access MV elements at their base system level as upward compatiblity is not guranteed and this can in fact be dangerous.

COS language methods and programs should access this class using the special $System object:

Set cosName = $System.MV.validCacheName("MVFILE.$TRANGEN4M3")

MVBASIC programmers should access this class using the "%SYSTEM.MV" method:

cosName = "%SYSTEM.MV"->validCacheName("MVFILE.$TRANGEN4M3")

The method passes a string to the conversion code compiler, checks for errors and returns a string of information.

The returned string is a series of comma separated numbers:

Status code:
Negative value is a negated errmsg number.
Positive value is data type of result.
0 Unknown
1 String
2 Integer
3 Numeric
4 Boolean
Bit values that show the types of computational codes found.
1 Contains an A correlative
2 Contains an F correlative
4 Contains a Concatenate Correlative
8 Contains a Substitute Correlative
16 Contains a Call or B; Correlative invoked for each value
32 Contains a Call or B: Correlative invoked once for an attribute

3+. If present, shows attributes referenced in the conversion code.

◆ InputDataOnly()

_.Library.Boolean InputDataOnly ( _.Library.Boolean DataOnlyFlag )

static

This method sets or clears a flag that controls whether INPUT commands.

will read only stacked DATA or will also read from the input device. The argument is a boolean value 0 or 1. If DataOnlyFlag is 1, only stacked DATA will be available to INPUT commands. An attempt to read beyond the stacked DATA will result in an ABORT. If DataOnlyFlag is 0, the Data Only flag is cleared and INPUT commands will return to the default state of reading both stacked DATA and directly from the input device.
The return value is the previous state of the flag. If no argument is given, the current state of the flag is returned without changing it.

◆ IteratorGet()

_.Library.String IteratorGet ( _.Library.Integer attrNo )

static

The method gets contents of the specified attribute, current value, current subvalue from @Record.

Use to Iterate through all the (sub)values in conjunction with A or F correlatives. If the specific attr,val,subval does not exist then the funtion will return an empty string.

◆ IteratorInit()

IteratorInit ( )

static

The Initializer for iterating through values and subvalues in conjunction with A and F correlatives.

This clears the moreValues and moreSubValues flags and sets the current value and current subvalue counters to 1.

◆ IteratorTest()

_.Library.Boolean IteratorTest ( )

static

The method tests to see if there are more values to process as indicated by.

the moreValues and moreSubValues flags and sets the current value and current subvalue counters accordingly. These flags and counters are used by the Conversion Processor to handle multi-values in A and F correlatives.

◆ TCL2Next()

_.Library.Integer TCL2Next ( )

static

Call this method to get the next Item ID from the TCL II processed command line.

Note that you can enable TCL II (list, vs *, vs itemidlist) processing for an MVBASIC cataloged program by editing the CATALOG pointer for the program and adding '2' to Attribute 5:

MYNEWVERB 0001 V 0002 MVB.3�SYS 0003 B 0004 0005 2 0006 0007 L 0008 MYNEWVERB 0009 BP 0010 SYSPROG

You can additionaly add the the following letters to attribute 5:
'C' - will cause the item body to be copied into @RECORD.
'N' - will allow new items and not check for an item's existence.
'D' - will force an open of the DICT rather than DATA section.

Returns:
1 - Success. The next Item Id has been placed in @ID and optionally the body has been copied into @RECORD
0 - End of Items or failure.

◆ camelCaseName()

_.Library.String camelCaseName ( _.Library.String input )

static

Given an MV identifier name of some sort in input, such as a file name.

this method will return a name that is valid as a class or property name using Camel Case.

◆ createMVProperty()

createMVProperty	(		pname,
			pord,
		_.Library.ObjectHandle	classDef,
		_.Collection.AbstractArray	ClassXref
	)

static

Method designed for use in PROTOCLASS to generate a property defined by the MV DICT item.

that has been parsed and stored in dictionary(pord)

◆ decomposeStatus()

decomposeStatus ( _.Library.Integer sc )

static

If an error occurred in a call to an object or class, you can.

call this method and it will PRINT the error messages to the terminal.

◆ fileDescClassName()

_.Library.String fileDescClassName ( _.MV.File fdsc )

static

Given an open file descriptor in fdsc, this method will suggest a valid name for a.

class or other ObjectScript identifier that can be used to name it outside the MV environment.

◆ fileDescDataGlobal()

_.Library.String fileDescDataGlobal ( _.MV.File fdsc )

static

Given an open file descriptor, this method will return the fully qualified.

name of the global that stores the data.

Fully qualified means that it includes the NAMESPACE (account) within it such as ^|"TESTACCOUNT"|JIM.DATA

◆ generateItypeMethods()

generateItypeMethods ( _.Library.ObjectHandle classDef )

static

This method will search a class for properties that are defined as itypes and.

add implementations of the calc and calcsql metods for those itypes to the class

◆ getPrimaryMVClass()

_.Library.ObjectHandle getPrimaryMVClass	(	_.MV.File	fdsc,
		_.Library.Boolean	createFlg,
		_.Library.String	NewName
	)

static

Given an open file descriptor, this method will return the class.

associated with that file.
If createFlg is set then the class will be created if it doesn't exist.
If NewName is specified then that name willl be used to create the class.

◆ newUniqueGlobal()

_.Library.String newUniqueGlobal ( _.Library.String prefix )

static

Supplies the next available unique global name using the same.

mechanisms as CREATE-FILE. Calling this will reserve a global name for you that is guranteed to be exclusive for your use. Note that the name returned does not include any namespace information and is unique across namespaces too. It is up to you to decide where (namespace wise) the global will exist.

◆ parseDict()

parseDict	(	_.MV.File	dict,
		_.Library.String	record,
		_.Library.String	name
	)

static

Parses the supplied DICT entry record as element name

into the public variable dictionary using the open dict file variable if it needs to reference other elements in the DICT.

If the method returns 0, then you can just exit your program and the MV shell will display any ERRMSG that has occurred.

Returns:	nnn	- Ordinal entry number in dictionary
	0	- Could not open DICTionary or other error

◆ setPortNumber()

_.Library.Status setPortNumber ( _.Library.Integer portNo )

static

Given a port number supplied by the caller, this function will set the.

current port number for this process. Should be called early on in the start up of the process for predictability, but can be called any time in practice.

◆ validCacheName()

_.Library.String validCacheName ( _.Library.String input )

static

Given an MV identifier name of some sort in input, such as a file name.

this method will return a name that is valid as a class or property name.

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ ConvAnalyze()

◆ InputDataOnly()

◆ IteratorGet()

◆ IteratorInit()

◆ IteratorTest()

◆ TCL2Next()

◆ camelCaseName()

◆ createMVProperty()

◆ decomposeStatus()

◆ fileDescClassName()

◆ fileDescDataGlobal()

◆ generateItypeMethods()

◆ getPrimaryMVClass()

◆ newUniqueGlobal()

◆ parseDict()

◆ setPortNumber()

◆ validCacheName()