


      VVVVAAAALLLL((((1111))))                      ((((UUUUNNNNIIIIXXXX 5555....0000))))                     VVVVAAAALLLL((((1111))))



      NNNNAAAAMMMMEEEE
           val - validate SCCS file

      SSSSYYYYNNNNTTTTAAAAXXXX
           vvvvaaaallll ----
           vvvvaaaallll [----ssss] [----rrrrSID] [----mmmmname] [----yyyytype] files

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _V_a_l determines if the specified _f_i_l_e is an SCCS file meeting
           the characteristics specified by the optional argument list.
           Arguments to _v_a_l may appear in any order.  The arguments
           consist of keyletter arguments, which begin with a ----, and
           named files.

           _V_a_l has a special argument, ----, which causes reading of the
           standard input until an end-of-file condition is detected.
           Each line read is independently processed as if it were a
           command line argument list.

           _V_a_l generates diagnostic messages on the standard output for
           each command line and file processed and also returns a
           single 8----bit code upon exit as described below.

           The keyletter arguments are defined as follows.  The effects
           of any keyletter argument apply independently to each named
           file on the command line.

                ----ssss             The presence of this argument silences
                               the diagnostic message normally
                               generated on the standard output for any
                               error that is detected while processing
                               each named file on a given command line.

                ----rrrr_S_I_D          The argument value _S_I_D (_SCCS
                               _I_Dentification String) is an SCCS delta
                               number.  A check is made to determine if
                               the _S_I_D is ambiguous (e. g., rrrr1 is
                               ambiguous because it physically does not
                               exist but implies 1.1, 1.2, etc. which
                               may exist) or invalid (e. g., rrrr1.0 or
                               rrrr1.1.0 are invalid because neither case
                               can exist as a valid delta number).  If
                               the _S_I_D is valid and not ambiguous, a
                               check is made to determine if it
                               actually exists.

                ----mmmm_n_a_m_e         The argument value _n_a_m_e is compared with
                               the SCCS %M% keyword in _f_i_l_e.

                ----yyyy_t_y_p_e         The argument value _t_y_p_e is compared with
                               the SCCS %Y% keyword in _f_i_l_e.




      Page 1                                                   (9010-E)






      VVVVAAAALLLL((((1111))))                      ((((UUUUNNNNIIIIXXXX 5555....0000))))                     VVVVAAAALLLL((((1111))))



           The 8----bit code returned by _v_a_l is a disjunction of the
           possible errors, i. e., can be interpreted as a bit string
           where (moving from left to right) set bits are interpreted
           as follows:

                bit 0 = missing file argument;
                bit 1 = unknown or duplicate keyletter argument;
                bit 2 = corrupted SCCS file;
                bit 3 = can't open file or file not SCCS;
                bit 4 = _S_I_D is invalid or ambiguous;
                bit 5 = _S_I_D does not exist;
                bit 6 = %Y%, ----yyyy mismatch;
                bit 7 = %M%, ----mmmm mismatch;

           Note that _v_a_l can process two or more files on a given
           command line and in turn can process multiple command lines
           (when reading the standard input).  In these cases an
           aggregate code is returned - a logical OOOORRRR of the codes
           generated for each command line and file processed.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           admin(1), delta(1), get(1), prs(1).

      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
           Use _h_e_l_p(1) for explanations.

      BBBBUUUUGGGGSSSS
           If _V_a_l attempts to process more than 50 files on a single
           command line, it fails and the debugger will be activated.


























      Page 2                                                   (9010-E)



