HCL Workload Automation, Version 9.4

delete

Deletes object definitions in the database.

Authorization

To delete scheduling objects, you must have delete access to the objects being deleted.

To delete security objects, you must have permission for the modify action on the object type file with attribute name=security.

Syntax

{delete | de}
{[calendars | calendar | cal=calname] |
[domain | dom=domainame] |
[eventrule | erule | er=eventrulename] |
[parms | parm | vb=[tablename.]variablename] |
[prompts | prom=promptname] |
[resources | resource | res=[workstationame#]resourcename] |
[runcyclegroup | rcg=runcyclegroupname] |
[vartable | vt=tablename] |
[wat=workloadapplicationtemplatename]
[cpu={workstationame [;force] | workstationclassname [;force]| domainame}]
[workstation | ws=workstationame] [;force] |
[workstationclass | wscl=workstationclassname] [;force] |
[jobs | jobdefinition | jd=[workstationame#]jobname] |
[sched | jobstream | js= [workstationame#]jstreamname
[valid from date|valid to date |valid in date date]] |
[users | user=[workstationame#]username] |
[accesscontrollist | acl for securitydomainname] |
[securitydomain | sdom=securitydomainname] |
[securityrole | srol=securityrolename]}
[;noask]

Arguments

calendars | calendar | cal

If no argument follows, deletes all calendar definitions.

If argument calname follows, deletes the specified calendar. Wildcard characters are permitted.

domain | dom

If no argument follows, deletes all domain definitions.

If argument domainname follows, deletes the specified domain. Wildcard characters are permitted.

eventrule | erule | er

If no argument follows, deletes all event rule definitions.

If argument eventrulename follows, deletes the specified event rule. Wildcard characters are permitted.

parms|parm|vb

If no argument follows, deletes all global variable definitions found in the default variable table.

If argument tablename.variablename follows, deletes the variablename variable of the tablename table. If tablename is omitted, composer looks for the variable definition in the default variable table. Wildcard characters are permitted on both tablename and variablename. For example:

delete parms=@.@

Deletes all variables from all tables.

delete parms=@

Deletes all variables from the default table.

delete parms=@.acct@

Deletes all the variables whose name starts with acct from all the existing tables.

Remember: While you delete a variable, the variable table that contains it is locked. This implies that, while the table is locked, no other user can run any other locking commands on it or on the variables it contains.

prompts | prom

If no argument follows, deletes all prompt definitions.

If argument promptname follows, deletes the specified prompt. Wildcard characters are permitted.

resources | resource | res

If no argument follows, deletes all resource definitions.

If argument workstationame#resourcename follows, deletes the resourcename resource of the workstationame workstation on which the resource is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for both workstationame and resourcename.

runcyclegroup | rcg

If no argument follows, deletes all run cycle group definitions.

If argument runcyclegroupname follows, deletes the specified run cycle group. Wildcard characters are permitted.

vartable | vt

If no argument follows, deletes all variable table definitions.

If argument tablename variable table follows, deletes the specified variable table. Wildcard characters are permitted.

wat

If no argument follows, deletes all workload application template definitions.

If argument workloadapplicationtemplate follows, deletes the specified workload application template. Wildcard characters are permitted.

cpu

Deletes workstations, workstation classes, or domains.

workstation: The name of the workstation. Wildcard characters are permitted. If you specify the force argument, the workstation definition is removed from the HCL Workload Automation database.
workstationclass: The name of the workstation class. Wildcard characters are permitted. If you specify the force argument, the workstationclass definition is removed from the HCL Workload Automation database.
domain: The name of the domain. Wildcard characters are permitted.

workstation | ws

If no argument follows, deletes all workstation definitions.

If argument workstationname follows, deletes the specified workstation. Wildcard characters are permitted. If you specify the force argument, the workstation definition is removed from the HCL Workload Automation database.

workstationclass | wscl

If no argument follows, deletes all workstation class definitions.

If argument workstationclassname follows, deletes the specified workstation class. Wildcard characters are permitted. If you specify the force argument, the workstation class definition is removed from the HCL Workload Automation database.

jobs | jobdefinition | jd

If no argument follows, deletes all job definitions.

If argument workstationame#jobname follows, deletes the jobname job of the workstationame workstation on which the job runs. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for both workstationame and jobname.

sched | jobstream | js

If no argument follows, deletes all job stream definitions.

If argument workstationame#jstreamname follows, deletes the jstreamname job stream of the workstationame workstation on which the job stream is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for both workstationame and jstreamname.

valid from: date Restricts the selection to job streams that have a valid from date equal to the indicated value. The format is mm⁄dd⁄yyyy.
valid to: date Restricts the selection to job streams that have a valid to date equal to the indicated value. The format is mm⁄dd⁄yyyy.
valid in: date date The time frame during which the job stream can run. The format is mm⁄dd⁄yyyy - mm⁄dd⁄yyyy. One of the two dates can be represented by @.

users | user

If no argument follows, deletes all user definitions.

If argument workstationame#username follows, deletes the username user of the workstationame workstation on which the user is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for both workstationame and username. The password field is not copied for security reasons.

accesscontrollist | acl

If no securitydomainname argument follows, delete access control list definitions for all the security domains.

If argument securitydomainname follows, delete the access control list definitions for the securitydomainname security domain. Wildcard characters are permitted for securitydomainname .

securitydomain | sdom

If no securitydomainname argument follows, delete all the security domains definitions.

If argument securitydomainname follows, delete the securitydomainname security domain definition. Wildcard characters are permitted for securitydomainname .

securityrole | srol

If no securityrolename argument follows, delete all the security roles definitions.

If argument securityrolename follows, delete the securityrolename security role definition. Wildcard characters are permitted for securityrolename .

;noask

Specifies not to prompt for confirmation before taking action on each qualifying object.

Comments

If you use wildcard characters to specify a set of definitions, composer requires confirmation before deleting each matching definition. A confirmation is required before deleting each matching definition if you do not specify the noask option.

To delete an object, it must not be locked. If some matching objects are locked during the command processing, an error message with the list of these objects is shown to the user.

Examples

To delete job3 that is launched on workstation site3, run the following command:

delete jobs=site3#job3

To delete all workstations with names starting with ux, run the following command:

de cpu=ux@

To delete all job streams with names starting with test on all workstations, run the following command:

de sched=@#test@

To delete all the event rules named from rulejs320 to rulejs329, run the following command:

de erule=rulejs32?