sddsalarmlog

• description: sddsalarmlog logs changes of alarm status for process variables named in an input file.
• example: The status of the positron accumulator ring process variables are logged for a one day duration.

  sddsalarmlog PAR.alog  PAR.alog.sdds -timeDuration=1,day
  

  where the file PAR.alog is the input file containing the names of the process variables, and the file PAR.alog.out is the output file.

• synopsis:

  usage: sddsalarmlog <input> <output> 
  -timeDuration=<realValue>[,<time-units>]
  [{-append[=recover] | -eraseFile | -generations[=digits=<integer>][,delimiter=<string>} |
   -dailyFiles[=verbose]]
  [-pendEventTime=<seconds>] [-durations] [-explicit[=only]] [-verbose]
  [-comment=<parameterName>,<text>]
  

• files:
  • input file:

    The input file is an SDDS file with the required string column ControlName which contains the names of the process variables whose status is to be monitored.

  • output file:

    The output file contains information on the process variable alarm status change, such as the time of occurence, the alarm designation, the severity of the alarm, and the row location of the previous alarm status change.

    In order to save disk space sddsalarmlog logs integer codes (indexes) instead of the actual string values for the control name, the alarm status and the alarm severity. The integer codes are indices into one of three string arrays written to the output file. The logging information can be recovered using SDDS tool sddsderef.

    As an option, and for a direct interpretation of the output file, the control name, alarm status and alarm severity can be written explicitly as string columns with or without the integer codes. However this option uses up a lot more disk space.

    In either case the following columns are defined:

    • PreviousRow -- Long column of row numbers. For each process variables alarm status change, the row location of the previous alarm status change is written.
    • TimeOfDay -- Float column of system time in units of hours. The time does not wrap around at 24 hours.

    By default these columns are defined (except when the option -explicit=only is specified):

    • ControlNameIndex -- Long column indicating the process variable whose alarm status changed. The value of this data is the index into the string array ControlNameString, which is the list of all process variables monitored.
    • AlarmStatusIndex -- Short column indicating the alarm status. The value of this data is the index into the string array AlarmStatusString, which is the list of all possible alarm status values.
    • AlarmSeverityIndex -- Short column indicating the alarm status. The value of this data is the index into the string array AlarmSeverityString, which is the list of all possible alarm severity values.

    These columns are created by the option -explicit:

    • ControlName -- String column for the process variable whose alarm status just changed.
    • AlarmStatus -- String column for the alarm status.
    • AlarmSeverity -- String column for the alarm severity.

    This column is created with option -durations:

    • Duration -- String column for the duration of the previous alarm state.

    These arrays are created by default except when the option -explicit=only is specified:

    • ControlNameString -- String colunm of all process variables to be monitored.
    • AlarmStatusString -- String colunm of all possible alarm status values.
    • AlarmSeverityString -- String colunm of all possible alarm severity values.

    These parameters are defined:

    • InputFile -- String parameter for the name of the input file.
    • TimeStamp -- String parameter for time stamp for file.
    • PageTimeStamp -- String parameter for time stamp for each page. When data is appended to an existing file, the new data is written to a new page. The PageTimeStamp value for the new page is the creation date of the new page. The TimeStamp value for the new page is the creation date of the very first page.
    • StartTime -- Double parameter for start time from the C time call cast to type double.
    • YearStartTime -- Double parameter for start time of present year from the C time call cast to type double.
    • StartYear -- Short parameter for the year when the file was started.
    • StartJulianDay -- Short parameter for the day when the file was started.
    • StartMonth -- Short parameter for the month when the file was started.
    • StartDayOfMonth -- Short parameter for the day of month when the file was started.
    • StartHour -- Short parameter for the hour when the file was started.

• switches:
  • -timeDuration=<realValue>[,<time-units>] -- Specifies time duration for logging. The default time units are seconds; one may also specify days, hours, or minutes.
  • -append[=recover] --Specifies appending to the file <output> if it exists already. If the recover qualifier is given, recovery of a corrupted file is attempted using sddsconvert, at the risk of loss of some of the data already in the file.
  • -eraseFile -- If the output file already exists, then it will be overwritten by sddsalarmlog.
  • -generations[=digits=<integer>][,delimiter=<string>] -- The output is sent to the file <SDDSoutputfile>-<N>, where <N> is the smallest positive integer such that the file does not already exist. By default, four digits are used for formating <N>, so that the first generation number is 0001.
  • -pendEventTime=<seconds> -- Specifies the CA pend event time, in seconds. The default is 10 .
  • -durations -- Specifies including state duration in output.
  • -connectTimeout -- Specifies maximum time in seconds to wait for a connection before issuing an error message. 60 is the default.
  • -explicit[=only] -- Specifies that explicit columns with control name, alarm status, and alarm severity strings be output in addition to the integer codes. If the "only" qualifier is given, the integer codes are omitted from the output.
  • -verbose -- Prints out a message when data is taken.
  • -precision={single|double} -- Selects teh data type for the statistics columns.
  • -updateInterval=<integer> -- Number of sample sets between each output file update. The default is 1.
  • -ezcaTiming[=<timeout>,<retries>] -- Sets EZCA timeout and retry parameters.
  • -noezca -- Obsolete.
  • -dailyFiles - The output is sent to the file <SDDSoutputfile>-YYYY-JJJ-MMDD.<N>, where YYYY=year, JJJ=Julian day, and MMDD=month+day. A new file is started after the midnight.
  • -oncaerror={usezero|skiprow|exit} -- Selects action taken when a channel access error occurs. The default is using zero (usezero) for the value of the process variable with the channel access error, and resuming execution. The second option (skiprow) is to

• see also:

• author: M. Borland, ANL