File Utility Program (FUP) Management Programming Manual

FUP Programmatic Interface
File Utility Program (FUP) Management Programming Manual—523322-001
2-3
Communicating With FUP
3. After you send the startup message, close FUP.
4. Open FUP for programmatic use.
Use #ZSPI as the first qualifier (in the process file name) when you open FUP. The
process file name must have the format:
$process-name.#ZSPI
You can include backup OPENs and CLOSEs in FUP, but the first qualifier of the
process file name for a backup OPEN must also be #ZSPI.
Additional restrictions apply when you open the FUP server:
•
You can open FUP only if you created the FUP process.
•
You can issue only one concurrent open.
•
The SYNC and NOWAIT depth must be zero.
Check for any file-system errors after you open FUP. File-system errors associated
with applications using SPI include:
5. Allocate the command and response buffer.
The recommended minimum buffer length in bytes is ZFUP-VAL-BUFLEN. A buffer
of this length is large enough to hold the command and response for all FUP
programmatic commands.
Error 11 FUP rejects the OPEN attempt because the first qualifier of the process file
name is not #ZSPI.
Error 12 Your management process tried to open FUP more than once.
Error 17 A problem occurred during the backup OPEN. This can happen if the backup
OPEN does not have a matching primary OPEN or if the backup and primary
OPEN parameters do not match.
Error 48 FUP rejects the OPEN because your user ID does not have the proper
security to perform the OPEN. This can happen when the process trying to
open FUP is not the creator of the FUP process.
Note. For a description of each file-system error, see the Guardian Procedure Errors and
Messages Manual.
Note. Although this manual refers to the SSINIT, SSNULL, and SSGET procedures,
Compaq also provides the SSPUTTKN, SSGETTKN, and SSMOVETKN procedures.
These procedures have the same functions as SSPUT, SSGET, and SSMOVE, and a
calling sequence that is simpler for TAL programming. Compaq also provides the #SSINIT,
#SSNULL, #SSPUT, #SSPUTV, #SSGET, #SSGETV, and #SSMOVE built-in functions for
TACL programming.