occpOpen
occpOpen(
t_libName
t_cellName
t_viewName
t_mode [t_nameSpace [x_iterInstSupport]]
)
=> o_occpHandle / nil
Description
Opens a properties file in the specified configuration view for read or edit. When editing a properties file, include the hdbOpen call before occpOpen and close the properties file before closing the HDB handle.
Arguments
|
t_libName
|
The library name for the configuration.
|
|
t_cellName
|
The cell name for the configuration.
|
|
t_viewName
|
The view name for the configuration.
|
|
t_mode
|
Specifies one of these modes:
-
r: Opens an existing properties file for reading. -
w: Creates a new properties file and opens it for editing. If a properties file already exists, it is opened with previous content discarded. -
a: Opens an existing properties file for editing. If it does not exist, creates a new file and opens it for editing.
|
|
t_nameSpace
|
The name space to use for library, cell, view, and instance names when using the occurrence properties SKILL interface. If it is not specified, the CDBA name space is used.
|
|
x_iterInstSupport
|
Indicates if the application supports iterated instance properties. The default value of 0 indicates that the application does not support iterated instances.
|
Value Returned
|
o_occpHandle
|
The handle for the opened properties file.
|
|
nil
|
The properties file was not opened or does not exist.
|
Example
unless( MyOccpHandle = occpOpen("lib1" "cell1" "cfgView1" "r" "CDBA")
printf("Could not open properties file (readOnly)\n"))
Related Topics
Hierarchy Database Functions
Occurrence Property Functions
Parent/Child Database Functions
Return to top
