Format: @file-spec [p1 [p2 [... p7]]]

file-spec

Specifies either the command procedure to be executed or the device or file from which input for the preceding command is to be read.

If you do not specify a file type, the system uses the default file type depending on the utility you are using (I.E. in PCL the default file type is .PCL) .

No wildcard characters are allowed in the file specification.

p1 [p2 [... p7]]

Specifies from one to seven optional parameters to pass to the command procedure. The parameters assign character string values to the symbols named P1, P2, and so on in the order of entry, to a maximum of seven. The symbols are local to the specified command procedure. For example, if you wanted to pass in a shotnumber to a TCL script as the first parameter, your first line could look like

EDIT mytree/SHOT=         'P1

Separate each parameter with one or more blanks. You can specify a parameter with a character string value containing alphanumeric or special characters, with the following restrictions:

• The command interpreter converts alphabetic characters to uppercase and uses blanks to delimit each parameter. To pass a parameter that contains embedded blanks or literal lowercase letters, place the parameter in quotation marks.

• If the first parameter begins with a slash character (/), you must enclose the parameter in quotation marks.

• To pass a parameter that contains literal quotation marks and spaces, enclose the entire string in quotation marks and use a double set of quotation marks within the string. For example:

  $ @TEST "Never say ""quit"""

  When the procedure TEST.COM executes, the parameter P1 is equated to the string:

  Never say "quit"

  If a string contains quotation marks and does not contain spaces, the quotation marks are preserved in the string and the letters within the quotation marks remain in lowercase. For example:

  $ @ANOTHER_TEST abc"def"ghi

  When the procedure ANOTHER_TEST.COM executes, the parameter P1 is equated to the string:

  ABC"def"GHI

• To use a symbol as a parameter, use apostrophes around the symbol to force symbol substitution. For example:

  $ @INFO 'NAME'

  The apostrophes cause the value "JOHNSON" to be substituted for the symbol NAME. Therefore, the parameter "JOHNSON" is passed as P1 to INFO.COM.

Format: ADD TAG node_name tag_name

This command will associate the tag \TAG_NAME with the node specified by the the path node_name. Tagnames must 24 characters or less and contain characters from the set A-Z,0-9, dollar and underscore.

NOTE: The tree must be open for write to use this command. see EDIT vs SET TREE.

PARAMETERS

node_name - a node or path name specifying a node in the tree. see help specify node_name for details. Must be less than 13 characters.

tag_name - a unique string which will become an acronym for the node specified with the node_name parameter. Must be less than 25 characters.

EXAMPLES

TCL> ADD TAG \MAIN::TOP.TIMING TIMING

TCL> ADD TAG -.SUB_PART.D1 MY_D1

Format:CREATE LIBRARY file-spec

file-spec

The file specification of the library you are creating. The CREATE LIBRARY creates a VMS text library of this file specification. If the file type is omitted the type .TLB is used.

Format: CREATE PULSE shot_number [/include=subtree_list] -
[/exclude=subtree_list] -
[/conditional] -
[/nomain]

Note: the experiment model must be open before issuing the CREATE PULSE command using the SET TREE command.

parameters

shot-number - specifies which pulse file to create

/INCLUDE

specifies a list of subtree names that are to be included in the pulse file. Wildcards are permitted.

/EXCLUDE

specifies a list of subtree names that are to be excluded from the pulse file. Wildcards are permitted.

/CONDITIONAL

specifies that subtrees which are set NOINCLUDE (see set node /INCLUDE) will not be included in the pulse file created.

/NOMAIN

by default the main tree is always included in the pulse file. Use this qualifier if you wish to omit the main tree. This is useful if you are creating the pulse file concurrently using several processes. In this case you would include the /NOMAIN qualifier in all but one process.

examples

The following creates the pulse file for shot number 42:

SET TREE CMOD
CREATE PULSE 42

The following creates the pulse file but omits the MHD subtree.

SET TREE CMOD
CREATE PULSE 42/EXCLUDE=MHD

Note: in the above example, if the MHD tree contained subtrees, they would be created even though the MHD tree is not. To exclude the MHD tree and all its subtrees use:

SET TREE CMOD
CREATE PULSE 42/EXCLUDE=(MHD,MHD.***)