DAMP statements via the system command INFORM-PROGRAM

If DAMP is interrupted using the key, DAMP functions can also be addressed via the BS2000 command INFORM-PROGRAM.
The MSG operand of the command is used to communicate with DAMP.

Format: INFORM-PROGRAM

INFORM-PROGRAM

MSG = *NO / <c-string 1..64>
,JOB-IDENTIFICATION = *OWN / *TSN(...) / *MONJV(...)
	*TSN(...)
		|	TSN = <alphanum-name 1..4>
	*MONJV(...)
		|	MONJV = <filename 1..54 without-gen>

Input in system mode is as follows: /INFORM-PROGRAM MSG='<function>'

Format: MSG = '<function>'

INFORM-PROGRAM MSG='<function>'

FUNCTION = *RESUME / HALT / *END / *TERMINATE / *DUMP / *TERMD / *ESCAPE / *BREAK /
				*CANCEL / *LOG-SESSION / *STOP-LOGGING / *REPEAT-SESSION(...) /
				*MODIFY-PAGE-ACCESS(...)
	*REPEAT-SESSION(...)
		|	LOGGING-FILE = <filename 1..54>
	*MODIFY-PAGE-ACCESS(...)
		|	AREA = <x-string 1..8> / <name 1..8>(...)
		|		<name>(...)
		|				|	DISPLACEMENT = 0 / <integer 0..9> / <x-string 1..8>
		|	,STATE = *READ-ONLY / *WRITEABLE

Operands

FUNCTION = *RESUME / *HALT / *END / *TERMINATE / *DUMP / *TERMD / *ESCAPE / *BREAK / *CANCEL / *LOG-SESSION / *STOP-LOGGING / *REPEAT-SESSION(...) / *MODIFY-PAGE-ACCESS(...)
Indicates the functions which can be assessed using the INFORM-PROGRAM command.

FUNCTION = *RESUME
DAMP is resumed at the point it was interrupted with the key.

FUNCTION = *HALT / *END / *TERMINATE
This terminates DAMP without a memory dump.
If DAMP is terminated abnormally and if a START-MODULE statement was active at the time of the interruption, the command /INFORM-PROGRAM MSG='*HALT' only aborts the external subroutine. DAMP can be resumed.

FUNCTION = *DUMP / *TERMD
This terminates DAMP with a memory dump.

FUNCTION = *ESCAPE / *BREAK
This displays the point at which DAMP was interrupted by .

FUNCTION = *CANCEL
This aborts any current DAMP function.

FUNCTION = *LOG-SESSION
This activates logging.

FUNCTION = *REPEAT-SESSION(...)
This replays the diagnostics log.

LOGGING-FILE = <filename 1..54>
This specifies the name of the file in which the inputs and outputs from the DAMP session were logged.

FUNCTION = *STOP-LOGGING
This deactivates logging.

FUNCTION = *MODIFY-PAGE-ACCESS(...)
This changes the status of memory pages in the address space in which DAMP is running.

AREA = <x-string 1..8> / <name 1..8>(...)
This specifies an area in the virtual address space for which the attributes are to be changed.

AREA = <x-string 1..8>
A hexadecimal string is interpreted as the number of a 4-Kb page.

AREA = <name 1..8>(...)
An alphanumeric entry is interpreted as a module name from the DAMP system.

DISPLACEMENT = 0 / <integer 0..9> / <x-string 1..8>
This specifies an address within the module relative to the start of the module. It is only possible to change the attributes of a page where the specified address lies between the beginning and end of the page.

STATE = *READ-ONLY / *WRITEABLE
This specifies whether or not it is to be possible to overwrite the specified memory area.

INFORM-PROGRAM MSG='?' activates DAMP’s SDF user guidance mode; DAMP treats “FUNCTION” like any other DAMP statement.

Examples

/INFORM-PROGRAM MSG='FUNCTION=*CANCEL'

Entering system commands in the command line

Any BS2000 system command can be entered in the command line. The user alone is responsible for ensuring that no commands are issued which would terminate the program (e.g. EXIT-JOB).
If abbreviated commands are entered and the command abbreviation corresponds to an abbreviated DAMP statement, the DAMP statement is always executed. You can have the input interpreted as a system command by prefixing a label, for example, /.LABEL. System command outputs are displayed in the DAMP message lines.