gtpd1m1yDatabase Reference

Offline Interface

An offline (MVS) program that requires a file address can link or call DFAD. To do this, code the following statement in the MVS program:

   CALL DFAD, (recid,ord,ret,nn)

Where:

recid
is a halfword record type equate value.

ord
is a fullword ordinal number.

ret
is the FACE program output area. The 4-byte FACE output will be located at ret+4. This address can be aligned to any boundary.

nn
is the 2-character FCTB version in EBCDIC form.

In this mode of operation no external (for example, print or console) communication is used.

DFAD loads the FACE table (FCTB) and gets a single file address. If no errors occur, a zero return code is set in register 15, and DFAD returns to the calling program with the file address placed at the location specified by the user.

Offline Interface Errors

If the version of the FCTB specified is not available, the job ends with system completion code of 806.

A return code is placed in R15:

0
Normal return
1
Invalid or not-in-use record type
2
Ordinal number greater than maximum
3
Unsupported unique record type
4
FARF6 splits are not supported
8
Calling sequence error.