XYGATE Access Control Reference Manual

XYGATE
®
Access Control Reference Manual
Chapter 4. DBSO – The Database Server
XYPRO Technology Corporation 50 Proprietary and Confidential
4.2 DBSO for Syntax and Statistics
When DBSO is run with any of the optional keywords or with an alternative ACACL or
ACCONF filename, it runs in a single pass, displaying any syntax errors found and
optionally displaying a variety of statistics.
Syntax:
RUN DBSO [SYNTAX | STATS | DSTATS | COMMANDS ] [<ACACL Filename>
<ACCONF Filename> | <logon name> ]
Where:
<ACACL Filename> is the name of the file containing the commands to
evaluate. If you want to syntax check only the ACCONF
file, the name of a known correct file must be placed here.
<ACCONF Filename> is the name of the file containing the configuration
information for XYGATEAC. If this filename is omitted, the
ACCONF file in the volume/subvolume where XYGATEAC
is installed will be used.
4.2.1 SYNTAX
The SYNTAX keyword causes DBSO to review the ACACL file specified on the
command line (or the default file if none is specified) for syntax errors.
The CHECKSUM for both the ACCONF and ACACL files are provided to give a
reasonable level of identity to the file. Every time DBSO loads the files into memory,
the CHECKSUM is generated and audited. At any time in the future, a version of the
ACACL file or ACCONF file can be proven to have been the file in effect at a particular
time if and only if the CHECKSUM value matches.
Example:
$SYSTEM.XYGATEAC 18> run dbso syntax $system.p06qa.acacl1
XYGATEAC 5.75 XYPRO \N1 20991231 (see >CONFIG for Copyright)
ACCONF CHECKSUM 1651907125 ($SYSTEM.P06QA.ACCONF)
XAC - ACACL syntax error at line 19, TOKEN COMMANDS
ACACL CHECKSUM 1249137975 ($SYSTEM.P06QA.ACACL1)
Syntax errors found
$SYSTEM.XYGATEAC 19>
In the example below, there were no errors. The ACCONF checksum is identical to the
one in the previous example, showing that the ACCONF has not changed. The ACACL
checksum has changed, so the ACACL file has changed.
Example:
$SYSTEM.XYGATEAC 19> run dbso syntax $system.p06qa.acacl1
XYGATEAC 5.75 XYPRO \N1 20991231 (see >CONFIG for Copyright)
ACCONF CHECKSUM 1651907125 ($SYSTEM.P06QA.ACCONF)
ACACL CHECKSUM 995061119 ($SYSTEM.P06QA.ACACL1)
No syntax errors found