V'0)<FACCOMP

FACCOMP

April 1992

GThe facilities comparison utility (FACCOMP) is used to compare the CMS =class contents and the VDE stream contents for a development stream/class.

&Software Version: FACCOMP Version X1.0

FACCOMP

F Activates the FACCOMP utility. The FACCOMP utility is run from DCL. C FACCOMP comparse the VDE view of the libraries with the CMS view.

Format

%
FACCOMP library-spec stream

Command Qualifiers Defaults

/[NO]LOG /LOG
/OUTPUT=file-spec None.
/PROCESS /PROCESS=flagfree

Command Qualifiers	Defaults
/[NO]LOG	/LOG
/OUTPUT=file-spec	None.
/PROCESS	/PROCESS=flagfree

prompts

LIB_SPEC:	library-spec
STREAM:	stream

Description

HThe FACCOMP command activates the utility from DCL and then acts on the Hset of specified libraries. The utility uses the logical VDE$LIBRARY to #locate the VDE database to process.
HThe FACCOMP utility produces a report of generation differences between Cthe CMS representation of a stream and the VDE representation of a Gstream. The report can be printed to the log file or can be printed to a user specified text file.
BThe utility verifies that the stream to compare exists in the VDE Elibrary. If the stream is not present in the VDE library the utility Bwill terminate. If the stream is present in the VDE library, each Cfacility matching the library specification parameter is processed.
DIf the CMS class corresponding to the stream name is not found in a Hfacility CMS library, a warning message is displayed. A warning message ?is displayed if the facility is not found in the VDE database. ,Processing continues in both of these cases.
FThe utility will return the highest severity error encountered as the @final completion status. For example, the library specification EVMS$:[A*.CMS] may result in ten CMS libraries to compare. All ten of Athe CMS library and VDE stream contents must match for a success >status. If one or more of the facilities in the set exhibit a 1difference, then a warning return status results.

Parameters

library-spec
G Specifies the CMS library that is to be acted on. This specification F can contain wildcards, but it must be a valid CMS library directory J specification (i.e. VMS$:[YELLOW_TEST.CMS]). An example of a wildcarded J specification would be: VMS$:[Y*.CMS]. This specification would process / all libraries that start with the letter "Y".
stream
9 Specifies the CMS class/VDE stream name to be compared.

Command Qualifiers

/[NO]LOG
H Specifies that the FACCOMP utility should display a message for every CMS LIBRARY that is processed.#
/OUTPUT=file-specification
A Specifies the name of a file that is to contain all the output.
ENote: error messages and informational messages will not be put into the output file.-
/PROCESS=(attribute[,attribute,...])
E The PROCESS qualifier is used to identify what libraries are to be J processed. Some libraries have special attributes associated with them, I VMSCMS$NO_PROPAGATE.FLAG is an example of an attribute. This attribute B indicates that this library is not to have any code propagation D performed within it. The process qualifier is used to selectively H process or skip libraries marked with certain attributes. The list of acceptable attributes is:
J
[NO]ALL - process all libraries no matter what attribute it may have;
[NO]ARCHIVEDFACILITY - process all archived libraries:
[NO]FLAGFREE - process libraries with not attributes=
[NO]NOPROPAGATE - process libraries marked no propagate

Examples

#1
"$> @VMSCMS$:SET_VDE_LIBRARY VMS!$> SET COMMAND VMSCMS$:FACCOMP0$> faccomp/log/process=ALL vms$:[A*.cms] V5.5.%FAC-I-USEVDELIB, Using VDE library VSC$DBROOT7%FAC-I-PROC, Processing library VMS$:[AAA_VDE_TEST.CMS]Date: 9-APR-1992 08:580VDE to CMS generation comparison for stream V5.5& Library: VMS$:[AAA_VDE_TEST.CMS]&Module Name CMS VDE&--------------------------------------%A.REQ 1L%FAC-W-DIFFER, VDE and CMS differ for stream V5.5 in VMS$:[AAA_VDE_TEST.CMS].%FAC-I-PROC, Processing library VMS$:[ACC.CMS]E%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ACC.CMS]1%FAC-I-PROC, Processing library VMS$:[ACLEDT.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ACLEDT.CMS]1%FAC-I-PROC, Processing library VMS$:[ADARTL.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ADARTL.CMS]0%FAC-I-PROC, Processing library VMS$:[AMBER.CMS]G%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[AMBER.CMS]1%FAC-I-PROC, Processing library VMS$:[ANALYZ.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ANALYZ.CMS]3%FAC-I-PROC, Processing library VMS$:[AQUARIUS.CMS]J%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[AQUARIUS.CMS]1%FAC-I-PROC, Processing library VMS$:[AUDSRV.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[AUDSRV.CMS]$show symbol $status $STATUS == "%X18178060"$>

"$> @VMSCMS$:SET_VDE_LIBRARY VMS!$> SET COMMAND VMSCMS$:FACCOMP0$> faccomp/log/process=ALL vms$:[A*.cms] V5.5.%FAC-I-USEVDELIB, Using VDE library VSC$DBROOT7%FAC-I-PROC, Processing library VMS$:[AAA_VDE_TEST.CMS]Date:   9-APR-1992 08:580VDE to CMS generation comparison for stream V5.5&      Library: VMS$:[AAA_VDE_TEST.CMS]&Module Name       CMS              VDE&--------------------------------------%A.REQ                               1L%FAC-W-DIFFER, VDE and CMS differ for stream V5.5 in VMS$:[AAA_VDE_TEST.CMS].%FAC-I-PROC, Processing library VMS$:[ACC.CMS]E%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ACC.CMS]1%FAC-I-PROC, Processing library VMS$:[ACLEDT.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ACLEDT.CMS]1%FAC-I-PROC, Processing library VMS$:[ADARTL.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ADARTL.CMS]0%FAC-I-PROC, Processing library VMS$:[AMBER.CMS]G%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[AMBER.CMS]1%FAC-I-PROC, Processing library VMS$:[ANALYZ.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[ANALYZ.CMS]3%FAC-I-PROC, Processing library VMS$:[AQUARIUS.CMS]J%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[AQUARIUS.CMS]1%FAC-I-PROC, Processing library VMS$:[AUDSRV.CMS]H%FAC-S-EQUAL, VDE and CMS are equal for stream V5.5 in VMS$:[AUDSRV.CMS]$show symbol $status  $STATUS == "%X18178060"$>

EThe user first sets the value of the logical VDE$LIBRARY to point to Bthe VMS product database by executing the SET_VDE_LIBRARY command Cprocedure. The user then adds the FACCOMP command to their process Ccommand table. In this example, the CMS class contents and the VDE Fstream contents for stream V5.5 are compared for facilities beginning =with the letter "a". The output qualifier is not used so any Adifferences will be written to SYS$OUTPUT. The process qualifier Ckeyword ALL is used to process archived and nopropagate facilities.
DThere is a stream difference encounted in this example. In facility GAAA_VDE_TEST there is a module, A.REQ which exists in the VDE database Dbut is not present in the CMS library. The return status, X18178060 Eequates to FAC-W-DIFFER, which was the warning condition encountered.

#2
'$> faccomp/nolog vms$:[sys.cms] V5.5.%FAC-I-USEVDELIB, Using VDE library VSC$DBROOTDate: 9-APR-1992 09:270VDE to CMS generation comparison for stream V5.5$ Library: VMS$:[SYS.CMS]%Module Name CMS VDE&--------------------------------------$BASE_LEVEL.MAR 55 15C%FAC-W-DIFFER, VDE and CMS differ for stream V5.5 in VMS$:[SYS.CMS]$>

'$> faccomp/nolog vms$:[sys.cms] V5.5.%FAC-I-USEVDELIB, Using VDE library VSC$DBROOTDate:   9-APR-1992 09:270VDE to CMS generation comparison for stream V5.5$             Library: VMS$:[SYS.CMS]%Module Name       CMS             VDE&--------------------------------------$BASE_LEVEL.MAR    55              15C%FAC-W-DIFFER, VDE and CMS differ for stream V5.5 in VMS$:[SYS.CMS]$>

BIn this example, the NOLOG qualifier is used which suppresses the H%FAC-I-PROC message. The generation of module BASE_LEVEL.MAR in VDE and BCMS differs. The %FAC-W-DIFFER message indicates that VDE and CMS +differ for stream V5.5 in the SYS facility.

#3
)$> faccomp/log vms$:[vms054*.cms] V5.5.%FAC-I-USEVDELIB, Using VDE library VSC$DBROOTN%FAC-I-SKPNOPROP, Library VMS$:[VMS054-2R.CMS] marked NOPROPAGATE, skipping itH%FAC-I-SKPARCH, Library VMS$:[VMS054-3.CMS] marked ARCHIVED, skipping itN%FAC-I-SKPNOPROP, Library VMS$:[VMS054-2R.CMS] marked NOPROPAGATE, skipping it$>

)$> faccomp/log vms$:[vms054*.cms] V5.5.%FAC-I-USEVDELIB, Using VDE library VSC$DBROOTN%FAC-I-SKPNOPROP, Library VMS$:[VMS054-2R.CMS] marked NOPROPAGATE, skipping itH%FAC-I-SKPARCH, Library VMS$:[VMS054-3.CMS] marked ARCHIVED, skipping itN%FAC-I-SKPNOPROP, Library VMS$:[VMS054-2R.CMS] marked NOPROPAGATE, skipping it$>

DThis example shows the messages displayed when a facility is marked Farchived or marked nopropagate and the /process qualifier is not used to include these facilities.

.
_ Contents