qstat(1p)
qstat(1p)
Prolog
Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementationen av detta gränssnitt kan skilja sig åt; se motsvarande Linux-manualsida för detaljer om Linux-beteende. Gränssnittet kanske inte heller är implementerat på Linux.
Namn
qstat — visa status för batchjobb
Synopsis
qstat [-f] jobbidentifierare... qstat -Q [-f] destination... qstat -B [-f] servernamn...
Beskrivning
Status för ett batchjobb, en batchkö eller en batchserver hämtas genom en begäran till servern. Verktyget qstat är en användartillgänglig batchklient som begär status för ett eller flera batchjobb, batchköer eller servrar, och skriver statusinformationen till standardutmatningen.
För varje batch-jobbidentifierare som behandlas korrekt ska qstat visa information om motsvarande batchjobb.
För varje destination som behandlas korrekt ska qstat visa information om motsvarande batchkö.
För varje servernamn som behandlas korrekt ska qstat visa information om motsvarande server.
qstat ska hämta statusinformation för batchjobb genom att skicka en Job Status Request till en batchserver. qstat ska hämta statusinformation för batchköer genom att skicka en Queue Status Request till en batchserver. qstat ska hämta serverstatusinformation genom att skicka en Server Status Request till en batchserver.
Alternativ
qstat ska följa Base Definitions-volymen av POSIX.1-2017, Section 12.2, Utility Syntax Guidelines.
Följande alternativ ska stödjas av implementationen:
-f
- Anger att en fullständig visning ska produceras.
- Minimiinnehållet i en fullständig visning anges i avsnittet STANDARDUTMATNING.
- Ytterligare innehåll och format för en fullständig visning är implementationsdefinierade.
-Q
- Anger att operanden är en destination.
- qstat ska visa information om varje batchkö vid varje destination som anges som operand.
-B
- Anger att operanden är ett servernamn.
- qstat ska visa information om varje server som anges som operand.
Operander
Om alternativet -Q anges till qstat ska verktyget acceptera en eller flera operander som följer syntaxen för en destination; se Section 3.3.2, Destination.
Om alternativet -B anges till qstat ska verktyget acceptera en eller flera servernamnsoperander.
Om varken -B eller -Q anges till qstat ska verktyget acceptera en eller flera operander som följer syntaxen för en batch-jobbidentifierare; se Section 3.3.1, Batch Job Identifier.
Standardindata
Används inte.
Indatafiler
Inga.
Miljövariabler
Följande miljövariabler ska påverka körningen av qstat:
HOME
- Bestämmer sökvägen till användarens hemkatalog.
LANG
- Tillhandahåller ett standardvärde för internationaliseringsvariabler som är osatta eller tomma. Se Base Definitions-volymen av POSIX.1-2017, Section 8.2, Internationalization Variables, för företrädesordningen mellan internationaliseringsvariabler som används för att bestämma värdena för lokalkategorier.
LC_ALL
- Om den är satt till ett icke-tomt strängvärde åsidosätter den värdena för alla andra internationaliseringsvariabler.
LC_COLLATE
- Bestämmer lokalen för beteendet hos intervall, ekvivalensklasser och flerteckens kollationeringselement inom reguljära uttryck.
LC_CTYPE
- Bestämmer lokalen för tolkningen av byteföljder av textdata som tecken, till exempel enkelbyte- i motsats till flerbytetecken i argument.
LC_MESSAGES
- Bestämmer lokalen som ska användas för att påverka formatet och innehållet i diagnostiska meddelanden som skrivs till standardfel.
LC_NUMERIC
- Bestämmer lokalen för valet av decimaltecken som används vid skrivning av formaterad flyttalsutmatning.
Asynkrona händelser
Standard.
Standardutmatning
Om en operand som anges till qstat är en batch-jobbidentifierare och alternativet -f inte anges, ska qstat visa följande poster på en enda rad, i angiven ordning, med blanktecken mellan varje post, för varje operand som behandlas korrekt:
- Batch-jobbidentifieraren
- Batchjobbets namn
- Attributet Job_Owner
- CPU-tid som använts av batchjobbet
- Batchjobbets tillstånd
- Batchjobbets plats
Om en operand som anges till qstat är en batch-jobbidentifierare och alternativet -f anges, ska qstat visa följande poster för varje operand som behandlas korrekt:
- Batch-jobbidentifieraren
- Batchjobbets namn
- Attributet Job_Owner
- Körningsanvändarens användar-ID
- CPU-tid som använts av batchjobbet
- Batchjobbets tillstånd
- Batchjobbets plats
- Ytterligare implementationsdefinierad information, om sådan finns, om batchjobbet eller batchkön
Om en operand som anges till qstat är en destination, alternativet -Q anges och alternativet -f inte anges, ska qstat visa följande poster på en enda rad, i angiven ordning, med blanktecken mellan varje post, för varje operand som behandlas korrekt:
- Batchköns namn
- Maximalt antal batchjobb som ska köras samtidigt i batchkön
- Totalt antal batchjobb i batchkön
- Batchköns status
- För varje tillstånd: antalet batchjobb i det tillståndet i batchkön samt tillståndets namn
- Batchköns typ, det vill säga exekveringskö eller routningskö
Om operanderna som anges till qstat är destinationer, alternativet -Q anges och alternativet -f anges, ska qstat visa följande poster för varje operand som behandlas korrekt:
- Batchköns namn
- Maximalt antal batchjobb som ska köras samtidigt i batchkön
- Totalt antal batchjobb i batchkön
- Batchköns status
- För varje tillstånd: antalet batchjobb i det tillståndet i batchkön samt tillståndets namn
- Batchköns typ, det vill säga exekveringskö eller routningskö
- Ytterligare implementationsdefinierad information, om sådan finns, om batchkön
Om operanderna som anges till qstat är batchservernamn, alternativet -B anges och alternativet -f inte anges, ska qstat visa följande poster på en enda rad, i angiven ordning, med blanktecken mellan varje post, för varje operand som behandlas korrekt:
- Batchserverns namn
- Maximalt antal batchjobb som ska köras samtidigt i batchkön
- Totalt antal batchjobb som hanteras av batchservern
- Batchserverns status
- För varje tillstånd: antalet batchjobb i det tillståndet samt tillståndets namn
Om operanderna som anges till qstat är servernamn, alternativet -B anges och alternativet -f anges, ska qstat visa följande poster för varje operand som behandlas korrekt:
- Serverns namn
- Maximalt antal batchjobb som ska köras samtidigt i batchkön
- Totalt antal batchjobb som hanteras av servern
- Serverns status
- För varje tillstånd: antalet batchjobb i det tillståndet samt tillståndets namn
- Ytterligare implementationsdefinierad information, om sådan finns, om servern
Standardfel
Standardfel ska endast användas för diagnostiska meddelanden.
Utdatafiler
Inga.
Utökad beskrivning
Ingen.
Slutstatus
Följande slutvärden ska returneras:
0
- Slutfört utan fel.
>0
- Ett fel inträffade.
Konsekvenser av fel
Utöver standardbeteendet ska qstat inte behöva skriva ett diagnostiskt meddelande till standardfel när felsvaret från en batchserver anger att batch-jobbidentifieraren inte finns på servern. Huruvida qstat väntar med att skriva ut det diagnostiska meddelandet medan verktyget försöker hitta batchjobbet på andra servrar är implementationsdefinierat.
Följande avsnitt är informativa.
Programanvändning
Ingen.
Exempel
Inga.
Motivering
qstat gör det möjligt för användare att visa status för jobb och lista batchjobben i köer.
Operanderna till qstat kan vara antingen jobbidentifierare, köer angivna som destinationsidentifierare eller batchservernamn. Alternativen -Q och -B, eller avsaknaden av dessa, anger operandernas natur.
De övriga alternativen till qstat låter användaren styra mängden information som visas och formatet som den visas i. Om en användare vill visa status för en uppsättning jobb som matchar ett urvalskriterium kan qselect användas för att hämta en sådan lista.
Alternativet -f låter användare begära en ”fullständig” visning i ett implementationsdefinierat format.
Historiskt har qstat varit en del av NQS och dess derivat, den befintliga praxis som verktyget bygger på.
Framtida riktning
qstat kan komma att tas bort i en framtida version.
Se även
Chapter 3, Batch Environment Services.
Base Definitions-volymen av POSIX.1-2017, Chapter 8, Environment Variables, Section 12.2, Utility Syntax Guidelines.
Upphovsrätt
Delar av denna text återges och reproduceras i elektronisk form från IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc. och The Open Group. Om det finns någon avvikelse mellan denna version och den ursprungliga IEEE- och The Open Group-standarden är den ursprungliga IEEE- och The Open Group-standarden det avgörande dokumentet. Den ursprungliga standarden kan hämtas online på:
http://www.opengroup.org/unix/online.html
Eventuella typografiska eller formateringsfel som förekommer på denna sida har sannolikt introducerats under konverteringen av källfilerna till man-sideformat. För att rapportera sådana fel, se:
https://www.kernel.org/doc/man-pages/reporting_bugs.html
Sidor som hänvisar till denna sida
Sidslut
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/qstat.1p.html
Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
https://www.linux.se/kontaka-linux-se/
Tack till Datorhjälp hemma som har sponsrat Linux.se med webbhotell.