The Generate Indicators using CLF (GENINDCLF) command generates an output file that contains CLF-related indicator definitions as CL source statements. These source statements are placed into a source file member that can be used as input when compiling a CL program.

The command can generate CL definitions for:

• indicators related to file input/output conditions related to CLF processing
• a separate indicator area that can be used instead of passing indicators in Input/Output buffers. This option should be used in conjunction with the Separate indicator area (SEPINDARA) parameter of the Open File using CLF (OPNFCLF) command.

To directly include indicator related definitions as part of a CL compilation see the Declare Indicators using CLF (DCLINDCLF) command and precompiler commands such as Create Bound CLF Program (CRTBNDCLF) and Create CLF Program (CRTCLFPGM).

Parameters

Source file (SRCFILE)

Specifies the database source file where the CL source statements are to be written. This file must exist when the command is run.

Qualifier 1: Source file

QCLSRC

The source file used will be QCLSRC.

name

Specify the name of the source file.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the thread is used to locate the source file. If no library is specified as the current library for the thread, the QGPL library is used.

name

Specify the name of the library to be searched.

Source member (SRCMBR)

Specifies the database source file member where the CL source statements are to be written. If the name is not specified, the file name is used. If the member does not exist, is is created.

INDICATORS

The name of the source member will be INDICATORS.

*FILE

The name of the file specified by the SRCFILE parameter is used as the member name.

name

Specify the name of the source file member that will contain the CL source statements.

Replace or add records (MBROPT)

Specify how the CL source is to be stored when an existing source member is specified for the SRCMBR parameter.

*REPLACE

The output data replaces any existing records in the specified source member.

*ADD

The output data is added to the end of existing records in the specified source member.

CLF file-related indicators (CLFIND)

Specifies if CLF file-related indicators are to be declared.

*NO

No CLF file-related indicators are to be declared.

*YES

CLF file-related indicator are to be declared. The indicators, and the Input/Output parameter associated with each indicator, are:

 

    &EOF    EOF        End of File
    &ERR    ERR        Error (such as record not available)
    &RNF    RCDNOTFND  Record Not Found

 

Indicators 01 - 99 (INDARA)

Specifies whether a separate indicator area should be declared.

*NO

A separate indicator area will not be declared.

*YES

A separate indicator area will be declared.

The name of the separate indicator area will be &CLF_IND_. The &CLF_IND_ variable will be defined as TYPE(*CHAR) with LEN(99) and have each character within the variable set to '0' (off). CL logical variables &IN01 through &IN99 will be declared and defined over the &CLF_IND_ variable. &IN01 will correspond to the first byte of &CLF_IND_, &IN02 the second byte, and so on.

Text 'description' (TEXT)

Specifies a character string that describes the member in the text field for the member.

*BLANK

The source member text field is set to all blanks.

character-value

Specify a character string of up to 50 characters to describe the source member. Enclose the string in apostrophes to use leading or trailing blanks.

Examples for GENINDCLF

Example 1: Generating Indicator Definitions

    GenIndCLF  CLFInd(*Yes) IndAra(*Yes)
      Text('CLF Indicator Definitions')

This command will generate CL DCLs for CLF file-related indicators and a separate indicator area for indicators &IN01 through &IN99. The generated CL source will be stored in file QCLSRC, member INDICATORS. If member INDICATORS does not exist in QCLSRC it will be added. If member INDICATORS does exist in QCLSRC it will be cleared prior to storing the generated source. The text description for member INDICATORS will be 'CLF Indicator Definitions'.

Error messages for GENINDCLF

*ESCAPE Messages

VC29002

Function did not complete. See previously listed messages related to possible user errors.

VC29003

Function did not complete. See previously listed messages for possible cause.

VC29004

Function did not complete. See previously listed messages for possible cause.

VC29005

Function did not complete. Contact your service provider.