Preparing and Executing the Program › Precompiling the Program › Precompiler Options › Parameters

Parameters

RCM = rcm-name

Specifies the name of the RCM created for the program by the precompiler.

This parameter must be specified for all host language programs except COBOL.

If this RCM is not specified to the COBOL precompiler, the RCM name is the program name identified in the program source. If the name is not identified in the program, you must specify an RCM parameter.

RCMVERSION = rcm-version-number

Specifies the version number of the RCM created for the program by the precompiler.

If RCMVERSION is not specified, the version number defaults to 1. If an RCM with the same version number already exists in the dictionary, the precompiler replaces the existing RCM.

AM = access-module-name

Specifies the name of the access module to be executed for the program at runtime.

The program can override this specification at runtime by issuing a SET ACCESS MODULE statement.

If this parameter is not specified, the access module name defaults to rcm-name.

The access module specified in access-module-name does need not exist when the program is precompiled. However, if the access module does not exist when the program is executed, an invalid SQL statement identifier error occurs.

SCHEMA = schema-name

Specifies the default schema-name qualifier for the precompiler to use when processing an INCLUDE TABLE statement that does not supply a qualifier.

If an INCLUDE TABLE statement supplies a qualifier, the SCHEMA parameter is ignored for that table.

If SCHEMA is not specified and an INCLUDE TABLE statement does not supply a qualifier, the precompiler returns an error.

NOINSTALL

Specifies that the precompiler should only check syntax.

If this parameter is specified, the precompiler does not store the RCM.

If this parameter is not specified and the precompiler executes without errors, the precompiler stores the RCM.

DICTNAME = dictionary-name

Specifies the name of the dictionary the precompiler should access.

If this parameter is not specified, the precompiler defaults to the dictionary specified in the DICTNAME parameter of the SYSIDMS statement in the precompiler JCL.

Note: For more information about sample precompiler JCL, see Sample JCL.

If this parameter is not specified and there is no SYSIDMS DICTNAME parameter, the CA IDMS returns an error at runtime.

SQL =

Specifies the SQL syntax standard that the precompiler should apply when checking the validity of SQL statements in the program.

The precompiler issues a warning if it detects an SQL statement that does not comply with the standard specified in this parameter.

If this parameter is not specified, the default is the same as specifying SQL = NO.

NO

Specifies that compliance with a named SQL standard is not checked or enforced, and all CA IDMS extensions are permitted.

89

Directs the precompiler to use ANSI X3.135-1989 (Rev), Database Language SQL with integrity enhancement, as the standard for compliance.

FIPS

Directs the precompiler to use FIPS PUB 127-1, Database Language SQL, as the standard for compliance.

LIST

Directs the precompiler to create a listing of the program with precompiler messages.

If this parameter is specified, the program listing is written to the SYSLST file.

If this parameter is not specified, the default is the same as specifying NOList.

The precompiler directive NODMLIST, included in the program source, overrides the EXEC PGM parameter LIST.

Note: For more information about NODMLIST, see Precompiler Directives.

NOList

Directs the compiler not to create a listing of the program with precompiler messages.

The precompiler directive DMLIST, included in the program source, overrides the EXEC PGM parameter NOList.

Note: For more information about DMLIST, see Precompiler Directives.

COBOL =

Specifies the version of COBOL with which COBOL statements generated by the precompiler must comply.

If this parameter is not specified, the default is the same as specifying COBOL = 2.

1

Directs the precompiler to comply with versions of COBOL that precede VS-COBOL II when generating COBOL statements.

2

Directs the precompiler to comply with VS-COBOL II when generating COBOL statements.

DATE =

Specifies the format of the DATE data type to be used for communication between the program and the database when the access module is executed.

TIME =

Specifies the format of the TIME data type to be used for communication between the program and the database when the access module is executed.

Note: You can use the DATE and TIME parameters to override the default for the installation.

ISO

Specifies that the format of the DATE data type should comply with the standard of the International Standards Organization. Formats used when ISO is specified are:

USA

Specifies that the format of the DATE data type should comply with the standard of the IBM USA standard. Formats used when USA is specified are:

EUR

Specifies that the format of the DATE data type should comply with the standard of the IBM European standard. Formats used when EUR is specified are:

JIS

Specifies that the format of the DATE data type should comply with the standard of the Japanese Industrial Standard Christian Era. Formats used when JIS is specified are: