 |
» |
|
|
|
Sequentially writes a block of data to a KSAM/XL file in the physical order. Syntax | |
REC I32A A
AIFKSMWRITE (overall_status, filenum, buffer,
I32 I32
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. |
