11: Utilities and User Commands

Command Purpose
cell_map_db_create_insert Create/Insert/Update /data/cell_map.db with contents of the /data/cell_map.SITE files
chk_file_lock This command displays the value of the semaphore that resides in the shared memory area ‘FileLock’.’
clear_error This command will send a message to the error manager that will cause the error message queue to be deleted. Running the command “errs” after this will only show errors generated after the clear_error command was issued.
critical Make a task critical
ctlgevlist Set event with string content
cyflexlogevent This utility provides a command line interface to add entries to the CyFlex system log.
darts_datapoint The darts_datapoint program controls the sequencing and reporting of various channel measurements.
dec2hex Convert a decimal to a hexadecimal equivalent
deg2mv Convert a temperature value to an equivalent millivolt value by working backward through a “long” calibration table for a designated channel.
delay The delay.nnn spec file is read to determine what streams of data are produced from variable 1 to variable 2 while introducing a delay. The delay is a specified number of samples and a specified sample interval. Within the spec file, there can be a maximum of 32 lines.
dspec_qt_conv Create a .ui file from a dsply_specs.nnn file
dumpit Display table of all active CyFlex variables.
dump_labels Display table of all active CyFlex variables.
dy Set dyno controller in open loop
dy_ff Switch dyno feed forward ON/OFF
dy_gains Set dyno gains
dy_ramp Set dyno ramp
elb The elb program inserts a electronic logbook entry into the the /specs/log/log.nnn file. The user is prompted to enter in their RACFID and a comment to be written to the logbook.
eo Execute on a file
err_codes Provides error description associated with a given error code or number
errc Obtain error code information
er_report Create database importable version of er_specs
errs Prepares a query to send to the error manager database and retrieve errors.
evreal Event content to real

fdump

Filtered dump of CyFlex variables
file_lock

This command locks the semaphore that resides in the shared memory area ‘FileLock’.’

It is normally called from a gp_test procedure that is controlling access to a shared device or some capability. The command may also be entered manually on a command console.

file_unlock

This command unlocks the semaphore that resides in the shared memory area ‘FileLock’.’

It is normally called from a gp_test procedure that is controlling access to a shared device or some capability. The command may also be entered manually on a command console.

flash_rpt Generic report writer that converts a template into a point-in-time report that contains variable label/value/units for each label tag found in a template file.
flexui_specs  
framp Monitor “UDPTimestampErr” errors from Gantner driver
get_cart_info Obtain emission cart assignment information.
get_errs get_errs retrieves data from the SQL error database and writes into the /data/errors/error.log.
get_hostname The get_hostname program finds the hostname of a specified testcell and places the result into a specified CyFlex string variable.
get_mapped_file Get the location of a mapped file or resource
get_mapped_host Get the hostname of a mapped file or resource
get_site_cfg Get the @SITE_CONFIG entry in the cvs_specs file
get_tc_name The get_tc_name app prints the cell name to the standard output (std_out)
get_tc_num This app returns the numerical equivalent of cell_name
get_vrbl_age The ‘get_vrbl_age’ app returns the value of the time in seconds since a variable(s) was last updated.
gval To display/return the value of a CyFlex XXX_VARIABLE.
gvals Output the values of a list of variables
gvar Get the value of a variable
hex2dec Convert a hexadecimal to a decimal equivalent
is_name_ready This utility is used to determine if a particular application is running, provided that it has registered its name.
learnit  
LV_test This is a simple functional test of the LV interface. LV stands for LabView, but it really applies to any external interface that needs to access information about CyFlex variables.
M5P  
make_sc  
make_tri_arrays Create array variables to hold the contents of tri_specs.dat
merge_keyword_files Merge 2 files which use keywords into one file.
mkdate This program saves a date/time value to the variable specified as argument 1. If two arguments are specified, this program saves a date/time value to argument 1 equal to the date time of argument 2. If only one argument is specified, the current date and time is saved to argument 1. The saved date/time value is a string in xml format.
mk_config_files12 The mk_config_files12 program creates the cell_map and test_map files from data within the tri_specs.dat file.
mk_data_dirs_cn

Creates the directories under the /data directory on a central node for the specified site.

Creates the /tmp directory

mk_data_dirs_tc

Creates the directories under the /data directory on a test cell node

Creates the /tmp directory

mk_PAMtestids The mk_PAMtestids program creates files within the /data/PAMtestids directory. The /home/tcp/testids file is read. This file contains lines of data. Each line of data has a testid and datapoint number.
mk_string_tran Create a transition event for a string variable
mssleep The ‘mssleeep’ utility initiates a sleep for some nanoseconds based on the specified input argument
MT-SIS Usage information for weight room “MT-SIS”
multi_lb_ctrl

Sets digital outputs that control relays in a load bank.

noncritical Make a task not critical
ramp Apply a ramp to a variable
recal_spd_pm Recalibrate the speed and period measurement tables
release_task Release task instance resources and exit the system
rm_event Removing a permanent ASSET event
rm_headers_in_btw Remove extraneous headers in a floger output file
rnd_trip The original purpose of this task was to hard wire an analog output (ao) on eblox or snapio to a analog input (ai) for eblox or snapio and record how long it takes after the ao change to see the value on the ai channel. It can also be used with other variables instead of just ai and ao by having 2 variables linked in some way. It can also be used to detect how long it takes a change for a single variable.
roadspeed_oly  
rpm_change_log The rpm_change_log task gathers information from the History section of the document section to produce a report of changes that have been made to a file between the specified start and end dates.
rstr_pnp_dat Restore the values of any pnp logical variables that have been saved.
rtsched Start a program with real-time schedule options.
setAEI_time Gets the current time and sets a string variable with the time in a format that is compatible with AEI multiFilter change cart.
setev Set a CyFlex event
setevint Set event with integer content
setevlist Set event with string content
setevparam Set event with additional structure message data. This is used if the event you want to set is complex and not something that can be set with setevint or setevstr. You must know before hand what the event structure looks like and create a file for it.
setevstr Set event with string content
set_eng_specs Set updated engine specs values.
set_eng_specs12 Set updated engine specs values.
settoll Change the compressed history tolerance value for a list of variables.
set_user Set User Control Loop Target
show_mem

This process will print the available memory size for common shared memory areas allocated for CyFlex variables and the portion of that which is used.

sigmon Monitors a list of given events (up to 20)
simple_elb The simple elb program inserts a electronic logbook entry into the the /specs/log/log.nnn file. The user is prompted to enter in their RACFID and a comment to be written to the logbook.
sine Apply a sine function to a variable
sizetest  
snap This function will search all asset shared memory areas which contain arrays of CyFlex variables and will print the label,value, and units, if the variable has the “display_active” member TRUE.
squarew Apply a square_wave function to a variable
tcs_more The ”tcs_more” utility will try to communicate with each CyFlex system that is defined in the /data/cell_map file.
wait_for_event This utility will wait for a particular event or for a specified number of seconds.
windows_reader The purpose of the windows_reader program is to transfer and read a windows file from a samba link, store the data from the file into cyflex variables, and then deletes the file.