#pragma comment

Purpose

Places a comment into the object module.

Syntax

Read syntax diagramSkip visual syntax diagram#pragmacomment( compilerdatetimestampcopyrightcsect_copyright,csect_nameuserservice,"token_sequence" )

Parameters

compiler
Appends the name and version of the compiler in an END information record at the end of the generated object module. The name and version are not included in the generated executable, nor are they loaded into memory when the program is run.
date
The date and time of the compilation are appended in an END information record at the end of the generated object module. The date and time are not included in the generated executable, nor are they loaded into memory when the program is run.
timestamp
Appends the date and time of the last modification of the source in an END information record at the end of the generated object module. The date and time are not included in the generated executable, nor are they loaded into memory when the program is run. If the compiler cannot find the timestamp for a source file, the directive returns Mon Jan 1 0:00:01 1990.
copyright
Places the text that is specified by the token_sequence, if any, into the generated object module. The token_sequence is included in the generated executable and loaded into memory when the program is run.
C only. csect_copyright
Places the text that is specified by the token_sequence, if any, into a CSECT section named csect_name in the generated object module. token_sequence is included in the generated executable and loaded into memory when the program is run.
C only. csect_name
The user-specified csect_name should not conflict with CODE, STATIC, or other reserved CSECT names specified by using #pragma csect.
user
Places the text that is specified by the token_sequence, if any, in the C_COPTIONS section of the generated object module.
service
Places the text that is specified by token_sequence in the object module. If the application fails abnormally, the text is displayed in the traceback.
token_sequence
The characters, if specified, enclosed in double quotation marks ("). This field has a 32767-byte limit.

Usage

More than one #pragma comment directive can appear in a translation unit. The #pragma comment user directive can appear multiple times while the #pragma comment copyright directive can appear only once.

-mzos-service overrides the #pragma comment(service,string) pragma directives that are specified in source files.

Related information