Software Release Note 118.0
C1091 PAGE User's Guide
February 10, 1992
The C1091 Page application is analogous to the generic Page application. The features and operations of the generic Page were chosen for the C1091 Page. However, there are number of differences between the two:
• The C1091 Page is written using ESM calls rather than SMG. Therefore, some keystrokes are not recognized by the C1091 Page. For example, hitting <F7> to toggle to a different scaling unit, as the case in the generic Page, will be ignored by the C1091 Page.
• The main screen format is somewhat different in order to fully support accessing the C1091 Timing module parameters. An illustration of the C1091 Page main screen is to follow.
• The C1091 Page is restricted to devices which are of C1091 type; other devices will be rejected.
The C1091 Page application was developed to allow the user to interact with the C1091 CAMAC Timing Modules in the most convenient way. The C1091 module has more parameters for setting and reading than any other modules which makes the generic Page an unsuitable application to use. The C1091 module has eight countdown counters, called channels. Each channel (device) has a timing delay, eight Tev Clk events, a SetOn event, and status information.
1. Main Screen
Figure 1 shows the C1091 Page main screen. The first and third rows are read-only. The first row displays the page name and the application name and version. The third row contains the device field labels. There are six fields:
Protection Flag It is a read-only field and indicates the user privilege for setting the device:
< Setting of delays and events is denied.
> Device enabling, disabling, or resetting is denied.
- Both Setting and Control properties are denied.
DEVICE Displays and accepts a 12-character device name.
SET DELAY Displays the readback of the timing delay of the device.
UNITS Indicates the SET DELAY scaling mode:
E Engineering units (milliseconds)
I Intermediate units (microseconds)
R Raw units (hex)
STATUS Displays the reading of the generic status. There are four bits defined:
Ful/[ ] Device event buffer status: Full/not full
Enb/Dis Device state: Enable/Disabled
Pnd/[ ] Setting of a new delay: Pending/not pending
Soe/[ ] SetOn event: active/not active
Hitting <CR> on Enb/Dis bit toggles its state.
Text/Events/Rate This field can be switched between the device DB text (read only), Tev Clk events, and reading data acquisition rate.
Figure 1. A blank C1091 Page main screen.
The second row is the menu bar which contains five items: File, SAR, Options, Print, and Exit.
File Displays a pulldown menu to allow for file manipulations.
SAR Displays the Save And Restore pulldown menu.
Options Gives users tools to: change fields, units, and screens, and expand messages.
Print Lists print queues and routes the image of screen to chosen queue.
Exit Exits the application. <CTRL-Z> or <F10> does the same.
1.1 File Pulldown Menu
The File pulldown menu displays four choices as shown in Figure 2. The user can Load, Save, Save As, and Delete Page files. The files are written to the current user directory (default directory). A logical name can be used to set the default directory in which C1091 Page looks to load and save files. To set the default directory, use the following DCL command:
$ DEFINE P91_AREA disk:[directory]
The program adds an extension of '.P91' to all C1091 Page files when saving; no extension is required.
Figure 2. File pulldown menu items.
Load Displays a pop-up menu of C1091 Page files found in the default directory. Arrow keys, Next Screen, or Prev Screen keys can be used to select a file from the list. When a file is selected, the device names are read from the file and data acquisition starts. Figure 3 shows the C1091 Page main screen after loading a file of the name 'E1091'.
Save Saves the presently displayed device names and their FTD's to a Page file. If the file doesn't exist, the user will be asked for a file name.
Save As Saves the presently displayed device names and their FTD's to a new Page file. It prompts the user for the new name.
Delete Pops up a list of file names for selection. It then deletes the selected file from the file list. In case that the selected file has SAR files, the program will delete both the selected Page file and its SAR files.
Figure 3. C1091 Page main screen after loading a file.
1.2 Options Pulldown Menu
The Options pulldown menu provides the user with more tools to interact with C1091 Page as shown in Figure 4.
Figure 4. Options pulldown menu items.
Scaling Units Selecting this item toggles between the three SET DELAY scaling modes. The user can toggle more than once until the desired units are displayed.
Text/Events/Rate This option allows the user to change the last field as desired. Text is a read-only and displays the device DB text. Events displays the Tev Clk events and SetOn event. A maximum of eight Tev Clk events can be set to a device. Adding an event is accomplished by typing in the event/s and hitting <CR> at the end of the field. Notice that the application recognizes only the input to the left of <CR>. Hitting <CR> in the middle of the field wipes out events found to the right of <CR>. Valid events range from 00 to FD. Figure 5 shows an example of C1091 Page main screen when displaying Events field. Rate allows for reading and setting of readback rates.
Figure 5. C1091 Page main screen when displaying events.
Extended Status Page This activates the extended status screen for a device. The cursor must be positioned on the row of the desired device before selecting this option.
Expand Error The user can get detailed information on error messages by placing the cursor on
Messages the abbreviated error message and then selecting this option.
1.3 SAR Pulldown Menu
The Save And Restore option provides the user with the ability to SAVE the current settings of the C1091 devices, and to RESTORE these saved devices and settings. For a single device the following parameters can be saved and restored: FTD, Set Delay, Tev Clk events, SetOn event, and device status (Enabled/disabled). Figure 6 shows the SAR pulldown menu items.
Figure 6. SAR pulldown menu items.
Save This saves the current setting of all the devices on the C1091 Page. When selected, a list of SAR titles and their corresponding time stamps will be displayed as shown in Figure 7. The program creates a SAR file for each title. The time stamp shows the date and time in which the SAR file was saved. The user has the option to save settings to an existing SAR file or a new file. Saving to an existing SAR file is accomplished by simply selecting the SAR title. Saving to a new SAR file is accomplished by selecting the New option from the SAR title list which prompts the user for a 30-character title. A maximum of 10 SAR files can be created for a single C1091 Page file.
Restore This option restores the settings of the saved devices. It displays a list of SAR titles along with their time stamps for selection. Once the selection is made, saved parameters for all the devices will be restored. A warning message will be put out if the devices in the C1091 Page file don't match those in the SAR file.
Delete This provides the user with the ability to delete SAR files. The user can delete a SAR file by selecting it from the list of SAR titles.
Figure 7. C1091 Page main screen showing SAR title list when selecting SAR/Save.
2. Extended Status Screen
This screen works exactly like the generic Page Extended Status screen. It displays all device status bitnames, their current states, and the control operations as shown in Figure 8. There are four status bits and three control bits defined. The screen can be displayed by selecting it from the menu bar or by hitting <PF3>.
Figure 8. C1091 Page Extended Status screen.
Controls, EPICURE, Applications, C1091, PAGE