OpenTP1 Version 7 Operation
mcftdmpqu (Copy contents of input/output queues)
Format
mcftdmpqu -k output-unit-type [-u output-unit-name] -f dump-file-name [-a] |
Function
The mcftdmpqu command copies the contents of input/output queues to a file. The contents to be copied are disk messages.
Before coping the contents of an input queue, the applicable service group must be shut down with the mcftdctsg command. When the mcftdmpqu command is used with the mcftdlqsg command (delete input queues), the mcfthldiq command must be executed to hold the input queue process of the service group before executing the mcftdmpqu command.
When the mcftdmpqu command is to be used independently to copy the contents of the output queue, the applicable logical terminal must be shut down first using the mcftdctle command or the dc_mcf_tdctle function. When you use the mcftdmpqu command in conjunction with the mcftdlqle command or the dc_mcf_tdlqle function (to delete the output queue), you must first use the mcfthldoq command to place the output queue of the applicable logical terminal on hold status.
Options
-k output-unit-type
Specifies the units of dump output:
-u output-unit-name
Specifies the name of a service group or logical terminal that is to be subject to dump output processing.
If svg is specified for the -k option, a service group name must be specified; if le is specified, a logical terminal name must be specified.
If svg or le is specified for the -k option, this option must be specified.
If all is specified for the -k option, specification of this option is ignored.
The user can specify a maximum of eight service group names or logical terminal names separated by spaces. Enclose the entire string of logical terminal names or service group names in double quotation marks ("). The same service group name or logical terminal name cannot be duplicated when specified.
The asterisk (*) can be used in the specification to indicate a group of service group names or logical terminal names. The name of a group of service groups cannot coincide with the names of service groups for which grouping is not specified. A group name must be enclosed in double quotation marks (").
-f dump-file-name~<path name, 1-35 characters>
Specifies the name of the output dump file.
Specifying the file name alone creates a file under the $DCDIR/spool directory. Specifying the full path name creates a file under the specified directory. However, the command does not create a directory.
In Windows, you cannot specify the dump file name by an absolute path you can only the name of the file to be created under $DCDIR/spool.
-a
Specifies that the output queue contents are to be added to an existing file.
When this option is omitted, a new file is opened, and the queue contents are written into it.
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA10103-E | The specified logical terminal has not been shut down (or suspended). | Standard error output |
KFCA10350-I | mcftdmpqu 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 mcftdmpqu command input source failed. | Message log file |
KFCA10372-E | mcftdmpqu command terminated abnormally. | Standard error output |
KFCA10374-I | Unsent message is copied to the file. | Standard output |
KFCA10375-E | Dump file name | Standard output |
KFCA10380-E | Retrieval of remote process failed. | Standard error output |
KFCA10383-E | The service group name is not registered. | Standard error output |
KFCA10519-I | Help message | Standard error output |
KFCA11096-W | Input queue cannot acquire the dump due to SPP resources. | Standard error output |
KFCA11811-E | Error occurred during output of the file. | Standard error output |
KFCA11812-E | Error was detected during read of the input/output queue. | Standard error output |
KFCA16402-E | RPC error occurred during command processing. | Standard error output |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.