Requirements for starting

Before starting the SESAM/SQL DBH with START-SESAM-DBH or START-PROGRAM, you assign files to the DBH and specify options for it by means of the following commands:

[/MODIFY-MSG-FILE-ASSIGNMENT ADD-FILE=$.SYSMES.SESAM-SQL.<ver>]          1.
[/MODIFY-SDF-OPTIONS-
         SYNTAX-FILE=*ADD(NAME=$.SYSSDF.SESAM-SQL.<ver>.USER)]           2.
[/MODIFY-TEST-OPTIONS DUMP=YES]                                          3.
[/ASSIGN-SYSDTA TO-FILE = *SYSCMD]                                       4.
[/ADD-FILE-LINK LINK-NAME=SESAMCID,FILE-NAME=conf_file]                  5.
[/ADD-FILE-LINK LINK-NAME=SESMAIL,FILE-NAME=mail_file]                   6.

1. To be able to use the SESAM/SQL messages, you need to activate the SESAM/SQL message file if this file is not available system-wide.

2. SESAM/SQL uses the SDF (System Dialog Facility) dialog interface of BS2000 for entering the DBH start statement and options, among other things. The SESAM-SDF sub system syntax file must therefore be activated. You must activate the SDF user syntax file and may need to change the settings for the SDF options.

3. You use this command to output each memory dump and issue a corresponding message to SYSOUT in order to obtain the diagnostic documentation required in the event of a malfunction.

4. Assigns the SYSDTA system file to the SYSCMD procedure file. This assignment is not necessary if you enter the DBH start statements and options in an S procedure (structured SDF procedure, see the SDF-P manual “ Programming in the Command Language”).

5. You use this command to assign the DBH a CATID list by means of a link name. conf_file must have the access type SAM and can contain a maximum of 50 CATIDs (see "MODIFY-CATID-LIST"). The CATID that you assign by means of the ADD-FILE-LINK command becomes effective at startup of the DBH.

6. You use this command to assign the DBH a MAIL parameter file by means of a link name. Its structure and its effect are described in the section “Sending important information of the DBH session by email”.

The SESAM/SQL DBH requests virtual address space when started. If there is not enough virtual address space available, loading is aborted and a corresponding error message appears. In this case, the BS2000 system administrator must increase the virtual address space for the user ID. If this is not possible, then you can try to reduce the amount of memory required by limiting the values of some DBH options (see the higher-order DBH option STORAGE-SIZE).

The requirements for the DBH restart are described in the section “Restart requirements” .