Specifications

Interfaces
Page
26
Function:
Forces an up-line dump of the system on the specified channel.
This function is a call to the Dump/Load Server. It is a server
function rather than a requester function since the server is the
component that will actually dump the target system.
The Force-dump function queues the request. The user checks for
completion with the Force-dump-poll function.
Inputs:
Channel-id
- the unique identification of the channel over which
the dump is to be performed. If not specified, the channel-id
from the Dump/Load Data Base is used.
Destination-address
- the identification of the target system. If
not specified but needed, the destination-address from the
Dump/Load Data Base is used. Destination-address is needed on
multiaccess channels.
NOTE
Either the channel-id or the destination-address
must be included in order to identify the target
system.
If both are included, the
destination-address is used as the data base
search key to find other values in the Dump/Load
Data Base.
Dump-file
- the identification of the file that is to be up-line
dumped into on the target system. If not specified, the file
identification from the
Dump/Load Data Base is used.
Dump-address
- the memory address in the target system to begin
dumping from. If not specified
and not obtainable from the
target, the value from the Dump/Load Data Base is used.
Dump-count
- the number of memory units to dump. Memory units are
whatever is customary for the processor type: usually, but not
necessarily, eight-bit bytes. If not specified, and not
obtainable from the target, the value from the
Dump/Load Data Base
is used.
Outputs:
Return-code
- the status of the request. One of:
Request accepted
- the dump process will be initiated.
Notification of completion is via
the Force-dump-poll
function.