op_apptrack_create()
Abstract
Initializes the state for application delay tracking and creates necessary files.
Syntax
op_apptrack_create (dir_path_name, base_file_name)
| Argument | Type | Description |
|---|---|---|
dir_path_name |
const char * |
Path for storing ADT files (see Details). |
base_file_name |
const char * |
Base name for ADT files. |
Return Type
Apptrackhandle
Global application delay tracking state, or OPC_NIL if an error occurs.
Details
There can be only one application delay tracking state during a simulation. If the state has been initialized by a prior call to this KP, subsequent calls return the existing handle.
For efficient operation, dir_path_name should point to an unfragmented area of disk.
Generally, base_file_name should be the project-scenario name, but can be customized if desired.
Purpose
This KP initializes the state for application delay tracking. It also specifies the path and base name for the ADT files, opens the raw files, and writes out the object ID file.
Errors
- Recoverable Error: Argument (
dir_path_name) is NIL. - Recoverable Error: Argument (
base_file_name) is NIL. - Recoverable Error: Directory path name (
<dir_path_name>) is not a directory.
Reference
- Use the KP op_apptrack_destroy() to destroy the application delay tracking state when it is no longer needed.