Using the Command Line Interface › ca_qmgr - Queue Manager Command › ca_qmgr - Job Specific Commands

ca_qmgr - Job Specific Commands

The ca_qmgr command contains job specific commands that allow you to monitor and control individual jobs.

The ca_qmgr command includes the following job specific commands:

ca_qmgr [-cahost <hostname>] [-entiredomain]

-changestatus <job #> <ready|hold>
-changedate <job #> <mm/dd/yy[yy]>
-changetime <job #> <hh:mm>
-stop <job #>
-view <job #>
-delete <job #>
-waitForJobStatus <job #> [<polling interval <secs>>]
-move <-s_server <source primary server>> <-d_server <dest primary server>> [-m_server <member server>] [-jobnum <job #>] [-hold]
-changeSessionPasswd <job number> [<old password> <new password>]

• -changestatus <job #> <ready|hold>

  Changes the job status to ready, or puts a job on hold.

  Example:

  ca_qmgr -changestatus 12 hold
  

• -changedate <job # mm/dd/yy[yy]>

  Changes the date a job will run.

  Example:

  ca_qmgr -changedate 12 04/01/2006
  

• -changetime <job # hh:mm>

  Changes the time a job will run.

  Example:

  ca_qmgr -changetime 12 12:08
  

  Note: All scheduled times for CA ARCserve Backup jobs are based upon the time zone where the CA ARCserve Backup server is located. If your agent machine is located in a different time zone than the CA ARCserve Backup server, you will need to calculate the equivalent local time that you want the job to be run.

• -changeSessionPasswd <job number> [<old password> <new password>]

  Changes the session password for the specified backup job with the status of ready, hold, or done. You can execute this command using either of two formats:

  • You can include this switch and specify the old and new session passwords all in one line:

    ca_qmgr -changeSessionPasswd 5 AAA BBB
    

  • You include this switch but do not include an old or new password and you will be prompted for each password.

    ca_qmgr -changeSessionPasswd 5
    

    Please enter old password:
    Please enter new password:
    Please reconfirm new password: 
    

  • job number

    Specifies the job number of the backup job that you want to change the session password.

  • old password

    Specifies the old session password that will be replaced for the backup job. This parameter is optional; however, if it is included you must also include the new password.

  • new password

    Specifies the new session password that will be applied to the backup job. This parameter is optional; however, it cannot remain empty if you include the old password.

  Notes:

  • If the backup job has no previous session password, you cannot add a new session password.
  • If the old password provided and the original session password for the specified job do not match, this command will fail.
  • If you include the old session password, but do not include a new session password, this command will fail (the new session password cannot be empty).
  • The maximum length of the session password is 23 characters.
• -stop <job ID>

  Stops a currently running job. If it is a repeating job, the next job in the sequence is queued. If it is a run-once job, the job is stopped and deleted. If it is a job on hold, no action is taken.

  Example:

  ca_qmgr -stop 12
  

  Important! No confirmation is asked prior to stopping the job. The job is stopped without asking if you are sure.

• -view <job ID>

  Views details of job ID (Job Summary)

  Example:

  ca_qmgr -view 12
  

• -delete <job ID>

  Deletes an inactive job. Deleting an inactive job completely removes it from the job queue.

  Example:

  ca_qmgr -delete 12
  

  Note: To delete an active job, you must first stop the job before you can delete it.

• -waitForJobStatus <job #> [<polling interval <secs>>]

  The ca_qmgr command will wait until the job is completed, and then returns to prompt. The optional polling interval indicates the time to poll for the job status internally.

  The <polling interval> value defines how often (in seconds) the ca_qmgr utility checks the job status with the Queue services. The default polling interval is 60 seconds.

• -move <-s_server <source primary server>> <-d_server <dest primary server>> [-m_server <member server>] [-jobnum <job #>] [-hold]

  Moves the job from one server to another. If you include this command, you must specify a source server and a destination server. In addition, you can also include subordinate options to further define the job to be moved. If you do not include any subordinate options, all jobs on the source primary servers will be moved to the destination primary server by default.

  • -s_server <source primary server>

    Specifies the source primary server where the job will be moved from. You must include the name of the source primary server.

  • -d_server <dest primary server>

    Specifies the destination primary server where the job will be moved to. You must include the name of the destination primary server.

  • -m_server <member server>

    Specifies the host where the moving job will be executed from. If you include this option, you must specify the member server.

  • -jobnum <job #>

    Specifies the job number that will be moved. If you include this option, you must specify a job number on the source primary server.

  • -hold

    If the option is included, specifies that the jobs being moved on the source primary server will be modified to a Hold status after they have been successfully moved, instead of the default action of Deleted.