gtpc2m84 | C/C++ Language Support User's Guide |
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:
- FCZ_YES - The default subsystem index in the entry control block (ECB)
will be used as input.
- FCZ_NO - The user-provided subsystem index in the IDSFCZ parameter block
will be used as input.
- default_SSU
- Specifies if the default SSU index is to be used as input to the service,
where:
- FCZ_YES - The default SSU index in the ECB will be used as input.
- FCZ_NO - The user-provided SSU index in the IDSFCZ parameter block will be
used as input.
- default_proc
- Specifies if a default processor ordinal number in the ECB will be used as
input to the service, where:
- FCZ_YES - The default processor ordinal number in the ECB will be used as
input.
- FCZ_NO - The user-provided processor ordinal number in the IDSFCZ
parameter block will be used as input.
- default_IStream
- Specifies if the default I-stream number in the ECB will be used as input
to the service, where:
- FCZ_YES - The default I-stream number in the ECB will be used as
input.
- FCZ_NO - The user-provided processor I-stream number in the IDSFCZ
parameter block will be used as input.
- request
- Specifies the type of request, where:
- FCZ_USER - The user has to specify the request type and set up the correct
record ID in the IDSFCZ parameter block as input.
- FCZ_FACE - Indicates a FACE-type call. The record type number must
be placed in the IDSFCZ parameter block input area.
- FCZ_FACS - Indicates a FACE-type call. The 8-character record name
(padded with blanks) must be placed in the IDSFCZ parameter block input
area.
- FCZ_FACE8 - indicates a FAC8C-type call. The 8-byte ordinal number
and record type number must be placed in the IDSFCZ parameter block input
area.
- FCZ_FACS8 - indicates a FAC8C-type call. The 8-byte ordinal number
and 8-byte character record type name (padded with blanks) must be placed in
the IDSFCZ parameter block input area.
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
- This function requires that the application program allocation specify
authorization to issue a restricted macro.
- A symbolic record type (FACS or FAC8C interface) or record type number
(FACE interface) and an ordinal within that record type must be
provided. The type of call (FACS, which is the default, FACE, FACE8, or
FAC8C) is specified by using the request parameter.
Optionally, a subsystem, subsystem user, processor, or I-stream (or any
combination of these) can be provided.
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