|
|
|
Sequentially writes a block of data to a KSAM/XL file in the physical order.
Syntax
REC I32A A I32 I32
AIFKSMWRITE ( overall_status, filenum, buffer, bytes, user_id );
Parameters
- overall_status
- record by reference (required)
Returns the overall status of the call. A zero indicates a successful
call. A negative value indicates an error in the overall call. Refer to
appendix A for meanings of status values.
- filenum
- 32-bit signed integer by value (required)
An identifier supplying the file number of the file to be written.
- buffer
- character array by reference (required)
Contains the block of data to be written. The content of the block was
obtained from an AIFKSMREAD.
- bytes
- 32-bit signed integer by value (required)
An integer specifying the number of bytes to be transferred. If the
value is zero, no transfer occurs. If bytes is larger
than the remaining bytes of the file, only the number of bytes up to the
EOF are written to the file.
- user_id
- 32-bit signed integer by value (optional)
The user ID assigned to a vendor at the time of purchase of the
Architected Interface Facility: Operating System product. If it is not
passed, the caller must have previously called AIFACCESSON.
Default: 0
Operation Notes
The AIFKSMWRITE call writes a block of data to the KSAM/XL file. The
contents are contained in the array buffer, which was obtained from an
AIFKSMREAD call. AIFKSMWRITE writes the file in its physical
sequence. It writes the indexes of the file, skips the unused index area, then
writes the data records. Following the execution of AIFKSMWRITE, the
data pointer is positioned to the next physical byte to be written, or at the
end-of-file if the last byte of the file has already been written.
|
