Google
 

Trailing-Edge - PDP-10 Archives - DEC_CMS-20_V1.0_SRC - cms/sources/cms20.hlp
There are no other files named cms20.hlp in the archive.
		DEC/CMS COMMANDS

note:  the default switch(es) for each command are 
       denoted by a right angle bracket (ie., ">")

The following commands are available to CMS users:

CMS ANNOTATE

Creates an element listing  (element-name.ANN)  in
your connected directory.  This listing includes the
element history and an annotated listing.

     CMS ANNOTATE element-name

          Command Switches
	__________________

          /APPEND                       
        > /NOAPPEND
        > /LOG
          /NOLOG
          /OUTPUT[:file-spec]           
        > /NOOUTPUT

          Element Switches
	__________________

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

        > /GENERATION:1+


CMS COPY ELEMENT

Duplicates an existing library element  (including
generation  history and file attributes) to form a
new element.

     CMS COPY ELEMENT old-element-name 
       filename.typ [filename.typ ... ] "remark"

          Command Switches
	__________________

        > /LOG
          /NOLOG                        


CMS CREATE CLASS

Establishes a class name.  Once a  class  name  is
established,  any  set of element generations (one
generation per element)  can  be  placed  in  that
class with CMS INSERT commands.

     CMS CREATE CLASS class-name "remark"

          Command Switches
          __________________

        > /LOG
          /NOLOG


CMS CREATE ELEMENT

Establishes the first generation of an element  by
copying a file(s) from your working directory into
the CMS library.   By  default,  CMS  deletes  all
working directory copies.

     CMS CREATE ELEMENT filename.typ 
       [,filename.typ ... ] "remark"

          Command Switches 
          __________________

          /KEEP
        > /NOKEEP
        > /LOG
          /NOLOG
          /RESERVE
        > /NORESERVE

          File Switches
          _______________

          /HISTORY[:"string"]
        > /NOHISTORY
          /NOTES:"string"
        > /NONOTES
          /POSITION:n


CMS DELETE CLASS

Deletes the specified class name provided that  no
elements belong to the class.

     CMS DELETE CLASS class-name "remark"

          Command Switches 
          __________________

        > /LOG
          /NOLOG


CMS DELETE ELEMENT /ALL

Deletes all generations of an established  element
from the library, provided that the element is not
reserved and that no generations  of  the  element
belong to any established classes.

     CMS DELETE ELEMENT /ALL element-name "remark"


          Command Switches
          __________________

        > /LOG
          /NOLOG


CMS DIFFERENCES

Compares the contents of two files and  creates  a
working  directory listing (file1.DIF) showing all
lines that differ.

     CMS DIFFERENCES file1 file2

          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
        > /LOG
          /NOLOG
          /OUTPUT:file3
        > /NOOUTPUT
          /PARALLEL
        > /NOPARALLEL
          /WIDTH:n


CMS FETCH

Delivers  a  copy   of   the   specified   element
generation to your working directory.  The element
is  not  reserved  and  therefore,   the   fetched
generation can not be replaced.

     CMS FETCH element-name "remark"

          Element Switches  
          __________________

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

        > /GENERATION:1+

                         element-generation-number [+]
          /MERGE:
                         class-name [+]

        > /NOMERGE
          /NOHISTORY
        > /LOG
          /NOLOG         
          /NONOTES       


HELP CMS

Provides online CMS documentation.


CMS INITIALIZE

Loads  an  empty  directory   with   CMS   control
files, creating a CMS library.  Subsequent DEC/CMS
commands refer to this CMS library.

     CMS INITIALIZE directory-spec "remark"

          Command Switches
          __________________

        > /LOG
          /NOLOG


CMS INSERT

Places an element generation in a class.

     CMS INSERT element-name class-name "remark"

          Command Switches
          __________________

          /IF-ABSENT
        > /LOG
          /NOLOG
          /SUPERSEDE
        > /NOSUPERSEDE

          Element Switches
          __________________

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

        > /GENERATION:1+


CMS REMOVE

Eliminates an element generation from a class.

     CMS REMOVE element-name class-name "remark"

          Command Switches
          __________________

          /IF-PRESENT
        > /LOG
          /NOLOG


CMS REPLACE

Returns the most  recent  version  of  a  reserved
element   from   your  working  directory  to  the
library.  By default, your  reservation  ends  and
DEC/CMS deletes all working directory versions.

     CMS REPLACE element-name "remark"

          Command Switches
          __________________

          /KEEP
        > /NOKEEP
        > /LOG
          /NOLOG
          /RESERVE
        > /NORESERVE

          Element Switches
          __________________

          /VARIANT:variant-letter
        > /NOVARIANT


CMS RESERVE

Delivers  a  copy   of   the   specified   element
generation to your working directory and marks the
element reserved.

     CMS RESERVE element-name "remark"

          Element Switches
          __________________

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

        > /GENERATION:1+

          /NOHISTORY
        > /LOG
          /NOLOG

                         element-generation-number [+]
          /MERGE:
                         class-name [+]

        > /NOMERGE

          /NONOTES


CMS SET ATTRIBUTE

Changes the attributes of  an  element  file  from
those  established  with  the  CMS  CREATE ELEMENT
command or  with  a  previous  CMS  SET  ATTRIBUTE
command.

     CMS SET ATTRIBUTE filename.typ "remark"

          Command Switches
          __________________

        > /LOG
          /NOLOG

          File Switches
          _______________

          /HISTORY[:"string"]
        > /NOHISTORY
          /NOTES:"string"
        > /NONOTES
          /POSITION:n


CMS SET CLASS /[NO]READ-ONLY

Establishes the READ-ONLY or NOREAD-ONLY attribute
of a class.

     CMS SET CLASS class-name /[NO]READ-ONLY
       "remark"

          Command Switches
          __________________

        > /LOG
          /NOLOG


CMS SET LIBRARY

Identifies  an  existing  CMS  library   so   that
subsequent  CMS  commands  refer  to the specified
library.

     CMS SET LIBRARY directory

          Command Switches
          __________________

        > /LOG
          /NOLOG



CMS SHOW ANCESTORS

Displays the transaction records of the  specified
element generation and all preceding generations.

     CMS SHOW ANCESTORS element-name

          Switches
          __________

          /APPEND
        > /NOAPPEND
          /CLASS
        > /NOCLASS
          /OUTPUT[:file-spec]
        > /NOOUTPUT

          Element Switches
          __________________

                         element-generation-number
          /FROM:
                         class-name

        > /FROM:1

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

        > /GENERATION:1+


CMS SHOW CLASS

Displays a  listing  of  all  established  library
classes.

     CMS SHOW CLASS [class-name]

          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /OUTPUT[:file-spec]
        > /NOOUTPUT


CMS SHOW DESCENDANTS

Displays the transaction records of the  specified
element generation and all succeeding generations.

     CMS SHOW DESCENDANTS element-name

          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /CLASS
        > /NOCLASS
          /OUTPUT[:file-spec]
        > /NOOUTPUT

          Element Switches
          __________________

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

        > /GENERATION:1


CMS SHOW ELEMENT

Displays a listing of all library elements and the
files within the elements.


                        element-name
     CMS SHOW ELEMENT 
                        *.*


          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /FORMAT:"string"
        > /NOFORMAT
          /OUTPUT[:file-spec]
        > /NOOUTPUT

          Element Switches  
          __________________

          /GENERATION:class-name 
          (used only with *.* parameter)


CMS SHOW GENERATION

Displays the transaction  record  for  a  specific
generation, or the names and generation numbers of
all element generations in a specified class.


     CMS SHOW GENERATION element-name

     CMS SHOW GENERATION *.* /BRIEF
     /GENERATION:class-name


          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /BRIEF
          (used only with *.* parameter)
          /CLASS
        > /NOCLASS
          /OUTPUT[:file-spec]
        > /NOOUTPUT

          Element Switches
          __________________

                         element-generation-number [+]
          /GENERATION:
                         class-name [+]

          (class name required with *.* parameter)


CMS SHOW HISTORY

Displays  a chronological  listing of all DEC/CMS
transactions that affect the library.

     CMS SHOW HISTORY [element-name]

          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /OUTPUT[:file-spec]
        > /NOOUTPUT
          /SINCE:date
          /UNUSUAL
        > /NOUNUSUAL

          (If the /SINCE Switch is not
          specified,
          CMS SHOW HISTORY displays all
          transactions
          since library creation.)


CMS SHOW LIBRARY

Displays  the  directory  specification  of   your
current DEC/CMS library.

     CMS SHOW LIBRARY

          Command Switches
          __________________

          /APPEND

        > /NOAPPEND
          /OUTPUT[:file-spec]
        > /NOOUTPUT


CMS SHOW RESERVATIONS

Displays a listing of all current reservations and
concurrent replacements.

     CMS SHOW RESERVATIONS [element-name]

          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /OUTPUT[:file-spec]
        > /NOOUTPUT


CMS SHOW VERSION

Displays the current version number of DEC/CMS.

     CMS SHOW VERSION

          Command Switches
          __________________

          /APPEND
        > /NOAPPEND
          /OUTPUT[:file-spec]
        > /NOOUTPUT


CMS UNRESERVE

Cancels an existing reservation.

     CMS UNRESERVE element-name "remark"

          Command Switches
          __________________

          /DELETE
        > /NODELETE
        > /LOG
          /NOLOG


CMS VERIFY

Performs a series of consistency  checks  on  your
CMS  library  to  confirm  that  all  elements are
present and are stored properly.


     CMS VERIFY

          Command Switches
          __________________

        > /LOG
          /NOLOG
          /RECOVER
        > /NORECOVER
          /REPAIR
        > /NOREPAIR










             SETTING UP A DEC/CMS LIBRARY

     1.  Create and protect a directory:

              @ BUILD <LEWIS.MYLIB>
	      @@DIRECTORY-GROUP n
	      @@GENERATIONS 2
              @@PROTECTION 775400
	      @@WORKING n
    	      @@PERMANENT n

          n = a value you provide


     2.  Initialize the directory as a DEC/CMS library:

              @ CMS INITIALIZE <LEWIS.MYLIB> "remark"


     3.  Access the library in a later session:

              @ CMS SET LIBRARY <LEWIS.MYLIB>