Parametry dostarczane do procesów w tle

W tej sekcji opisano różne typy parametrów dostarczanych do procesów w tle.

Parametry ogólne

Poniższe informacje są przekazywane do każdego procesu w tle.

  • Kod zadania. Kod zadania to unikatowy identyfikator procesu w tle.

  • Numeru wątku zadania. Numeru wątku jest używany jedynie dla procesów w tle, które można uruchamiać w wielu równoległych wątkach. Zawiera względny numer wątku procesu. Na przykład: jeśli proces fakturowania został skonfigurowany w celu uruchomienia w 20 równoległych wątkach, wówczas każda z 20 instancji otrzymuje względny numer wątku (od 1 do 20). Więcej informacji można znaleźć w sekcji Optymalna liczba wątków dla równoległych procesów w tle.

  • Liczba wątków zadania. Liczba wątków jest używana jedynie dla procesów w tle, które można uruchamiać w wielu równoległych wątkach. Obejmuje całkowitą liczbę równoległych wątków, które zostały zaplanowane. Na przykład: jeśli proces fakturowania został skonfigurowany do uruchomienia w 20 równoległych wątkach, wówczas każda z 20 instancji otrzymuje liczbę wątków równą 20. Więcej informacji można znaleźć w sekcji Optymalna liczba wątków dla równoległych procesów w tle.

  • Numer ponownego uruchomienia zadania. Numer ponownego uruchomienia jest używany jedynie dla procesów w tle, które pobrały informacje należące do danego numeru uruchomienia. Powinien być dostarczany jedynie w razie konieczności pobrania historycznego uruchomienia (a nie ostatniego uruchomienia).

  • Data robocza zadania. Data robocza jest używana jedynie dla procesów w tle, które używają w swoim przetwarzaniu bieżącej daty. Na przykład: Proces fakturowania może wykorzystywać datę roboczą w celu określenia, które cykle fakturowania powinny zostać pobrane. Jeśli ten parametr pozostanie pusty, zostanie użyta data systemowa. Jeśli data zostanie wprowadzona, jej format musi odpowiadać wzorcowi: RRRR-MM-DD. Uwaga: ten parametr jest używany tylko podczas kontroli jakości w celu przetestowania działania procesów.

  • Nadpisanie maksymalnej liczby rekordów między potwierdzeniami. Ten parametr jest opcjonalny i powoduje nadpisanie każdego pola dotyczącego standardowego potwierdzania dla procesu w tle. Tę wartość należy zmniejszyć na przykład wtedy, gdy użytkownik prześle zadanie w ciągu dnia i zażąda częstszych potwierdzeń w celu zwolnienia przetrzymywanych zasobów. Użytkownik może zwiększyć tę wartość, gdy proces w tle będzie wykonywany w nocy (lub w weekendy), a na serwerach jest dostępna duża ilość pamięci.

  • Nadpisanie maksymalnej liczby minut między ponownym inicjowaniem kursora. Ten parametr jest opcjonalny i nadpisuje parametr dotyczący standardowej liczby minut między ponownym inicjowaniem kursora dla procesu w tle. Te wartości należy zmniejszyć na przykład wtedy, gdy użytkownik prześle zadanie w ciągu dnia i zażąda częstszych potwierdzeń w celu zwolnienia przetrzymywanych zasobów (lub częstszego inicjowania kursora). Użytkownik może zwiększyć te wartości, gdy proces w tle będzie wykonywany w nocy (lub w weekendy), a na serwerach jest dostępna duża ilość pamięci.

  • ID użytkownika. Względem ID użytkownika należy uważać na następujące sytuacje:

    • Zarówno użytkownik przesyłający zadanie, jak i ID użytkownika zarejestrowany podczas przesyłania zadania muszą mieć dostęp do usługi aplikacyjnej dotyczącej kontrolki zadania zabezpieczającej wykonywanie.

    • ID użytkownika używany jest w przetwarzaniu wszystkich procesów zadań, w których został zapisany w tworzonych lub aktualizowanych rekordach.

    • Profil wyświetlania użytkownika o danym ID umożliwia kontrolowanie sposobu formatowania dat i wartości walutowych w komunikatach.

  • Hasło. Hasło nie jest obecnie używane.

  • Kod języka. Kod języka jest używany w celu realizacji dostępu do wartości specyficznych dla języka tabeli kontrolnej. Na przykład w tym kodzie języka są obecne komunikaty o błędach.

  • Uruchamianie programu śledzenia, Zakończenie programu śledzenia, Śledzenie kodu SQL i Dane wyjściowe śledzenia. Te przełączniki są używane tylko podczas kontroli jakości oraz testowania. Jeśli uruchomienie programu śledzenia jest zaznaczone, komunikat zostanie wyświetlony przy każdym uruchomieniu programu. Jeśli zakończenie programu śledzenia jest zaznaczone, komunikat zostanie wyświetlony przy każdym zakończeniu programu. Jeśli śledzenie kodu SQL jest zaznaczone, komunikat zostanie wyświetlony przy każdym wykonaniu instrukcji SQL. Jeśli dane wyjściowe śledzenia są zaznaczone, zapisywane są specjalne komunikaty sformatowane przez proces w tle.

Uwaga: Informacje wyświetlane, gdy przełącznik śledzenia danych wyjściowych jest włączony, zależą od procesu w tle. Możliwe jest także, że proces w tle nie wyświetli żadnej informacji dla tego przełącznika.

Wspólne dodatkowe parametry

Każda kontrolka zadania obsługuje definiowanie dodatkowych parametrów. Niektóre dodatkowe parametry są wspólne dla wszystkich procesów zadań lub wspólne dla określonego typu procesu zadania. Kontrolki zadań należy dostarczać wraz z odpowiednimi dodatkowymi parametrami. Jednak wprowadzając nowe dodatkowe parametry nie można zaktualizować istniejących kontrolek zadań nowym dodatkowym parametrem.

W poniższej tabeli przedstawiono wspólne parametry, które można połączyć z kontrolką zadania. Należy zauważyć, że w przypadku parametrów zadania, jakkolwiek istnieje numer kolejny kontrolujący porządek wyświetlania parametrów, proces zadania nie korzysta z numeru kolejnego do identyfikowania poszczególnych parametrów, zamiast tego używa on nazwy parametru. W niektórych przypadkach obsługiwanych jest wiele nazw parametrów (wersja zapisana literami różnej wielkości i wersja zapisana wielkimi literami).

Nazwa parametru Opis Dodatkowe komentarze
MAX-ERRORS / maxErrors Każde zadanie zawiera - w ramach parametrów uruchamiania - wstępnie zdefiniowaną stałą, która określa liczbę błędów, jaką zadanie może napotkać zanim konieczne będzie przerwanie jego działania. Użytkownik może zastąpić tę stałą, korzystając z tego parametru. Wartość wejściowa musi być liczbą całkowitą większą od zera lub równą zeru. Maksymalną wartością dla tego parametru jest 999 999 999 999 999.
DIST-THD-POOL Każdy proces zadania jest wykonywany w puli wątków. Ten parametr jest wymagany tylko jeśli proces zadania ma być wykonywany w puli wątków innej niż domyślna. Nazwa domyślnej puli wątków to DEFAULT.
emailMode Gdy zadanie jest przesyłane z powiązanym adresem e-mail, domyślna logika przewiduje wysłanie wiadomości e-mail po zakończeniu zadania niezależnie od tego, czy zakończyło się ono powodzeniem. Ten parametr umożliwia ograniczenie wysyłania wiadomości e-mail do konkretnego statusu zadania po jego zakończeniu. Poprawne wartości
  • ERROR - wiadomość e-mail ma być wysyłana tylko po zakończeniu zadania ze statusem "Błąd".

  • SUCCESS - wiadomość e-mail ma być wysyłana tylko po pomyślnym zakończeniu zadania.

  • ALL - wiadomość e-mail ma być wysyłana zawsze po zakończeniu zadania. (Jest to wartość domyślna.)

Poniższe parametry mają zastosowanie tylko do zadań korzystających z metody alokacji pracy do wątków Wybór instrukcji SQL na podstawie wątku opisanej w sekcji Równoległe procesy w tle.
overrideLowIdValue Służy do określania nowej dolnej wartości ID do użycia podczas obliczania zakresu wątków. Framework domyślnie zakłada ID z zakresu od 0 (np. 000000000) do 9 (np. 9999999999), ale ten parametr pozwala zastąpić dolną wartość. Wartością parametru może być konkretna liczba lub wartość auto. Po ustawieniu wartości auto w parametrze ustawiana jest najniższa bieżąca wartość z tabeli bazy danych powiązana z procesem w tle.
overrideHighIdValue Służy do określania nowej górnej wartości ID do użycia podczas obliczania zakresu wątków. Framework domyślnie zakłada ID z zakresu od 0 (np. 000000000) do 9 (np. 9999999999), ale ten parametr pozwala zastąpić górną wartość. Wartością parametru może być konkretna liczba lub wartość auto. Po ustawieniu wartości auto w parametrze ustawiana jest najwyższa bieżąca wartość z tabeli bazy danych powiązana z procesem w tle.
idRangeOverrideClass Ten parametr służy do określania niestandardowej klasy w celu obliczenia zakresu wątków. Podczas wykonywania zadania zostanie uruchomiona ta zastąpiona klasa i zostaną wywołane metody ustawiania w celu zainicjowania ID zgodnie z wymaganiami. Metody pobierania dolnych i górnych wartości zostaną wywołane w celu pobrania dolnego i górnego ID do użycia w uruchomieniu. Określona nazwa klasy musi wdrażać interfejs com.splwg.base.api.batch.BatchIdRangeOverride.
Poniższe parametry mają zastosowanie tylko do zadań wykonujących pojedyncze potwierdzenie, na przykład zadań ekstrakcji.
numRecordsToFlush Ten parametr służy do definiowania częstotliwości opróżniania bufora hibernacji w celu zapobiegania wysokiemu zużyciu sterty i błędom braku pamięci.

Specyficzne parametry zadań

W niektórych procesach działających w tle zdefiniowane są dodatkowe parametry specyficzne dla funkcji tych procesów. Są one definiowane i dokumentowane w zapisie kontrolki zadania w aplikacji.