File Utility Program (FUP) Management Programming Manual

Introduction
File Utility Program (FUP) Management Programming Manual—523322-001
1-5
SPI With ORSERV
SPI With ORSERV
You can use the ORSERV programmatic interface to execute the ONLINERELOAD,
STATUS, SUSPEND, and GETVERSION commands. Use your management
application to create an ORSERV process, open the process, and then send your
command request to it.
Your management application sends commands directly to the ORSERV process. For
more information, see Section 4, ORSERV Programmatic Interface.
ORSERV Management Programming
Although you can reload a key-sequenced file using the interactive FUP RELOAD
command, it requires operator intervention. An operator must decide when to initiate
the reload operation, when to suspend the reload by using the SUSPEND command (if
necessary), and when to resume the reload with the RELOAD command.
You can write a management application that performs these duties automatically and
eliminates the need for operator intervention. You can design your management
application to initiate, suspend, and restart reload operations:
•
Initiate the reload when it has minimal effect on other applications that are running
on the system.
•
Reload each partition of a partitioned file (that resides on different systems) when it
has a minimal effect on each system.
•
Monitor the execution of other applications running on the system and suspend the
reload until it has minimal impact (or the other applications have completed).
•
Generate status reports at specific intervals to show the progress of a reload
operation. You can store these reports in a disk file for later reference or have them
displayed at a specific terminal for immediate use.
•
Restart the reload with the ZRATE field of ZORS-MAP-PAR-ONLINERELOAD set
to a lower value.
Note. The ZRATE field determines the percentage of execution time that ORSERV spends
performing the reload. The ORSERV process spends the remainder of its execution time in
delay mode to let other applications use processor time, physical memory, and other system
resources.