mcfthldoq [-s MCF-communication-process-identifier] -l logical-terminal-name [-k hold-type]

The mcfthldoq command holds the process of a logical terminal output queue.

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 mcftrlsoq command to release the held process.

-s MCF-communication-process-identifier

Specifies the MCF communication process identifier of the MCF communication service controlling the target logical terminal. No more than one MCF communication process identifier can be specified.

If this option is omitted, the mcfthldoq command is executed on all MCFs. This means that the overhead required to search for the MCF communication services is added to the processing load of the operation commands.

If you want to have a configuration that includes lots of MCF communication services or if you wan to use many operation commands, use the -s option to specify an MCF communication process identifier.

-l logical-terminal-name~<1-8 character identifier>

Specifies the name of the logical terminal whose output queue process is to be held.

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

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

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

*

Holds the output queue process for all logical terminals.

leading-string*

Holds the output queue process for all logical terminals beginning with the leading string.

<Example of specifying more than one logical terminal>

To specify len1, len2, and len3: -1 "len1len2len3"

<Example of specifying a group of logical terminals>

To specify all logical terminals beginning with len, code: -l "len*"

-k hold-type~<<insc>>

Specifies the type of holding.

insc

Both input and scheduling of output queues are held.

in

Only input of output queues is held.

sc

Only scheduling of output queues is held.

Message ID	Description	Output destination
KFCA10104-W	Specified logical terminal has been held.	Standard error output
KFCA10122-W	Command was processed normally, but status inherit cataloging failed.	Standard error output
KFCA10123-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
KFCA10350-I	mcfthldoq command has been entered.	Standard output
KFCA10351-E	MCF startup processing is underway.	Standard error output
KFCA10352-E	MCF termination processing is underway.	Standard error 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 mcfthldoq command input source failed.	Message log file or standard error output
KFCA10371-I	mcfthldoq command has been accepted normally.	Standard output
KFCA10373-E	mcfthldoq command terminated abnormally.	Standard error output
KFCA10380-E	Retrieval of remote process failed.	Standard error output
KFCA10382-E	Specified logical terminal has not been cataloged.	Standard error output
KFCA10391-E	mcfthldoq command is not supported.	Standard error output
KFCA10525-I	Help message	Standard output
KFCA16402-E	RPC error occurred during command processing.	Standard error output

• If a UAP sends a message to a logical terminal for which the input of the output queue is held, it stops until the held process is released.
• For a UAP sending messages to multiple logical terminals, if the input of the output queue for one of the logical terminals is held, the messages to the other logical terminals may also be stopped until the held process is released.
• 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.