gtpc2m5j | C/C++ Language Support User's Guide |
This function is used to generate the address of a subsequent record on a
general file when the current position is known.
Format
#include <tpfapi.h>
void raisa(enum t_blktype size, enum t_lvl level, int count,
int type, int dev);
- size
- The record size to which the target general file has been
formatted. This argument must belong to enumeration type
t_blktype, which is defined in tpfapi.h.
Use Lx notation, as follows:
- L1
- 381 bytes
- L2
- 1055 bytes
- L4
- 4095 bytes.
- level
- One of 16 possible values representing a valid data level from enumeration
type t_lvl, expressed as Dx, where x represents
the hexadecimal number of the level (0-F). The FARW on this
level contains the file address of the current file position.
- count
- This argument is an unsigned integer representing the number of records to
add to the current file address to arrive at the requested position or file
address. Do not use a negative value as this
argument.
- type
- The type of addressing scheme used to address the records on the
file. Use the defined terms RAISA_RRN to reflect relative
record number addressing, or RAISA_MCHR to reflect absolute
module/cylinder/head/record addressing.
- dev
- The device type on which the general file resides. The supported
device types are: 3390, 3380, 3375, and 3350. Use the defined
terms RAISA_D3390 to indicate 3390, RAISA_D3380 to
indicate 3380, RAISA_D3375 to indicate 3375, or
RAISA_D3350 to indicate 3350.
Normal Return
Void. The FARW has been updated with the proper file address.
Error Return
Not applicable.
Programming Considerations
- This function is provided for RRN and 4-byte MCHR formats for online
programs only.
- Specifying an invalid parameter results in a system error with
exit.
Examples
The following example increments the RRN file address on level D3 by one
1055-byte record for a general file on a 3380.
#include <tpfapi.h>
·
·
·
raisa(L2,D3,1,RAISA_RRN,RAISA_D3380);
Related Information