PRS(1s,C) AIX Commands Reference PRS(1s,C) ------------------------------------------------------------------------------- prs PURPOSE Displays a Source Code Control System (SCCS) file. SYNTAX +-----------------+ +--------------------------+ prs ---| +-------------+ |--| one of |--- file ---| | | -a | | | +- -rSID ----+ +----+ | ^ | +-| -d "string" |-+ +-| |---| -e |--+ +--------+ ^+-------------+| | | | -l | +---------------+ +- -ccutoff -+ +----+ 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 recognized 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. Figure 5 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). Processed July 12, 1991 PRS(1s,C) 1 PRS(1s,C) AIX Commands Reference PRS(1s,C) +-------------------------------------------------------------+ |Figure 5 (Page 1 of 2). Delta Table Keywords for 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 | | | +--------+---------------------------+---------------+--------+ Processed July 12, 1991 PRS(1s,C) 2 PRS(1s,C) AIX Commands Reference PRS(1s,C) +-------------------------------------------------------------+ |Figure 5 (Page 2 of 2). Delta Table Keywords for SCCS File | +--------+---------------------------+---------------+--------+ |Keyword | Data Represented | Value | Format | +--------+---------------------------+---------------+--------+ |:Dg: | Sequence numbers of | :DS:... | Simple | | | deltas ignored | | | +--------+---------------------------+---------------+--------+ |:DI: | Sequence numbers of | :Dn:/:Dx:/:Dg:| Simple | | | deltas included, | | | | | excluded, and ignored | | | +--------+---------------------------+---------------+--------+ |: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 | +--------+---------------------------+---------------+--------+ |:C: | Comments for delta | text | Multi | +--------+---------------------------+---------------+--------+ Figure 6 lists the keywords associated with the header flags in the SCCS file. For more information of Header flags, see Figure 2. +-------------------------------------------------------------+ |Figure 6 (Page 1 of 2). Header Flag Keywords for SCCS File | +--------+---------------------------+---------------+--------+ |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 | +--------+---------------------------+---------------+--------+ Processed July 12, 1991 PRS(1s,C) 3 PRS(1s,C) AIX Commands Reference PRS(1s,C) +-------------------------------------------------------------+ |Figure 6 (Page 2 of 2). Header Flag Keywords for SCCS File | +--------+---------------------------+---------------+--------+ |Keyword | Data Represented | Value | | | | | | Format | +--------+---------------------------+---------------+--------+ |: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 | +--------+---------------------------+---------------+--------+ |:FL: | Header flag list | text | Multi | +--------+---------------------------+---------------+--------+ Figure 7 lists the keywords associated with other parts of the SCCS file. +-------------------------------------------------------------+ |Figure 7. Other Keywords for SCCS File | +--------+---------------------------+---------------+--------+ |Keyword | Data Represented | Value | | | | | | Format | +--------+---------------------------+---------------+--------+ |:UN: | user names | text | Multi | +--------+---------------------------+---------------+--------+ |:FD: | descriptive text | text | Multi | +--------+---------------------------+---------------+--------+ |:BD: | body of text | text | Multi | +--------+---------------------------+---------------+--------+ |:GB: | text in a g-file | text | Multi | +--------+---------------------------+---------------+--------+ |: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 | +--------+---------------------------+---------------+--------+ Processed July 12, 1991 PRS(1s,C) 4 PRS(1s,C) AIX Commands Reference PRS(1s,C) FLAGS Each flag or group of flags applies independently to each named file. -a Writes information for the specified deltas, whether they have been removed (see "rmdel"). If you do not specify the -a flag, prs supplies information only for the specified deltas that have not been removed. -ccutoff Specifies a cutoff date and time for the -e and -l flags. Specify cutoff in the following 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 separate the fields with any non-numeric characters. For example, you can specify "-c84/2/20,9:22:25" or "-c84/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 quotation marks. -e Requests information for all deltas created earlier than and including the delta specified 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????? Temporary prs files. RELATED INFORMATION See the following commands: "admin," "delta," "get," and "sccshelp." See the sccsfile file in AIX Operating System Technical Reference. See the discussion of SCCS in AIX Operating System Programming Tools and Interfaces. Processed July 12, 1991 PRS(1s,C) 5