LOAD-PROGRAM

Load program (load or object module)

Component:	BLSSERV
Functional area:	Program control
Domain:	PROGRAM
Privileges:	STD-PROCESSING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

As of BLSSERV V2.3, the LOAD-PROGRAM command has been replaced by LOAD-EXECUTABLE-PROGRAM. However, LOAD-PROGRAM continues to be supported for reasons of compatibility. Despite this, the LOAD-EXECUTABLE-PROGRAM command should be used for new applications. The section below simply contains a short functional description, the syntax format, and the command return codes.

Function

The LOAD-PROGRAM command has two functions:

• It calls up the dynamic binder loader DBL and defines the primary input. The DBL then links LLMs (link and load modules) or OMs (object modules) to create a load unit, which it then loads into memory.

• It calls up the static loader ELDE. ELDE then loads a program (load module) linked by the TSOSLNK linkage editor into memory.

When calling with LOAD-PROGRAM, only the checks of the addressing mode compatible with BLSSERV < V2.5 are performed. This corresponds to specifying AMODE-CHECK=*STD in the START- or LOAD-EXECUTABLE-PROGRAM command. Execution of the loaded program or load unit does not begin until it is requested by means of a RESUME-PROGRAM command. If users wish to load and start the load unit or program with just one command, they may issue the START-EXECUTABLE-PROGRAM (or START-PROGRAM) command in place of the LOAD-PROGRAM and RESUME-PROGRAM commands.

In the case of operands which have *DBL-PARAMETERS as their default value, the MODIFY-DBL-DEFAULTS command can be used to modify the default DBL parameters which apply when the task is started. The parameters can be configured separately for calls to the LOAD- and START-... commands on the one hand and for the BIND macro call on the other. The SHOW-DBL-DEFAULTS command lists the values which are currently set. The RESET-DBL-DEFAULTS can be used to return the settings to the original DBL defaults.

Restrictions

Users with SECURITY-ADMINISTRATION, SAT-FILE-EVALUATION or SAT-FILE-MANAGEMENT privilege can use the command in procedures only.

Format

LOAD-PROGRAM

Alias: 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>

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed
2	0	BLS0150	Warning on program loading (see message to SYSOUT)
	32	BLS0152	Program loading aborted due to system error
	64	CMD0216	User has no authorization for command
	64	BLS0153	Program loading aborted due to unrecoverable error (for cause, see SYSOUT message)