delete

You can use the delete command to remove scheduling items from the database.

Overview

You can use the command option to delete items located in specific folders or multiple items that are located in different folders. You must have the delete access to remove scheduling items.

Important: You must make sure that the item you want to delete is not locked by any other user.

Syntax and command line options

Before you run the command, you must specify at least one scheduling item you want to delete. The noask parameter is optional. You can run the command as follows:
ocli model delete | de | del Scheduling item [;noask]
You can use the following scheduling parameters to view specific information.
Scheduling items
Table 1. Scheduling items
Scheduling items Description
calendars | calendar | cal [folder/]calname You must specify the [folder/]calname that you want to delete. Wildcard characters are permitted.
domain | dom domainname You must specify the domainname that you want to delete. Wildcard characters are permitted.
folder | fol foldername If you do not provide the foldername or if the folder contains scheduling items, an error message is displayed. Wildcard characters are permitted.
jobs | jobdefinition | jd [[folder/]workstationame#][folder/]jobname You can specify the jobname that you want to delete. You can provide [folder/]workstationame#] and the folder in which the job stream is defined to make the selection more specific. Wildcard characters are permitted.
sched | jobstream | js [[folder/]workstationame#][folder/]jstreamname[valid from date|valid to date |valid in date date] [;full] [;force] You must specify the jstreamname that you want to delete. You can provide [folder/]workstationame#] and the folder name to make the selection more specific. Wildcard characters are permitted. You can also add the options below to provide more details of the job stream.

Valid from date: You can specify a date which will restrict the selection of job streams, that have a valid from date equal to the value specified. The format is mm/dd/yyyy.

Valid to date: You can specify a date which will restrict the selection of job streams, that have a valid to date equal to the value specified. The format is mm/dd/yyyy.

valid in date date: Specify the time frame at which the job is run. You can specify one of the dates as @. The format is mm/dd/yyyy-mm/dd/yyyy.

full: If you add the option, all the job definitions in the job stream are displayed.

Important: To delete a job stream that has been referenced in other items, use the command ./ocli model delete js jobstreamSelector ;force. When you use force, not only the job streams are deleted, but also all the references associated with it.
prompt | pr [folder/]promptname You must specify the [folder/]promptname that you want to delete. Wildcard characters are permitted.
resource | re | reso [folder/]resourcename You must specify the [folder/]resourcename that you want to delete. You can provide the [folder/]workstationame#] and the folder in which the resource is defined to make the selection more specific. Wildcard characters are permitted.
runcyclegroup | rcg [folder/]rcgname] You must specify the [folder/]rcgname] that you want to delete. Wildcard characters are permitted.
users | user [[folder/]workstationame#]username [;password] You must specify the [[folder/]workstationame#]username [;password] that you want to delete. Wildcard characters are permitted.
parms | parm | variable | vb [[folder/]tablename.]variablename You must specify the [[folder/]tablename.]variablename that you want to delete. Wildcard characters are permitted.
vartable | vt [folder/]tablename You must specify the [folder/]tablename that you want to delete. Wildcard characters are permitted.
workstation | ws | cpu {[folder/]workstationame You can specify the name of the workstation that you want to delete. Optionally, you can provide the folder in which the items are located. Wildcard characters are permitted.
workstationclass | wsc [folder/]workstationclassname] You must specify the [folder/]workstationclassname] that you want to delete. Wildcard characters are permitted.

;noask

When you add the option as an argument the agent will not ask for confirmation before taking action on each qualifying job.

Examples

  1. Run the following command to delete sac5 stored in the oldfolder folder that is launched on workstation stat1 stored in the test folder:
    ocli model delete jobs=test/stat1#oldfolder/sac5
  2. Run the following command to delete all workstations with names starting with xl:
    ocli model de cpu=xl@
  3. Run the following command to delete all job streams stored in the folder path test/oldfolder on all workstations:
    ocli model de sched=@#test/oldfolder/@