sccsfile
Purpose
Contains the Source Code Control System (SCCS) informa-
tion.
Description
The SCCS file is an ASCII file consisting of the fol-
lowing six logical parts:
checksum The sum value of all characters, except the
characters in the first line.
delta table Information about each delta including type,
SCCS identification (SID) date and time of
creation, and comments.
user names Login names and numerical group IDs, or
both, of users who are allowed to add or
remove deltas from the SCCS file.
flags Definitions of internal keywords.
comments Descriptive information about the file.
body The actual text lines intermixed with
control lines.
There are lines throughout an SCCS file that begin with
the ASCII SOH (start of heading) character (octal 001).
This character is called the control character and is
represented graphically as @ (at sign) in the following
text. Any line described in the following text not shown
beginning with the control character cannot begin with
the control character.
The DDDDD entries represent a 5-digit string (a number
from 00000 to 99999).
The following describes each logical part of an SCCS
file.
Checksum
The checksum is the first line of an SCCS file. The
value of the checksum is the sum of all characters,
except those of the first line. The @h designates a
magic number of 064001 octal (or 0x6801). The format of
the line is:
@hDDDDD
Delta Table
The delta table consists of a variable number of entries
such as:
@sDDDDD/DDDDD/DDDDD
@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD
DDDDD
@i DDDDD . . .
@x DDDDD . . .
@g DDDDD . . .
@m <MR number>
.
@c <comments> . . .
.
@e
@s The first line which contains the number of lines
inserted or deleted or unchanged respectively.
@d The second line which contains:
o The type of delta. D designates normal delta
and R designates removed.
o The SCCS ID (SID) of the delta.
o The date and time the delta was created.
o The login name that corresponds to the real user
ID at the time the delta was created.
o The serial numbers of the delta and its prede-
cessor.
@i Contains the serial numbers of the deltas included.
This line is optional.
@x Contains the serial numbers of deltas excluded. This
line is optional.
@g Contains the serial numbers of the deltas ignored.
This line is optional.
@m Optional lines, each one containing one modification
request (MR) number associated with the delta.
@c Comment lines associated with the delta.
@e Ends the delta table entry.
User Names
The list of login names and numerical group IDs, or both,
of users who can add deltas to the file, separated by
new-line characters. The bracketing lines @u and @U sur-
round the lines containing the list. An empty list
allows any user to make a delta.
Flags
Flags are keywords used internally in the system. For
more information about their use, see the admin command
in AIX Operating System Commands Reference. The format
of each flag line is:
@f <flag> <optional text>
The following flags are defined:
@ft <type of program>
@fv <program name>
@fi
@fb
@fm <module name>
@ff <floor>
@fc <ceiling>
@fd <default-sid>
@fn
@fj
@fl <lock-releases>
@fq <user defined>
The flags are used as follows:
b Allows the use of the -b option on the get command to
cause a branch in the delta tree.
c Defines the highest release number that can be
retrieved by a get command for editing. This release
number must be less than or equal to 9999, and its
default value is 9999. This release number is called
the ceiling release number.
d Defines the default SID to be used when one is not
specified with a get command.
f Defines the lowest release number that can be
retrieved by a get command for editing. This release
number must be between 0 and 9999, and its default
value is 1. This release number is called the floor
release number.
i Controls the error warning message "No ID keywords".
When this flag is not present, this message is only a
warning. When this flag is present, the file is not
used and the delta is not made.
j Causes the get command to allow concurrent edits of
the same base SID.
l Defines a list of releases that cannot be edited with
get using the -e flag.
m Defines the first choice for the replacement text of
the %M% identification keyword.
n Causes the delta command to insert a delta that
applies no changes for those skipped releases when a
delta for a new release is made. For example, delta
5.1 is made after delta 2.1, skipping releases 3 and
4. When this flag is omitted, it causes skipped
releases to be completely empty.
q Defines the replacement for the %Q% identification
keyword.
t Defines the replacement for the %Y% identification
keyword.
v Controls prompting for MR numbers in addition to com-
ments. If optional text is present, it defines an MR
number validity checking program.
Comments
Typically, the comments section contains a description of
the purpose of the file. Bracketing lines @t and @T sur-
rounding text designate the comments section.
Body
The body section consists of control and text lines.
Control lines begin with the control character, text
lines do not. There are three kinds of control lines:
insert, delete, and end, represented by:
@I DDDDD
@D DDDDD
@E DDDDD
respectively. The digit string is the serial number cor-
responding to the delta for the control line.
Related Information
The admin, delta, get, and prs commands in AIX Operating
System Commands Reference.