CHECKJOB(1)                    User Contributed Perl Documentation                    CHECKJOB(1)



NAME
       checkjob - Displays job information through SLURM processing.

SYNOPSIS
       checkjob [<jobID>]

DESCRIPTION
       The checkjob command displays information of a job by using the SLURM utility scontrol, or
       sacct for a recently completed job, as its source. Information includes status,
       associations, various time parameters, and resources. The checkjob utility is based upon
       the SLURM to provide a Moab-like format display output. View the man pages for the use of
       scontrol and sacct for even more information and greater depth of understanding of the
       specified job.

OPTIONS
       -h    Display a brief help message
       -man  Display the man page.
       -A    Display a short list of attributes
       -v    Display verbose data (if any).
       -v -v Display the job script if available

OUTPUT FIELD DESCRIPTIONS
       AName
            The specified name given to the job.

       Allocated Nodes
            List of nodes and processors allocated to job.

       BP List
            List of nodes if a BG system.

       class
            The class name is equivalent to the Slurm partition name.

       Dedicated Resources Per Task
            Resources requirement options.

       Depend
            Job deferred until another specified job acquires state.

       Eligible
            Predicition of the job initiation time.

       Executable
            The name of the command to run.

       Group
            The unix group ID under which the job was submitted.

       Holds
            Types of job holds currently applied to job.

       IWD
            Directory where the executable runs.

       job
            The SLURM generated identifying (ID) value assigned to a job.

       Node Access
            The ability to share nodes with other jobs.

       Note
            The system resources comments.

       Number of Nodes
            The minimum and optionally maximum count of nodes to be allocated.

       Partition
            The name of the partition.

       Partition List
            List of Nodes for the job.

       qos
            The type of Quality of Service for the job.

       StartPriority
            The priority value of the job.  Note that a job priority of zero prevents the job from ever being scheduled.

       StartTime
            The initiation time of the job.

       SubmitTime
            The time that the job was first entered to SLURM for run consideration.

       State
            Current job state.

       System Available Partition List
            The cluster to run the job.

       SystemID
            The cluster name.

       SystemJID
            The Job ID.

       Task Distribution
            The list of nodes allocated to the job.

       Time Queued Total
            Amount of time the job is queued.

       Total Requested Nodes
            The minimum and optionally maximum count of nodes to be allocated.

       Total Requested Tasks
            Number of tasks requested by job.

       TimeLimit
            The time limit, or wall clock, of the job.

       State
            The current state of the job.

       user
            The unix user ID under which the job was submitted.

       User Specified Partition List
            Chosen Cluster to run job.

       WallTime
            Length of time job has been running out of the specified limit.

EXAMPLE
        The following is the output for job number 1007857:

         user2@tux>checkjob 1007857
         job 1007857

         AName: test123
         State: Running
         Creds:  user:user2  group:user2  account:uacct  class:pbatch  qos:normal
         WallTime:  12:00:00
         SubmitTime: Tue Mar  8 06:29:11
           (Time Queued  Total:  1:05:48   Eligible:  1:05:48)

         StartTime: Tue Mar  8 07:34:59
         Total Requested Nodes:  8K
         Total Requested Tasks:  1

         Partition: pbatch
         Dedicated Resources Per Task: gscratchc
         Node Access: SINGLEJOB
         Number of Nodes: 8K


         BP List:
         tux[400x433]

         SystemID:  tux
         SystemJID: 1007857
         IWD:        /p/gscratchc/user2/bin
         Executable: /p/gscratchc/user2/bin/testjob

         User Specified Partition List:    tux
         System Available Partition List:  tux
         Partition List: tux
         StartPriority: 518259

POD ERRORS
       Hey! The above document had some coding errors, which are explained below:

       Around line 832:
           You forgot a '=back' before '=head1'

       Around line 834:
           '=item' outside of any '=over'

       Around line 971:
           You forgot a '=back' before '=head1'



perl v5.16.3                                2017-01-30                                CHECKJOB(1)