OpenTP1 Version 7 Operation

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

mcftspqle (Skip first message in a logical terminal message queue)

Format

mcftspqle -s MCF-communication-process-identifier
          -l logical-terminal-name -t message-type [-g]

Function

The mcftspqle command deletes a specified logical terminal's first unsent message of a specified message type.

Before executing the mcftspqle command, you must shut down the logical terminal with the mcftdctle command or the dc_mcf_tdctle function. If the TP1/NET/HNA-560/20 protocol is used, the session must also be terminated with the mcftdctss command.

Options

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

Specifies an MCF communication process identifier.

No more than one MCF communication process identifier can be specified.

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

Specifies the name of a logical terminal whose first unsent message 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.

Use an asterisk (*) to specify a group of logical terminal names. Only one group can be specified. Do not specify the name of a group of logical terminals with any other logical terminal names. Enclose a group name in double quotation marks (").

*
Deletes the first message for all the logical terminals.

leading-string*
Deletes the first message for all logical terminals beginning with the leading string.

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

<Example of specifying a group of logical terminals>
To specify all logical terminals beginning with len: -1 "len*"

-t message-type

Specifies the type of the first unsent message to be deleted.

IO: Inquiry-response message

PRIO: One-way send message (priority)

NORM: One-way send message (normal)

-g

Deletes an untransmitted message group of the type specified in the -t option.

If there is no message group or the -g option is omitted, only the first untransmitted message of the type specified in the -t option is deleted.

Note that the -g option is valid only when TP1/NET/XMAP3 protocol is used.

Output messages

Message ID Description Output destination
KFCA10101-E Specified logical terminal has not been shut down. Standard error output
KFCA10102-E Specified type of queue contains no messages. Standard error output
KFCA10350-I mcftspqle 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 mcftspqle command input source failed. Message log file or standard error output
KFCA10371-I mcftspqle command has been accepted normally. Standard output
KFCA10373-E mcftspqle 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 mcftspqle command is not supported. Standard error output
KFCA10506-I Help message Standard output
KFCA16402-E RPC error occurred during command processing. Standard error output