system newconf - create a new system configuration


      system newconf [-f] [-v] [-nco] [-r rev] [[-w] [-b] [-k] [-br b_rev]
      [-nrl]] [system ] [old_configuration] [new_configuration]


      The system newconf command creates a new configuration (release)
      structure under the system directory. The new configuration is copied
      from an old one, so that it looks exactly the same as the old
      configuration after the creating. The files are, however, not copied,
      but links to them are created. The directory structure of the new
      configuration is the same as for the old one. This directory structure
      should be later used for an integration of the new release. The
      directory structure below is created. Default is to create it on
      /ipa/systems, it can be created on another root by using the
      environment variable SDE_SYSTEMS. This example uses /ipa/systems:

           The system name.

           The name of an existing system configuration.

           The name of the configuration to be created.

      -f   Execute the command directly without asking for parameters.

      -v   Shows which directories have been created. List all the
           subsystems that are initiated and all the files copied to the new
           RCS libraries.

      -nco Do not check out files from the RCS libraries when the
           configuration is created. Default is to check out the files.

      -r rev
           Select the latest version of files whose number is less than or
           equal to rev. If rev indicates a branch rather than a version,
           the latest version on that branch is retrieved. If option -r is
           omitted then the name of the old configuration is taken as rev.
           In the case that the configuration is specified as x.y-z, where
           x,y and z are numbers, the corresponding symbolic name will be
           Rx_y_z.  If rev is specified as latest than the latest versions
           of the files will be copied to the new RCS libraries.  Otherwise,
           a version is composed of one or more numeric or symbolic fields
           separated by periods.

      -w   Initiate the new configuration. For each subsystem creates a new
           RCS library (instead of having a symbolic link to the original
           library), and copies a particular version of files to the new

      -k   Do not remove the versions after the selected version of each
           copied file, from the RCS library (RCS/file,v). The default is to
           only save the selected version of the file in the RCS library.
           Status and eventual name are set on the selected version of the

      -nrl Do not remove eventual lock from each file, warning messages will
           be sent for this version of the file. The option may be useful
           together with -k option, when the locked version is a version
           that should be kept anyway.  Default is to remove the lock from
           the file version, and remove the file version if it is not

      -b   Create a branch for all files in the directory. The branch is
           created from the copied file version.  Default is to create it as
           the first branch from the file version, if a branch already exist
           from this file version, a new branch is created with an
           incremented branch number.

           The first version in the branch has the same file contents as the
           copied file version.  The file version in the branch will have
           the state specified by the option -S.

           The created branch is set to default, i.e. the files will be
           checked out and checked in to this branch by default, without
           giving any revision number.

           Used with the -w option.

      -br branch_rev
           Same as -b. The only difference is that all files will have the
           revision specified by branch_rev.

           Used with the -w option.


      $ system newconf -nco

      System name: ex_system
      Old Configuration: 1.0-0
      New Configuration: 1.1-0

      System ex_system configuration 1.1-0 is created

      system newconf -w -r latest 1.0-0 1.1-0

      creates a new configuration and initiates it. The latest versions of
      files from 1.0-0 are copied to the 1.1-0 configuration.

      system newconf -w -r latest -b 1.0-0 1.1-0

      creates a new configuration and initiates it. The latest versions of
      files from 1.0-0 are copied to the 1.1-0 configuration, all files will
      have a branch in the new configuration.


      Ivica Crnkovic, Elisabet de Waal