! Help file for CAMAC Topology Supervisor
!
1 ASSIGN
 This command assigns a logical name to a CAMAC module.  CAMAC logical
 names should be prefaced with a facility identifier followed by a "$"
 or "_" (e.g. CEX$TR812).

 Format:  ASSIGN physical_name logical_name [/qualifier,...]
2 Parameters
Physical_name
 The physical name is composed of a 2-letter highway (SH for serial
 highway, PH for parallel highway), 1-letter branch designation, 1- or
 2-digit crate number, the characters ":N" and a 1- or 2-digit station
 number.

 Example: SHA1:N20		(serial highway A, crate 1, station 20)

Logical_name
 The logical name is used to identify a CAMAC module to the driver.  The
 name is a character string having a maximum of 32 characters.  If the
 string contains other than alphanumeric, dollar-sign ($) or underscore
 (_) characters, it must be enclosed in quotation marks ("). 
 
 The logical name is placed in the system logical name table and thus must
 be unique with respect to all other system-wide logical names (as well as
 file names, etc.).  CAMAC logical names should include a facility prefix
 followed by a "$" or "_" and a module identifier, to insure uniqueness
 (for example, CEX$TR812). 
2 Qualifiers
/COMMENT
 Permits you to include the comment "str" (of up to 40 characters) in
 the cts database.  If "str" includes any chars other than alphanumerics,
 "$" or "_", then it must be included in double quotes.  (Note that
 blanks - i.e. spaces -  are NOT alphanumeric characters.)  Comments are
 useful for documenting listings created by the show command. 

 Format:  /COMMENT=str

 Example: /COMMENT="A-D converter for Charge Exchange"
/REFERENCE_UIC
 The reference uic allows use of a logical name - physical specifier 
 assignment to be restricted to particular users, based upon the user's
 uic.  The uic must conform to the standard uic syntax, except that the
 wildcard character * may  replace the user and/or the group number and
 both the double quotes as well as the brackets must be entered.  The
 default is "[*,*]". 

 Format:  /REFERENCE_UIC="[u,g]"
1 AUTOCONFIGURE
 Reassigns logical names to physical specifiers based upon the cts 
 database.  This command can be given as part of the site-specific 
 startup command file to recreate all CAMAC logical names when VMS
 is reloaded. 

 Format:  AUTOCONFIGURE [str,...] [/qualifier]
2 Parameters
str
 An optional match string.  If present, only those devices which match
 the string are reassigned.  Full wildcarding is permitted.  (The
 default match string is "*" - i.e. all devices).  Note that
 "AUTOCONFIGURE str" reassigns logical names for the same subset of
 devices that is displayed by the "SHOW str" command. 
2 Qualifiers
/PHYSICAL
 Compares the match string against physical device names, and reassigns
 logical names in physical device name order.  The default is to
 compare the match string against logical names.

 Format:  /PHYSICAL
          /NOPHYSICAL  (Default)
1 DEASSIGN
 Deassigns a CAMAC logical name - physical device equivalence.

 Format:  DEASSIGN logical_name
1 EXIT
 Terminates the supervisor.
1 MODIFY
 Modifies a CAMAC logical name assignment.  Any part(s) of the assignment
 may be modified.

 Format:  MODIFY str[,...] [/qualifier,...]
2 Examples
 The following are examples of legal MODIFY commands:

 MODIFY/LOG ABC* /LOGICAL_NAME=XYZ$*
   Specifies that all devices whose logical name begins with "ABC" are to
   be assigned logical names beginning with "XYZ$" instead.  All changes
   are logged to the terminal.  E.g.  ABCTR812 would be renamed XYZ$TR812.

 MODIFY/LOG XYZ$*,ABC$* /CRATE=2 /BRANCH=B
   Specifies that all devices whose logical name begins with "XYZ$" or
   "ABC$" are to be redefined to be in crate 2 of branch B of their
   original highway type.   All changes will be logged to the terminal.

 MODIFY/LOG/PHYSICAL SH%2:* /HIGHWAY=PH /CRATE=3
   Specifies that all devices in crate 2 of any serial highway branch are
   to be redefined to be in crate 3 of the same branch of the parallel
   highway.  All changes are logged to the terminal

 MODIFY/PHYSICAL SHA3:N5 /STATION=15
   Specifies that the device in station 5, crate 3 of serial highway A is
   to be redefined to be in station 15 of the same crate and highway.
   Note that if more than one logical name has been assigned to this one
   module, the station will be redefined for all logical names.
2 Parameters
str
 The match string.  The modifications which are specified are applied to
 all devices which match the string.  Full wildcarding is permitted.  Note
 that "MODIFY str" selects the same subset of devices that is displayed by
 the "SHOW str" command. 
2 Qualifiers
/BRANCH
 Replaces the branch designation in the physical name.

 Format:  /BRANCH=c      (where "c" is the branch identifier, e.g. "A")
/COMMENT
 Replaces the comment string.  If "str" contains any characters other
 than alphanumerics, "$" or "_", then it must be enclosed in quote marks.
 The comment may be up to 40 characters long.

 Both /NOCOMMENT and /COMMENT without a value delete the existing comment.

 Format:  /COMMENT[=str]
	  /NOCOMMENT
/CRATE
 Replaces the crate number in the physical name.

 Format:  /CRATE=u       (where "u" is the crate number, e.g. "13")
/CSU
 Replaces the entire CAMAC Support Unit specifier in the physical name.

 Format:  /CSU={PH/SH}cu[:]
/HIGHWAY
 Replaces the highway designator in the physical name.

 Format:  /HIGHWAY={PH/SH}
/LOG
 Causes CTS to display all changes to logical or physical names as they
 are made (changes to comments are not logged).

 Format:  /LOG
          /NOLOG  (Default)
/LOGICAL_NAME
 Replaces the logical name.  Full wildcards are permitted IF the match
 string is being compared against logical names.  Note that great care
 must be exercised in the specification of the wildcard characters to
 avoid renaming logical names in undesireable ways.

 Format:  /LOGICAL_NAME=logical_name
/PHYSICAL
 Compares the match string against physical device names, and applies
 modifications in physical device name order.  The default is to
 compare the match string against logical names.

 Format:  /PHYSICAL
          /NOPHYSICAL  (Default)
/REFERENCE_UIC
 The reference uic allows use of a logical name - physical specifier 
 assignment to be restricted to particular users, based upon the user's 
 uic.  The uic must conform to the standard uic syntax, except that the 
 wildcard character * may replace the user and/or the group number and 
 both the double quotes as well as the brackets must be entered. 

 Both /NOREFERENCE_UIC and /REFERENCE_UIC without a value delete the
 existing uic restriction (i.e. the reference uic is set to "[*,*]").

 Format:  /REFERENCE_UIC="[u,g]"
	  /NOREFERENC_UIC
/STATION
 Modifies the station portion of the physical specifier.  "n" must be a
 legal station number.

 Format:  /STATION=[N]n
1 SET
 Changes the status of a CAMAC support unit (crate).

 Format:  SET csu /qualifier[=status] [,/qualifier...]
2 Parameter
csu
 Specifies the CAMAC support unit.

 Format:  {PH/SH}cu:

 Example: SHA1:			(Serial Highway A, crate 1)
2 Qualifiers
/LAM_SUPPORT
 Enables or disables LAM interrupt support for the specified CAMAC
 support unit.

 Formats:  /LAM_SUPPORT=ENABLE     enables LAM support
           /LAM_SUPPORT=ON         enables LAM support
           /LAM_SUPPORT=DISABLE    disables LAM support
           /LAM_SUPPORT=OFF        disables LAM support
/OFFLINE
 Sets the specified CAMAC support unit OFFLINE.
/ONLINE
 Sets the specified CAMAC support unit ONLINE.
/STATION
 Format:  /STATION=[N]n

 Specifies the station number of the LAM Grader module.  The default
 station  number is "N23". 

 Valid only when /LAM_SUPPORT={ENABLE/ON} is also specified.
1 SHOW
 Generates a display of the logical name - physical specification
 equivalences defined for CAMAC devices.  To avoid wrap-around when long
 comments have been entered, use the DCL command SET TERM/WIDTH=132 (if
 your terminal supports this feature), or write the output to a file
 (using /OUTPUT) and print the file on a 132 column printer.

 Format:	show[/option] [str,...]

2 Parameters
str
 An optional match string.  If present, only those devices which match
 the  string are displayed.  Full wildcarding is permitted.  (The
 default match string is "*" - i.e. all devices).  If /PHYSICAL is
 specified, the string is compared to the physical specification. 
 Otherwise, the string is compared to the logical name. 
2 Qualifiers
/BRIEF
 Generates a brief display.  (This is a one line display which permits 35
 of the 40 comment characters to be displayed before wrap-around occurs.)
 /BRIEF is the default, unless /OUTPUT is specified (in which case /FULL
 is the default).
/FULL
 Generates a complete display (including the REFERENCE_UIC).  /BRIEF is
 the default unless /OUTPUT is specified (in which case /FULL is the
 default).
/LOGICAL
 Generates the display alphabetically by logical name.  /LOGICAL is the
 default.
/OUTPUT
 Writes the output to the specified file (or print queue).  The default
 file name is CTS.LIS.

 Format:  /OUTPUT[=file_specification]

 Example: /OUTPUT=SYS$PRINT		prints file on line printer
/PHYSICAL
 Generates the display in highway - crate - station number order.
 /LOGICAL is the default.
