START-PROGRAM

Load and start program (load or object module)

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

As of BLSSERV V2.3, the START-PROGRAM command is replaced by the START-EXECUTABLE-PROGRAM command. START-PROGRAM continues to be supported and remains compatible. However, the START-EXECUTABLE-PROGRAM command should be used for new applications. Below you will simply find a brief description of the command function, the syntax format and the return codes.

Function

With the START-PROGRAM command

• object modules are linked, loaded into memory and started (invocation of the dynamic binder loader DBL),

• load modules are loaded into memory and started (invocation of the static loader ELDE).

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-EXECUTABLE-PROGRAM command.
If the user wishes to load a program but not yet start it, the LOAD-EXECUTABLE-PROGRAM (or LOAD-PROGRAM) command is the appropriate one to issue.
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 command can be used to return the settings to the DBL defaults.

Restrictions

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

Format

START-PROGRAM                                                                                    

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

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 the command
	64	BLS0153	Program loading aborted due to unrecoverable error (for cause, see SYSOUT message)