START-PROGRAM

Programm (Lade- oder Bindemodul) laden und starten

Komponente:	BLSSERV
Funktionsbereich:	Programm-Steuerung
Anwendungsbereich:	PROGRAM
Privilegierung:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Das Kommando START-PROGRAM wurde ab BLSSERV V2.3 durch das Kommando START-EXECUTABLE-PROGRAM ersetzt. START-PROGRAM wird weiterhin noch kompatibel unterstützt. Für Neuanwendungen sollte jedoch das Kommando START-EXECUTABLE-PROGRAM verwendet werden. Nachfolgend sind nur noch eine kurze Funktionsbeschreibung, das Syntaxformat und die Kommando-Returncodes enthalten.

Funktionsbeschreibung

Mit dem Kommando START-PROGRAM werden

• Bindemodule gebunden, in den Speicher geladen und gestartet (Aufruf des dynamischen Bindeladers DBL),

• Lademodule in den Speicher geladen und gestartet (Aufruf des statischen Laders ELDE).

Beim Laden werden die zu BLSSERV < V2.5 kompatiblen Prüfungen des Adressierungsmodus durchgeführt (entspricht AMODE-CHECK=*STD im Kommando START-EXECUTABLE-PROGRAM).
Wenn der Benutzer das Programm laden, aber noch nicht starten möchte, steht ihm das Kommando LOAD-EXECUTABLE-PROGRAM (bzw. LOAD-PROGRAM) zur Verfügung. Bei Operanden, die den Default-Wert *DBL-PARAMETERS besitzen, kann der Benutzer die DBL-Voreinstellungen, die zu Beginn der Task gelten, mit dem Kommando MODIFY-DBL-DEFAULTS verändern. Die Einstellung kann dabei für den Aufruf mit den LOAD- bzw. START-Kommandos sowie für den Makroaufruf BIND getrennt erfolgen. Mit dem
Kommando SHOW-DBL-DEFAULTS kann sich der Benutzer über die aktuell eingestellten Werte informieren. Mit dem Kommando RESET-DBL-DEFAULTS können die geänderten Einstellungen auf die DBL-Voreinstellungen zurückgesetzt werden.

Einschränkungen

Benutzer mit den Privilegien SECURITY-ADMINISTRATION, SAT-FILE-EVALUATION und SAT-FILE-MANAGEMENT können das Kommando nur in Prozeduren nutzen.

 

Format

START-PROGRAM                                                                                    

Kurzname: SR / SRPG

FROM-FILE = <filename 1..54 without-gen> / *MODULE(...) / *PHASE(...)

*MODULE(...)

|

LIBRARY = *DBL-PARAMETERS / *STD / *OMF / <filename 1..54 without-gen> / *LINK(...)

|

*LINK(...)

|

|

LINK = <structured-name 1..8> / <filename 1..8 without-gen-vers>

|

,ELEMENT-OR-SYMBOL = *ALL / <composed-name 1..64 with-under>(...) /

|

<c-string 1..32 with-low>(...)

|

<composed-name 1..64 with-under>(...)

|

|

VERSION = *STD / <text 1..24>

|

<c-string 1..32 with-low>(...)

|

|

VERSION = *STD / <composed-name 1..24 with-under> / <c-string 1..24>

|

,PROGRAM-MODE = *DBL-PARAMETERS / *24 / *ANY

|

,RUN-MODE = *DBL-PARAMETERS / *STD / *ADVANCED(...)

|

*ADVANCED(...)

|

|

ALTERNATE-LIBRARIES = *DBL-PARAMETERS / *NO / *YES

|

|

,NAME-COLLISION = *DBL-PARAMETERS / *STD / *ABORT

|

|

,UNRESOLVED-EXTRNS = *DBL-PARAMETERS / *STD / *DELAY / *ABORT

|

|

,ERROR-EXIT = *DBL-PARAMETERS / *NONE / <x-string 1..8>

|

|

,MESSAGE-CONTROL = *DBL-PARAMETERS / *INFORMATION / *ERROR /

|

|

*WARNING

|

|

,LOAD-INFORMATION = *DBL-PARAMETERS / *DEFINITIONS / *MAP / *NONE /

|

|

*REFERENCES

|

|

,PROGRAM-MAP = *DBL-PARAMETERS / *NO / *SYSLST(...) / *SYSOUT / *BOTH(...)

|

|

*SYSLST(...)

|

|

|

SYSLST-NUMBER = *STD / <integer 0..99>

|

|

*BOTH(...)

|

|

|

SYSLST-NUMBER = *STD / <integer 0..99>

|

|

,SHARE-SCOPE = *DBL-PARAMETERS / *SYSTEM-MEMORY / *NONE / *ALL /

|

|

*MEMORY-POOL(...)

|

|

*MEMORY-POOL(...)

|

|

|

SCOPE = *ALL / *USER-ID / *USER-GROUP / *HOST-SYSTEM

|

|

,IGNORE-ATTRIBUTES = *DBL-PARAMETERS / *NONE / *READ-ONLY

|

|

,REP-FILE = *DBL-PARAMETERS / *NONE / <filename 1..54 without-gen>

|

|

,AUTOLINK = *DBL-PARAMETERS / *YES / *NO / *ALTERNATE-LIBRARIES

|

|

,PROGRAM-VERSION = *DBL-PARAMETERS / *STD / *BLANK /

|

|

<composed-name 1..24 with-under>

*PHASE(...)

|

LIBRARY = <filename 1..54 without-gen>

|

,ELEMENT = <filename 1..41 without-gen-vers>

|

,VERSION = *STD / <text 1..24>

,CPU-LIMIT = *JOB-REST / <integer 1..32767 seconds>

,TEST-OPTIONS = *DBL-PARAMETERS / *NONE / *AID

,MONJV = *NONE / <filename 1..54 without-gen-vers>

,RESIDENT-PAGES = *PARAMETERS (...)

*PARAMETERS(...)

|

MINIMUM = *STD / <integer 0..32767 4Kbyte>

|

,MAXIMUM = *STD / <integer 0..32767 4Kbyte>

,VIRTUAL-PAGES = *STD / <integer 0..32767 4Kbyte>

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando ausgeführt
2	0	BLS0150	Warnung bei Laden des Programms (siehe Meldung auf SYSOUT)
	32	BLS0152	Laden des Programms wegen Systemfehlers abgebrochen
	64	CMD0216	Benutzer besitzt keine Berechtigung für das Kommando
	64	BLS0153	Laden des Programms wegen nicht korrigierbaren Fehlers abgebrochen (Ursache siehe SYSOUT-Meldung)