xcomqm Command

Contents
xdtful11601
The xcomqm command lets you maintain 
CA XCOM Data Transport
 queues 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.
Syntax
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 
-r
 option, it performs the command and exits xcomqm without reading the rest of the command line.
Options
The following list explains the options for xcomqm:
  • -r
    Display the release level of xcomqm and exit.
  •  
    -A
    entryname
     
    Release a held transfer.
  • -C
    entryname
     
    Get a trace of a transfer.
  • -D
    entryname
     
    Display details about a queue entry.
  • -H
    entryname
     
    Hold a scheduled transfer.
  • -L[a]
    List your queued transfers. Use -La for all queued transfers.
  • -R
    entryname
     
    Remove a queue entry.
  • -Rf
    entryname
     
    Force 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.
  • -T
    entryname
     
    Terminate an active transfer.
  • -T[f]
    entryname
     
    Force 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.
  • -S
    entryname
     
    Suspend a transfer.
  • -E
    entryname
     
    Resume a suspended transfer.
  • -d
    Display debugging information.
  •  
    no option
     
    Display the help menu.
  • -z
    Display logging text for transfer.
entryname
 represents the Transaction ID, which is the six-digit name of the transfer entry in the queue.