Current Supported Releases: Sablime^® v6.0 & v5.2

NAME
     nrmdel - remove a version from an SBCS file

SYNOPSIS
     nrmdel [-sNRY] [-m mr-list] [-r sid] [-y comment] s-file ...

DESCRIPTION
     nrmdel is used to remove versions from an SBCS files, or  s-
     files  (see  nadmin(1)).   The version to be removed must be
     specified by its SBCS identifier (SID, see nget(1)), or  its
     name.

     A command line begins with option arguments  and  ends  with
     s-file  arguments.   s-file  arguments  can be any mix of s-
     files, directories and a single - character (see nadmin(1)).

     For each valid s-file, nrmdel will verify that the specified
     version  is  a  leaf version (i.e. the last of its branch or
     the last of the trunk) and that it is not currently out  for
     edit.  If those conditions are met the version delta body is
     removed from the s-file  and  the  SID  of  the  version  is
     displayed.  This SID becomes available for future deltas.

     The version's MR list and comments are preserved and a  line
     is added on top of existing comments
          *** DELTA REMOVED *** yy/mm/dd HH/MM/SS user
     Additional MRs and comments can be provided. If  the  s-file
     requires  MRs  for  creating deltas it will also require MRs
     for removing them.  Only the nadmin -y~e command can  remove
     the  MR  list  and  comments.   A  version is not completely
     removed. There remains a delta header record including  date
     and  time  of  creation,  author,  initial  SID and sequence
     number. The sequence number is not freed, unless the  s-file
     is  passed  through ncomb(1).  nprs(1) -a generates informa-
     tion on removed deltas.

     nrmdel only removes leaf versions.  Branches can be  removed
     by repeated applications of nrmdel.

OPTIONS
     -s   Silent mode. Do not display the SID  or,  for  multiple
          s-files, the s-file name. Warnings are also suppressed.
          Error messages are unaffected.  See also -Y.

     -N   No  execution.  Simply  prints  the  s-files  that  are
          matched  by  the s-file arguments and that would other-
          wise be processed.

     -R   Recursive. If an s-file argument is a  directory,  des-
          cend  recursively  into  all its subdirectories looking
          for s-files.  This option is  also  controlled  by  the
          sbcsenv(1) variable recursive [= no].

SBCS Release 1.2    Last change: 1 April 1994                   1

     -Y   Yes to any y/n prompt.  The only y/n prompt that  could
          occur is a prompt to restore the s-file from its backup
          Z-file. nrmdel must already have  write  permission  in
          the  s-file  directory so any attempt to restore the s-
          file from the Z-file is expected to  succeed.   Without
          -Y,  a  command  invoked  with  -s  will  fail on a y/s
          prompt.

     -mmr-list
          Add these MRs to the version MR  list.  nrmdel  removes
          the  version  delta  body  but preserves the version MR
          list and all previous comments.  nrmdel, unlike ndelta,
          will not prompt on its own if the file requires MRs and
          none were provided. It  will  use  a  default  null  MR
          instead.   If  the  s-file has an MR validation program
          that does not accept null MRs, the  removal  will  fail
          and a proper MR will have to be provided.

     -rsid
          Specify the version to be removed. This can be  a  com-
          plete  SID,  or  the  form R.L or R.L.B.S, or a version
          name.

     -ycomment
          Specify an additional comment. nrmdel will on  its  own
          insert  a  default  comment  (see above). If additional
          comments are specified, they will be placed  above  the
          default  comment.   nrmdel,  unlike  ndelta,  will  not
          prompt on its  own  if  a  comment  was  not  provided,
          because is has its own default comment.

FILES
     z-file
          Transient lock file, created in the  s-file  directory;
          removed after completion.

     Z-file
          Backup file created by nrmdel and  removed  after  suc-
          cessful  completion.   May  exist  after  completion of
          nrmdel if the command ended unexpectedly.

NOTES
     Multiple Files
          nrmdel requires the  version  to  be  fully  specified.
          Unless  all  s-files  have synchronized SIDs, or unless
          the version to remove has a name, this will not  be  an
          effective multi file command.

     Multi-User
          nrmdel modifies the s-file.  When used in a  multi-user
          project,  ndelta  may  have  to  be  owned  by the SBCS
          administrator and set-UID (see nadmin(1) -  MULTI  USER

SBCS Release 1.2    Last change: 1 April 1994                   2

          ACCESS and sbcsproj(1)).

     Y/N Prompt
          An unexpected prompt to restore the  s-file  is  always
          possible.   Specifying  -Y provides a default y answer.
          Because the user must already have permission to modify
          the s-file, any restore is expected to succeed.

COMPARISON WITH SCCS
     SBCS only:
          The name of the removed SID is displayed; the -sNRY, -m
          mr-list  and  -y  comment  options are new; in addition
          only SBCS inserts a default comment when a  version  is
          removed.   SBCS  also  has a more general definition of
          s-file arguments.

DIAGNOSTICS
     Warning and error messages have error codes that can be used
     with nhelp for a more detailed explanation.

SEE ALSO
     nadmin(1), ncdc(1), ndelta(1), nget(1),  nhelp(1),  nprs(1),
     nrmdel(1), nsact(1), nunget(1), sbcsdiff(1), sbcsenv(1).

SBCS Release 1.2    Last change: 1 April 1994                   3

Return to SBCS Commands manpage index