Monitoring and Controlling Jobs › SAP Commands › Issue an SAP Command Against an SAP-R3 or SAP-Job Copy Job › JobDelete Command

JobDelete Command

You can use the JobDelete command to delete an SAP-R3 or SAP-Job Copy job from the SAP system.

You can delete a job in the following SAP states:

• Canceled
• Completed
• Finished
• Released
• Scheduled

If the agent is configured to delete children jobs, you must ensure that all children are inactive before you issue the JobDelete command. If you delete a parent job while there are still outstanding children jobs, you cannot access the children from the Monitor perspective. To ensure that all children are canceled before issuing the delete command, you must issue the JobCancel command for each child. You can only cancel active jobs.

The agent parameter file (agentparm.txt) determines if the server also deletes children for a parent job. You can contact your agent administrator for details about the following agent properties:

• sap.job.children.delete
• sap.job.children.monitor
• sap.job.children.recursive

If the job you are deleting has children, ensure all of the children are in one of the listed states before you delete the job. If you delete a job parent when there are still outstanding children jobs, the children cannot be accessed from the Monitor perspective. In this case, you need to delete the outstanding children from the SAP system.

If the agent is configured to monitor the children, a job with children is marked FAILED under the following conditions:

• A parent job is deleted while its children are still active.
• A parent job is finished and any child job was terminated.
• A parent job is finished and any child job was deleted.

Note: When an SAP job is in the COMPLETE state, the parent job and all its children are complete.