English FUJITSU Software BS2000 UDS/SQL V2.9 Creation and Restructuring © Siemens Nixdorf Informationssysteme AG 1995 1995 AG Informationssysteme Nixdorf Siemens © P:\FTS-BS\DB\UDS\UDSV29\Handbücher\aktuell\udsauf\en\udsauf.vor Pfad: User Guide Edition September 2017 Comments… Suggestions… Corrections… The User Documentation Department would like to know your opinion on this manual. Your feedback helps us to optimize our documentation to suit your individual needs. Feel free to send us your comments by e-mail to: [email protected] Certified documentation according to DIN EN ISO 9001:2008 To ensure a consistently high quality standard and user-friendliness, this documentation was created to meet the regulations of a quality management system which complies with the requirements of the standard DIN EN ISO 9001:2008. cognitas. Gesellschaft für Technik-Dokumentation mbH www.cognitas.de Copyright and Trademarks Copyright © 2017 Fujitsu Technology Solutions GmbH. All rights reserved. Delivery subject to availability; right of technical modifications reserved. All hardware and software names used are trademarks of their respective manufacturers. This manual is printed on paper treated with chlorine-free bleach. Contents 1 Preface . 11 1.1 Structure of the UDS/SQL documentation . 11 1.2 Objectives and target groups of this manual . 16 6. September6. 2017 Stand 13:22.38 Pfad: P:\FTS-BS\DB\UDS\UDSV29\Handbücher\aktuell\udsauf\en\udsauf.ivz 1.3 Summary of contents . 17 1.4 Changes since the last edition of the manuals . 18 1.5 Notational conventions . 20 1.5.1 Warnings and notes . 20 1.5.2 Non-SDF notational conventions . 20 1.5.3 SDF syntax representation . 22 1.6 Sample databases . 27 2 Overview of UDS/SQL . 31 2.1 Basic concepts of the UDS/SQL database system . 31 2.2 Files and realms of a UDS/SQL database . 34 2.3 Overview of UDS/SQL programs . 43 2.3.1 START commands for the UDS/SQL programs . 47 2.4 Tools for UDS/SQL . 51 3 Database creation (BCREATE, BFORMAT, DDL- and SSL-Compiler, BGSIA, BGSSIA, BCALLSI) . 53 3.1 Preparing database creation . 57 3.1.1 Setting up the compiler database . 57 3.1.2 Setting up the user realms . 61 3.2 Generating the schema . 63 3.2.1 Formatting the compiler database with BCREATE . 63 Dokuschablonen 19x24 Version 7.32us für FrameMaker V7.x vom 28.03.2007 © cognitas GmbH 2001-2007 U931-J-Z125-17-76 Contents 3.2.2 Compiling the Schema DDL . 66 3.2.3 Compiling the SSL . 76 3.2.4 Setting up the Schema Information Area (SIA) with BGSIA . 79 SIA report . 84 Description of the ESTIMATE-REPORT . 84 3.3 Formatting user realms with BFORMAT . 88 3.4 Generating the subschema . 91 3.4.1 Compiling the Subschema DDL . 91 3.4.2 Generating the Subschema Information Area (SSIA) with BGSSIA . 94 3.5 Additional measures for CALL DML programs with BCALLSI . 97 4 Specifying access authorizations (ONLINE-PRIVACY, BPRIVACY) . 103 4.1 User groups . 104 4.2 Access rights . 105 4.3 Checking access rights . 106 4.4 System environment for ONLINE-PRIVACY . 108 4.5 System environment for BPRIVACY . 110 4.6 Rules for the statements . 111 4.7 Overview of statements . 112 ADD-USER-GROUP (Defining a user group with or without assigning access rights) 113 END (Terminating command input) . 119 GRANT-ACCESS (Assigning access rights to a user group) . 120 OPEN-DATABASE (Opening the database) . 125 REMOVE-USER-GROUP (Deleting one or more user group(s)) . 126 REVOKE-ACCESS (Withdrawing access rights from a user group) . 129 SHOW-USER-GROUP (Outputting information on user groups) . 134 UNDO (Undoing a statement) . 137 4.8 Command sequence for starting ONLINE-PRIVACY . 138 4.9 Command sequence for starting BPRIVACY . 139 U931-J-Z125-17-76 Contents 5 Storing and unloading data (BINILOAD, BOUTLOAD) . 141 5.1 Storing records in the database with BINILOAD . 142 5.1.1 Description of functions . 143 5.1.2 Readying the input file and preparing the BINILOAD run . 148 5.1.3 BINILOAD system environment . 149 5.1.4 Statements for BINILOAD . 151 EXECUTION (Checking/not checking input data) . 156 SORTCORE (Specifying the size of the sort buffer) . 157 SCHEMA (Specifying the name of the schema) . 158 SUBSCHEMA (Specifying the name of the subschema) . 159 FILLING (Specifying the occupancy level of table pages) . 160 6. September6. 2017 Stand 13:22.38 Pfad: P:\FTS-BS\DB\UDS\UDSV29\Handbücher\aktuell\udsauf\en\udsauf.ivz USER RECORD LENGTH (Specifying the length of the input records) . 161 USER BUFFER LENGTH (Specifying the block length of the input file) . 162 INPUT FILE (Specifying the name of the input file) . 163 STORE RECORD (Specifying the record type) . 164 RECORD-DBKEY (Assigning the database key value to a record) . 165 RECORD-DISPL (Creating the database record) . 167 RECORD-AREA (Specifying the realm) . 169 INSERT (Specifying the set) . 170 SET ORDER (Specifying the sort sequence) . 171 OWNER (Defining the owner) . 172 5.1.5 Command sequence for starting BINILOAD . 179 5.1.6 Creating work files . .180 5.1.7 BINILOAD example . 184 5.2 Copying, deleting and unloading records with BOUTLOAD . 188 5.2.1 BOUTLOAD functions . 188 5.2.2 Preparing the output files and the BOUTLOAD run . 192 5.2.3 BOUTLOAD log for the output record format . 198 5.2.4 BOUTLOAD system environment . 199 5.2.5 BOUTLOAD statements . 200 COPY-RECORD (Copying records to output files) . 201 END (Terminating the BOUTLOAD run) . 202 EXPORT-RECORD (Unloading records to output files) . 203 OPEN-DATABASE (Assigning the database) . 205 REMOVE-RECORD (Deleting records) . 206 5.2.6 Command sequence to start BOUTLOAD . 207 5.2.7 Examples . 208 Dokuschablonen 19x24 Version 7.32us für FrameMaker V7.x vom 28.03.2007 © cognitas GmbH 2001-2007 U931-J-Z125-17-76 Contents 6 Restructuring the database (BCHANGE, BALTER) . 213 6.1 Modifying the Schema DDL . 220 Schema entry . 222 Realm entry . 223 Record entry . 224 Set entry . 234 6.2 Modifying the SSL . 239 Schema entry . 241 Record entry . 242 Set entry . 245 6.3 Summary of restrictions . 249 6.3.1 Schema DDL modifications . 250 6.3.2 SSL modifications . 251 6.4 Checking the consistency of the database . 252 6.5 Checking free memory space . 253 Calculation formulas . 264 6.6 Recovery measures and response to errors . 270 6.6.1 Saving the database . 270 6.6.2 Restoring the database . 272 6.7 Preparing the compiler database with BCHANGE . 274 6.8 Compiling the Schema DDL . ..