CA XCOM Data Transport r11.5 Enhanced Features › History Command Option (-c7)

History Command Option (-c7)

The new -c7 command option allows you to retrieve history records.

This command accepts a history filter file in XML format or CNF format and creates a file of the matching history records in a format that a CA Easytrieve report can be generated from.

To generate the history filter file in XML format, use the Export button on the Get History Records page of the GUI.

To create a history filter file in CNF format, you can specify the following new parameters:

• OEDATE—Limits the history request to only those file transfers that were scheduled or completed on or before the end date and time.
• OETIME—Limits the history request to only those file transfers that were scheduled or completed on or before the end date and time.
• OFILETYPE—Limits the history request to those transfers with the specified FILETYPE.
• OFLMAX—Limits the history request to only those file transfers where the number of bytes transferred is equal to or less than the value specified.
• OFLMIN—Limits the history request to only those file transfers where the number of bytes transferred is equal to or greater than the value specified.
• OID—Limits the history request to only those file transfers with a specific transfer ID. The transfer ID is a user-defined identifier for file transfer requests.
• OINIT—Limits the history request to only locally initiated transfers or only remotely initiated transfers.
• OLIMIT—Sets the maximum number of history records that can be returned.
• OLOCATN—Limits the history request to transfers in one of the following locations:
  • Transfers that have been completed and have been stored in a database
  • Transfers still in the queue
• OLMSG—Limits the history request by the transfer's last message.
• OLU—Limits the history request to only those file transfers with a specific remote LU name.
• OREQ—Limits the history request to only those file transfers that contain this specific request number.
• OSDATE—Limits the history request to only those file transfers that were scheduled or completed on or after the start date and time.
• OSTIME—Limits the history request to only those file transfers that were scheduled or completed on or after the start date and time.
• OSYSID—Limits the history request to only those file transfers executed on the specified system ID.
• OSYSNAME—Limits the history request to only those file transfers executed on the specified system name.

  Note: OSYSNAME and OSYSID together uniquely identify a CA XCOM Data Transport r11.6 server

• OTNAME—Limits the history request to only those file transfers with a specific remote TCP/IP name or TCP/IP address.
• OTYPE—Specifies if the history request should include active transfer requests, inactive transfer requests, or completed transfers.
• OTYPEREQ—Limits the history request to only send transfers or only receive transfers.
• OUSER—Limits the history request to only those file transfers submitted by a specific user.

For more information about using the -c7 option, see the CA XCOM Data Transport for UNIX and Linux User Guide.

For more information about using the Export button, see the CA XCOM Data Transport GUI Online Help.