Listing projects, jobs, stages, links, parameters, and queues

You can list projects, jobs, stages, links, job parameters, and workload management queues by using the dsjob command.

The different versions of the syntax are described in the following sections.

Listing projects

The following syntax displays a list of all known projects on the server:


dsjob -lprojects

This syntax is equivalent to the DSGetProjectList function.

Listing jobs

The following syntax displays a list of all jobs in the specified project:


dsjob -ljobs project

project is the name of the project containing the jobs to list.

This syntax is equivalent to the DSGetProjectInfo function.

Listing jobs with specific job statuses

The following syntax displays a list of all jobs in the specified project with specific job status values:


dsjob -ljobs [-status status_list] project

project is the name of the project containing the jobs to list.

status_list is a list of job status values as defined in the dsapi.h file.

The following command lists all jobs in the dstage1 project with statuses of DSJS_CRASHED or DSJS_STOPPED:
dsjob –ljobs -status 96/97 dstage1

Listing stages

The following syntax displays a list of all stages in a job:


dsjob -lstages [-useid] project job|job_id

-useid specify this if you intend to use a job alias (jobid) rather than a job name (job) to identify the job.

project is the name of the project containing job.

job is the name of the job containing the stages to list. To identify a job invocation, use the format job.invocation_id.

job_id is an alias for the job that has been set using the dsjob -jobid command.

This syntax is equivalent to the DSGetJobInfo function with DSJ_STAGELIST specified as the InfoType parameter.

Listing links

The following syntax displays a list of all the links to or from a stage:


dsjob -llinks [-useid] project job|job_id stage

-useid specify this if you intend to use a job alias (jobid) rather than a job name (job) to identify the job.

project is the name of the project containing job.

job is the name of the job containing stage. To identify a job invocation, use the format job.invocation_id.

job_id is an alias for the job that has been set using the dsjob -jobid command.

stage is the name of the stage containing the links to list.

This syntax is equivalent to the DSGetStageInfo function with DSJ_LINKLIST specified as the InfoType parameter.

Listing parameters

The following syntax display a list of all the parameters in a job and their values:


dsjob -lparams [-useid] project job|job_id

-useid specify this if you intend to use a job alias (jobid) rather than a job name (job) to identify the job.

project is the name of the project containing job.

job is the name of the job whose parameters are to be listed. To identify a job invocation, use the format job.invocation_id.

job_id is an alias for the job that has been set using the dsjob -jobid command.

This syntax is equivalent to the DSGetJobInfo function with DSJ_PARAMLIST specified as the InfoType parameter.

Listing invocations

The following syntax displays a list of the invocations of a job:


dsjob -linvocations [-useid] project job|job_id

-useid specify this if you intend to use a job alias (jobid) rather than a job name (job) to identify the job.

project is the name of the project containing job.

job is the name of the job whose parameters are to be listed. To identify a job invocation, use the format job.invocation_id.

job_id is an alias for the job that has been set using the dsjob -jobid command.

Listing workload management queues

The following syntax displays a list of the workload management queues:


dsjob -lqueues