qalter(1p)

PROLOG

Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementeringen av detta gränssnitt kan skilja sig åt; se motsvarande Linux-manualsida för detaljer om Linux-beteende. Gränssnittet kan också saknas i vissa Linux-implementationer.

NAMN

qalter — ändra ett batchjobb

SYNOPSIS

qalter [-a date_time] [-A account_string] [-c interval] [-e path_name]
       [-h hold_list] [-j join_list] [-k keep_list] [-l resource_list]
       [-m mail_options] [-M mail_list] [-N name] [-o path_name]
       [-p priority] [-r y|n] [-S path_name_list] [-u user_list]
       job_identifier...

BESKRIVNING

Egenskaperna för ett batchjobb ändras genom en begäran till den batchserver som hanterar batchjobbet. Verktyget qalter är en batchklient som användaren kan köra för att begära ändring av egenskaperna för ett eller flera batchjobb.

Verktyget qalter ska ändra egenskaperna för de batchjobb, och endast de batchjobb, för vilka en batch-job_identifier anges till verktyget.

Verktyget qalter ska ändra egenskaperna för batchjobb i den ordning som batch-job_identifier anges till verktyget.

Om qalter misslyckas med att behandla en batch-job_identifier ska verktyget fortsätta att behandla återstående batch-job_identifier, om sådana finns.

För varje batch-job_identifier som qalter lyckas behandla ska varje egenskap hos det identifierade batchjobbet ändras enligt alla optioner som angetts till verktyget.

För varje identifierat batchjobb där qalter misslyckas ska verktyget inte ändra någon egenskap hos batchjobbet.

För varje batchjobb som qalter behandlar ska verktyget inte ändra någon annan egenskap än de som krävs av de optioner och optionsargument som angetts till verktyget.

Verktyget qalter ska ändra batchjobb genom att skicka en Modify Job Request till den batchserver som hanterar varje batchjobb. När qalter avslutas ska det ha ändrat batchjobbet som motsvarar varje batch-job_identifier som behandlats utan fel. Ett försök att ändra egenskaperna för ett batchjobb i tillståndet RUNNING är implementationsdefinierat.

OPTIONER

Verktyget qalter ska följa Base Definitions-volymen av POSIX.1-2017, avsnitt 12.2, Utility Syntax Guidelines.

Följande optioner ska stödjas av implementationen:

-a date_time

Omdefiniera den tidpunkt då batchjobbet blir körbart.

Argumentet date_time ska ha samma form och representera samma tid som för verktyget touch(1p). Den tid som representeras ska sättas i batchjobbets egenskap Execution_Time. Om den angivna tiden är tidigare än aktuell tid ska optionen -a inte ha någon effekt.

-A account_string

Omdefiniera det konto som resursförbrukningen för batchjobbet ska debiteras till.

Syntaxen för optionsargumentet account_string är ospecificerad.

Verktyget qalter ska sätta batchjobbets egenskap Account_Name till värdet av optionsargumentet account_string.

-c interval

Omdefiniera om batchjobbet ska checkpointas, och i så fall hur ofta.

Verktyget qalter ska acceptera ett värde för optionsargumentet interval som är ett av följande:

n

Ingen checkpointing ska utföras på batchjobbet (NO_CHECKPOINT).

s

Checkpointing ska endast utföras när batchservern stängs av (CHECKPOINT_AT_SHUTDOWN).

c

Automatisk periodisk checkpointing ska utföras enligt egenskapen Minimum_Cpu_Interval för batchkön, i enheter av CPU-minuter (CHECKPOINT_AT_MIN_CPU_INTERVAL).

c=minutes

Automatisk periodisk checkpointing ska utföras var minutes CPU-tid, eller var Minimum_Cpu_Interval minuter, beroende på vilket som är störst. Argumentet minutes ska följa syntaxen för osignerade heltal och ska vara större än noll.

En implementation kan definiera andra checkpointintervall. Implementationens konformitetsdokument ska beskriva alla alternativa checkpointintervall, hur de anges, deras interna beteende och hur de påverkar verktygets beteende.

Verktyget qalter ska sätta batchjobbets egenskap Checkpoint till värdet av optionsargumentet interval.

-e path_name

Omdefiniera sökvägen som ska användas för batchjobbets standardfelström.

Verktyget qalter ska acceptera ett optionsargument path_name som följer syntaxen för elementet path_name, definierat i System Interfaces-volymen av POSIX.1-2017. Det kan föregås av ett värdnamnselement av formen hostname:.

Om optionsargumentet path_name utgör en absolut sökväg ska qalter sätta batchjobbets egenskap Error_Path till värdet av optionsargumentet path_name, inklusive värdnamnselementet om ett sådant finns.

Om optionsargumentet path_name utgör en relativ sökväg och inget värdnamnselement anges, ska qalter sätta batchjobbets egenskap Error_Path till värdet av den absoluta sökväg som härleds genom att expandera optionsargumentet path_name relativt den aktuella katalogen för den process som kör qalter.

Om optionsargumentet path_name utgör en relativ sökväg och ett värdnamnselement anges, ska qalter sätta batchjobbets egenskap Error_Path till värdet av optionsargumentet utan expansion.

Om optionsargumentet path_name inte innehåller något värdnamnselement ska qalter lägga till prefixet hostname: framför sökvägen i egenskapen Error_Path, där hostname är namnet på den värd där qalter körs.

-h hold_list

Omdefiniera vilka typer av spärrar, om några, som finns på batchjobbet. Optionen -h ska acceptera ett värde för optionsargumentet hold_list som är en sträng av alfanumeriska tecken i den portabla teckenuppsättningen.

Verktyget qalter ska acceptera ett värde för optionsargumentet hold_list som är en sträng med ett eller flera av tecknen u, s eller o, eller det enskilda tecknet n. För varje unikt tecken i optionsargumentet hold_list ska qalter lägga till ett värde i batchjobbets egenskap Hold_Types enligt följande, där varje värde representerar en annan spärrtyp:

u

USER

s

SYSTEM

o

OPERATOR

Om något av dessa tecken upprepas i optionsargumentet hold_list ska dubbletterna ignoreras. En befintlig egenskap Hold_Types kan rensas med spärrtypen:

n

NO_HOLD

Verktyget qalter ska betrakta det som ett fel om någon annan spärrtyp än n kombineras med spärrtypen n.

Strikt konforma program ska inte upprepa något av tecknen u, s, o eller n i optionsargumentet hold_list. Verktyget qalter ska tillåta upprepning av tecken, men ska inte tilldela upprepade tecken någon ytterligare betydelse.

En implementation kan definiera andra spärrtyper. Implementationens konformitetsdokument ska beskriva alla ytterligare spärrtyper, hur de anges, deras interna beteende och hur de påverkar verktygets beteende.

-j join_list

Omdefiniera vilka strömmar från batchjobbet som ska slås samman. Optionen -j ska acceptera ett värde för optionsargumentet join_list som är en sträng av alfanumeriska tecken i den portabla teckenuppsättningen.

Verktyget qalter ska acceptera ett optionsargument join_list som består av ett eller flera av tecknen e och o, eller det enskilda tecknet n.

Alla andra angivna utdataflöden för batchjobbet ska slås samman till det utdataflöde som representeras av det tecken som anges först i optionsargumentet join_list.

För varje unikt tecken i optionsargumentet join_list ska qalter lägga till ett värde i batchjobbets egenskap Join_Path enligt följande, där varje värde representerar en annan batchjobbström som ska slås samman:

e

Batchjobbets standardfel (JOIN_STD_ERROR).

o

Batchjobbets standardutdata (JOIN_STD_OUTPUT).

En befintlig egenskap Join_Path kan rensas med join-typen:

n

NO_JOIN

Om n anges ska inga filer slås samman. Verktyget qalter ska betrakta det som ett fel om någon annan join-typ än n kombineras med join-typen n.

Strikt konforma program ska inte upprepa något av tecknen e, o eller n i optionsargumentet join_list. Verktyget qalter ska tillåta upprepning av tecken, men ska inte tilldela upprepade tecken någon ytterligare betydelse.

En implementation kan definiera andra join-typer. Implementationens konformitetsdokument ska beskriva alla ytterligare batchjobbströmmar, hur de anges, deras interna beteende och hur de påverkar verktygets beteende.

-k keep_list

Omdefiniera vilken utdata från batchjobbet som ska behållas på körvärden.

Optionen -k ska acceptera ett värde för optionsargumentet keep_list som är en sträng av alfanumeriska tecken i den portabla teckenuppsättningen.

Verktyget qalter ska acceptera ett optionsargument keep_list som består av ett eller flera av tecknen e och o, eller det enskilda tecknet n.

För varje unikt tecken i optionsargumentet keep_list ska qalter lägga till ett värde i batchjobbets egenskap Keep_Files enligt följande, där varje värde representerar en annan batchjobbström som ska behållas:

e

Batchjobbets standardfel (KEEP_STD_ERROR).

o

Batchjobbets standardutdata (KEEP_STD_OUTPUT).

Om både e och o anges ska båda filerna behållas. En befintlig egenskap Keep_Files kan rensas med keep-typen:

n

NO_KEEP

Om n anges ska inga filer behållas. Verktyget qalter ska betrakta det som ett fel om någon annan keep-typ än n kombineras med keep-typen n.

Strikt konforma program ska inte upprepa något av tecknen e, o eller n i optionsargumentet keep_list. Verktyget qalter ska tillåta upprepning av tecken, men ska inte tilldela upprepade tecken någon ytterligare betydelse.

En implementation kan definiera andra keep-typer. Implementationens konformitetsdokument ska beskriva alla ytterligare keep-typer, hur de anges, deras interna beteende och hur de påverkar verktygets beteende.

-l resource_list

Omdefiniera de resurser som är tillåtna eller krävs av batchjobbet.

Verktyget qalter ska acceptera ett optionsargument resource_list som följer följande syntax:

resource=value[,,resource=value,,...]

Verktyget qalter ska sätta en post i värdet för batchjobbets egenskap Resource_List för varje resurs som listas i optionsargumentet resource_list.

Eftersom listan över resursnamn som stöds kan variera mellan batchservrar ska qalter låta batchservern validera resursnamnen och de tillhörande värdena. Se avsnitt 3.3.3, Multiple Keyword-Value Pairs, för ett sätt att ta bort par av formen keyword=value och value@keyword, samt andra allmänna regler för listorienterade batchjobbegenskaper.

-m mail_options

Omdefiniera vid vilka punkter i batchjobbets körning som batchservern ska skicka e-post om en ändring i batchjobbets tillstånd.

Optionen -m ska acceptera ett värde för optionsargumentet mail_options som är en sträng av alfanumeriska tecken i den portabla teckenuppsättningen.

Verktyget qalter ska acceptera ett värde för optionsargumentet mail_options som är en sträng med ett eller flera av tecknen e, b och a, eller det enskilda tecknet n.

För varje unikt tecken i optionsargumentet mail_options ska qalter lägga till ett värde i batchjobbets egenskap Mail_Users enligt följande, där varje värde representerar en annan tidpunkt under ett batchjobbs livstid då e-post ska skickas:

e

MAIL_AT_EXIT

b

MAIL_AT_BEGINNING

a

MAIL_AT_ABORT

Om något av dessa tecken upprepas i optionsargumentet mail_options ska dubbletterna ignoreras.

En befintlig egenskap Mail_Points kan rensas med mail-typen:

n

NO_MAIL

Om n anges ska ingen e-post skickas. Verktyget qalter ska betrakta det som ett fel om någon annan mail-typ än n kombineras med mail-typen n. Strikt konforma program ska inte upprepa något av tecknen e, b, a eller n i optionsargumentet mail_options. Verktyget qalter ska tillåta upprepning av tecken, men ska inte tilldela upprepade tecken någon ytterligare betydelse.

En implementation kan definiera andra mail-typer. Implementationens konformitetsdokument ska beskriva alla ytterligare mail-typer, hur de anges, deras interna beteende och hur de påverkar verktygets beteende.

-M mail_list

Omdefiniera listan över användare som den batchserver som kör batchjobbet ska skicka e-post till, om batchservern skickar e-post om batchjobbet.

Syntaxen för optionsargumentet mail_list är ospecificerad. Om implementationen av qalter använder en namntjänst för att hitta användare ska verktyget acceptera den syntax som används av namntjänsten.

Om implementationen av qalter inte använder en namntjänst för att hitta användare ska implementationen acceptera följande syntax för användarnamn:

mail_address[,,mail_address,,...]

Tolkningen av mail_address är implementationsdefinierad.

Verktyget qalter ska sätta batchjobbets egenskap Mail_Users till värdet av optionsargumentet mail_list.

-N name

Omdefiniera batchjobbets namn.

Optionen -N ska acceptera ett värde för optionsargumentet name som är en sträng med upp till 15 alfanumeriska tecken i den portabla teckenuppsättningen, där det första tecknet är alfabetiskt.

Syntaxen för optionsargumentet name är ospecificerad.

Verktyget qalter ska sätta batchjobbets egenskap Job_Name till värdet av optionsargumentet name.

-o path_name

Omdefiniera sökvägen för batchjobbets standardutdata.

Verktyget qalter ska acceptera ett optionsargument path_name som följer syntaxen för elementet path_name, definierat i System Interfaces-volymen av POSIX.1-2017. Det kan föregås av ett värdnamnselement av formen hostname:.

Om optionsargumentet path_name utgör en absolut sökväg ska qalter sätta batchjobbets egenskap Output_Path till värdet av optionsargumentet path_name.

Om optionsargumentet path_name utgör en relativ sökväg och inget värdnamnselement anges, ska qalter sätta batchjobbets egenskap Output_Path till den absoluta sökväg som härleds genom att expandera optionsargumentet path_name relativt den aktuella katalogen för den process som kör qalter.

Om optionsargumentet path_name utgör en relativ sökväg och ett värdnamnselement anges, ska qalter sätta batchjobbets egenskap Output_Path till värdet av optionsargumentet path_name utan någon expansion av sökvägen.

Om optionsargumentet path_name inte innehåller något värdnamnselement ska qalter lägga till prefixet hostname: framför sökvägen i egenskapen Output_Path, där hostname är namnet på den värd där qalter körs.

-p priority

Omdefiniera batchjobbets prioritet.

Verktyget qalter ska acceptera ett värde för optionsargumentet priority som följer syntaxen för signerade decimala heltal och som inte är mindre än -1024 och inte större än 1023.

Verktyget qalter ska sätta batchjobbets egenskap Priority till värdet av optionsargumentet priority.

-r y|n

Omdefiniera om batchjobbet kan köras om.

Om optionsargumentets värde är y ska qalter sätta batchjobbets egenskap Rerunable till TRUE.

Om optionsargumentets värde är n ska qalter sätta batchjobbets egenskap Rerunable till FALSE.

Verktyget qalter ska betrakta det som ett fel om något annat tecken än y eller n anges i optionsargumentet.

-S path_name_list

Omdefiniera det skal som tolkar skriptet på destinationssystemet.

Verktyget qalter ska acceptera ett optionsargument path_name_list som följer följande syntax:

pathname[@host][,pathname[@host],...]

Verktyget qalter ska endast acceptera en sökväg som saknar motsvarande värdnamn. Verktyget qalter ska endast tillåta en sökväg per namngiven värd.

Verktyget qalter ska lägga till ett värde i batchjobbets egenskap Shell_Path_List för varje post i optionsargumentet path_name_list. Se avsnitt 3.3.3, Multiple Keyword-Value Pairs, för ett sätt att ta bort par av formen keyword=value och value@keyword, samt andra allmänna regler för listorienterade batchjobbegenskaper.

-u user_list

Omdefiniera det användarnamn under vilket batchjobbet ska köras på destinationssystemet.

Verktyget qalter ska acceptera ett optionsargument user_list som följer följande syntax:

username[@host][,,username[@host],,...]

Verktyget qalter ska endast acceptera ett användarnamn som saknar motsvarande värdnamn. Verktyget qalter ska endast acceptera ett användarnamn per namngiven värd.

Verktyget qalter ska lägga till ett värde i batchjobbets egenskap User_List för varje post i optionsargumentet user_list. Se avsnitt 3.3.3, Multiple Keyword-Value Pairs, för ett sätt att ta bort par av formen keyword=value och value@keyword, samt andra allmänna regler för listorienterade batchjobbegenskaper.

OPERANDER

Verktyget qalter ska acceptera en eller flera operander som följer syntaxen för en batch-job_identifier; se avsnitt 3.3.1, Batch Job Identifier.

STANDARDINDATA

Används inte.

INDATAFILER

Inga.

MILJÖVARIABLER

Följande miljövariabler ska påverka körningen av qalter:

LANG

Anger ett standardvärde för internationaliseringsvariabler som är osatta eller tomma. Se Base Definitions-volymen av POSIX.1-2017, avsnitt 8.2, Internationalization Variables, för prioriteten mellan internationaliseringsvariabler som används för att bestämma värden för lokalkategorier.

LC_ALL

Om denna är satt till ett icke-tomt strängvärde, åsidosätter den värdena för alla andra internationaliseringsvariabler.

LC_CTYPE

Bestämmer lokalen för tolkning av byteföljder som teckendata, till exempel enkelbyte- kontra 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.

LOGNAME

Bestämmer användarens inloggningsnamn.

TZ

Bestämmer tidszonen som används för att tolka optionsargumentet date-time. Om TZ är osatt eller tom ska en ospecificerad standardtidszon användas.

ASYNKRONA HÄNDELSER

Standard.

STANDARDUTDATA

Ingen.

STANDARDFEL

Standardfel ska endast användas för diagnostiska meddelanden.

UTDATAFILER

Inga.

UTÖKAD BESKRIVNING

Ingen.

SLUTSTATUS

Följande slutvärden ska returneras:

Värde	Betydelse
0	Lyckad avslutning.
>0	Ett fel inträffade.

FÖLJDER AV FEL

Utöver standardbeteendet ska verktyget qalter inte krävas att skriva ett diagnostiskt meddelande till standardfel när felsvaret från en batchserver anger att batch-job_identifier inte finns på servern. Huruvida qalter försöker hitta batchjobbet på andra batchservrar är implementationsdefinierat.

Följande avsnitt är informativa.

ANVÄNDNING I PROGRAM

Ingen.

EXEMPEL

Inga.

BAKGRUND OCH MOTIVERING

Verktyget qalter låter användare ändra egenskaperna för ett batchjobb.

Som metod för att ändra ett köat jobb är qalter bättre än att radera och lägga in batchjobbet i kön igen, eftersom ett ändrat jobb behåller sin plats i kön med vissa traditionella urvalsalgoritmer. Dessutom är qalter både kortare och enklare än en sekvens av verktygen qdel och qsub.

Resultatet av ett försök från användaren att ändra ett batchjobb i tillståndet RUNNING är implementationsdefinierat, eftersom ett batchjobb i RUNNING-tillstånd redan har öppnat sina utdatafiler och i övrigt utfört de åtgärder som anges av de optioner som gällde när batchjobbet började köras.

Optionerna som behandlas av qalter är identiska med dem för verktyget qsub, med några undantag: -V, -v och -q. Optionerna -V och -v är olämpliga för qalter, eftersom de fångar potentiellt tillfällig miljöinformation från den inskickande processen. Optionen -q skulle ange en ny kö, vilket till stor del skulle upphäva den tidigare nämnda fördelen med att använda qalter. Dessutom ger verktyget qmove ett bättre sätt att flytta jobb.

Varje följande stycke ger bakgrunden till en option i qalter.

Ytterligare motivering för dessa optioner finns i motiveringen för verktyget qsub.

Optionen -a låter användare ändra datum och tid då ett batchjobb blir körbart.

Optionen -A låter användare ändra det konto som ska debiteras för resurser som förbrukas av batchjobbet. Stöd för optionen -A är obligatoriskt för konforma implementationer av qalter, även om stöd för bokföring är valfritt för servrar. Huruvida bokföring ska stödjas lämnas åt serverimplementatören, men obligatoriskt stöd för optionen -A ger användarna ett konsekvent gränssnitt och låter dem styra bokföring på servrar som stöder bokföring.

Optionen -c låter användare ändra checkpointintervallet för ett batchjobb. Ett checkpointsystem, som inte definieras av POSIX.1-2008, gör det möjligt att återställa ett batchjobb från den senaste checkpointen vid en krasch. Checkpointing används typiskt för jobb som förbrukar dyrbar beräkningstid eller måste uppfylla en kritisk tidsplan. Användare bör kunna göra avvägningen mellan overhead från checkpointing och risken för att batchjobbet inte avslutas i tid; därför tillhandahåller denna volym av POSIX.1-2017 optionen för checkpointintervall. Stöd för checkpointing är valfritt för servrar.

Optionen -e låter användare ändra namn och plats för standardfelströmmen som skrivs av ett batchjobb. Sökvägen för standardfelströmmen är dock meningslös om värdet på batchjobbets egenskap Join_Path är TRUE.

Optionen -h låter användare sätta spärrtypen i batchjobbets egenskap Hold_Types. Verktygen qhold och qrls lägger till respektive tar bort spärrtyper i egenskapen Hold_Types. Optionen -h har modifierats för att tillåta implementationsdefinierade spärrtyper.

Optionen -j låter användare ändra beslutet att slå samman batchjobbets standardfelström med batchjobbets standardutdataström.

Optionen -l låter användare ändra resursgränserna som läggs på ett batchjobb.

Optionen -m låter användare ändra listan över punkter i ett batchjobbs livstid då de angivna användarna ska få e-postmeddelanden.

Optionen -M låter användare ändra listan över användare som ska få meddelanden om händelser i batchjobbets livstid.

Optionen -N låter användare ändra namnet på ett batchjobb.

Optionen -o låter användare ändra namn och sökväg dit batchjobbets standardutdataström ska skrivas.

Optionen -P låter användare ändra prioriteten för ett batchjobb. Stöd för prioritet är valfritt för batchservrar.

Optionen -r låter användare ändra om batchjobbet kan köras om.

Optionen -S låter användare ändra namn och plats för skalavbildningen som ska anropas för att tolka batchjobbets skript. Denna option har modifierats för att tillåta en lista över skalnamn och skalplatser associerade med olika värdar.

Optionen -u låter användare ändra den användaridentifierare under vilken batchjobbet ska köras.

Syntaxen för operanden job_identifier finns så att användaren kan skilja mellan ursprungsservern och destinationsservern, eller körservern. Dessa kan vara samma server eller olika servrar. Delen .server_name identifierar den ursprungliga batchservern, medan delen @server identifierar destinationsservern.

Historiskt har verktyget qalter varit en komponent i Network Queuing System (NQS), den befintliga praxis som detta verktyg har härletts från.

FRAMTIDA RIKTNINGAR

Verktyget qalter kan komma att tas bort i en framtida version.

SE ÄVEN

Kapitel 3, Batch Environment Services, qdel(1p), qhold(1p), qmove(1p), qrls(1p), qsub(1p), touch(1p)

Base Definitions-volymen av POSIX.1-2017, kapitel 8, Environment Variables, avsnitt 12.2, Utility Syntax Guidelines

COPYRIGHT

Delar av denna text är återgivna och reproducerade 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. Vid avvikelser mellan denna version och den ursprungliga IEEE- och The Open Group-standarden är den ursprungliga standarden den avgörande referensen. 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 troligen införts vid konverteringen av källfilerna till manualsidesformat. 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

• qmove(1p)

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/qalter.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.