bdfp1m15Programming Concepts and Reference

dfcre-Create a Subfile

Use this group of functions to create a new subfile, an empty pool subfile, or an empty indexed pool subfile with its corresponding index file. You can subsequently add logical records (LRECs) to the empty detail subfile as required.

Format

dft_hdr *dfcre(dft_fil *file, dft_opt options);
dft_hdr *dfcre_alg(dft_fil *file, dft_opt options, dft_alg *alg);
dft_hdr *dfcre_alg_pth_all(dft_fil *file, dft_opt options, dft_alg *alg);
dft_hdr *dfcre_alg_pth(dft_fil *file, dft_opt options, dft_alg *alg
        dft_pth pth);



alg
is a pointer to an algorithm argument that identifies the subfile.

The TPFDF product uses the algorithm argument to determine the subfile (ordinal number) that is to be accessed. Specify the algorithm argument based on the type of algorithm that is defined in the DSECT or DBDEF macro for the file. If the DSECT or DBDEF macro defines the #TPFDB04 or the #TPFDB0D algorithm, do not use this parameter.

If the subfile you are accessing is contained in a detail file or intermediate index file defined with the #TPFDBFF algorithm, the TPFDF product uses the algorithm argument to locate the subfile. See TPFDF Database Administration for more information about how the TPFDF product uses the algorithm argument to locate the subfile.

file
is a pointer to the base address of the SW00SR slot (defined in c$sw00sr.h) of the subfile that you want to access and is returned by the dfopn function.

options
are the processing options for this function. Use one of the following values:

DFCRE_INDEX
creates an indexed subfile and inserts an index LREC referencing this subfile into the related index file (or files) defined by the database administrator.

If you have supplied an algorithm argument when you opened the subfile (using a dfopn function), you can use DFCRE_INDEX with the dfcre function. If not, you must use the dfcre_alg function and supply an algorithm argument in the alg parameter.

If you specify this value, the algorithm defined for the new subfile must be #TPFDBFF.

0
specifies that you do not want to use any processing options.

pth
is the path number for a detail subfile using index support. The value is defined in the DBDEF macro and is a decimal number (0, 1, 2, and so on). The default path number is 0.

See TPFDF Database Administration for more information about path indexes.

Entry Requirements

None.

Normal Return

A pointer to the main storage address of the header of the prime block of the created subfile.

Error Return

 See Identifying Return Indicators and Errors for information about how to check the error indicators. 

Programming Considerations

Examples

The following example creates a new indexed subfile using the algorithm argument member_number.

dft_fil *file_ptr;
char member_number[10];

  ·
  ·
  ·
(void)dfcre_alg(file_ptr, 0, member_number);

Related Functions