Submission of a batch request
For a batch request submission, the qsub command is used.
% qsub [job script name]
Execution example
Request 12345.cmc submitted to queue: ACE.
The above example is the output when a batch request is submitted.
The received request was assigned a request ID. In the example, the ID is 12345.cmc.
Status check of a batch request
Right after a batch request is received, the batch request goes into "QUE" status .
When the batch is registered and scheduled onto the scheduler map, the batch request goes into .
When a computation starts, the status of it becomes "RUN"(execution)status.
The following commands can check the status of your batch request.
command name | output |
---|---|
qstat | display the status of your submitted batch request |
sstat | display the schedule status of your submitted batch request |
qstat command
This command shows the status of your submitted batch requests.
% qstat
Output example
RequestID ReqName UserName Queue Pri STT S Memory CPU Elapse R H M Jobs
----------- -------- -------- -------- ---- --- - -------- -------- -------- - - - ----
53678.cmc AAA.nqs User_A F4S 0 RUN - 617.29M 79997.28 80254 Y Y Y 1
53720.cmc BBB.nqs User_B F4L 0 QUE - 0.00B 0 0 Y Y Y 1
The display information from qstat is as follows.
RequestID:request ID number
This is the number assigned to submitted batch request.
ReqName:batch request name
The name of the batch request is shown.
UserName: user name
Queue:queue where batch request is located
The name of the queue displayed here is "Execution Queue".
As to "Execution queue", see the job class tables below:
Job class table
Pri:Priority of batch request
STT:Status of batch request
- QUE queued:Waiting for execution
- RUN running:Running computation
- POR post-running:Waiting for termination of sleep request
- PRR pre-running:Waiting for execution of sleep request
- EXT exiting:Moving computation result file (inc. staging out)
- STG staging:Generating batch job or moving input file(stage in)
- HLD held:pending
- HOL holding:requesting for pending
- WAT waiting:Waiting for scheduled time
- SUS suspending,suspended,resuming:Requesting suspension/Suspended/Resuming
- TRS transferring:Transferring from transfer queue
- ARI arriving:Receiving from transfer queue
- MIG migrating:Migrating request
- RST restarting:Restarting from check point
- CHK checkpointing:Checkpointing
S:stall status
- Y stall
- - normal
- batch request under stall status cannot be executed correctly.
qstatgroup command
This command shows the status of batch requests submitted by group members.
(In the case of the HPCI user, this shows the scheduling status of batch requests submitted by HPCI project members.)
% qstatgroup
The display of the command is updated every 15 minutes.
sstat command
This command shows the scheduling status of the submitted batch job request.
% sstat
Output example
[VCC information]
RequestID ReqName UserName Queue Pri STT PlannedStartTime
--------------- -------- -------- -------- ----------------- --- -------------------
12345.cmc AAA.nqs User_A V56C 3.0585/ 3.0585 RUN Already Running...[HCC information]
RequestID ReqName UserName Queue Pri STT PlannedStartTime
--------------- -------- -------- -------- ----------------- --- -------------------
12345.hcc BBB.nqs User_B H-large 0.0000/ 0.0000 QUE -
The information obtained with a sstat command is as follows:
RequestID:Request ID
This is the number assigned to the submitted batch request.
ReqName:name of batch request
This is the name of the batch request.
UserName:user name
Queue:the name of the queue where the batch request is located
The name of queue displayed here is the "Execution Queue".
For the"Execution queue", see the job class tables below:
Job class table
Pri:priority of batch request
STT:status of batch request
- QUE QUEUED:Waiting for execution
- RUN RUNNING:Running computation
- ASG ASSIGNED:Computational resource is assigned
- POR POST-RUNNING:Waiting for termination of sleep request
- PRR PRE-RUNNING:Waiting for execution of sleep request
- EXT EXITING:Moving computation result file (inc. staging out)
- STG STAGING:Generating batch job or moving input file(stage in)
- HLD HELD:pending
- HOL HOLDING:requesting for pending
- WAT WAITING:Waiting for scheduled time
- SUS SUSPENDING,SUSPENDED,RESUMING:Requesting suspension/Suspended/Resuming
- TRS TRANSFERRING:Transferring from transfer queue
- ARI ARRIVING:Receiving from transfer queue
- MIG MIGRATING:Migrating request
- RST RESTARTING:Restarting from check point
- CHK CHECKPOINTING:Checkpointing
PlannedStartTime:planned time for starting computation
When "STT:status of batch request" becomes "ASG"、PlannedStartTime can be displayed.
sstatgroup command
This command shows the scheduling status of batch requests submitted by group members.
(In the case of the HPCI user, this shows the scheduling status of batch requests submitted by HPCI project members.)
% sstatgroup
The display of the command is updated every 15 minutes.
Removal of batch request
qdel command
This command removes the submitted batch request from the queue
Execution example
% qdel 123456.cmc # you need to specify the batch request ID you want to delete.
Request 123456.cmc was deleted.
Other commands
If you are interested in other related useful commands, please read "Part 4 Reference" from the following manual. (Authentication with user ID is required.)
NQSII Manual(authentication required)