Example PAMs

STAR Computing	Tutorials main page
Example PAMs
Offline computing tutorial	Maintained by Kathy Turner

You can use my example pam given here to see how to write all files needed and to run in BFC STAF.

Set up directories needed

go to your work area, e.g. cd ~/work

Create a new domain (easiest to do for testing - later can add it to pre-existing domain). Create the directories under ~/work:

       mkdir pams; cd pams
       mkdir daq; cd daq;   # daq is my domain
       mkdir idl
       mkdir inc
       mkdir kumac
       mkdir wgf            # new package wgf

Now write files needed
- The package "wgf" will have one module: write_geant_file.
- cd ~work/pams/daq/wgf and then write:
  - write_geant_file.idl
  - write_geant_file.c
- cd ~work/pams/daq/idl and then write:
  - wgf_params.idl

Now compile your file

      cd ~work/pams/daq/wgf
      makes

Write the kumacs you need:
cd ~work/pams/daq/kumac and then write:
- create_tables_daq.kumac
- wgf_init.kumac
- wgf_run.kumac
- can also write wgf_finish.kumac if needed

Now set up to run your package from "user" chain in BFC:

cd ~work
cp $STAR/pams/global/kumac/*user*.kumac .

edit init_user.kumac and put in

             exec ./pams/daq/kumac/create_tables_daq
             exec ./pams/daq/kumac/wgf_init

edit run_user.kumac and put in

             exec ./pams/daq/kumac/wgf_run

edit finish_user.kumac if needed

Now set up to run BFC:
- cd ~work
- must pick a chain that either reads in an input file with the tables we need on it (see code for tables needed) or that calculates tables needed
- cp $STAR/kumacs/chain/call_bfc_readfz_to_dst_year2.kumac .
- for this example package, we just need to read in an fz file, run "g2t" then "user", therefore
- edit call_bfc_readfz_to_dst_year2.kumac and change so that:
```
TOP=/scr22/kathy/work _  # give full directory to find user kumacs
domain=' geometry g2t daq '  - # name of my domain ... will automatically be loaded
chain='  fzin rg2t user '  - # don't need anything else
          
```

To run in STAF from ~work

      starpro
      staf
        exec call_bfc_readfz_to_dst_year2
     HURRAY!! IT WORKED (10/6/98)

To make it official, make sure you've gone through all the steps required (see previous tutorial pages). Then you will have to check in (to CVS) your code,idls & kumacs into a pre-existing domain & package, or ask to have a new one created. Then send a request to Kathy Turner and ask to have it included in the BFC kumacs.