qstat(1p)

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök

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

qselect(1p)

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.