Current Supported Releases: Sablime^® v6.0 & v5.2

NAME
     nval - validate an SBCS file

SYNOPSIS
     nval -

     nval [-s] [-m mod-name] [-r sid] [-y mod-type] s-file ...

DESCRIPTION
     nval determines if the s-files specified by the s-file argu-
     ments meet the characteristics specified by the option argu-
     ments.

     When nval is used with a single -  argument,  it  reads  its
     standard input for lines that are independently processed as
     if they were  command  line  arguments:  they  must  contain
     options  and s-file arguments.  This differs from other SBCS
     commands in that the options used are not specified  on  the
     command  line but are expected, and may vary, with each line
     of input.

     Aside from the above special case, nval will  interpret  its
     s-file  arguments  like  other major SBCS commands (see nad-
     min(1)).

     nval 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 code returned by nval is a number between 0 and 255 that
     can  be  parsed  as  an  8-bit string. Moving from the least
     (rightmost) to the most (leftmost) significant bit, the bits
     are coded as follows:
          bit
          1 mismatch between %M% -m argument
          2 mismatch between %Y% and -y argument
          3 the SID does not exist
          4 the SID is invalid or ambiguous
          5 cannot open file or file not in s-file format
          6 corrupted s-file
          7 unknown or duplicate option
          8 missing or invalid s-file arguments

     When processing more than one file, as when multiple  s-file
     arguments are given or an s-file argument is a directory, or
     when reading its standard input, nval returns  an  aggregate
     code  that  is  a bitwise OR of the codes generated for each
     file processed.

OPTIONS
     -s   Silent mode.  Suppress the normal error or warning mes-
          sages.  If the single - option is used, silent mode can

SBCS Release 1.2    Last change: 1 April 1994                   1

          only be obtained by having the -s option on all command
          lines  entered  through stdin.  Invoking nval -s - does
          not meet the special case,  and  nval  will  behave  as
          other  SBCS  commands,  expecting s-file names from its
          standard input, but no options.

     -m mod-name
          Compare mod-name with the %M% ID keyword in the s-file.
          If  mod-name  contains blanks and is passed on the com-
          mand line it is interpreted by the shell  and  must  be
          quoted;  if  it  is passed through stdin as part of the
          single - option, it is not interpreted by any shell and
          must  still  be  double  quoted;  if  there is no space
          between -m and mod-name the -m should  be  included  in
          the double quote.

     -r sid
          Check if the indicated SID or version name  is  ambigu-
          ous, invalid, or absent from the s-file.

     -y mod-type
          Compare mod-type with the %Y% ID keyword.  If  mod-type
          contains blank spaces, the remarks made for -m apply.

COMPARISON WITH SCCS
     The SBCS nsact has no built-in limit on the number of  files
     it can process.

NOTES
     nval does not have original  error  messages  and  indicates
     errors through its exit code.

SEE ALSO
     nadmin(1), ncdc(1), ndelta(1), nedges(1), nget(1), nhelp(1),
     nprs(1), nsact(1), nwhat(1), sbcsenv(1), sbcsproj(1).

SBCS Release 1.2    Last change: 1 April 1994                   2

Return to SBCS Commands manpage index