; TELL ;--------------------------------------------------------------- ;! Send parameters to tasks that know to read them on the fly ;# PSEUDOVERB GENERAL ;----------------------------------------------------------------------- ;; Copyright (C) 1995, 1998, 2019-2020 ;; Associated Universities, Inc. Washington DC, USA. ;; ;; This program is free software; you can redistribute it and/or ;; modify it under the terms of the GNU General Public License as ;; published by the Free Software Foundation; either version 2 of ;; the License, or (at your option) any later version. ;; ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; ;; You should have received a copy of the GNU General Public ;; License along with this program; if not, write to the Free ;; Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, ;; MA 02139, USA. ;; ;; Correspondence concerning AIPS should be addressed as follows: ;; Internet email: aipsmail@nrao.edu. ;; Postal address: AIPS Project Office ;; National Radio Astronomy Observatory ;; 520 Edgemont Road ;; Charlottesville, VA 22903-2475 USA ;----------------------------------------------------------------------- TELL LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC TELL: Verb to send parameters to a task from AIPS in execution OPTELL TELL operation code TASK Task name NUMTELL 0.0 35.0 AIPS number of running task VERSION Version of task desired. Task name may be inserted as an immediate argument i.e TELL TASK or TELL 'TASK' ---------------------------------------------------------------- TELL Type: Pseudoverb Use: Sends selected parameters to those tasks that know how to use this option. Use SHOW TASK to review these parameters. TELL works by putting the parameters in a file. At some later time, the task reads this file and acts on the request. Adverbs: OPTELL...Nature of the operation: 'ABOR' Die now, reset file statuses and delete outputs. 'QUIT' Die now, but save the current output results. 'CHAN' Change the running parameters. TASK.....Requested task name (5 characters or less). NUMTELL..AIPS number of the task to be "told" - this allows you to tell batch jobs to terminate gracefully. 0 => current AIPS number. DOWAIT...Logical adverb. True (> 0) specifies that AIPS not resume until the requested task has finished. VERSION..Desired version of the task, i.e. 'NEW', 'OLD'. See HELP VERSION for details. Grammar: TELL or TELL taskname The first TELLs the task referred to by the adverb TASK. The second TELLs the task 'taskname'. Examples: TASK='CNTR'; TELL TELLs the task CNTR TELL IMAGR TELLs the task IMAGR. Note that the adverb TASK is not set to 'IMAGR' in the second example. Tasks which support this capability: APCLN.....Deconvolves images with B. G. Clark CLEAN method. Can change DOTV, NITER, beam, and other parameters. IMAGR.....Wide-field and/or wide-frequency Cleaning / imaging. Can change quite a few parameters SCMAP.....Imaging plus self-calibration loop with editing Can change several imaging and self-cal parameters. SCIMG.....Full-featured imaging plus self-calibration loop with editing. Can change imaging, editing, and self-cal parameters. SDCLN.....Deconvolves images with CLEAN followed by SDI methods. Can change DOTV, NITER, beam, and other parameters. UTESS.....Deconvolves multiple images with maximum entropy methods - for images of polarization. Can change DOTV, NITER, other parameters. VTESS.....Deconvolves multiple images with maximum entropy methods. Can change DOTV, NITER, other parameters. Tasks which support QUIT or ABOR operations only: MCUBE.....Builds n+1 (or n) dimensional images from sets of n-dimensional images. ----------------------------------------------------------------