Specifications

Interfaces
Page
22
Function:
Forces a down-line load 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 service the load request that is
forced from the target system.
The Force-load function queues the request. The user checks for
completion with the Force-load-poli function.
Inputs:
Channel-id
-
the unique identification of the channel over which
the load 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
i
nc luded
,
the
destination-address is used as the data base
search key to find other values in the Dump/Load
Data Base.
Load-file
-
the identification of the file that
is
to be down-line
loaded into the target system. If not specified, the file
identification from the Dump/Load Data Base is used.
Secondary-loader
-
the identification of the file that contains
the secondary loader program to use.
If
not specified but needed,
the file identification from the Dump/Load Data Base is used.
Tertiary-loader
-
the identification of the file that contains the
tertiary loader program to use.
If
not specified but needed, the
file identification from the Dump/Load Data Base is used.
Outputs:
Return-code
-
the status of the request. One of:
Request accepted
-
the load process will be initiated.
Notification of completion is via the Force-load-poll
function.