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.
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