Previous Topic: ACID VerificationNext Topic: Establishing a Multiple ACID Environment


Field Information Extract

This function is useful for extracting information in user-defined fields on an ACID. In order to extract the information for a given ACID, the one issuing the diagnose must have been permitted use of the other ACID or have the NOSUBCHK attribute.

AIFUNC

Contains AI$FDTUX

AIFDTNME

Contains the field name to be extracted

AIACID

Name of ACID containing the field (leave blank for self)

AIFDTOUT

Address of user supplied buffer to contain extracted information

AIFDTLN1

Length of buffer in AIFDTOUT

AIFDTCODE

Returned FDTCODE used by system

AIFDTLN2

Size of actual data in user ACID

AIFDTLN3

Maximum field allowed as defined in FDT

The return codes contained in AIRC are as follows:

AIRC = 0

Extract successful

AIRC = 4

ACID does not have any FDT fields attached

AIRC = 8

ACID has FDT fields attached, but not the requested field

AIRC = 12

Bad parameters passed

AIRC = 16

Caller doesn't have necessary authority