The Compare Subsystem  Description command compares the  attributes and
entries of  two subsystem descriptions.  A spooled  file is output with
the results.

The major attributes which are not compared are:

      - Owner
      - Authorizations
      - Text description
      - Create date and time

A typical command would be:

             CMPSBSD       FROMSBSD(xxx) TOSBSD(yyy)

The  TAA  CVTSBSD  command is  used  to  convert all  of  the subsystem
attributes  and  entries to  data  base  files  in  QTEMP.    Different
members are used  for each file representing the  From and To subsystem
information.  A comparison is then made.

A  spooled file  is  output with  the results.   An  optional parameter
allows an escape message if  differences exist.  An optional  parameter
allows the spooled file to be deleted if no differences exist.

CMPSBSD  escape messages you can monitor for
--------------------------------------------

      TAA9895    Differences exist (optional based on ESCAPE parm)

Escape messages from based on functions will be re-sent.

Comparison technique
--------------------

CVTSBSD is used  for each subsystem to create multiple  files in QTEMP.
The information  from each subsystem is written  to either the FROMSBSD
member or the TOSBSD member in each file.

The Operational  information  is in  the  SBSPOOL file.    Each  record
contains the same  operational information and  there will be  at least
one record  for each subsystem.   The fields  from the first  record in
each member are compared for such values as Maximum number of jobs.

Each  defined pool is a unique  record.  The Pool  ID (1-10) is used to
determine which pool to  compare.  For example, the attributes  of Pool
1 in  the From Subsystem  are compared to  Pool 1 in the  To Subsystem.
If  one  of the  attributes  differs, the  From and  To  information is
printed.  If a  pool exists in  one subsystem but  not in the other,  a
line is printed.

The same  technique is  used for  the other  files created by  CVTSBSD.
It is  not an error if no entries exist in  a member being compared.  A
key field in each file is  used to determine whether the  corresponding
entry exists in the other file.

The following chart describes the key fields used:

       Information               File           Key field
       -----------               ----           ---------

       Pool                      SBSPOOL        Pool ID
       Auto start entries        SBSAUTSTR      Job name
       Workstation name entries  SBSSTNNAM      Workstation name
       Workstation type entries  SBSSTNTYP      Workstation type
       Job queue entries         SBSJBQENT      Job queue
       Routing entries           SBSRTGENT      Routing program
       Communication entries     SBSCMNENT      Device
       Remote location entries   SBSRMTLOC      Remote location
       Prestart job entries      SBSPRESTR      Job name

If multiple keys exist  (such as duplicate job names),  the comparisons
occur in the  order in which the data is read.   This can result in the
wrong  comparison.  The  Routing Entries can  create the most confusion
because  it  is  normal   to  use  the  same  program   with  different
attributes such as classes.

In some  cases it may be desirable  to print the output  of DSPSBSD and
manually compare some entries.

Command parameters                                    *CMD
------------------

   FROMSBSD      The  qualified  name  of  the  From  Subsystem  to  be
                 compared.    The  library  value  defaults  to  *LIBL.
                 *CURLIB may also be used.

   TOSBSD        The  qualified  name   of  the  To  Subsystem   to  be
                 compared.   The default is  *FROMSBSD meaning the same
                 subsystem name  as in  the  FROMSBSD parameter.    The
                 library  value defaults  to  blanks.   If  no name  is
                 entered,  *LIBL  is  assumed.    *CURLIB may  also  be
                 used.

   ESCAPE        Whether  to  send  an  escape  message  if differences
                 exist.  The  default is *NO  which means a  completion
                 message is sent.

                 *YES may  be specified to send  TAA9895 if differences
                 exist.

   DLTSPLF       Whether  to delete  the spooled  file if there  are no
                 differences.    The  default   is  *YES  meaning   the
                 spooled file is  deleted if no differences  are found.
                 The  spooled file  is  always retained  if differences
                 exist.

                 *NO may be  specified to  ensure a  spooled file  will
                 exist  regardless  of  whether  differences  exist  or
                 not.

Restrictions
------------

See the previous comments on the comparison technique used.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTSBSD         Convert subsystem description
     EDTVAR          Edit variable
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CMPSBSD       *CMD                   TAASYSW       QATTCMD
   TAASYSWC      *PGM       CLP         TAASYSWC      QATTCL
   TAASYSWR      *PGM       RPG         TAASYSWR      QATTRPG
   TAASYSWP      *FILE      PF
   TAASYSWQ      *FILE      PF
   TAASYSWS      *FILE      PF
   TAASYSWT      *FILE      PF
   TAASYSWU      *FILE      PF
   TAASYSWV      *FILE      PF
   TAASYSWW      *FILE      PF
   TAASYSWX      *FILE      PF
   TAASYSWY      *FILE      PF

The TAASYSWx  files are created  from the corresponding  TAASYSVx files
used  by CVTSBSD.  This  allows the TAASYSWR program  to have two files
with the same definition to handle the From and To information.