NAME

jobcontrol - Control CGIBurn jobs.


SYNOPSIS

jobcontrol lets a user kill or clean up a CGIBurn job. If the job requested it when it was created, it will ask the user to confirm first.


DESCRIPTION

jobcontrol recognizes the following CGI parameters:

job
The jobid of the job that is being controlled.
action
The action that should be performed on the job. Should be ``TERM'' to terminate the job, or ``cleanup'' to clean up the job.
splash
Set to 1 to indicate that the user has already seen the splash page warning them that it could take a second.
confirm
Set to 1 to indicate that the user has already seen the confirmation page, and has chosen to continue.


TEMPLATES

Uses job_confirm.tpl as job_confirm, job_cleaned as job_cleaned.tpl, and job_splash as job_splash.tpl.


All templates

All templates have access to all :const variables from CGIBurn::Conf.


job_confirm/pagestart

This is the only section of job_confirm. It is displayed when an action is requested on a job that requires confirmation.

It has access to the following special variables:

NOTE
A note describing the reason why confirmation is needed.
JOB_ID
The job ID for the job which is being confirmed.
ACTION
The action that is being confirmed; this is passed along to the CGI script.
JOB_CONFIRMED
Set to 1 if this will completely confirm the action; set to 0 if another confirmation may still be required.


job_cleaned/pagestart

The job_cleaned template is used to indicate that a job has been cleaned up after.

The pagestart section is the first thing displayed.

It has access to the following special variables:

JOB_ID
The job ID for the job which is being confirmed.


job_cleaned/toolbar

Displayed between pagestart and pageend. Has access to the same special variables as job_cleaned/pagestart.


job_cleaned/pageend

Last part of the page. Has access to the same special variables as job_cleaned/pagestart.


job_splash/pagestart

This page is displayed while the user is waiting for a job to finish canceling.

It is the only section of the job_splash template.

It has access to the same special variables as job_cleaned/pagestart.

JOB_ID
The job ID for the job which is being confirmed.


SEE ALSO

CGIBurn::Job, viewjobs, CGIBin::CGITools, CGI, CGI::Carp, TEMPLATES.