*CONTROL (*CBL) 语句

在线编辑

使用 *CONTROL (或 *CBL) 语句，可以选择性地显示或禁止在整个源文本中列出源代码和存储器映射。

格式

读取语法图跳过可视语法图*CONTROL*CBLSOURCENOSOURCELISTNOLISTMAPNOMAP.

有关这些选项生成的输出的完整讨论，请参阅 COBOL for Linux® on x86 Programming Guide中的 Getting listings 。

有关指定列表是以 UTF-8 编码还是以编译时语言环境指定的代码页编码的信息，请参阅 COBOL for Linux on x86 Programming Guide中的 LSTFILE 。

*CONTROL 和 *CBL 语句是同义词。 在接受 *CBL 的任何位置接受 *CONTROL。

字符 *CONTROL 或 *CBL 可以在以列 7 开头的任何列中开始，后跟至少一个空格或逗号以及一个或多个选项关键字。 选项关键字必须由一个或多个空格或逗号分隔。 此语句必须是行上的唯一语句，并且不允许继续。 可以使用句点来终止该语句。

必须在程序源中嵌入 *CONTROL 和 *CBL 语句。 例如，对于批处理应用程序，必须将 *CONTROL 和 *CBL 语句放在 PROCESS (CBL) 语句与程序结束之间 (或 END PROGRAM 标记 (如果指定))。

包含 *CONTROL (*CBL) 语句的源行不会出现在源列表中。

如果在安装时将某个选项定义为固定选项，那么该固定选项优先于以下所有 参数和语句:

  • PARM (如果可用)
  • CBL 语句
  • *CONTROL (*CBL) 语句

请求的选项按以下方式处理:

  1. 如果选项或其否定在 *CONTROL 语句中出现多次，那么将使用最后出现的选项字。
  2. 如果已请求相应选项作为编译器的参数，那么带有选项字否定的 *CONTROL 语句必须在要禁止其列示输出的源文本部分之前。 当迂到带有肯定选项字的 *CONTROL 语句时，将继续列示输出。
  3. 如果已请求将相应选项的求反作为编译器的参数，那么 始终 禁止该列表。
  4. *CONTROL 语句仅在写入它的源程序 (包括任何包含的程序) 中有效。 在对两个或多个 COBOL 源程序进行批量编译时，它不会继续有效。