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:
Deletes all variables from all tables.delete parms=@.@
Deletes all variables from the default table.delete parms=@
Deletes all the variables whose name starts with acct from all the existing tables.delete parms=@.acct@
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
delete jobs=site3#job3
de cpu=ux@
de sched=@#test@
de erule=rulejs32?
See also
From the Dynamic Workload Console you can perform the same tasks as described in:
the Dynamic Workload Console User's Guide.
- To delete workstations, see
- To delete event rules, see
- To delete access control lists, security domains, and security roles, see
- To delete all other objects, see