man1/DMANcooking

Table of Contents

Description

A graphical utility for cooking cathodes.

Arguments

--dbman_host <hn> - optional

the host where dbman(8) is running

If not supplied the default is: localhost

--src <sn> - optional

Which ion source to cook.

Valid values are: S1 or S2.

If not supplied the default is: S1

--mngr_conf <fn> - optional

Pathname of the CONFLIST file to load.
See the section "MNGRconf configuration file" below.

If not supplied the default is: MNGRconf.

--cat_list <fn> - optional

Pathname to a file containing a list of cathodes to cook and the cooking time. See the section "cat_list configuration file" below.

--park_list <fn> - optional

Pathname to a file containing a list of parameter tagnames and values. The contents of the file are executed when cooking completes if parking is enabled.

The file format is the same as used by the dbmod(1) program. In fact dbmod(1) is invoked by DMANcooking to process this file.

--print_cmd <arg>

The command to use to invoke printing when the "Print Current Log" menu is used. The program pipes the text into the stdin of the specified command.

If not specified the command defaults to "lpr".

Note that if the command requires options then the entire command should be double quoted so that it is treated as one field by the command line parsing.

--help - optional

Starting the program with this option causes it to print an online help message and exit.

MNGRconf configuration file

group1 - ion source 1

The parameters in this group are used to interface DMANcooking to the S1 ion source indexer.

If this source is to be used all parameters in the group marked required must be present.

<ctl1 0> - required

The cathode number control.

Usually this parameter uses the refname CatNumC in the database.

This parameter must be writable by DMANcooking.

DMANcooking uses the PhyMax value from this parameter when the program is started to determine how many cathode buttons to create.

<read1 0> - required

The current cathode position.

Usually this parameter uses the refname CatNumR in the database.

<read2 0> - required

cathode indexer busy SR

Usually this parameter uses the refname IdxBsySR in the database.

DMANcooking uses the text messages associated with this parameter.

It expects the message names which are given in the McSNICSmngr(8) manual page.

The message values are: rest, busy, need_home, and error.

McSNICSmngr(8) is the indexer program used by NEC ion sources at this time. If a different indexer and program are used it is expected that the parameter interface for the program will follow the same behavior as McSNICSmngr(8) .

<read3 n> - optional

Current logging sources.

Each parameter listed in this section is a data source for the current logging feature of the program.

The parameters show up on the "Select Current Log Src" menu allowing the user to choose which of the available data sources will be used when logging current.

Index 0 is the default. Index values may be skipped and the program will operate properly.

group2 - ion source 2

The parameters in this group are used to interface DMANcooking to the S2 ion source indexer.

If this source is to be used all parameters in the group marked required must be present.

The parameter list is the same as source 1 except that g2 is used for the group.

cat_list configuration file

This is an optional configuration file which allows a list of cathodes and the cooking time to be specified. The cathode list and the cooking time can of course be changed by the operator.

There are five directives: cook_time, cook_pass, park_cat, park_ctl, and cat.

A # at the beginning of a line is a comment. Behavior of # chars in any other position is undefined.

The cat directive is followed by a list of cathode positions. There may be any number of cathodes listed. If multiple cat directives exist they are all used. This makes it easier to read the list when editing.

The cook_time directive sets the cooking time. Cooking time is specified in seconds. If multiple cook_time directives are found in the file the last one found is the value actually used.

If cook_time is not specified it defaults to 60 seconds.

The cook_pass directive sets the number of times to pass through the cooking list.

If cook_pass is not specified it defaults to 1.

The park_cat directive sets the parking cathode number.

If park_cat is not specified it defaults to cathode 0.

The park_ctl directive determines the initial state of parking. Valid values are: disable or enable.

If this directive is not present parking is enabled when the program starts.

See the section "cat_list file example" below.

MNGRconf file example

cat_list file example

#
# this is an example cat_list file
#
# There are several cat directives, some of which
# are commented out.
#
# The cooking time is set to 120 seconds
#
# The parking position is set to 1
#
# The program is set to make two passes through the cooking list.
#

cook_time 120
cook_pass 2
park_cat 1
park_ctl disable

cat 1 2 3 4 5 6 7 8 9
cat 10 11 12 13 14 15 16 17 18 19
#cat 20 21 22 23 24 25 26 27 28 29
#cat 30 31 32 33 34 35 36 37 38 39
#cat 40 41 42 43 44 45 46 47 48 49

#cat 50 51 52 53 54 55 56 57 58 59

Notes

At this time DMANcooking isn’t doing a very good job of looking at the indexer status. It’s only looking for "rest". If the indexer screws up it’s likely the program will also.

Manual page revision

$Id: DMANcooking.1,v 1.10 2008/04/21 18:21:42 kitchen Exp $

Table of Contents

Name
Synopsis
Description
Arguments
MNGRconf configuration file

group1 - ion source 1
group2 - ion source 2

cat_list configuration file
MNGRconf file example
cat_list file example
Notes
Manual page revision