Starting SESAM programs with /START-PROGRAM

All SESAM/SQL programs are started using SESAM start commands for the specific programs; see "Overview of the start commands". It is assumed that you have installed SESAM/SQL and CRTE with IMON or that the files required have been set up under their default filenames (see "Tasks of the start commands").

For reasons of compatibility, you can continue to use the command START-PROGRAM to start the SESAM programs. Additional information about the program-specific sections for DBH, SESADM and utility monitor is contained in this section.
You will also find the command sequences mentioned in the start files of the demonstration database MAN-DB; see the “ Core manual”.

When SESAM programs are started using /START-PROGRAM the following operand must be specified:

RUN-MODE=*ADVANCED(UNRESOLVED-EXTRNS=*DELAY,

LOAD-INFORMATION=*REFERENCES)

Version coexistence

If SESAM programs are started by means of the /START-PROGRAM command, the most recently installed correction delivery status is loaded, if you do not specify the VERSION parameter. If you do specify the parameter, the specified version must match the version of the start LLM in the SESAM module library.

Starting the DBH

You should also note the following before starting the SESAM/SQL DBH with /START-PROGRAM:

• The SESAM/SQL DBH loads modules dynamically. When dynamically loading the first module, it searches the following module libraries in the order specified:

  1. The module library, which is assigned the link name SESAMOML by means of the /ADD-FILE-LINK command

  2. The module library assigned by means of /SET-TASKLIB LIBRARY=modlib.This module library is ignored if modlib is the TASKLIB library of the default user ID

  3. Hardware dependent module library SYSLNK.SESAM-SQL.<ver> or SKULNK.SESAM-SQL.<ver> of the calling user ID.

  4. Hardware dependent SYSLNK.SESAM-SQL.<ver> or SKULNK.SESAM-SQL.<ver> module library of the default user ID (the user ID specified with the BS2000 system parameter DEFLUID)

  5. The TASKLIB module library of the default user ID

  All subsequent modules are loaded from the same library as the first one. This means you must make all SESAM/SQL modules available in the same module library.

• SYSLNK.SESAM-SQL.<ver> is the default name of the module library of SESAM/SQL for/390 servers.
  SKULNK.SESAM-SQL.<ver> is the default name of the module library of SESAM/SQL for x86 servers.

  If you use another name, or if the module library is not under either the calling user ID or the default user ID, you have to assign the module library with the link name SESAMOML (ADD-FILE-LINK LINK-NAME=SESAMOML, FILE-NAME=sesam-modlib). If the RELOAD-DBH-SESSION statement is to be used in order to load a new correction version of the DBH modules without interrupting ongoing operation, the file thus assigned should be overwritten with the new correction version.

• The hardware dependent CRTE library is required to run the SESAM/SQL DBH. You must always assign the CRTE library under the link name
  BLSLIBxx before starting the DBH, if you have not installed CRTE with IMON. The placeholder xx stands for a two-digit serial number (00 £ xx £?99).

Command sequence for starting the DBH (/390 servers)

/ADD-FILE-LINK LINK-NAME=SESAMOML, FILE-NAME=$TSOS.SYSLNK.SESAM-SQL.<ver>
/ADD-FILE-LINK LINK-NAME=BLSLIB01, FILE-NAME=$TSOS.SYSLNK.CRTE
/START-PROGRAM FROM-FILE=*MODULE -
/ (LIBRARY=$TSOS.SYSLNK.SESAM-SQL.<ver> -
/ ,ELEM=SESAM -
/ ,PROG-MODE=ANY -
/ ,RUN-MODE=ADVANCED(UNRESOLVED-EXTRNS=*DELAY,LOAD-INFORMATION=*REFERENCES))

Starting SESADM (/390 servers)

/ADD-FILE-LINK LINK-NAME=SESAMOML, FILE-NAME=$TSOS.SYSLNK.SESAM-SQL.<ver>
/ADD-FILE-LINK LINK-NAME=BLSLIB01, FILE-NAME=$TSOS.SYSLNK.CRTE
/START-PROGRAM FROM-FILE=*MODULE -
/ (LIBRARY=$TSOS.SYSLNK.SESAM-SQL.<ver> -
/ ,ELEM=SESADM -
/ ,PROG-MODE=ANY -
/ ,RUN-MODE=ADVANCED(UNRESOLVED-EXTRNS=*DELAY,LOAD-INFORMATION=*REFERENCES))

Starting the utility monitor (/390 servers)

/ADD-FILE-LINK LINK-NAME=MAPLIB,FILE-NAME=$TSOS.SYSFHS.SESAM-SQL.<ver>.UTI.D
/ADD-FILE-LINK LINK-NAME=SESAMOML,FILE-NAME=$TSOS.SYSLNK.SESAM-SQL.<ver>
/ADD-FILE-LINK LINK-NAME=BLSLIB01,FILE-NAME=$TSOS.SYSLNK.CRTE
/ADD-FILE-LINK LINK-NAME=SEEHELP,FILE-NAME=$TSOS.SYSMAN.SESAM-SQL.<ver>.UTI.D
/ADD-FILE-LINK LINK-NAME=SESCONF,FILE-NAME=SESCONF.SESUTI.ZX -            
/                               ,ACCESS-METHOD=SAM
/START-PROGRAM FROM-FILE=*MODULE(LIBRARY=$TSOS.SYSLNK.SESAM-SQL.<ver>    -
/                        ,ELEMENT=SESUTI    							 -                             
/                        ,PROG-MODE=ANY                                  -
/                        ,RUN-MODE=ADVANCED(ALTERNATE-LIBRARIES=YES      -
/                        ,UNRESOLVED-EXTRNS=*DELAY                       -
/                        ,LOAD-INFORMATION=*REFERENCES))

Starting the performance monitor SESMON (SX servers)

/ADD-FILE-LINK LINK-NAME=MAPLIB,FILE-NAME=$TSOS.SYSFHS.SESAM-SQL.<ver>.MON.E
/ADD-FILE-LINK LINK-NAME=SESAMOML, FILE-NAME=$TSOS.SPULNK.SESAM-SQL.<ver>
/ADD-FILE-LINK LINK-NAME=BLSLIB01, FILE-NAME=$TSOS.SPULNK.CRTE
/MODIFY-DBL-DEFAULT PRIORITY=*FORCED, -
/  SCOPE=*PROGRAM-CALLS(LOADING=*PARAM,RESOLUTION=*PARAM(MMODE-CHECK=NO))
/START-PROGRAM FROM-FILE=*MODULE -
/ (LIBRARY=$TSOS.SPULNK.SESAM-SQL.<ver> -
/ ,ELEM=SESMON -
/ ,PROG-MODE=ANY -
/ ,RUN-MODE=ADVANCED(UNRESOLVED-EXTRNS=*DELAY,LOAD-INFORMATION=*REFERENCES))