Managing administrative jobs using wsadmin scripting (deprecated)

Use the wsadmin tool and the commands in the AdministrativeJobs command group to manage administrative jobs in your flexible management environment.

Before you begin

Configure a job manager, administrative agent, and register managed nodes with the job manager to set up a flexible management environment.

About this task

Use this topic to manage administrative jobs that you submit to the job manager.

Procedure

  • Display the status of a job.
    Use the getOverallJobStatus command to display the overall job status for a specific job or a list of jobs of interest. The following command example displays the job status for a specific job:
    AdminTask.getOverallJobStatus(['-jobTokenList [myJobToken]]')
    The following command example displays the overall job status for multiple jobs:
    AdminTask.getOverallJobStatus('-jobTokenList [myJobToken myJobToken2 myJobToken3]')
    The command returns job status information for the job or jobs of interest. The system displays the following information in the overall job status:
    • The STATE attribute specifies the current state of the job.
    • The TOTAL_RESULTS attribute specifies the total number of jobs.
    • The DISTRIBUTED attribute specifies the number of distributed jobs.
    • The ASYNC_IN_PROGRESS attribute specifies the number of asynchronous jobs in progress.
    • The SUCCEEDED attribute specifies the number of successful jobs.
    • The PARTIALLY_SUCCEEDED attribute specifies the number of partially successful jobs. Partial success can occur, for example, when a node represents multiple servers, and only some of the servers on the node complete successfully.
    • The FAILED attribute specifies the number of failed jobs.
    • The REJECTED attribute specifies the number of rejected jobs.
    • The NOT_ATTEMPTED attribute specifies the number of jobs that the system has not attempted.
  • Suspend a job.
    Use the suspendJob command to suspend a job on the job manager, as the following command demonstrates:
    AdminTask.suspendJob('-jobToken myToken')
  • Resume a job.
    Use the resumeJob command to resume a suspended job, as the following command demonstrates:
    AdminTask.resumeJob('-jobToken myToken')
  • Delete a job.
    Use the deleteJob command to delete an existing job from the job manager. If the job is running when you invoke the command, the system still returns the job results regardless of whether the job is deleted. The following command example deletes a job from the job manager:
    AdminTask.deleteJob('-jobToken myToken -deleteResults true')