mcftdmpqu (Copy contents of input/output queues)

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.

-k output-unit-type

Specifies the units of dump output:

all: Contents of all input and output queues

svg: Queue contents in units of service groups

le: Queue contents in units of logical terminal names

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

*: Specifies that the queue contents of all service groups or logical terminals are to be dumped.

character-string*: Specifies leading characters of a service group name or a logical terminal name when the queue contents of all service groups or logical terminals with names beginning with the specified character string are to be dumped.

<Example of specifying more than one service>: To specify seg1, seg2, and seg3: -g "seg1seg2seg3"

<Example of specifying a group of service groups>: To specify all service groups beginning with seg, code: -u "seg*"

-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.

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