Communicator e3000 MPE/iX Release 6.5 (Non-Platform Software Release C.65.00 (30216-90291)

52 Chapter3
Growth Solution
MPE/iX Large Files Overview
HPFFILLDATA
NM callable only.
This routine can be used to efficiently initialize a buffer with a specified character value.
Syntax
I64 @64 CV I32
HPFFILLDATA ( count, buffer_ptr, fill_char, status )
Parameters
count 64-bit signed integer by reference (required)
A positive count of the number of bytes in the buffer indicated by the
buffer_ptr parameter that should be initialized.
buffer_ptr 64-bit pointer by value (required)
A pointer to the buffer that should be initialized. The
buffer_ptr may
point to any valid object in your stack, heap, or a file that has been opened
with user-mapped access.
fill_char Character value by value (required)
The character value that should be used to initialize the specified buffer.
Any value in the range of 0 through 255 can be specified, including all
printable and non-printable ASCII characters.
status 32-bit signed integer by reference (optional)
Returns the status of the HPFFILLDATA call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
encountered,
status is interpreted as two 16-bit fields. Bits (0:16)
comprise status.info. A negative value indicates an error condition,
and a positive value indicates a warning condition. Bits (16:16) comprise
status.subsys. The value represents the subsystem that set the status
information.
Miscellaneous
This section covers several issues that are related to Large Files that may be of interest to
the reader.
STORE/RESTORE Impact
The STORE and RESTORE utilities have been modified to handle Large Files. This
enhancement was accomplished in such a fashion that STORE tapes with Large Files are
completely compatible with previous versions of the operating system. A STORE tape
created on release 6.5 can be taken to any other MPE/iX system and be successfully
restored. On systems prior to 6.5, any Large File on the tape is not recognized as a valid
file and will not be restored onto the system. Although Large Files are skipped over in this
scheme, all other files will be able to be restored.
Any attempt to store a Large File using the ;TRANSPORT STORE option results in an error
at store time.
In addition to the STORE/RESTORE and TurboSTORE products all supporting Large Files,
most, if not all, 3rd party backup products have also been enhanced to support Large Files.