File Utility Program (FUP) Management Programming Manual

FUP Programmatic Interface

File Utility Program (FUP) Management Programming Manual—523322-001

2-8

Elements of SPI Messages for FUP

A command and response buffer contains special codes called tokens. Each token

contains a specific piece of information such as the command number or object type.

Examples of these tokens are ZFUP-CMD-CHECKSUM, which is the command

number token for the CHECKSUM command, and ZFUP-OBJ-FILE, which is the

object-type token.

Source Definition Files

When you write your FUP management application, each source module must include

the SPI standard definitions and the FUP definitions. Depending on the language you

use, include these files with your source code (the disk volume is selected at your site):

Naming Rules for Applications

Compaq uses symbolic names beginning with the letter Z for all definitions (including

the fields of structures) in definition files. To avoid conflicts with Compaq names, do not

begin any names you define in your application with an uppercase or lowercase Z.

Common Syntax Elements

These syntax elements are common to FUP commands. Not every element is

applicable to each command.

Command Numbers

Each FUP command is assigned a unique command number. The command numbers

are represented by symbolic names using the form ZFUP-CMD-name. (The name

C Use the #INCLUDE directive to include the ZSPIDEF.ZSPIC and

ZSPIDEF.ZFUPC files.

COBOL85 Use the COPY statement to include ZSPIDEF.ZSPICOB and

ZSPIDEF.ZFUPCOB. Use the COPY statement with the REPLACING option

to include a section of a file.

TACL Load the ZSPIDEF.ZSPITACL and ZSPIDEF.ZFUPTACL files. To avoid buffer

overflows during loading, load each file:

PUSH X

#LOAD / LOADED X / $volume.ZSPIDEF.ZFUPTACL

POP X

TAL Use the ?SOURCE directive to include ZSPIDEF.ZSPITAL and

ZSPIDEF.ZFUPTAL.

Note. Except for the examples in TAL, the symbolic names in this manual are in DDL (or

COBOL85) format using hyphens (-) as separators. If you are writing a TAL or TACL

application, substitute the circumflex (^) symbol for the hyphens. If you are writing a C

application, substitute the underscore (_) symbol for the hyphens.