CMPSBSD COMPARE SUBSYSTEM DESCRIPTION TAASYSW
The Compare Subsystem Description command compares the attributes and
entries of two subsystem descriptions. A spooled file is output with
The major attributes which are not compared are:
- 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.
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
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
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
*NO may be specified to ensure a spooled file will
exist regardless of whether differences exist or
See the previous comments on the comparison technique used.
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
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.
Added to TAA Productivity tools July 1, 1999