FR - Read (sets) a local string variable

(10/02/07)

PURPOSE

Associates a file name template or any other alphanumeric string with a string (symbolic) variable. This operation should only be called from inside a procedure. The string variable is specified inside the procedure. The associated value is read from current input stream which may be either an interactive SPIDER run or a higher level procedure.

SEE ALSO

FR L [Read (sets) a local string variable]
FR G [Read (sets) a global string variable]
FR F [Read (sets) global string variables from a file]
RR [Read (Set) Register variables]
VAR [Variable Assignment]

USAGE

.OPERATION: FR
[Operation given in a SPIDER procedure.]

.PROMPT & VARIABLE NAME: ?MYPROMPT? [name]
[Enter prompt string to be printed when procedure is called from an interactive session and name for this variable.]

[Upon procedure execution, prompt string is printed on terminal or in SPIDER results file:]

.MYPROMPT: PIC{***[num]}
[Enter value to be associated with this variable. Any alphanumeric string such as a filename is allowed. If the value contains another variable or a register, then these components are evaluated in the procedure where they are specified (before being passed into the caller).]

NOTES

  1. Example.
    If the following lines are contained inside a SPIDER procedure:

    FR
    ?NERVE FILE PREFIX? [temp]
     
    DO I=4,6
    FS
    [temp]{***I}
    ENDDO
     
    CP
    [temp]004
    [temp]_jnk
    EN

    When procedure is invoked from an interactive SPIDER session, the ?NERVE FILE PREFIX? prompt appears and the user has responded with nerve:

    ?NERVE FILE PREFIX? [nerve]

    When do-loop executes, operation sequence is :

    FS
    nerve004
    FS
    nerve005
    FS
    nerve006

    Following do-loop execution, operation sequence is :

    CP
    nerve004
    nerve_jnk

SUBROUTINES

DRIV1, SYMPAR, RDPRMC

CALLER

DRIV1