prs
PURPOSE
Displays a Source Code Control System (SCCS) file.
SYNOPSIS
prs [-d[dataspec]] [-r[SID]] [-c[cutoff]] [-e] [-l] [-a] files
DESCRIPTION
The prs command reads files, and writes to standard
output a part or all of a Source Code Control System
(SCCS) file. If you specify a directory in place of
file, prs performs the requested actions on all SCCS
files (those with a name that has the s. prefix). If you
specify a - (minus) in place of file, prs reads standard
input and interprets each line as the name of an SCCS
file. prs continues to take input until it reads an end-
of-file character (Ctrl-D).
Data Keywords
Data keywords specify which parts of an SCCS file are to
be retrieved and written to standard output. All parts
of an SCCS file have an associated data keyword. There
is no limit to the number of times a data keyword can
appear in a string. The information that prs displays
consists of user-supplied text and appropriate values
(extracted from the SCCS file) substituted for the recog-
nized data keywords in the order of appearance in string.
The format of a data keyword value is either simple, in
which the keyword substitution is direct, or multi-line,
in which the substitution is followed by a carriage
return. Text is any characters other than recognized
data keywords. Specify a tab character with \t and a
carriage return/new-line character with a \n. Remember
to quote the \t and \n with an extra \ to prevent shell
from interpreting the \ and just passing a t or n to prs
as text.
The following table lists the keywords associated with
information in the delta table in the SCCS file (see the
sccsfile file in AIX Operating System Technical Reference
for the structure of an SCCS file).
+---------+---------------------------+---------------+---------+
| Keyword | Data Represented | Value | Format |
+---------+---------------------------+---------------+---------+
| :R: | Release number | num | Simple |
+---------+---------------------------+---------------+---------+
| :L: | Level number | num | Simple |
+---------+---------------------------+---------------+---------+
| :B: | Branch number | num | Simple |
+---------+---------------------------+---------------+---------+
| :S: | Sequence number | num | Simple |
+---------+---------------------------+---------------+---------+
| :I: | SCCS ID string (SID) | :R::L::B::S: | Simple |
+---------+---------------------------+---------------+---------+
| :Dy: | Year delta created | YY | Simple |
+---------+---------------------------+---------------+---------+
| :Dm: | Month delta created | MM | Simple |
+---------+---------------------------+---------------+---------+
| :Dd: | Day delta created | DD | Simple |
+---------+---------------------------+---------------+---------+
| :D: | Date delta created | YY/MM/DD | Simple |
+---------+---------------------------+---------------+---------+
| :Th: | Hour delta created | HH | Simple |
+---------+---------------------------+---------------+---------+
| :Tm: | Minute delta created | MM | Simple |
+---------+---------------------------+---------------+---------+
| :Ts: | Second delta created | SS | Simple |
+---------+---------------------------+---------------+---------+
| :T: | Time delta created | HH:MM:SS | Simple |
+---------+---------------------------+---------------+---------+
| :DT: | Delta type | D or R | Simple |
+---------+---------------------------+---------------+---------+
| :P: | User who created the | login name | Simple |
| | delta | | |
+---------+---------------------------+---------------+---------+
| :DS: | Delta sequence number | num | Simple |
+---------+---------------------------+---------------+---------+
| :DP: | Previous delta sequence | num | Simple |
| | number | | |
+---------+---------------------------+---------------+---------+
| :Dt: | Delta information | :DT::I::D: | Simple |
| | | :T::P::DS::DP:| |
+---------+---------------------------+---------------+---------+
| :Dn: | Sequence numbers of | :DS: . . . | Simple |
| | deltas included | | |
+---------+---------------------------+---------------+---------+
| :Dx: | Sequence numbers of | :DS: . . . | Simple |
| | deltas excluded | | |
+---------+---------------------------+---------------+---------+
| :Dg: | Sequence numbers of | :DS: . . . | Simple |
| | deltas ignored | | |
+---------+---------------------------+---------------+---------+
| :DI: | Sequence numbers of | :Dn:/:Dx:/:Dg:| Simple |
| | deltas included, | | |
| | excluded, and ignored | | |
+---------+---------------------------+---------------+---------+
Figure 7 (Part 1 of 2). Delta Table Keywords
+---------+---------------------------+---------------+---------+
| Keyword | Data Represented | Value | Format |
+---------+---------------------------+---------------+---------+
| :Li: | Lines inserted by Delta | num | Simple |
+---------+---------------------------+---------------+---------+
| :Ld: | Lines deleted by Delta | num | Simple |
+---------+---------------------------+---------------+---------+
| :Lu: | Lines unchanged by Delta | num | Simple |
+---------+---------------------------+---------------+---------+
| :DL: | Delta line statistics | :Li:/:Ld:/:Lu:| Simple |
+---------+---------------------------+---------------+---------+
| :MR: | MR numbers for delta | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
| :C: | Comments for delta | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
Figure 7 (Part 2 of 2). Delta Table Keywords
The following table lists the keywords associated with
the header flags in the SCCS file. For more information
of Header flags, see Figure 1.
+---------+---------------------------+---------------+---------+
| Keyword | Data Represented | Value | Format |
+---------+---------------------------+---------------+---------+
| :Y: | module type | text | simple |
+---------+---------------------------+---------------+---------+
| :MF: | MR validation flag set | yes or no | Simple |
+---------+---------------------------+---------------+---------+
| :MP: | MR validation program | text | Simple |
| | name | | |
+---------+---------------------------+---------------+---------+
| :KF: | Keyword/error warning | yes or no | Simple |
| | flag set | | |
+---------+---------------------------+---------------+---------+
| :BF: | Branch flag set | yes or no | Simple |
+---------+---------------------------+---------------+---------+
| :J: | Joint edit flag set | yes or no | Simple |
+---------+---------------------------+---------------+---------+
| :LK: | Locked releases | :R: . . . | Simple |
+---------+---------------------------+---------------+---------+
| :Q: | User defined keyword | text | Simple |
+---------+---------------------------+---------------+---------+
| :M: | Module name | text | Simple |
+---------+---------------------------+---------------+---------+
| :FB: | Floor boundary | :R: | Simple |
+---------+---------------------------+---------------+---------+
| :CB: | Ceiling boundary | :R: | Simple |
+---------+---------------------------+---------------+---------+
| :Ds: | Default SID | :I: | Simple |
+---------+---------------------------+---------------+---------+
| :ND: | Null Delta flag set | yes or no | Simple |
+---------+---------------------------+---------------+---------+
Figure 8 (Part 1 of 2). Header Flag Keywords
+---------+---------------------------+---------------+---------+
| Keyword | Data Represented | Value | Format |
+---------+---------------------------+---------------+---------+
| :FL: | Header flag list | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
Figure 8 (Part 2 of 2). Header Flag Keywords
The following table lists the keywords associated with
other parts of the SCCS file.
+---------+---------------------------+---------------+---------+
| Keyword | Data Represented | Value | Format |
+---------+---------------------------+---------------+---------+
| :UN: | user names | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
| :FD: | descriptive text | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
| :BD: | body of text | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
| :GB: | text in a g-file | text | Multi- |
| | | | line |
+---------+---------------------------+---------------+---------+
| :W: | a what string | :Z::M: \tab | Simple |
| | | :I: | |
+---------+---------------------------+---------------+---------+
| :A: | a what string | :Z::Y::M::I::Z| Simple |
+---------+---------------------------+---------------+---------+
| :Z: | a what string delimiter | "@(#)" | Simple |
+---------+---------------------------+---------------+---------+
| :F: | SCCS file name | text | Simple |
+---------+---------------------------+---------------+---------+
| :PN: | SCCS file path name | text | Simple |
+---------+---------------------------+---------------+---------+
Figure 9. Other Keywords
FLAGS
Each flag or group of flags applies independently to each
named file.
-a Writes information for the specified deltas,
whether or not they have been removed (see
"rmdel"). If you do not specify the -a flag,
prs supplies information only for the speci-
fied deltas that have not been removed.
-ccutoff Specifies a cutoff date and time for the -e
and -l flags. Specify cutoff in the fol-
lowing form:
YY[MM[DD[HH[MM[SS]]]]]
All omitted items default to their maximum
values, so specifying "-c8402" is the same as
specifying "-c840229235959". You can sepa-
rate the fields with any non-numeric charac-
ters. For example, you can specify
"-c84/2/20,9:22:25" or "-c"84/2/20 9:22:25""
or ""-c84/2/20 9:22:25"".
-d"string" Specifies the data items to be displayed.
string is a string consisting of optional
text and SCCS file data keywords. You must
enclose all text and spaces in string in quo-
tation marks.
-e Requests information for all deltas created
earlier than and including the delta speci-
fied by the -r flag.
-l Requests information for all deltas created
later than and including the delta specified
by the -r flag.
-rSID Specifies the SID of a delta for which prs
will retrieve information. If no SID is
specified, prs retrieves the information for
the SID of the highest numbered delta.
FILES
/tmp/pr?????
RELATED INFORMATION
The following commands: "admin," "delta," "get," and
"help."
The sccsfile file in AIX Operating System Technical Ref-
erence.
The discussion of SCCS in AIX Operating System Program-
ming Tools and Interfaces.