>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  RES_EXECUTE






      Process an executable res file.


Calling Sequence

      res_execute, res


      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


        /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.


Common Blocks


      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.

© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us