[mcfttim [-t "[btim=time-check-interval] [mtim=unprocessed-send-message-remaining-time] [rmtim=unprocessed-receive-message-remaining-time]"] [-p "[usertime=yes|no] [timereqno=maximum-number-of-time-monitored- requests] [msgsize=maximum-message-length] [msgout=yes|no]"]]

This command defines the environment related to an MCF time check.

-t

(Operands)

btim=time-check-interval~<unsigned integer> ((1-60)) <<1>> (Unit: seconds)

Specify the interval for a time check of an MCF communication service.

MCF checks at this interval whether a specified time limit has elapsed. An error in the time check value specified with other operands is affected by the length of this interval and will be magnified.

mtim=unprocessed-send-message-remaining-time~<unsigned integer> ((60-65535)) <<180>> (Unit: seconds)

Specify the resident time for unsent messages.

When MCF is terminating, the resident time of unsent messages remaining in the output queue is checked. This prevents an unduly long termination process; the time check however is valid only for a normal termination.

Messages remaining in the queue after the specified time elapses are deemed to have been transmitted, and termination processing will continue. In this case, the unprocessed send message is discarded and an MCF event that reports the discarding of an unprocessed message (ERREVTA) is issued.

Note that monitoring is suspended on a timer start request message by the dc_mcf_execap function for the resident time of unsent messages remaining in the output queue. If a timer start request message remains when the command to normally terminate OpenTP1 is executed, the timer start request message is discarded immediately and ERREVTA is reported.

rmtim=unprocessed-receive-message-remaining-time~<unsigned integer> ((60-65535)) <<0>> (Unit: seconds)

Specify the resident time for unprocessed received messages.

When MCF is terminating, the resident time in which unprocessed received messages remaining in the input queue is checked. This prevents an unduly long termination process; the time check however is valid only for a normal termination or planned termination A.

MCF will terminate abnormally if messages are remaining in the queue after the specified time elapses. Specify 0 for no time monitoring; in this case, MCF waits until all received messages in the queue are processed.

-p

(Operands)

usertime=yes|no~<<no>>

Specify whether to use the facility for user timer monitoring.

yes

Uses the facility for user timer monitoring.

no

Does not use the facility for user timer monitoring.

timereqno=maximum-number-of-time-monitored-requests~<unsigned integer> ((1-10000)) <<16>>

Specify the maximum number of requests to be monitored for a timeout.

msgsize=maximum-message-length~<unsigned integer> ((0-256)) <<0>> (units: bytes)

Specify the maximum segment length of the message to be passed to the MHP to be started if a timeout occurs.

msgout=yes|no~<<no>>

This operand specifies:

• Whether to output message KFCA16518-I if the function for canceling the user timer monitoring returns an error of DCMCFER_PARAM_TIM_ID (for C) or an error of 70910 (for COBOL)
• Whether to output message KFCA16519-I if a timeout occurs

yes

Outputs these messages.

no

Does not output these messages.