Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
Display information about reservations

usage: qcg-rlist [-C <period>] [-c] [-F <format>] [-h] [-n <NOTE>] [-N] [-R] [-S <period>] [-s <status(es)>] [-T <format>] [-t] [-v]
usage: qcg-client get_reservations [-C <period>] [-c] [-F <format>] [-h] [-n <NOTE>] [-N] [-R] [-S <period>] [-s <status(es)>] [-T <format>] [-t] [-v]

Options:
 -C,--changed <period>      changed in the period of time
 -c,--color               changed in the period of time (not supported yet)Colorize output
 -hF,--helpformat <format>       columns          format
 -h,--help                     display help message
 -n,--note                            <NOTE>           list elements with the given note
 -N,--no-list               do not display list
 -R,--report                display do not display listsummary report.
 -RS,--reportsubmitted <period>    submited in the period of time. If the status is defined the default value of the period is 1 day.
 -s,--status <status(es)>   status(es) of the job. Lack of this  display summary reportoption is equivalent to requesting unterminated activities.
 -ST,--submittedtime <period><format>         time format
 -t,--truncated             display submitedtruncated in the period of time. If the status is
identifiers
 -v,--version                                                      defined the default value of the period is 1 day.
 -s,--status <status(es)>                        status(es) of the job. Lack of this option is
                                                 equivalent to requesting unterminated activities.
 -v,--version                                    display version

Polecenie wyświetla listę rezerwacji użytkownika.

Opcja -C/--changed pozwala określić, że wyświetlone mają być rezerwacje, których status zmienił się w zadanym okresie czasu. W ciągu ostatnich „liczba” dni („d”), godzin („h”), minut („m”).

Opcja -S/--submitted pozwala określić, że wyświetlone mają być rezerwacje zlecone w zadanym okresie czasu. W ciągu ostatnich „liczba” dni („d”), godzin („h”), minut („m”).

Opcja -s/--status pozwala zawęzić listę wyświetlanych rezerwacji do tych w danym stanie. Możliwe jest podanie wielu stanów rozdzielonych przecinkiem.

Opcja -n/--note pozwala zawęzić listę rezerwacji do tych posiadających określony opis (note). Możliwe jest podanie wyrażenia zawierającego % oznaczający dowolny ciąg znaków (np. "eksperyment nr %").

Opcja -N/--no-list powoduje pominięcie wyświetlania listy rezerwacji. Stosowane w połączeniu z opcją -R do wyświetlania tylko statystyki.

Opcja -R/--report powoduje wyświetlenie statystyki rezerwacji.

 

Statusy rezerwacji:

  • SUBMITTED - rezerwacje zlecona do wykonania,
  • RESERVED - zasoby zarezerwowane, rezerwacja nieaktywna,
  • ACTIVE - rezerwacja aktywna,
  • FINISHED - rezerwacja zakończona,
  • FAILED - rezerwacja zakońzona niepowodzeniem,
  • CANCELED - rezerwacja anulowana.

Dla wygody użytkowników zamiast listy stanów możliwe jest podanie zdefiniowanych stałych:

  • all - rezerwacje we wszystkich stanach,
  • terminated - rezerwacje w stanach końcowych (FINISHED,FAILED,CANCELED)
  • unterminated - rezerwacje niezakończone (SUBMITTED,ACTIVE,RESERVED).

Przełącznik -R włacza wyświetlenie reportu przedstawiającego liczbę rezerwacji w każdym stanie.

display version

Polecenie wyświetla listę rezerwacji użytkownika.

Opcja -C/--changed - pozwala określić, że wyświetlone mają być rezerwacje, których status zmienił się w zadanym okresie czasu. W ciągu ostatnich „liczba” dni („d”), godzin („h”), minut („m”).

Opcja -c/–color - koloruje linie zgodnie ze stanem rezerwacji

Opcja -F/–format - własny format wyświetlania lini

Opcja -n/--note - pozwala zawęzić listę rezerwacji do tych posiadających określony opis (note). Możliwe jest podanie wyrażenia zawierającego % oznaczający dowolny ciąg znaków (np. "eksperyment nr %").

Opcja -N/--no-list - powoduje pominięcie wyświetlania listy rezerwacji. Stosowane w połączeniu z opcją -R do wyświetlania tylko statystyki.

Opcja -R/--report - powoduje wyświetlenie statystyki rezerwacji.

Opcja -S/--submitted - pozwala określić, że wyświetlone mają być rezerwacje zlecone w zadanym okresie czasu. W ciągu ostatnich „liczba” dni („d”), godzin („h”), minut („m”).

Opcja -s/--status - pozwala zawęzić listę wyświetlanych rezerwacji do tych w danym stanie. Możliwe jest podanie wielu stanów rozdzielonych przecinkiem.

Opcja -T/--time - format wyświetlanego czasu

Opcja -t/--truncated - wyświetlenie listy "przyciętych" identyfikatorów.

 

Statusy rezerwacji:

  • SUBMITTED - rezerwacje zlecona do wykonania,
  • RESERVED - zasoby zarezerwowane, rezerwacja nieaktywna,
  • ACTIVE - rezerwacja aktywna,
  • FINISHED - rezerwacja zakończona,
  • FAILED - rezerwacja zakońzona niepowodzeniem,
  • CANCELED - rezerwacja anulowana.

Dla wygody użytkowników zamiast listy stanów możliwe jest podanie zdefiniowanych stałych:

  • all - rezerwacje we wszystkich stanach,
  • terminated - rezerwacje w stanach końcowych (FINISHED,FAILED,CANCELED)
  • unterminated - rezerwacje niezakończone (SUBMITTED,ACTIVE,RESERVED).

Przełącznik -R włacza wyświetlenie reportu przedstawiającego liczbę rezerwacji w każdym stanie.

Code Block
qcg-rlist 
qcg-rlist -S 1d
qcg-rlist -s failed
qcg-rlist -S 1d -s all -R

 

Format wyświetlania dat

Użytkownik może zdefiniować przy wywołaniu polecenia lub w pliku konfiguracyjnym własny format wyświetlania dat.

  • YY - rok (4 cyfry)
  • yy - rok (2 cyfry)
  • m - miesiąc (01-12)
  • B - nazwa miesiąca
  • b - skrócona nazwa miesiąca
  • A - nazwa dnia tygodnia
  • a - skrócona nazwa dnia tygodnia
  • d - dzień (01-31)
  • e - dzień (1-31)
  • H - godzina (00-23)

  • k - godzina (0-23)

  • M - minuty (00-59)

  • S - sekundy (00-59)

Domyślny format: "dd.MM.yy HH:mm"

 

Format wyświetlania kolumn:

Użytkownik może zdefiniować własny format wyświetlanych linii podając ciąg tekstowy definiujący ten format poprzez opcję polecenia lub plik konfiguracyjny).

W formacie użytkownik podaje kolumny, ich rozmiary i sposób wyrównywania wg następującego schematu:

Code Block
%[-]<WIDTH><COLUMN_ID> [ %[-]<WIDTH><COLUMN_ID> ] ...

gdzie:

  • % - obowiązkowy znak rozpoczynający definicję kolumny
  • - opcjonalny znak "minus" określający wyrównywanie do lewej
  • WIDTH - czerokość pola w znakach. Szerszy tekst będzie przycinany do tej szerokości.
  • COLUMN_ID - identyfikator kolumny (patrz tabela poniżej).

Domyślny format: ""%-22I  %-20N  %-15T  %-15X  %-15E  %-16S  %-8H  %-5C  %-20D""

 

Wyświetlane kolumny:

KolumnaIdentyfikatorZnaczenie

JOB IDENTIFIER

IIdentyfikator zadania

NOTE                

NOpis zadania (wartość dyrektywy #QCG note)

SUBMISSION TIME

TCzas zlecenia zadania

START TIME     

XCzas rozpoczęcia zadania

FINISH TIME    

ECzas zakończenia zadania

STATUS          

SStatus zadania

HOSTNAME

HNazwa klastra/klastrów, na którym/których wykonuje się zadanie

SLOTS

CLiczba zarezerwowanych rdzeni
STATUS DESCRIPTIONDOpis stanu (dodatkowy opis dla stanu FAILED)

 

Przykładowe wywołanie.

Code Block
qcg-list -F ""%-22I  %-20N  %-15T  %-15X  %-15E  %-16S  %-8H  %-5F  %-20D" -t "dd.MM.yy HH:mm"
Code Block
qcg-rlist 
qcg-rlist -S 1d
qcg-rlist -s failed
qcg-rlist -S 1d -s all -R