CLEARCMD - Delete a command in the COM file

This topic describes the CLEARCMD. Use this command to delete a transfer request from the communication file. It generates a WLOG command that reports the event in the LOG file.

Description

Deletes a transfer request from the communication file.

Parameters

COMMAND

Request keyword.

INDEX

Request number as displayed by the LISTCOM command.

JOBNAME Jobname (string 15).

USERID

Identifier of the request owner.

Delete a single command

To use CLEARCMD to delete a single command, the USERID, INDEX, and COMMAND parameters are mandatory.

Example

Begin by running the LISTCOM command.

cftutil listcom

RECORDS

RECORD N 1 ACTIVE : YES

COMMAND-TYPE : SEND USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9168

COMMANDE :

part=bclpm,idf=un,fname=cc,mintime=+1

Enter the CLEARCMD command.

cftutil clearcmd userid=AXWAY\Manager,command=send,index=1

Repeat the LISTCOM command, and the example below displays  the results (note the record is now set to CLEARED).

cftutil listcom

RECORD N 1 ACTIVE : CLEARED

COMMAND-TYPE : SEND USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9168

COMMANDE :

part=bclpm,idf=un,fname=cc,mintime=+1

RECORD N 6 ACTIVE : YES

COMMAND-TYPE : WLOG USERID : AXWAY\Manager

GROUPID :

JOBNAME : 10204

COMMANDE :

MSG='CLEARCMD Command=SEND, Userid=AXWAY\Manager, Index=1 _ Command O K'

Delete a group of commands

To delete a group of commands use the following syntax.

To delete all commands=cmd for this userid:

INDEX=*,COMMAND= cmd,USERID=userid

To delete all commands for this jobname and this userid:

INDEX=*,JOBNAME= job,USERID=userid

To delete all commands=cmd for this jobname and this userid:

INDEX=*,JOBNAME= job,COMMAND=cmd ,USERID=userid

Example

To delete all RECV commands that have the JOBNAME 9168 for the Axway/Manager account user begin by executing the LISTCOM command.

cftutil listcom

RECORD N 3 ACTIVE : YES

COMMAND-TYPE : RECV USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9168

COMMANDE :

part=loop,idf=*

RECORD N 4 ACTIVE : YES

COMMAND-TYPE : RECV USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9168

COMMANDE :

part=pesit1,idf=*

Enter the CLEARCMD command.

cftutil clearcmd userid=AXWAY\Manager,command=recv,index=*,jobname=9168

Run LISTCOM; the selected records now display as CLEARED.

cftutil listcom

RECORD N 3 ACTIVE : CLEARED

COMMAND-TYPE : RECV USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9168

COMMANDE :

part=loop,idf=*

RECORD N 4 ACTIVE : CLEARED

COMMAND-TYPE : RECV USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9168

COMMANDE :

part=pesit1,idf=*

The following screen shows the WLOGs that correspond to the 2 deleted RECV commands.

RECORD N 7 ACTIVE : YES

COMMAND-TYPE : WLOG USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9088

COMMANDE :

MSG='CLEARCMD Command=RECV,Jobname=9168, Userid=AXWAY\Manager, Index=

3 _ Command OK'

 

RECORD N 8 ACTIVE : YES

COMMAND-TYPE : WLOG USERID : AXWAY\Manager

GROUPID :

JOBNAME : 9088

COMMANDE :

MSG='CLEARCMD Command=RECV,Jobname=9168, Userid=AXWAY\Manager, Index=

4 _ Command OK'

Syntax error

The following is a list of error and information messages that display if there are no WLOG transfers in CFTCOM.

Error 1

CFTU26E CLEARCMD _ Error (Index value not authorized_ Bad command)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,index=4*,command=recv)

 

Error 2

CFTU26E CLEARCMD _ Error (COMMAND Keyword missing)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,index=4,jobname=1234)

 

Error 3

CFTU26E CLEARCMD _ Error (COMMAND or JOBNAME Keyword missing)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,index=*)

 

Error 4

CFTU26E CLEARCMD _ Error (WLOG not authorized_ Bad command)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,index=*,command=wlog)

 

Error 5

CFTU26E CLEARCMD _ Error (COMMAND or JOBNAME Keyword missing)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,index=*)

Execution errors

The following is a list of error and information messages that display if there is an error when executing the WLOG transfers in CFTCOM.

Error 1

CFTU26E CLEARCMD _ Error ( Bad userid)

CFTU00I CLEARCMD _ Failed (userid=XXXXY\Manager,command=send,index=2)

 

Error 2

CFTU26E CLEARCMD _ Error ( Communication media record not found)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,command=send,index=99)

 

Error 3

CFTU26E CLEARCMD _ Error ( Bad command)

CFTU00I CLEARCMD _ Failed (userid=AXWAY\Manager,command=halt,index=2)

Example

The following examples show the LISTCOM messages after three erroneous CLEARCMD commands.

RECORD N 10 ACTIVE : YES

COMMAND-TYPE : WLOG USERID : AXWAY\Manager

GROUPID :

JOBNAME : 10188

COMMANDE :

MSG='CLEARCMD Command=SEND, Userid=XXXXY\Manager, Index=2 _ Bad userid'

 

RECORD N 11 ACTIVE : YES

COMMAND-TYPE : WLOG USERID : AXWAY\Manager

GROUPID :

JOBNAME : 11780

COMMANDE :

MSG='CLEARCMD Command=SEND, Userid=AXWAY\Manager, Index=99 _ Communication media record not found'

 

RECORD N 12 ACTIVE : YES

COMMAND-TYPE : WLOG USERID : AXWAY\Manager

GROUPID :

JOBNAME : 4196

COMMANDE :

MSG='CLEARCMD Command=HALT, Userid=AXWAY\Manager, Index=2 _ Bad command'

Related Links