BASEstar CIMfast User's Guide

*HyperReader

CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Overview of BASEstar CIMfast
    1.1 What Is BASEstar CIMfast?
    1.2 CIMfast Event Language
      1.2.1      CEL Features
    1.3 Standalone BCF
    1.4 Callable BCF
      1.4.1      Application Interaction with Callable BCF

  2      Using the CIMfast Event Language
    2.1 Syntax Rules
    2.2 General Format
    2.3 CEL Internal Point Definition
    2.4 Use of Quotation Marks Within CEL
      2.4.1      Correct Syntax Example
      2.4.2      Incorrect Syntax Examples
    2.5 Case Sensitivity in CEL
    2.6 CEL Comments
    2.7 Using the CEL Preprocessor
      2.7.1      The #include Statement
      2.7.2      The #define Statement
      2.7.3      Using the Preprocessor to Define Macros
    2.8 Qualifying Events with State Information
      2.8.1      Important Notes Regarding Event Execution
    2.9 CEL Parsing Errors

  3      Using CEL Expressions
    3.1 What Are CEL Expressions?
    3.2 Types of CEL Expression Operators
    3.3 CEL Expression Format
    3.4 Using CEL Expressions for Event Qualification
    3.5 Using CEL Expressions as Action Parameters
    3.6 Using the EVALUATE Action to Compute an Expression
      3.6.1      IF-THEN-ELSE Constructions
      3.6.2      Looping Constructions

  4      BASEstar Classic CIMfast Command Line
    4.1 Setup Command Procedure
    4.2 Command Line Syntax
    4.3 Online Help
    4.4 DCL Command Line

  5      BASEstar Open CIMfast for OSF/1 AXP Command Line
    5.1 Setup Procedure
    5.2 Command Line Syntax
    5.3 Online Help
    5.4 Command Line

  6      Debugging BASEstar CIMfast Applications
    6.1 Using CEL Listing Files
    6.2 Tracing Event and Action Execution

  7      Using BASEstar CIMfast Data Files
    7.1 Using Data Files
    7.2 Opening and Closing Files
    7.3 Writing to Files
    7.4 Reading from Files
    7.5 Using BASEstar CIMfast to Write/Read an Unformatted Binary File
    7.6 Using BASEstar CIMfast to Write/Read an ASCII File

  8      Using CIMfast with BASEstar
    8.1 Using BASEstar Messaging
      8.1.1      BASEstar Message Ports
      8.1.2      Sending/Replying to BASEstar Messages
      8.1.3      BCF Formatted Message Expressions
      8.1.4      Events Caused by BASEstar Message Receipt
      8.1.5      Expression Operators for MSG_EVENT Events
    8.2 Using BASEstar Data Services
      8.2.1      Scoping of Data Points
      8.2.2      Event Classification for BASEstar Data Points
      8.2.3      Setting the Values of Data Points
      8.2.4      Events Caused by BASEstar Data Points
      8.2.5      Expression Operators for PT_EVENT Events
    8.3 Using BASEstar Synchronization Services
      8.3.1      Events Caused by BASEstar Synchronization Services
      8.3.2      Expression Operators Used with SYNC_ xxx _EVENT Events

  9      Using LSE to Create CEL Files
    9.1 Invoking LSE
    9.2 Creating CEL Files

  10     BASEstar Classic CIMfast Configuration
    10.1 Ctrl/Y and Ctrl/C Interrupt Handling
    10.2 Logicals
    10.3 File Locations

  11     BASEstar Open CIMfast for OSF/1 AXP Configuration
    11.1 BASEstar CIMfast Environment Variables
    11.2 BASEstar CIMfast File Locations
    11.3 Required BASEstar Open Servers

  12     BASEstar CIMfast Performance Considerations
    12.1 Performance Enhancement Tips
    12.2 Event Execution
    12.3 Action Execution
    12.4 Performance Tuning with Scope and Event Classification
    12.5 Reducing the Time to Load CEL Files
    12.6 Resource Usage

  13     CEL Quick Reference
    13.1 CEL Events
    13.2 CEL Actions
    13.3 CEL Expressions
    13.4 BASEstar Classic CIMfast Events
    13.5 BASEstar Classic CIMfast Actions
    13.6 BASEstar Classic CIMfast Expressions
    13.7 BASEstar Open CIMfast for OSF/1 AXP Events
    13.8 BASEstar Open CIMfast for OSF/1 AXP Actions
    13.9 BASEstar Open CIMfast for OSF/1 AXP Expressions

  14     CEL Event Reference

  EXIT_EVENT

  INIT_EVENT

  PT_EVENT

  TIMEOUT_EVENT

  <User-defined-Event-name>

  15     CEL Action Reference

  ABORT_ACTIONS

  ABORT_CE

  ABORT_EVENTS

  CALLBACK

  ENV_INIT

  ERROR_EVENT_SET

  EVALUATE

  EVENT_LOG

  EXECUTE

  EXIT

  FILE_CLOSE

  FILE_OPEN_APPEND

  FILE_OPEN_READ

  FILE_OPEN_READ_WRITE

  FILE_OPEN_WRITE

  FILE_WRITE

  INPUT

  NMS_PUT

  NMS_REMOVE

  NOOP

  PRINT

  PT_EVENTS_DISABLE

  PT_EVENTS_ENABLE

  PT_SCOPE_EXTERN

  PT_SCOPE_INTERN

  PT_SET

  PT_SET_EXTERN

  PT_SET_INTERN

  PT_VALUE_GET_EXTERN

  REEX_ACTION

  REEX_EVENT

  SET_OUTPUT_FILTER

  SPAWN

  SPAWN_NOWAIT

  TIMER_CANCEL

  TIMER_START

  WAIT

  16     CEL Expression Operator Reference

  ABS

  ADD

  AND

  BIT_AND

  BIT_OR

  BIT_TEST

  BOOLEAN

  BUFFER

  BUFFER_CREATE

  BUFFER_EXTRACT

  BYTE

  CEIL

  COS

  CUR_EVENT_P1 . . . CUR_EVENT_P10

  CUR_EVENT_PAR

  CUR_EVENT_PAR_COUNT

  CUR_PT_ELEMENTS

  CUR_PT_FIELD_NAME

  CUR_PT_FORMAT

  CUR_PT_FORMAT_STR

  CUR_PT_LENGTH

  CUR_PT_NAME

  CUR_PT_SIZE

  CUR_PT_STATUS

  CUR_PT_UPDATE_TIME

  CUR_PT_VALUE

  CUR_TMR_NAME

  DEC

  DIV

  D_FLOAT

  ELEMENTS

  ENV

  EQU

  EQUW

  EXP

  FILE_EOF

  FILE_READ

  FLOOR

  FM_BUFFER_CREATE

  FM_ITEM_GET

  FORMAT

  FORMAT_STR

  F_FLOAT

  GT

  GTE

  INC

  INPUT

  LAST_ACTION_DESCR

  LAST_ACTION_STATUS

  LAST_ACTION_TEXT

  LENGTH

  LN

  LOG

  LONG

  LT

  LTE

  MAX

  MIN

  MOD

  MUL

  NEQ

  NEQW

  NMS_GET

  NMS_LOOKUP

  NMS_REMOVE

  NOT

  OR

  POW

  PT_NAME_LIST

  PT_SIZE

  PT_STATUS

  PT_VALUE_GET

  PT_VALUE_GET_INTERN

  RAND

  SIN

  SQRT

  STAT_AVG

  STRING

  STR_CONCAT

  STR_FORMAT

  STR_INDEX

  STR_LENGTH

  STR_SUBSTR

  SUB

  TAN

  TIME_BIN

  TIME_STR

  WORD

  17     BASEstar Classic CIMfast CEL Event Reference

  MSG_EVENT

  PT_DELETE_EVENT

  SYNC_BAR_EVENT

  SYNC_BAR_TIMEOUT_EVENT

  SYNC_EVN_EVENT

  SYNC_EVN_TIMEOUT_EVENT

  SYNC_SEM_EVENT

  SYNC_SEM_TIMEOUT_EVENT

  18     BASEstar Classic CIMfast CEL Action Reference

  BSTAR_CLI

  CIRCUIT_CONNECT

  CIRCUIT_DISCONNECT

  EXPORT_DATA

  HISTORY_PUT

  MSG_PORT_CLOSE

  MSG_PORT_OPEN

  MSG_PRINT_FLOAT

  MSG_PRINT_INT

  MSG_PRINT_STR

  MSG_REPLY

  MSG_SEND

  STATUS_GET

  STATUS_PUT

  STATUS_REMOVE

  SYNC_BAR_ADJUST_QUORUM

  SYNC_BAR_CREATE

  SYNC_ELEMENT_DELETE

  SYNC_ELEMENT_PRINT

  SYNC_EVENTS_OFF

  SYNC_EVENTS_ON

  SYNC_EVENTS_WAIT

  SYNC_EVN_ADD_TO_LIST

  SYNC_EVN_CREATE

  SYNC_EVN_REM_FROM_LIST

  SYNC_EVN_TRIGGER

  SYNC_SEM_CREATE

  SYNC_SEM_RELEASE

  19     BASEstar Classic CIMfast CEL Expression Operator Reference

  CUR_EVL_MSG_CLASS

  CUR_EVL_MSG_SUBTYPE

  CUR_EVL_MSG_TEXT

  CUR_EVL_MSG_TIME_STR

  CUR_EVL_MSG_TYPE

  CUR_MSG_BUFFER

  CUR_MSG_CODE

  CUR_MSG_LENGTH

  CUR_MSG_PORT_ID

  CUR_MSG_PORT_NAME

  CUR_MSG_SRC_PORT_ID

  CUR_STATUS_COMPONENT

  CUR_STATUS_MODE

  CUR_STATUS_MODE_TEXT

  CUR_STATUS_VERSION

  CUR_SYNC_ELEMENT_COUNT

  CUR_SYNC_ELEMENT_ID

  CUR_SYNC_ELEMENT_NAME

  CUR_SYNC_ELEMENT_VALUE

  PT_INFO

  SYNC_ELEMENT_COUNT

  SYNC_ELEMENT_ID

  SYNC_ELEMENT_VALUE

  20     BASEstar Open CIMfast for OSF/1 AXP CEL Event Reference

  ACTIVITY_EXECUTE_EVENT

  ACTIVITY_RESUME_EVENT

  ACTIVITY_TERMINATE_EVENT

  BSTR_EVENT

  21     BASEstar Open CIMfast for OSF/1 AXP CEL Action Reference

  ACTIVITY_BEGIN

  ACTIVITY_BREAK

  ACTIVITY_END

  AMS_ENABLE

  CONTEXT_SET_DEFAULT

  DATABASE_SET_SCOPE

  EVENT_CREATE

  EVENT_DECLARE

  EVENT_DISABLE

  EVENT_ENABLE

  FILTER_CREATE

  PT_CREATE

  PT_LOCK_EXCLUSIVE

  PT_LOCK_WRITE

  PT_UNLOCK

  TRIGGER_CREATE

  TRIGGER_DISABLE

  TRIGGER_ENABLE

  22     BASEstar Open CIMfast for OSF/1 AXP CEL Expression Operator Reference

  CONTEXT_GET_DEFAULT

  CUR_ACTIVITY_NAME

  CUR_BREAK_NAME

  CUR_EVENT_NAME

  CUR_EVENT_ORIGIN

  CUR_EVENT_PAR_NAME

  CUR_EVENT_TIME

  A CEL Examples

  B CEL Reserved Words

  C CEL Obsolete Expressions and Actions

  CUR_EVENT_PAR_FORMAT

  PT_ELEMENTS

  PT_EVENTS_CHANGE

  PT_EVENTS_CURRENT

  PT_EVENTS_NONE

  PT_EVENTS_UPDATE

  PT_FORMAT

  PT_FORMAT_STR

  PT_LENGTH

  STR_CONVERT

  STR_TO_FLOAT

  STR_TO_LONG

  TRN_LOGICAL

  USERNAME

  D Data Types