mcfthldiq -g service-group-name [-k hold-type] [-r]

The mcfthldiq command holds the process of input queues for the specified service group.

Using this command affects the OpenTP1 system as described in the notes below. Once this command is executed and the target processing terminates, be sure to execute the mcftrlsiq command to release the held process.

-g service-group-name ~<1-31 character identifier>

Specifies the name of a service group whose input queue process is to be held.

A maximum of eight service group names can be specified. When entering large amounts of inputs for the operation, specify more than one service group or specify a group of service groups to increase the number of service groups to be processed in parallel by one command while reducing the number of commands to be entered.

To specify multiple service group names, separate them by a space and enclose the entire string of service group names in double quotation marks ("). The same service group name cannot be duplicated when specified.

The asterisk (*) can be used in the specification to indicate a group of service names. Only one group can be specified. The name of a group of service groups cannot coexist with the names of service groups for which no grouping is specified. A group name must be enclosed in double quotation marks (").

*

Holds input queues for all service groups.

leading-string*

Holds input queues for all service groups beginning with the leading string.

<Example of specifying more than one service>

To specify seg1, seg2, and seg3: -g "seg1seg2seg3"

<Example of specifying a group of service groups>

To specify all services beginning with seg, code: -g "seg*"

-k hold-type~<<insc>>

Specifies the type of holding.

insc

Both input and scheduling of input queues are held.

in

Only input of input queues is held.

sc

Only scheduling of input queues is held.

-r

Specifies that the hold status of the service group not be inherited after full recovery.

Message ID	Description	Output destination
KFCA10350-I	mcfthldiq command has been entered.	Standard output
KFCA10353-W	Input format is invalid.	Standard error output
KFCA10354-E	Memory is inadequate.	Standard error output
KFCA10355-W	Specification of an argument is invalid.	Standard error output
KFCA10356-E	Overtime occurred during process.	Standard error output
KFCA10357-E	Overtime occurred in MCF.	Standard error output
KFCA10358-E	Error occurred in an internal function.	Standard error output
KFCA10359-W	Response to mcfthldiq command input source failed.	Message log file or standard error output
KFCA10371-I	mcfthldiq command has been accepted normally.	Standard output
KFCA10373-E	mcfthldiq command terminated abnormally.	Standard error output
KFCA10380-E	Retrieval of remote process failed.	Standard error output
KFCA10383-E	Specified service group has not been cataloged.	Standard error output
KFCA10523-I	Help message	Standard output
KFCA11072-W	A specified service group has been held.	Standard error output
KFCA11088-W	Command was processed normally, but status inherit cataloging failed.	Standard error output
KFCA11089-W	Command was processed normally, but status inherit cataloging failed because number of inherit statuses exceeded the maximum specified in the definition.	Standard error output
KFCA11800-W	Input queue cannot be held or released from hold status due to SPP resources.	Standard error output
KFCA16402-E	RPC error occurred during command processing.	Standard error output

• If you hold the input of the input queue for a service group which is started up with the MCF application start service, the MCF application start service holds the startup of all the service groups.
• If you hold the input of the input queue for a service group which the MCF communication service starts, the messages to be sent to the logical terminal of the input source also remain in the OTQ until the held process is released.
• If you hold the input of the input queue for a service group which the MCF communication service starts, the processing performance of the MCF communication service may be degraded.
• When there is at least one held service group, an attempt to perform normal termination, planned termination A, or planned termination B causes OpenTP1 to terminate abnormally. In this case, execute the dcstop command after releasing all the service groups from hold.
• If an attempt is made to input a message to the service group for which the input of the input queue is held, the operation command to the logical terminal of the input source and the connection to which the logical terminal belongs may result in a timeout. The operation command is accepted even if a timeout occurs. The operation command is executed after releasing the service group from hold.