val

PURPOSE

     Validates Source Code Control System (SCCS) files.

SYNOPSIS
     val -
     val [-s] [-rSID] [-mname] [-ytype] files


DESCRIPTION

     The val command reads files  and determines if the speci-
     fied file  is an Source  Code Control System  (SCCS) file
     meeting the  characteristics specified by the  flags.  If
     you  specify a  - (minus)  for file,  val reads  standard
     input and interprets  each line of standard  input as val
     flags and  the name  of an SCCS  file.  val  continues to
     take  input until  it  reaches  an end-of-file  character
     (Ctrl-D).

     The  val  command  displays error  messages  to  standard
     output  for  each file  processed.   val  also returns  a
     single 8-bit  code upon  exit.  The 8-bit  code indicates
     possible mismatches  or errors.   It is interpreted  as a
     bit string  in which  set bits (from  left to  right) are
     interpreted as follows:

     bit 0 = missing file parameter
     :55 1 = unknown or duplicate flag
     bit 2 = damaged SCCS file
     bit 3 = cannot open file or file not SCCS
     bit 4 = SID is invalid
     bit 5 = SID does not exist
     bit 6 = %Y%, -y mismatch
     bit 7 = %M%, -m mismatch

     When val processes  two or more files on  a given command
     line or multiple command lines (when reading the standard
     input), a  code is returned that  is a logical OR  of the
     codes generated for each command line and file processed.
     val can process up to 50  files on a single command line.
     Any number above 50 produces a dump.

FLAGS

     Each flag or group of flags applies independently to each
     named file.  The flags may appear in any order.

     -mname   Compares the value name  with the SCCS %M% iden-
              tification keyword in file.  See "Identification
              Keywords"   for  more  information  on  the  %M%
              keyword.

     -rSID    Specifies the  SID of the file  to be validated.
              The SID must be valid and unambiguous.
     -s       Suppresses the error message normally written to
              standard output.
     -ytype   Specifies a  type to  compare with the  SCCS %Y%
              identification keyword in  file.  See "Identifi-
              cation Keywords" for more information on the %Y%
              keyword.

RELATED INFORMATION

     The following commands:    "admin,"  "delta," "get," and
     "prs."

     The sccsfile file in  AIX Operating System Technical Ref-
     erence.

     The discussion  of SCCS in AIX  Operating System Program-
     ming Tools and Interfaces.