Current Supported Releases: Sablime® v6.0 & v5.2
NAME
ncdc - change the delta comments in SBCS files
SYNOPSIS
ncdc [-NRY] [-m mr-list] [-r sid] [-t desc-file] [-v name]
[-y comment] s-file ...
DESCRIPTION
ncdc is used to (1) amend the comment and MR list of a sin-
gle version in each s-file. The version must be specified by
-r sid where sid is either the version SID or the version
name. ncdc can also be used to (2) set or change the name
of a version that has been reserved but not yet returned,
i.e. still recorded in the p-file. And finally ncdc can be
used to (3) add to the s-file descriptive text.
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)).
ncdc will perform one of the above three actions for all s-
files matched by the s-file arguments.
Comment and MR list.
This type of ncdc command is of the form
ncdc [-r sid] [-m mr-list] [-y comment] s.file
where neither -t nor -v is specified. Amending the MR
list requires that the s-file v mr-validation flag be
set. The original comment or MR list remains, but ncdc
adds the new one, appropriately identified. The amend-
ments can be done by the user who created the version
or by a user who currently owns the s-file or its
directory.
New version name.
This type of ncdc command is of the form
ncdc [-r sid] -v name s.file
where -v is specified but neither -t, -m nor -y. The
version must be in the p-file (i.e. being edited) and
have been reserved by the user now changing or setting
its name. The new name must not exist in the s-file or
elsewhere in the p-file. If the version already has
the required name, a warning is issued. When using
this mode, the version need not be specified by -r
because often there is only one p-file record for this
user and this determines the intended SID. However, if
there is ambiguity ncdc will fail and ask for the ver-
sion to be specified. The SID of the version renamed,
and the new name, are displayed.
Descriptive text.
If the ncdc command is of the form
SBCS Release 1.2 Last change: 1 April 1994 1
ncdc -t desc-file s.file,
where -t is specified but neither -v, -m nor -y, then
the text of file desc-file is appended to the descrip-
tive text. The complete descriptive text can be edited
only by the nadmin command.
OPTIONS
-r sid
The SBCS identifier (SID), or the name, of the version
to update. If ncdc is being used to amend the MR list
or the delta comment, the version must be identified.
If ncdc is being used to change a version name, then
the version must be gotten for edit by the user and
that information is recorded in the p-file and it is
usually not necessary to specify the -r. Finally, if
ncdc is adding to the descriptive text, -r cannot be
used.
-m mr-list
Add (or remove) this list of MR identifiers to the s-
file MR-list. The s-file must have its v flag set or
ncdc will fail. mr-list can be a single - character
(null MR) or a comma or blank separated list of MR
identifiers; if blanks are used, the list must be
quoted. An MR entry is added to the list unless it
begins with a !, in which case it is deleted from the
list. MRs added or removed from the MR list are also
incorporated into standard comments
*** LIST OF ADDED(DELETED) MRS ***
<added (deleted) mr-list>
and added to the version comment.
If -m is not used and the s-file requires MR (v flag
set) the prompt MRs? is issued on standard output and
standard input is read. Any MRs? prompt always pre-
cedes the comments? prompt (see -y option). The
interactive MR list is again blank or comma separated,
and is terminated by an unescaped new-line.
If the s-file v flag specifies a validation program,
all the MRs specified, including any ! prefix, will be
passed to this program for validation (see ndelta(1)).
The program is called with arguments 1 and 2 being the
g-file name and the module type ("" if none) and argu-
ments 3 and above representing the specified MRs. If
the validation program returns a non zero exit code, an
error message is issued and the s-file remains
unchanged.
The MR list remains sorted and unique at all times.
-t desc-file
SBCS Release 1.2 Last change: 1 April 1994 2
desc-file is the name of a file of text to append to
the file descriptive text (nadmin -t). The text is
appended to the original text after a line that identi-
fies the date, time and author:
*** ADDED *** yy/mm/dd hh/mm/ss user
desc-file can also be one of the tilde sequences ~e,
~r[file] or ~w[file], to interactively edit the text
that is to be appended, read it from file or write it
to file, respectively A null file implies stdout or
stdin. Note that an interactive edit (~e) locks the
s-file and should only be done with caution in a
multi-user environment.
-v name
Use name to rename a version that has not yet been
returned to the s-file. The target version will be
inferred from the user's p-file record for the s-file.
If this information is not enough, the user can specify
the version SID or name with the -r option. This
option cannot be used with either -m or -y; these amend
version already in the s-file. Only nadmin can edit
version names once they are in the s-file (nadmin
-r~e).
-y comment
This is the text amendment to the existing comment
text. ncdc does not replace the existing comment, but
it adds the new comment followed by a line of the form:
*** CHANGED *** yy/mm/dd hh/mm/ss user
above the existing comment. -y- specifies a null com-
ment, and has no effect.
If -y is not specified, the prompt comments? is issued
on standard output before standard input is read. An
unescaped new-line character terminates the interactive
comment text.
EXAMPLES
ncdc -r1.6 -m"BL7-123 !BL7-122 BL8-001" -y"new mr numbers" s-file
adds BL7-123 and BL8-001 to the MR list, removes BL7-122
from the MR list, and adds the comment "new mr numbers" to
version 1.6 in the s-file.
ncdc -r1.6 s-file
MRs? BL7-123 !BL7-122 BL8-001
comments? new mr numbers
does the same thing, and so would
ncdc -r1.6 s-file >/dev/null <<!
BL7-123 !BL7-122 BL8-001
new mr numbers
!
SBCS Release 1.2 Last change: 1 April 1994 3
FILES
z-file
Transient lock file, removed before ncdc terminates.
Z-file
Backup file for the s-file; created by ncdc, it may
exist after ncdc terminates if the command encountered
an unexpected condition. If it exists, the next SBCS
command will use it to restore the s-file.
NOTES
Multiple Files
ncdc requires the version to be fully specified.
Unless all s-files have synchronized SIDs, or unless
version names are used, this will not be an effective
multi-file command.
Multi-User
ncdc needs to modify the s-file or the p-file. When
used in a multi-user project, ncdc needs to run set-UID
with the SBCS administrator permissions. (see nad-
min(1) - MULTI USER ACCCESS 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.
Warning
If s-file names are supplied to the ncdc command via
standard input (- on the command line) then the -y and
-m (when required) options must also be used.
COMPARISON WITH SCCS
SBCS only:
The options -NRY, -t desc-text, -v name. SBCS has a
more general definition of s-file arguments and can
make use of the sbcsenv environment.
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), nedges(1), nget(1), nhelp(1),
nprs(1), nrmdel(1), nsact(1), nunget(1), sbcsenv(1).
SBCS Release 1.2 Last change: 1 April 1994 4
Return to SBCS Commands manpage index
Copyright © 2003
Lucent Technologies