gtpc2m5jC/C++ Language Support User's Guide

raisa-General File Get File Address

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

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