mcfmcomn [-n sequence-number-appended-logical-terminal-count] -p MCF-work-area-size [-i inc|msg] [-j journal-buffer-size] [-o "[cmdsvname=MCF-online-command-service-name]"] [-r number-of-simultaneous-transaction-processes-of-other-node] [-c maximum-number-of-concurrent-synchronous-sending-processes] [-w "[stats=yes|no]"]

This command defines the environment shared to MCF managers.

-n sequence-number-appended-logical-terminal-count~<unsigned integer> ((0-2048)) <<0>>

Specify the maximum number of logical terminals that are to use message sequence numbers with one MCF system. Specify 0 if message serial numbers are not to be used.

-p MCF-work-area-size~<unsigned integer> ((100-2000000)) (Unit: kilobytes)

Specify the size of the shared memory to be used by MCF processes. For this, compute the size of the shared memory to be secured statically for the tables and buffer pools.

Add the MCF work area size that you set here to static_shmpool_size in the system environment definition ($DCDIR/conf/env). If the MCF work area size is too small, memory might become insufficient even if the value of static_shmpool_size is sufficient.

If the MCF static shared memory becomes insufficient, one half the size specified by this option is automatically allocated from the unused area of the static shared memory (the value specified by the static_shmpool_size operand of the system environment definition). Memory is automatically allocated up to a maximum of 254 times. If the memory is still insufficient, log message KFCA10230-E is output along with error information.

If a static shared memory shortage is detected even though 254 or fewer automatic memory allocations have occurred, log message KFCA10240-E is output along with error information. Use the -i option to specify whether to output log message KFCA10242-I. To detect a static shared memory shortage, specify msg in the -i option so that a message is output.

-i inc|msg

~<<inc>>

Specify whether to output log message KFCA10242-I when a static shared memory shortage occurs in the MCF work area size specified in the -p option and additional memory is automatically allocated.

inc

No log message is output when additional memory is allocated to the static shared memory.

msg

Log message KFCA10242-I is output when additional memory is allocated to the static shared memory.

-j journal-buffer-size~<unsigned integer> ((multiple of 4 between 4096-4000000)) <<4096>> (Unit: bytes)

Specify the size of the area for storage of the journal data used for process recovery. An MCF manager process uses this area to store data for a journal service until the following requests are issued:

• output requests to the journal file,
• storage requests to the journal service buffer

Compute the size as:

[260 + (24 x m)],

where m is the number of retained messages (the value specified with the -m option of the message queue service definition). MCF will check and revise the specified value as follows:

1. if the specified value is smaller than the minimum value determined by MCF, it is revised upward to the said minimum value.
2. if the specified value is larger than the maximum value determined by MCF, it is revised downward to the said maximum value.
3. if the specified value is not a multiple of 4, it is rounded up to the nearest multiple of 4.

-o cmdsvname=MCF-online-command-service-name~<1-8 alphanumeric characters>

Specify the MCF online command service name.

For the values specified here, specify the alphanumerics with eight characters or less beginning with the _mcs header.

-r number-of-simultaneous-transaction-processes-of-other-node~<unsigned integer> ((0-1310720))

Specify the number of transactions of other node that are to be processed simultaneously by the MCF that provides remote MCF service.

-c maximum-number-of-concurrent-synchronous-sending-processes ~<unsigned integer> ((1-10000)) <<255>>

Specify the maximum number of SPP processes that can concurrently perform synchronous sending to logical terminals. The actual number of SPP processes that can perform synchronous sending cannot exceed the number specified by the prc_process_count operand in the process service definition. Therefore, when specifying this option, specify a value smaller than the value specified by the prc_process_count operand, considering the number of processes that perform synchronous sending concurrently. If the specified value is larger than the value specified by the prc_process_count operand, the value specified by the prc_process_count operand is assumed.

This option is valid for the resident and non-resident processes.

The concurrent synchronous sending process is a process placed in the wait state until receiving the response after performing synchronous sending to a logical terminal.

-w stat=yes|no~<<no>>

Specify whether to acquire MCF statistics.

yes

Acquires MCF statistics and stores them in static shared memory.

You can use the mcfstats and mcfreport commands to reference the stored MCF statistics.

no

Does not acquire MCF statistics.