gtpc2m82C/C++ Language Support User's Guide

tpf_esfac-Obtain Extended Symbolic File Address Information

This function obtains information about the characteristics of a specific symbolic file address.

Format

#include  <sysapi.h>
int tpf_esfac(unsigned int file_address, tpf_sonfmt *son_info);

or

#include  <sysapi.h>
int tpf_esfac(TPF_FA8 *fa8, tpf_sonfmt *son_info);

file_address
A file address for which the information is to be obtained.

fa8
A pointer to an 8-byte file address for which the information is to be obtained.

son_info
A pointer to an empty record where the information is to be kept upon return.

Normal Return

Integer value of 0 indicating successful completion.

Error Return

A nonzero value is returned if the file address information could not be obtained.

Programming Considerations

Examples

The following example returns the file characteristics of the file address reference format (FARF) address in ECB data level 2 and for the specified 8-byte file address.

#include <sysapi.h>

  ·
  ·
  ·
int retval; tpf_sonfmt son_info; TPF_FA8 fa8;
  ·
  ·
  ·
retval = tpf_esfac((const unsigned int)ecbptr()->ebcfa2, &son_info);
  ·
  ·
  ·
retval = tpf_esfac(&fa8, &son_info);

Related Information

sonic-Obtain Symbolic File Address Information.