OpenTP1 Version 7 Operation
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 (").
-t message-type
Specifies the type of the first unsent message to be deleted.
-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 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.