The Calculix system has two Master Libraries:-
The two Libraries provide Standard data which can be used on any Contract as required. The routines for manipulating the data within each Master Library are identical to those contained in the corresponding section of the Main Calculix system.
The Master Description Library is accessed via the Calculix Main Menu and offers the same basic options as appear on the Contract Description Menu. The Master Description Library is identified as the Calculix file called "desc.kl". Any description file can be made the Master by re-naming it "desc.kl". Care should be taken when re-naming files to ensure that existing files are not accidentally overwritten.
When working on a contract the Master Description Library is used in tandem with the relevant Contract Description Library. Whenever the system wants to find a Description it uses the corresponding Description code and first of all tries to find it in the Contract Description file. If a description is found it will be used. If no description is found in the Contract file, Calculix will look in the Master Description Library and use the Description there, if there is one. If a description is still not found, the item will appear without a description and a suitable message will be displayed.
As a result of this process there is no need to copy Descriptions into the Contract file in order to use them on a Contract. This keeps the Contract Description file small and since it contains ALL of the Rogue descriptions and ONLY the Rogue descriptions it is very easy to inspect for management purposes.
There are, of course, some Descriptions which although basically standard have some variable content which depends on the particular contract. e.g. items containing PC sums, contract water levels etc..
These descriptions MUST be copied from the Master Description Library to the Contract Description Library and then edited to suit the Contract requirements.
There will also be rogue descriptions which are similar to but not exactly the same as descriptions that already exist in the Master Library. These MUST also be copied into the Contract description file where the copy can be edited to suit the contract requirements.
The Master Description Library MUST be regarded as SACROSANCT.
Calculix descriptions have a special feature using the Question Mark character. A Question Mark is assumed to mean that there is some information outstanding and any Description containing a question mark will be identified as being "incomplete".
It is recommended that the Question Mark is used in connection with all Contract Specific information contained in Descriptions in the Master Description Library. This will ensure that these descriptions are not accidentally left unchanged without an error message appearing in the Bill.
The Master Element Library is accessed via the Calculix Main menu and offers the same basic options as appear in the Contract Element menu. The Master Element Library is identified as the Calculix file called "element.kl". Other Element libraries can be made the Master by re-naming them "element.kl". Care should be taken in re-naming files to ensure that existing files are not accidentally overwritten.
Unlike Descriptions, Elements MUST be in the Contract file if they are to be used on the Contract. This means that Elements must always be copied from an Element Library (usually the Master Library) into the Contract File (or created from scratch). The reason for this is that it is a feature of The Elemental taking-off process that all Elements will require some editing to suit each particular Contract.
The copy process includes a facility to Edit the Element immediately after the data has been copied.
The Elements in the Master Library are fundamentally the same as those in a Contract File with ONE MAJOR EXCEPTION.
Whilst in the Master Library the "variable" data of an Element (L,W,H,A,B and C fields) should not be entered with actual values but should contain a cryptic describing the nature of the variable. This will enable users of the Element to understand what information is required when they use the Element. This cryptic will be deleted or overtyped with the appropriate value once the Element has been copied into the Contract File.
e.g. the internal reveal of a window will be stored as intrev in the Master Library and this will be replaced by, say, .075 once the Element is copied into the Contract File.
This procedure helps to ensure that the variable data is properly understood and avoids previous data being accidentally used on a later contract.
Because the variable fields can contain alpha characters, they can not be validated as number fields and the input data is not therefore padded out to three decimal places. This does not affect any of the mathematics but if three decimal places are wanted for neatness they must be entered manually. This is in distinction with all other dimension fields on the Element Worksheet which are automatically adjusted to three decimal places.
It is intended that the Master Libraries are stable and secure. It is not, therefore, possible to edit either of the Master Libraries when working on a Calculix Contract. Whenever a Master Library entry is not exactly what is required it is necessary to copy the Master library data into the Contract library and edit it there. This leaves the Master Library unchanged.
It is, of course, possible to edit the data in the Master libraries, but it is envisaged that this will only be done under strict control and then using the special routines provided.
The procedure for editing data in the Master Libraries is exactly the same as for similar data in the Contract files. For details see the appropriate Chapters of the Manual.
From each of the Master Libraries it is possible to inspect the data used on any Contract using the HOME key and, if appropriate, copy it into the Master Library. Once in the Master Library the data can be edited and further copied by the usual procedures. In this way the Master libraries can be easily built up to include as much data as required.
The Master Libraries can be password protected against unauthorised access. This is an optional facility and no action is required unless you want to introduce password protection on either or both of the Master Libraries. It is important to note that this option works on the REAL Master Libraries only and not on Contract libraries which are temporarily assigned as Master Libraries.
The password is set up for each of the two Master Libraries separately although the procedure is the same in both cases.
The routines are contained on the Master Library main menus and are divided into two facilities:-
The Access password is the password that must be entered in order to work on the protected Master Library.
The Control password provides password protection on the Access password.
Anybody who knows the Access password can change it to something else. In cases where this would be a problem, the Access password can itself be password protected by using the Control password. Once again, anybody who knows what the Control password is, can change it and it is, therefore, important that the system manager keeps tight security on the Control password. It is not necessary to use the Control password if you don't require it.
If you do not want to restrict access to either or both of the Master Libraries, you should ignore the facility altogether and continue to use these libraries in the usual way.
To create an Access password, you should select the appropriate option from the Library Main menu. Enter the required password and press <RETURN>.
You will then be asked to re-type the password to ensure that there were no typing errors. Re-enter the password and press <RETURN>. If the two entries are the same the password will be created.
You can abandon the procedure at any time during any password routine by pressing <ESC>.
If you want to change an existing Access password, you should select the same Access password option from the Library main menu. If an Access password already exists you will be automatically asked to input the existing password first. When you have correctly entered the existing password, press <RETURN> and you will then be allowed to enter the new password. You will be asked to re-type the password to ensure that there were no typing errors and if the two entries are the same the new password will be accepted.
The method of creating and editing the Control password is identical to that for the Access password. Once again the control password does not prevent entry to the Libraries but prevents unauthorised change to the Access password. Any attempts to change the Access password will be preceded by a demand for the correct control password. When using the Control password, it is important to re-create the Access password AFTER the Control password has been created or edited, otherwise the Access password will not be encrypted with the control password.
Using a Master Library that has been password protected with an Access password is slightly different. After selecting the Library option on the Calculix Main menu, you will be asked to enter the Access Password. The library Main Menu will only be displayed after the correct Access password has been entered. Thereafter all subsequent use of the Library is exactly the same as for unprotected libraries.
If you have gone to the trouble of protecting the Libraries, you should not leave your terminal unattended whilst logged-in to the Library. If it is necessary to leave your terminal you should log-off and then log-in again when you return.
A password can be removed from a Library by changing it to NULL. This is done by following the Edit password procedure and making no entry for the new password. You will be asked to re-enter the password and you should again make no entry (i.e. just press <RETURN>). Thereafter the password protection will be removed until it is changed again.
Send mail to
with questions or comments about this web site.