OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

mcftdlqle (Delete output queues for logical terminals)

Format

mcftdlqle [-s MCF-communication-process-identifier]
          -l logical-terminal-name [-d deletion-type]

Function

The mcftdlqle command deletes the entire output queues for specified logical terminals.

When the mcftdlqle command is to be used independently, the applicable logical terminal must first be shut down using the mcftdctle command or the dc_mcf_tdctle function. When the TP1/NET/HNA-560/20 protocol is used, the mcftdctss command must also be executed to terminate the session. The logical terminal must not be a terminal of alternate origin.

If the mcftdlqle command is used with the mcftdmpqu command, the mcfthldoq command must first be executed to hold the output queue process of the logical terminal before executing the mcftdlqle command.

Options

-s MCF-communication-process-identifier~<numerals (0-9), a-f> ((01-ef))

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 mcftdlqle 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 want to use many operation commands, use the -s option to specify an MCF communication process identifier.

-l logical-terminal-name~<identifier, 1-8 characters>

Specifies the name of a logical terminal whose output queue is to be deleted.

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. 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 (").

*
Specifies that the output queues of all logical terminals are to be deleted.

character-string*
Specifies leading characters of a logical terminal name when the output queues of all logical terminals with names beginning with the specified character string are to be deleted.

<Example of specifying more than one logical terminal>
To specify len1, len2, and len3: -1 "len1[Figure]len2[Figure]len3"

<Example of specifying a group of logical groups>
To specify all logical terminals beginning with len, code: -l "len*"

-d deletion-type

Specifies the type of deletion.

disk
Only disk queues are deleted.

memory
Only memory queues are deleted.

all
Both disk and memory queues are deleted.

When this option is specified, events that report the discarding of an unprocessed message (ERREVTA) are not reported.

When this option is omitted, the MHP for MCF events that report the discarding of an unprocessed message is activated to delete the output queues (disk queue and memory queue).

Output messages

Message ID Description Output destination
KFCA10103-E A specified logical terminal has not been shut down. Standard error output
KFCA10350-I mcftdlqle 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 mcftdlqle command input source failed. Message log file or standard error output
KFCA10371-I mcftdlqle command has been accepted normally. Standard output
KFCA10373-E mcftdlqle command terminated abnormally. Standard error output
KFCA10380-E Retrieval of remote process failed. Standard error output
KFCA10382-E A specified logical terminal has not been cataloged. Standard error output
KFCA10391-E mcftdlqle command is not supported. Standard error output
KFCA10507-I Help message Standard output
KFCA16402-E RPC error occurred during command processing. Standard error output