Current Supported Releases: Sablime® v6.0 & v5.2
NAME
nprs - generate SBCS file reports
SYNOPSIS
nprs [-aelsNRY] [-c cutoff] [-d dataspec] [-r sid] file ...
DESCRIPTION
nprs retrieves information about an SBCS file, or s-file
(see nadmin(1)), and prints a report using a standard or
user-provided template.
The command line option arguments start with a - (see nad-
min(1)) The file arguments can be any mix of s-files, direc-
tories and a single - character. s-file or directory names
can be full or relative path names. If a file argument is a
directory, nprs will process all s-files in that directory.
Files from that directory that do not have the s. prefix are
ignored. If a file argument is the - character, nprs reads
its standard input for names of s-files and directories, one
name per line. File names read from standard input that do
not have the s. prefix are ignored.
OPTIONS
-a Include all versions, both regular deltas (type D) and
removed deltas (type R, see nrmdel(1)). Without the -a
option only information on existing versions is
printed.
-e Include only versions created earlier than, or match-
ing, the version specified by -r or the date specified
by -c.
-l Include only versions created later than, or matching,
the version specified by -r or the date specified by
-c.
-s Silent mode. If more than one s-file is specified, or
if the file argument is a directory or -, nprs identi-
fies each s-file by printing its name to standard out-
put, followed by the actual report. The -s option
suppresses the printing of the file names as well as
other nonerror warnings. Actual errors are not
affected.
-c cutoff
Use the date-time cutoff value. This is a string con-
taining from 1 to 6 fields of 2 digits each, of the
form YY[MM[DD[HH[MM[SS]]]]]
Fields omitted default to their maximum possible value
and nonnumeric characters may separate individual
fields. For example, -c7502, -c750228235959 and
SBCS Release 1.2 Last change: 1 April 1994 1
-c"93/11/15 9:22:25" are all equivalent. When spaces
are used, the string must be quoted.
This option requires one of -e or -l to be also speci-
fied.
-d dataspec
Use the dataspec string instead of the default as the
data and format specification for the report. The
string consists of regular text with embedded s-file
DATA keywords (see DATA KEYWORDS below); if the string
contains spaces it must be quoted. The default
dataspec is the built-in string
:Dt: [:V:]\t:DC:\nMRs:\n:MR:COMMENTS:\n:C:
It includes the version name, in brackets, and the
delta character counts. :DC: expands to n/m, where n
is the size, in characters, of the delta, and m is the
size of the full version. The size of the delta is the
size of the instructions needed by the SBCS differenc-
ing engine to recreate the full version from its prede-
cessor; it is not a direct measure of the size differ-
ence between two versions.
-r sid
If sid is a valid R.L or R.L.B.S SID (SBCS identifier),
nprs will report only on that version. If sid is a
partial SID, nprs will report only on the latest ver-
sion, trunk or branch, matching the SID components pro-
vided. If sid is a - (dash), only the most recent ver-
sion is used.
DATA KEYWORDS
The report extracted by dataspec consists of: (1) user-
supplied text which is any dataspec text that is not recog-
nized as a DATA keyword; (2) values from the s-file, substi-
tuted for dataspec DATA keywords. A DATA keyword is substi-
tuted inline if it is Simple (S) or as multiline text ending
with a new-line if it is Multi-line (M).
A tab can be specified by \t and a new-line by \n. These
characters have to be escaped or quoted to survive parsing
by the shell. See the -d option, above, for the default
built-in dataspec.
SBCS Release 1.2 Last change: 1 April 1994 2
Table 1. nprs DATA Keywords
Keyword Data Item Value Format
___________________________________________________________________________
:A: A what string :Z::Y: :M: :I::Z: S
:B: Branch number nnnn S
:BF: Branch flag yes or no S
:C: Comments for Version text M
:Cd: Char size of delta num S
:Cs: Char size of version num S
:CB: Ceiling boundary :R: S
:D: Date Version created :Dy:/:Dm:/:Dd: S
:DC: Delta character statistics :Cd:/:Cs: S
:DF: Delta flag(*) :DT:[bd][cn ] S
:DP: Predecessor Delta seq-no. nnnn S
:DS: Delta sequence number nnnn S
:DT: Delta type(**) D or R S
:Dm: Month Delta created nn S
:Dd: Day Delta created nn S
:Ds: Default SID :I: S
:Dt: Delta text info.(***) See below S
:Dy: Year Delta created nn S
:F: s-file name text S
:FB: Floor boundary :R: S
:FD: File descriptive text text M
:FL: Flag list text M
:GB: Gotten body text M
:I: SBCS ID string (SID) :R:.:L:.:B:.:S: S
:J: Joint edit flag yes or no S
:KF: Keyword error/warning flag yes or no S
:KV: Keyword validation string yes or no S
:L: Level number nnnn S
:LK: Locked releases :R:... S
___________________________________________________________________________
(*) :DF: = :DT:[b(ase) or d(elta)][c(ompressed), n(ull delta) or other]
(**) :DT: = D(elta, i.e., regular) or R(emoved)
(***) :Dt: = :DT: :I: :D: :T: :P: :DS: :DP:
SBCS Release 1.2 Last change: 1 April 1994 3
Table 1 (cont'd). nprs DATA Keywords
Keyword Data Item Value Format
________________________________________________________
:M: Module name text S
:MF: MR validation flag yes or no S
:MP: MR validation pgm name text S
:MR: MR numbers for Version text M
:ND: Null delta flag yes or no S
:P: Version Creator ID logname S
:PN: SBCS file path name text S
:Q: User-defined keyword text S
:R: Release number nnnn S
:S: Sequence number nnnn S
:T: Time Version created :Th:::Tm:::Ts: S
:Th: Hour Version created nn S
:Tm: Minutes Version created nn S
:Ts: Seconds Version created nn S
:UN: User names text M
:V: The version name text S
:W: A what string :Z::M:\t:I: S
:WC: Base compression yes or no S
:WV: Compression scheme "b|d" S
:X: Binary file flag yes or no S
:Y: Module type flag text S
:YV: Delta scheme "f|d|r" S
:Z: what string prefix @(#) S
________________________________________________________
EXAMPLES
The following are possible nprs reports ($ is the UNIX
prompt):
$ nprs -d"Users and/or user IDs for :F: are:\n:UN:" s.file
Users and/or user IDs for s.file are:
xyz
131
abc
Also,
$ nprs -d"Latest :M: version: :I: Created :D: By :P:" -r- s.main.c
Latest main.c version: 3.7 Created 92/12/01 By cas
And the special case:
$ nprs s.file
D 1.1 92/12/1 00:00:00 cas 1
MRs:
bl78-12345
bl79-54321
COMMENTS:
this is the comment line for the main.c initial version
...
SBCS Release 1.2 Last change: 1 April 1994 4
Similar information is produced for each delta table entry
of the D type.
FILES
prs.xNNNNN
Temporary file are created in the temporary directory
specified in the SBCS environment, and are removed
before the command terminates.
NOTES
Multiple Files
nprs usually needs the delta to be specified, and when
it doesn't, it tends to produce output for many deltas
from each s-file.
Multi-User
nprs only needs to read the s-files and should not run
as a set-UID program.
Y/N Prompts
COMPARISON WITH SCCS
SCCS only:
The line oriented DATA keywords used by SBCS are not
supported by SBCS.
SBCS only:
New DATA keywords: release 1.0 introduced :WC: and
:X:; release 1.2 introduces :Cd:, :Cs:, :DC: to support
delta character sizes, :DF: for more complete delta
flag, :V: for the version name, :WV: and :YV: for the
string value of the compression and delta schemes,
respectively.
Differences:
The default dataspec includes the version name, in
brackets, and the delta character statistics. In SCCS
it includes the line count statistics.
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), sidtree(1).
SBCS Release 1.2 Last change: 1 April 1994 5
Return to SBCS Commands manpage index
Copyright © 2003
Lucent Technologies