gtpc2m84C/C++ Language Support User's Guide

tpf_faczc-File Address Calculation

This function provides the interface to the file address compute program (FACE) address generation routines and allows access to records that are unique to a subsystem, subsystem user (SSU), processor, or I-stream.

Format

#include <sysapi.h>
int tpf_faczc(IDSFCZ *idsfcz,
              FCZ_YES_NO default_SS,
              FCZ_YES_NO default_SSU,
              FCZ_YES_NO default_proc,
              FCZ_YES_NO default_IStream,
              FCZ_REQUEST request);

idsfcz
A pointer to the IDSFCZ parameter block that holds the input and output of the FACZC system service.

default_SS
Specifies if a default subsystem index is to be used as input to the service, where:

default_SSU
Specifies if the default SSU index is to be used as input to the service, where:

default_proc
Specifies if a default processor ordinal number in the ECB will be used as input to the service, where:

default_IStream
Specifies if the default I-stream number in the ECB will be used as input to the service, where:

request
Specifies the type of request, where:

Normal Return

FCZRC_OK.

Error Return

FCZRC_TYPE_NOT_IN_USE
The requested record type is not in use.

FCZRC_OUT_OF_RANGE
The requested record type does not exist or exceeds the limit.

FCZRC_ORD_OUT_OF_RANGE
The record ordinal number is out of the allowable range.

FCZRC_NO_SPLIT_CHAIN
The record has no split chain.

FCZRC_PARM_OUT_OF_RANGE
The input parameter is outside the allowable range.

Programming Considerations

Examples

The following example generates a file address for "#PROG1" record number 235.

#include <sysapi.h>

·
·
·
IDSFCZ f={0}; f.fcz_ordinal=235; memcpy(f.fcz_rec_type.name, "#PROG1 ",8); f.fcz_request_type =FCZ_REQ_FACS; tpf_faczc(&f, FCZ_YES, FCZ_YES, FCZ_YES, FCZ_YES, FCZ_USER);

Related Information