pmterrtab(4M)                  DG/UX R4.11MU05                 pmterrtab(4M)


NAME
       pmterrtab - table of equivalent error numbers

DESCRIPTION
       The file /etc/pmterrtab contains an ASCII table of error numbers that
       are semantically equivalent among eight (8) different operating
       systems.  The system administrator can modify its contents with a
       text editor.  It is read by programs such as pmtd(1M) that need to
       translate error numbers from other operating systems into DG/UX errno
       values.

       The pmterrtab file must be in the following format:

       First Line:         os1 os2 os3 os4 os5 os6 os7 os8

                           where os* is a name for the particular operating
                           system.  For example, dg or sun may be used.

       Other Lines:        err1 err2 err3 err4 err5 err6 err7 err8

                           where err* is an error number of the operating
                           system for that column.  For Unix systems, errno
                           values are used as error numbers.

       Fields within the same line must be separated with spaces or tabs.
       Lines beginning with a # are ignored.  They may used to add comments.

       It is the responsibility of the system administrator to maintain this
       file and keep it up to date relative to the various operating
       systems' new releases and error numbers.

       Some operating system vendors use the same error numbers.  For
       example, dg and any BCS compliant system would use the same error
       numbers.

       A Unix operating system vendor will probably use the same error
       numbers as att, sun, or dg.  Error number sharing makes it easy to
       maintain the table because you do not have to fill in the values for
       new vendors so long as the vendor uses the same error numbers as a
       vendor already in the table.

       If there is no equivalent error number for a particular operating
       system, a value of 0 should be placed in that entry.

FILES
       /etc/pmterrtab              Table of equivalent error numbers.
       /usr/include/sys/errno.h    Table describing DG/UX error numbers.

EXAMPLES
       $ cat /etc/pmterrtab.example
       # operating systems:
       #--- ----  ----  ----  ----  ----  ----  ----
       dg   sun   att   xxx   xxx   xxx   xxx   xxx
       # error numbers :
       #--- ----  ----  ----  ----  ----  ----  ----
       2    2     2     0     0     0     0     0
       38   0     38    0     0     0     0     0
       45   78    45    0     0     0     0     0
       130  38    0     0     0     0     0     0

       Although this example file is not complete, it demonstrates two
       importants points: First, error numbers may vary widely from one
       operating system to another, or they may be the same.  Second, not
       every operating system has error numbers that correspond to
       another's.

SEE ALSO
       pmtd(1M), pmttapetab(4M).

CAVEATS
       The pmtd(1M) server expects a column named dg to exist in this file.


Licensed material--property of copyright holder(s)