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:

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 "seg1[Figure]seg2[Figure]seg3"
<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.

Output messages

Message IDDescriptionOutput destination
KFCA10103-EThe specified logical terminal has not been shut down (or suspended).Standard error output
KFCA10350-Imcftdmpqu command has been entered.Standard output
KFCA10353-WInput format is invalid.Standard error output
KFCA10354-EMemory is inadequate.Standard error output
KFCA10355-WSpecification of an argument is invalid.Standard error output
KFCA10356-EOvertime occurred during process.Standard error output
KFCA10357-EOvertime occurred in MCF.Standard error output
KFCA10358-EError occurred in an internal function.Standard error output
KFCA10359-WResponse to mcftdmpqu command input source failed.Message log file
KFCA10372-Emcftdmpqu command terminated abnormally.Standard error output
KFCA10374-IUnsent message is copied to the file.Standard output
KFCA10375-EDump file nameStandard output
KFCA10380-ERetrieval of remote process failed.Standard error output
KFCA10383-EThe service group name is not registered.Standard error output
KFCA10519-IHelp messageStandard error output
KFCA11096-WInput queue cannot acquire the dump due to SPP resources.Standard error output
KFCA11811-EError occurred during output of the file.Standard error output
KFCA11812-EError was detected during read of the input/output queue.Standard error output
KFCA16402-ERPC error occurred during command processing.Standard error output