HP 3000 Manuals HP 3000 Manuals
SDSetControl
Sets the dictionary control functions.
Syntax
SDSetControl (Dcb,ItemNumber,ItemValue,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
ItemNumber Required input by value; type = 4 byte Integer
This parameter specifies the cardinal number of
the desired control item. The table below
lists the current selectable items, their
possible values (see parameter ItemValue) and
the results of each setting.
ItemValue Required input; type = ItemValueType This
parameter specifies the setting for item
specified in the ItemNumber parameter. The
type actually depends upon the data type of
ItemNumber.
-----------------------------------------------------------------------------------------------------
| | | | | |
| Item Number | Item | Data Type | Item Value | Result |
| | | | | |
-----------------------------------------------------------------------------------------------------
| | | | | |
| 1 | LoggingFlag | One byte Boolean | True | Transaction |
| | | | | logging ON |
| | | | | |
-----------------------------------------------------------------------------------------------------
| | | | | |
| | | | False | Transaction |
| | | | | logging OFF |
| | | | | |
-----------------------------------------------------------------------------------------------------
| | | | | |
| 2 | Compatibility | One byte Boolean | True | Compatibility |
| | Mode data format | | | mode format |
| | | | | |
-----------------------------------------------------------------------------------------------------
| | | | | |
| | | | False | Native mode |
| | | | | format |
| | | | | |
-----------------------------------------------------------------------------------------------------
Status Output; type = StatusType
This parameter contains information indicating
the success or failure of the intrinsic call.
This information is detailed in Table Table
3-1, located in Chapter 3 of this manual.
Discussion
The following discussion describes the items which correspond to the
values of the parameter ItemNumber, and results of the possible values
for the parameter ItemValue which may be entered for each item.
LoggingFlag
When the value of the ItemNumber parameter is 1, the ItemValue parameter
will set the status of the LoggingFlag.
* When ItemValue is set to True (LoggingFlag set to 'ON') this
intrinsic adds extra information to the TurboIMAGE transaction log if
TurboIMAGE Transaction Logging is enabled. Note, however, that if
TurboIMAGE Transaction Logging is not enabled, turning System
Dictionary logging on via this intrinsic has no effect.
Note that the status of TurboIMAGE Transaction Logging cannot be
checked or changed from within System Dictionary. You must run the
TurboIMAGE utility DBUTIL to access that function.
* When ItemValue is set to False (LoggingFlag set to 'OFF') no System
Dictionary transaction information will be added to the TurboIMAGE
transaction log.
* When a dictionary is first created, LoggingFlag is set to False.
* The setting of this flag affects all users of the dictionary. It
remains as is (either True or False), even when closing and reopening
the dictionary, until changed by another call to this intrinsic.
When the value for ItemNumber is 1, the following restrictions apply when
using this intrinsic:
Compatibility Mode Data
1. Open mode--The dictionary must be opened in Exclusive Update mode.
2. Security--The current scope must be the Dictionary Administrator
scope.
When the value of the ItemNumber parameter is 2, the ItemValue parameter
will set the type of data format used with attributes. Refer to Appendix
C of this manual for information on attribute data formats. Note that
this intrinsic does not switch the operating mode of System Dictionary.
* When ItemValue is set to True (Compatibility mode format selected)
attribute data will be processed in the Compatibility Mode format.
This means that data will be input and output in HP3000 floating
point format, and that alignment of attribute values will conform to
Compatibility Mode alignment rules.
* When ItemValue is set to False (Native Mode format selected)
attribute data will be processed in the Native Mode format. This
means that data will be input and output in HP3000 Series 900
floating point format (IEEE standard) and that alignment of attribute
values will conform to Native Mode alignment rules. Note that this
is the default setting, and unless this intrinsic is accessed to
change this value, attribute data will be processed in Native Mode
format.
* The setting of this flag affects only the calling program and remains
active only during the current execution of the program. However, it
may be changed multiple times during the same execution of the
program.
When the value for ItemNumber is 2, the following restrictions apply when
using this intrinsic:
1. Open mode--The dictionary can be opened in any mode.
2. Security--This intrinsic will succeed with any current scope.