Command AFETCH
| GSI | Biophysics |

AFETCH

name qual
/
run()
dump()
date()
lib()
path()
analyzer
calib
lin
spec
cond
disp
modify
alldmi
nolist
debug

Purpose

Get data elements (analyzers, calibrations, and/or linearizations) from data element library

Parameters

name

Data element identifier.

qual

Data element qualifier.
Data element identifier and qualifier, respectively, may be given by a name or number. A name may contain wild card characters at any position: '%' specifies one character, '*' a (sub)string of any length. If omitted, uniqueness or reference to the last display is assumed.

run(r)

Run identifier (up to 8 characters). Wild card characters are supported: '%' specifies a single character, '*' a (sub)string of any length.

dump(n)

Dump command number. May be a number or an asterisk (*) indicating all dumps with the given run identifier.

date(d)

Selected period of element creation dates, given by a single date or by 'date1 to date2'. Default for 'date1' is the earliest, for 'date2' the current date. The sequence for each date string is 'day month year'. Day, or both month and day, may be omitted; default is the beginning or end of the specified month or year, respectively.

lib(l)

Library name. Replaceable default: the name used last.

path(p)

Library name path prefix.

analyzer

Only analyzers will be fetched.

calib

Only calibrations will be fetched.

lin

Only linearizations will be fetched.
Only one of the key words ANALYZER, CALIB or LIN, may be specified in the same command, and they are only allowed in data element loops. If none of them is specified, all data elements available are fetched.

spec

Analyzers only: fetch spectrum only.

cond

Analyzers only: fetch conditions only.

disp

Analyzers only: fetch display windows and points only.

alldmi

All analyzer qualifiers (event ids) 'ETn' including 'ET1' are renamed to 'DMI'; if not specified, 'ET1' becomes 'GLIST'.

modify

Modify existing data element(s) - if necessary - without prompting.

nolist

Execution messages are suppressed.

debug

Debug switch. Lots of output !

Function

The specified data element(s) are fetched from the specified library.
If possible. The attributes of an existing data element are modified corresponding to the attributes of the fetched data element.
Parts of the analyzer structure may be selected for fetching: spectrum, conditions, display windows and points.

Remarks

Special analyzer qualifier names are renamed automatically:
               'ETLIST'       to 'LIST'                                         
               'ET1', '1'     to 'GLIST' or                                     
                                 'DMI',  if ALLDMI specified                    
               'ET2'...'ET9'  to 'DMI'                                          

Examples

AFETCH * * / R(*) D(*) DATE(9 8 80) ANAL
All analyzers dumped at August 9, 1980, are fetched from the data element library.
AFETCH PDP301 / RUN(NORM) PATH(XY01) LIB(satan) CALIB
Calibration 'PDP301' of run 'NORM' is fetched from library XY01/satan. The data element qualifier and dump command number are prompted.
AFETCH  XE*  L%1 / R(ARPB) D(*) DATE(8 81 TO 9 81)
All data elements of run 'ARPB' dumped between August 1st, 1981, and September 30th, 1981, with names beginning with 'XE' and with qualifier names 'Lx1' (x = any valid character), are fetched from the data element library.
| GSI | Biophysics |
Last updated: M.Kraemer@gsi.de, 3-Aug-1999