SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Vol 2

CLOSE

Name:
    CLOSE (LET)
Type:
    Let Subcommand
Purpose:
    Close a file associated with a given unit number.
Description:
    When Dataplot opens a file, it will be attached to a specific unit number between 1 and 99. This command can be used to close a currently open file based on its associated unit number. This syntax is typically used by Dataplot developers for debugging purposes.

    Enter HELP FILE SWITCHES to see a list of files that can be opened by Dataplot. See the Program example for an example of using the PROBE command to obtain the relevant unit number.

Syntax 1:
    LET <iflag> = CLOSE <unit>
    where <unit> is an numeric value between 1 and 99;
    and      <iflag> is a parameter that contains the status value from the close.

    This syntax closes the file associated with the specified unit number. The status from the CLOSE command is saved in <iflag>.

    If the specified unit is not attached to a file, <iflag> will typically have a value of 0.

Syntax 2:
    LET <iflag> = CLOSE DELETE <unit>
    where <unit> is an numeric value between 1 and 99;
    and      <iflag> is a parameter that contains the status value from the close.

    This syntax closes the file associated with the specified unit number. The status from the CLOSE command is saved in <iflag>. In addition, this syntax will delete the file when it is closed.

    If the specified unit is not attached to a file, <iflag> will typically have a value of 0.

Examples:
    LET IFLAG = CLOSE 44
    LET IFLAG = CLOSE DELETE 44
Note:
    The unit number should be entered as a literal number. If you have the unit number stored as a parameter, you can use the "^" character as in

      LET IFLAG = CLOSE ^IVAL
Default:
    None
Synonyms:
    None
Related Commands:
    INQUIRE = Inquire whether the specified file exists.
    FILE SWITCHES = Probe for unit numbers associated with certain files.
Applications:
    Debugging
Implementation Date:
    2016/06
Program 1:
     
    PROBE IWRINU
    LET UNIT = PROBEVAL
    LET IFLAG = CLOSE ^UNIT
        

Privacy Policy/Security Notice
Disclaimer | FOIA

NIST is an agency of the U.S. Commerce Department.

Date created: 06/10/2016
Last updated: 06/10/2016

Please email comments on this WWW page to alan.heckert@nist.gov.