File Utility Program (FUP) Management Programming Manual

File Utility Program (FUP) Management Programming Manual—523322-001
2-1
2 FUP Programmatic Interface
This section describes how a management application program uses the Subsystem
Programmatic Interface (SPI) to communicate with a FUP process.
You can use SPI to execute these FUP commands from an application written in
COBOL85, C, TACL, or TAL:
Communicating With FUP
To communicate with a FUP process:
1. Start a FUP process.
You can use a process creation procedure, such as PROCESS_LAUNCH_. FUP is
in the $SYSTEM.SYSnn.FUP program file (where nn is a two-digit octal integer
that identifies the subvolume).
2. Send FUP a startup message.
Open the FUP process, then send FUP a startup message using these guidelines:
•
The name of the IN file parameter must be $RECEIVE.
•
FUP ignores the OUT file parameter, AUTOSTOP parameter, and any ASSIGN
or PARAM messages.
Topic Page
Communicating With FUP
2-1
Elements of SPI Messages for FUP 2-8
SPI Programming Considerations for FUP 2-12
Common Definitions 2-24
CHECKSUM Recomputes the checksum value for blocks of data in disk files
DUPLICATE Makes a copy of one or more disk files unless the restartable option is
being used (it only allows the duplication of one disk file)
GETVERSION Returns the FUP server version and the server ID
LOAD Loads data into a structured disk file without affecting any associated
alternate-key files
LOADALTFILE Generates alternate-key records from a specified primary file and loads
the alternate-key records into an alternate-key file
RESTART Allows the continuation of a DUPLICATE command (with the restartable
option specified) that failed
Note. Before reading this section, you should be familiar with the SPI Programming Manual.
Note. For more information on process creation, see the Guardian Procedure Calls
Reference Manual.