Log dla wsparcia

Zarządzanie ekranem

Ekran wprowadzania

Zadanie wsadowe

Tę funkcję można wykonać w trybie wsadowym,, ale brak dedykowanego zadania standardowego do jej wykonania.

Komunikaty o błędach

Jedynymi komunikatami o błędach są komunikaty ogólne.

Użyte tabele

Odniesienie do dokumentacji Implementacja

Informacje o logu

Log to plik w formacie XML (Extensible Markup Language).

Plik XML zawiera tag <LOGFILE VERSION=’n’>. Szczegóły loga znajdują się między indywidualnie zgrupowanymi tagami wewnątrz taga <LOGFILE VERSION='n'>. Indywidualne tagi podano poniżej:

• <INFOS>. Zawartość tego taga dostarcza informacje ogólne takie, jak data, kiedy log został wygenerowany.
• <CLIENT>. Zawartość tego taga dostarcza informacje dotyczące klienta (jeśli log został wygenerowany z klienta-serwera).
• <CONF_FILE NAME='FOLDERS.xml'>. Zawartość tego taga podsumowuje konfigurację folderów w pliku FOLDERS.xml.
• <CONF_FILE NAME='solution.xml'>. Zawartość tego taga podsumowuje konfigurację rozwiązania w pliku solution.xml.
• <DATABASE>. Zawartość tego taga dostarcza informacje o cechach bieżącej bazy danych.
• <WEBSERVERCONF>. Zawartość tego taga dostarcza informacje o serwerach sieciowych dostępnych z poziomu rozwiązania.
• <EDTSERVERCONF>. Zawartość tego taga dostarcza informacje o serwerach wydruku dostępnych z poziomu rozwiązania.
• <FOLDER CODE='FOLDER'>. Ten tag jest uwzględniany dla każdego folderu. Zawartość tego taga opisuje cechy folderu „FOLDER” (FOLDER = nazwa folderu). Wymienione są wszystkie istniejące foldery, ale cechy są dostarczane tylko dla: folderu uruchomienia (wszystkie informacje), folderu nadrzędnego bieżącego folderu, jeśli się różni (wybrane informacje) i katalogu głównego („X3”) rozwiązania (tylko wybrane informacje).

Następujące podsekcje opisują zawartość każdego taga.

Zawartość sekcji INFOS

Zawartość między tagami < INFOS> i </INFOS> jest następująca:

• <DATE>. Data i godzina uruchomienia funkcji.
• <FOLD>. Folder, z którego funkcja została uruchomiona.
• <USER>. Kod użytkownika, który uruchomił funkcję.
• <RUNTIME>. Wersja klienta i numer licencji zdefiniowany przez ver$(0).
• <SOFTWARE_VERSION>. Numer wersji aplikacji (np. 11.0.12).
• <PATCHLIST>. Ostatnia wykonana łatka.
• <PATCHDATE>. Data ostatniej wykonanej łatki.
• <INCIDENT_ID>. Numer incydentu podany w momencie uruchomienia funkcji. Z zasady numer incydentu jest dostarczany przez dział wsparcia.

Zawartość sekcji CLIENT

Zawartość między tagami < CLIENT> i </CLIENT> jest następująca:

• <X3VERSION>. Numer wersji aplikacji odpowiadający klientowi (np. 001.12.2019).
• <X3FILEVERSION>. Numer wersji technicznej (np. 15c.06).
• <X3CLTVERSION>. Dodatkowy numer wersji (używany wyłącznie dla klienta 107).

Zawartość sekcji FOLDERS.xml

Zawartość między tagami <CONF_FILE NAME='FOLDERS.xml'> i </CONF_FILE> odpowiada zawartości pliku FOLDERS.xml :

• Tag <INFOFOLDERS versolsup='version'>.
  Zawartość tego taga dostarcza informacje o rozwiązaniu:
• <ACTUAL>. Lista folderów (sekcja <FOLDER> na folder).
• <DEFLIC>. Definicja licencji (numer, data wygaśnięcia, teksty partnera/klienta, liczba sesji, opcje).

Zawartość sekcji solution.xml

Zawartość między tagami <CONF_FILE NAME='solution.xml'> i </CONF_FILE> odpowiada zawartości pliku solution.xml :

• Tag <solution name='name' mainport='port_number'> dostarcza informacje o składnikach technicznych rozwiązania ('name') definiuje port IP ('port_number'):
• <module name='name' family='APPLICATION' type='X3'>. Informacje o serwerze aplikacji.
• <module name='name' family='RUNTIME' type='MAIN'>. Informacje o środowisku wykonawczym.
• <module name='name' family='DOC' type='X3'>. Informacje o serwerze dokumentacji.
• <module name='name' family='WEB' type=''>. Informacje o serwerze sieciowym.
• <module name='BOXIRn' family='BUSOBJ' type=''>. Informacje o serwerze Business Objects, gdzie „n” to numer wersji Business Objects (np. „BOXIR3”).
• <module name='name' family='REPORT' type=''>. Informacje o serwerze wydruku.
• <module name='name' family='DATABASE' type='database'>. Informacje o serwerze bazy danych, gdzie „type” to baza danych (np. „ORACLE”).
• <module name='SAGE_SEARCH' family='EXALEAD' type='MASTER'>. Informacje o serwerze wyszukiwania.
• <module name='name' family='SERVERJAVA' type=''>. Informacje o serwerze Java.

Zawartość taga DATABASE

Zawartość między tagami <DATABASE TYPE='database_type'> i </DATABASE> jest następująca:

• <NAME>. Nazwa bazy danych.
• <VERSION>. Numer wersji.
• <VERSION_DESC>. Szczegółowy opis bazy danych i numeru wersji.

Zawartość sekcji WEBSERVERCONF

Tagi <WEBSERVERCONF> i WEBSERVERCONF zawierają jeden tag <WEBSERVER_ID name=’name’> na dostępny serwer sieciowy. Tagi, które opisują każdy serwer sieciowy pochodzą z pliku config.ini. Informacje są wskazywane w następujący sposób:

• Tagi <SERVER_NAME> i <SERVER_PATH> wskazują umiejscowienie plików konfiguracyjnych.
• Hierarchia pliku config.ini szczegółowo opisuje konfigurację sieciową:
  
  <ALL>
  <APACHE>
  <APACHEDOCS/>
  <APACHEPORT/>
  ...
  </APACHE>
  <CONTROL>
  <DOCONFIG/>
  <EMBEDEDSOFTS/>
  ...
  </CONTROL>
  <CONTROL>
  ...

Liczba sekcji i podsekcji ma znaczenie. Te informacje nie są tutaj wyszczególniane. Interpretacja wartości należy do obowiązków zespołu projektującego.

Jeśli z dowolnego powodu plik konfiguracyjny serwera konfiguracyjnego nie może zostać znaleziony, w miejscu szczegółów pliku konfiguracyjnego może wyświetlić się sekcja <STATUS>. Jeśli wartość tego taga nie jest dostępna oznacza to, że nie znaleziono pliku konfiguracyjnego.

Zawartość sekcji EDTSERVERCONF

Tagi <EDTSERVERCONF> i </EDTSERVERCONF> zawierają jeden tag <EDTSERVER_ID name='name'> na dostępny, opublikowany serwer wydruku. Tagi, które opisują każdy serwer wydruku pochodzą z pliku adxeditionserverconfig.ini, który jest umiejscowiony w katalogach serwera wydruku. Informacje są wskazywane w następujący sposób:

<AdxSrvImp>
<cap config='' id=''>
<general adxsolprf='' lang='' log='' port='' restartrpts='' />
<log number='' size="''" />
<jobs max='' purgetime='' vpalloc='' />
<processes killtime='' max='' min='' />
</config>
</AdxSrvImp>

Interpretacja wartości należy do obowiązków zespołu projektującego.

Jeśli z dowolnego powodu plik konfiguracyjny serwera wydruku nie może zostać znaleziony, w miejscu szczegółów pliku konfiguracyjnego może wyświetlić się sekcja <STATUS>.

• Jeśli wartość tego taga nie jest dostępna oznacza to, że nie znaleziono pliku konfiguracyjnego.
• Jeśli wartość tego taga nie jest dostępna oznacza to, że nie znaleziono serwera wydruku (brak odpowiedzi na żądanie połączenia).

Ten błąd może wystąpić, jeśli proces czyszczenia łączy się z portem administracyjnym 1818. Jest to port używany domyślnie do instalacji oprogramowania. Jeśli ten port nie jest używany należy ponownie go zdefiniować używają zmiennej globalnej typu „Integer” pod nazwą GADMINPORT. Umożliwia to otrzymanie odpowiedniej wartości.

Zawartość sekcji FOLDER

Zawartość tagów <FOLDER CODE='folder_code'> i </FOLDER> jest następująca:

Osobna sekcja na folder.

• <HEADER>. Informacje powiązane z cechami ogólnymi folderu „folder_code”. Nagłówek zawiera następujące tagi:
• <NAME>. Nazwa folderu.
• <REFFOLDER>. Nazwa folderu referencyjnego.
• <TESFOLDER>. Flaga dla folderów „testowych”.
• <SPEFOLDER>. Flaga dla „właściwych” folderów.
• <DATABASE>. Nazwa bazy danych.
• <LANGUAGE>. Lista języków zdefiniowanych w folderze.
• <DEFLANGUAGE>. Domyślny język.
• <MODULES>. Lista aktywnych modułów.
• <STARTDATE>. Data rozpoczęcia.
• <RPTCURRENCY>. Waluta raportowania.
• <DEFCOUNTRY>. Domyślny kod kraju.
• Informacje w pliku APL.ini. Te informacje są definiowane w tagu <APL_INI>, gdzie każda zmienna posiada swój własny tag, którego nazwa to nazwa zmiennej wielkimi literami. Podczas wymiarowania zmiennej nawiasy są zamieniane na podkreślnik („_”). Może on zawierać np. następujące tagi: <ADXMOTHER_0_0>, <ADXMOTHER_1_0>, <ADXMSO>, <ADXMTO>, <ADXMPR>, <ADXMUA>, <MAXMEM>, <SADMEM>, <ADXTCT>, <ADXTLK>, <ADXTMS>, <MAXHEAP>.

• <ACTIVITY_CODES>. Wartości kodów działań. Ta sekcja zawiera trzy podsekcje: <FUNCTIONAL>; <SIZING>; <LOCALIZATION>.
  W każdej podsekcji istnieją dodatkowe podsekcje na moduł nazwany MODULE NAME=’module_name’ zawierający następujące informacje:
• Sekcja <ACTIVITY_CODE CODE='activity_code'> z podsekcjami <ACTIVE> zdefiniowanymi jako „Tak” lub „Nie”.; <DIMENSION>; <DIM_MIN>; <DIM_MAX> dla kodów typu <SIZING> (wymiarowanie).

• <ENTRY_POINTS>. Punkty wejścia (dla każdego punktu wejścia) i podtag <STD_TRT NAME='standard_entry point_name'> zawierający sekcje <SPE_TRT> oraz <ACV_CODE>.

• <CPYLIST>. Lista firm (dla każdej firmy) i podtag <COMPANY CODE='company code'>, który zawiera następujące informacje:
• <NAME>.
• <LEGISLATION>.
• <SITLIST>. Lista powiązanych lokalizacji (dla każdej lokalizacji) i podtag <SITE NAME='code'>, który zawiera kod lokalizacji finansowej powiązanej z sekcją <FINANCIAL>.

• <PARAMVALUES>. Wartości parametrów. Grupy parametrów są określane przez tag <PARAMGRP NAME='group_code'> z podsekcją <PARAM NAME='parameter_code'> na parametr. Każda podsekcja zawiera tag <VALUES>, który zawiera następujące informacje:
• <FOLDERVALUE>. Wartość folderu. Jeśli nie wskazano żadnej wartości to tag zawiera <LEG NAME=’legislation_code’, który zawiera:
• <LEGVALUE>. Wartość wskazana na poziomie legislacji, jeśli dotyczy (opcjonalne). Dotyczy to wartości parametrów zdefiniowanych przez wyjątek na niższych poziomach (firmy powiązane z legislacją, lokalizacje, które podlegają tym firmom).
• <CPY name='company_code'>. Definiuje, czy wartość parametru istnieje na poziomie firmy lub przynajmniej lokalizacje powiązane z firmą. Ten tag zawiera więc następujące podsekcje:
• <CPYVALUE>. Wartość powiązana z firmą, jeśli dotyczy.
• <FCY NAME='site_code'>, który zawiera tag <FCYVALUE>, jeśli parametr jest definiowany na poziomie lokalizacji.

• <USER_VALUES>. Wartości parametrów powiązane z użytkownikami, jeśli dotyczy. Wartości są zawarte w podtagu <USER CODE='user_code'>, który zawiera następujące wartości:
• <LOCALPRG>. Lista procesów, które nie odpowiadają żadnemu konkretnemu typowi, których plik wykonawczy jest umieszczony w folderze referencyjnym (a nie w folderze testowym lub projektowania).
• <SPEPRG>. Lista skryptów, które odpowiadają konkretnemu typowi skryptu.
  
• <PATCHES>. Lista łatek zainstalowanych w folderze, wg typu. Każdy typ stanowi grupę <TYPE CODE='code_type'>, która zawiera podtag <CURRENT_STATUS>, który zawiera jedną grupę na wersję. Każda grupa zawiera następujące informacje:
• <VERSION ID='version_number'>. Numer wersji. Ta sekcja zawiera następujące informacje:
• <FIRST NUM='number'>. Pierwszy numer zrealizowanej łatki (zawierający informacje <COMMENT>, <FILE>, <PATCHNUM>).
• <LAST NUM='number'>. Ostatni numer zrealizowanej łatki (zawierający informacje <COMMENT>, <FILE>, <PATCHNUM>).
• <MISSING NUM='number'>. Liczba brakujących łatek lub liczba całkowita w formacie first_number – last_number. Ten tag jest obecny tylko, jeśli w numeracji występują brakujące elementy.
• <INSTALL_HISTORY>. Dla każdego typu łatki (tag <TYPE CODE='code'>) i dla każdej wersji głównej (tag <VERSION ID='xxx'>), dostarczana jest lista tagów <PATCHLIST num='number' date='date of installation'>, która zawiera tagi:
• <USER>. Kod użytkownika, który zainstalował listę.
• <COMMENT>. Komentarz powiązany z pierwszą łatką na liście.
• <FILE>. Nazwa odpowiadającego pliku.
• <MAINTENANCE>. Numer łatki.
  Uwaga: Ta sama lista łatek jest powtarzana kilkukrotnie w historii, jeśli została ona wykonana wielokrotnie (listy można rozróżnić sprawdzając pierwszy numer łatki).
• <DATABASE TYPE='database_type'>. Typ bazy danych. Ten tag zawiera wiele sekcji:
• <STATS>. Jest to pierwsza sekcja. Dla każdej tabeli zawiera ona podsekcję <TABLE NAME=’table_name’>, która zawiera:
• <LAST_ANALYSIS>. Data ostatniego wykonanego czyszczenia indeksów.
• <NB_ROWS>. Liczba pozycji w tabeli.
• <INDEXES_VERIFICATION>. Jest to druga sekcja. Stanowi ona oddzielną funkcję. W ten sposób wyniki analizy indeksów są obecne w indywidualnych podsekcjach:
• <INDEXES_MISSING>. Brakujące indeksy (i dla każdego brakującego indeksu, sekcja <INDEX TABLE='table'>, która zawiera pola <NAME> oraz <INDEX>).
• <INDEXES_MISSING_ON_INACTIVE_TABLES>. Zawiera brakujące indeksy w nieaktywnych tabelach (z tymi samymi informacjami).
• <OPTIMIZATION_INDEX_MISSING>. Zawiera aktywne indeksy optymalizacji, ale których brakuje w tabelach (z tymi samymi informacjami).
• <OPTIMIZATION_INDEX_INACTIVE_ON_TABLES>. Zawiera indeksy optymalizacji w nieaktywnych tabelach (z tymi samymi informacjami).
• <INTERNAL_INDEXES>. Lista znalezionych indeksów wewnętrznych.
• <INDEXES_NOT_DESCRIBED_IN_DICTIONARY>. Dostarcza listę indeksów, które istnieją w bazie, ale nie zostały opisane w słowniku.
• <INDEX_NOT_CONFORMANT>. Lista niezgodnych indeksów.

Komentarze

Informacje zawarte w sekcjach ograniczonych tagiem <FOLDER CODE='folder_code'> nie istnieją we wszystkich folderach:

• Sekcja <HEADER> jest zawsze obecna.
• Sekcja <ACTIVITY_CODE> jest zawsze obecna.
• Sekcja <ENTRY_POINTS> jest zawsze obecna..
• Sekcja <CPYLIST> jest zawsze obecna.
• Sekcja <PARAMVALUES> jest obecna tylko dla folderów folderu Administratora („X3” dla aplikacji).
• Sekcja <LOCALPRG> jest obecna tylko dla folderów folderu Administratora („X3” dla aplikacji).
• Sekcja <DATABASE> jest obecna tylko dla folderu, z poziomu którego narzędzie zostało uruchomione. Ważne jest więc prawidłowe wybrane folderu, z poziomu którego narzędzie ma zostać uruchomione.

Zawartość sekcji DATABASE