RES_EXECUTE Name
RES_EXECUTE Purpose
Process an executable res file.
Category
Calling Sequence
res_execute, res Inputs
res = Name of executable res file. in
An executable res file contains data and also one or
more blocks of IDL code that may be executed. The IDL
code can access and use the data from the res file.
By default the first code block to be found, if any,
will be executed.
Keyword Parameters
Keywords
/DEBUG list each command that is executed.
/LIST means list res file contents and code to execute.
Code will not be executed.
SET=set specify a code set name if other than IDLCODE.
Any other name is added to IDLCODE_. Examples
SET='image' gives IDLCODE_IMAGE,
SET='plot' gives IDLCODE_PLOT
This specifies the code block to execute, /LIST,
/UPDATE, or /DROP.
/UPDATE means update the specified code block with new
code. The new may be pasted into a text area.
NEW=new May give new code for /UPDATE instead of pasting.
/DROP drop the specified code set from the res file.
CODE=code Returned code (/LIST or execute only).
Values may be passed in as keywords. The executed
code must deal with undefined values. This allows
some run-time control of the code execution.
Any such values are available under the variable name
used as the keyword, so do not abbreviate, the names
must match those used in the code.
Outputs
Common Blocks
Notes
Notes: Code may be added to a res file using /UPDATE.
The IDL code is in a text array and saved under
the tag IDLCODE or IDLCODE_set where set is a name as
described above. It must be a set of IDL statements
(not a procedure). Data may be read from the res file
using resget, the code should assume it is already open.
The code in a set may call another code set:
code_block: set
where set is the full set name. May nest such calls
but do not recurse or do a closed loop of blocks.
Modification History
R. Sterner, 2005 Feb 03
R. Sterner, 2005 Feb 07 --- Added more keywords.
R. Sterner, 2005 Feb 08 --- Can pass variables in by keyword.
Also allow nested calls to code blocks.
R. Sterner, 2007 Feb 06 --- Merged continued code lines.
Copyright (C) 2005, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.