Deleting catalog entries

The DELETE command is used to delete one or more catalog entries. A transfer in process is interrupted and its transfer request disappears from the catalog.

This file is automatically deleted for an R, Receive, type request in non terminated state, a state other than T and X, if the receive file is a temporary file.

For any selected set of transfers, transfers are processed in batches of 20 transfers every 5 seconds.

Syntax

[ BLKNUM = { 0 | n } ]

[ DIRECT = { BOTH | RECV | SEND } ]

[ FORCE =  { YES | NO } ]

[ IDA = identifier  ]

[ IDF = identifier ]

[ IDT = { * | transid } ]

[ IDTU = string ]

[ STATE = { * | C | D | H | K | T | X } ]

Description Use this command to delete one or more catalog entries.

Parameters

BLKNUM 

Block number. If the values '*' or ' ' are used then all transfers are selected regardless of the block that they belong to.

DIRECT 

Transfer direction for the requests in question.

The possible values are:

  • BOTH: (default) takes both send transfers and receive transfers into account
  • RECV: limits the action to receive transfers
  • SEND: limits the action to send transfers

IDA 

Local identifier of the transfer assigned by the user or user application. The maximum length is 64 characters.

Several catalog entries may be associated with a given IDA. There is no default value.

IDF 

Model file identifier.

Several catalog entries may be associated with a given IDF. There is no default value.

If a set of transfers is selected, transfers are processed in batches of 20 every 5 seconds.

IDT 

Transfer identifier.

This identifies a transfer for a given partner and direction. The value ‘*’ means that no selection is required using the IDT parameter (default value).

IDTU 

Transfer local counter identifier.

PART

(Mandatory)

Partner identifier.

The associated value of this parameter may be:

  • an identifier: the command only concerns the transfers with this partner
  • a mask: the command concerns the transfers with the partners, whose identifiers correspond to this mask
  • if a set of transfers is selected, transfers are processed in batches of 20 every 5 seconds

STATE 

Transfer state.

The default value * means no selection is required to be made on the transfer state. (refer to the Transfer-related successive phases and actions).

Example 1

DELETE        PART = SIE??

This command deletes all transfers, IDT = * by default, in the send and receive directions, DIRECT = BOTH by default, for the partners whose identifier begins with "SIE" and contains 5 characters in all.

Example 2

DELETE

PART = HQ,

 

 

DIRECT = SEND,

 

 

IDF = ACCNT

 

This command deletes all transfers, IDT = * by default, in the send direction (DIRECT = SEND) of the model file ACCNT to the partner HQ.

Related Links