The xcomqm command lets you maintain
CA XCOM Data Transportqueues by using the command-line interface. This command lets you delete entries from the queue, suspend transfers, resume suspended transfers, display the list of entries in the queue, and display detailed information about the queue entries.
The syntax for xcomqm is as follows:
xcomqm [option][option]. . .
You can use more than one option on a command line. You can also use the same option more than once. Each option must be separated by a space. These options can be listed in any order, but note that when the shell encounters options such as the
-roption, it performs the command and exits xcomqm without reading the rest of the command line.
The following list explains the options for xcomqm:
- -rDisplay the release level of xcomqm and exit.
- -AentrynameRelease a held transfer.
- -CentrynameGet a trace of a transfer.
- -DentrynameDisplay details about a queue entry.
- -HentrynameHold a scheduled transfer.
- -L[a]List your queued transfers. Use -La for all queued transfers.
- -RentrynameRemove a queue entry.
- -RfentrynameForce the entry to be removed from the queue. Use this command when you want to remove a transfer that is still active.
- -R*Remove all completed or scheduled entries from the queue.If you use this option on an active transfer, it interrupts the transfer.
- -TentrynameTerminate an active transfer.
- -T[f]entrynameForce termination of the transfer. Use this command when you want to remove a transfer that is still active.When using SNA/APPC protocols, the TP will ABEND and it may be necessary to restart the underlying SNA software. When using TCP/IP, xcomtcp will ABEND.
- -SentrynameSuspend a transfer.
- -EentrynameResume a suspended transfer.
- -dDisplay debugging information.
- no optionDisplay the help menu.
- -zDisplay logging text for transfer.
entrynamerepresents the Transaction ID, which is the six-digit name of the transfer entry in the queue.