Product Documentation

FairCom RTG COBOL Edition User's Guide

Previous Topic

Next Topic

Substitution Specifiers

The value of some configuration elements may contain substitution specifiers that are expanded to actual content at runtime. This feature is useful when it is required to set configuration elements to values that are known only at runtime.

The following substitution specifiers are supported:

  • %n Expands to name of the file affected by configuration.
  • %d Expands to directory of the file affected by configuration.
  • %p Expands to the process ID (PID) of the runtime client process.
  • %t Expands to the thread ID of the runtime client process.
  • %i Expands to the instance number of the runtime client process.
  • %(ENV) Expands to content of environment variable ENV. See below.

In addition, %p, %t, and %i can optionally contain embedded format specifiers with the following prototype:

%[0][width][x|X]specifier

  • [0] left-pads the number with zeroes (0) instead of spaces when width is specified.
  • [width] minimum number of characters to be printed. If the value to be printed is shorter than this number, the result is padded with blank spaces. The value is not truncated even if the result is larger.
  • [x] number is an unsigned hexadecimal integer.
  • [X] number is an unsigned hexadecimal integer (uppercase).

%(ENV) as well as %n, %d, %p, %t, and %i can be used on the following:

  • server, user, password in the instance tag.
  • file and dir in the file tag.
  • dir and file values in the <map> specifications.

TOCIndex