LOAD-PROGRAM

Programm (Lade- oder Bindemodul) laden

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

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

Funktionsbeschreibung

Das Kommando LOAD-PROGRAM hat zwei Funktionen:

• Es ruft den dynamischen Bindelader DBL auf und definiert die Primäreingabe. Der DBL bindet dann LLMs (link and load modules) oder OMs (object modules) zu einer Ladeeinheit und lädt diese in den Hauptspeicher.

• Es ruft den statischen Lader ELDE auf. Der ELDE lädt dann ein Programm (Lademodul) in den Hauptspeicher, das vom Binder TSOSLNK gebunden wurde

Beim Laden werden die zu BLSSERV < V2.5 kompatiblen Prüfungen des Adressierungsmodus durchgeführt (entspricht AMODE-CHECK=*STD im Kommando LOAD-EXECUTABLE-PROGRAM). Die geladene Ladeeinheit bzw. das geladene Programm wird erst gestartet, wenn dies durch ein Kommando RESUME-PROGRAM gefordert wird. Wenn der Benutzer die Ladeeinheit bzw. das Programm laden und starten möchte, kann er an Stelle der Kommandos LOAD-PROGRAM und RESUME-PROGRAM das Kommando START-EXECUTABLE-PROGRAM (bzw. START-PROGRAM) verwenden.

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

LOAD-PROGRAM

Kurzname: LDPG

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)