Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

kc_max_par_str - Maximalwerte der Anwendung (MAX-Parameter)

Für den Parametertyp KC_MAX_PAR ist die Datenstruktur kc_max_par_str definiert. In kc_max_par_str liefert UTM bei KC_GET_OBJECT folgende Informationen zurück:

  • Basiseigenschaften der Anwendung, z.B. den Anwendungsnamen, Funktionsvariante, Name der KDCFILE.

  • die Maximalwerte der Anwendung, z.B. Größe des Pagepools, des Wiederanlaufbereichs und der KDCS-Speicherbereiche, maximale Anzahl der Benutzer, maximale Anzahl der Lock- und Keycodes der Anwendung, maximale Zeitspanne für zeitgesteuerte Asynchron-Aufträge, maximale Anzahl der für die Anwendung einsetzbaren Prozesse.

  • Nur auf Unix-, Linux- und Windows-Systemen: Betriebsmittel des Systems, die von der Anwendung belegt werden, z.B. Schlüssel für Shared Memory Segmente und Semaphore.

mod 1     

Datenstruktur kc_max_par_str

siehe 2

-

char adf_name[16]; 3


-

char applimode;

applimode

-

char appliname[8];

appliname

-

char asyntasks[3];

asyntasks

-

char blksize[2];

blksize

x(GIR)

char bretrynr[5];

bretrynr

-

char cacheshmkey[10]; (nur auf Unix-, Linux- und Windows-Systemen)

cacheshmkey

-

char cachesize_pages[10];

cachesize_pages

x(GIR)

char cachesize_paging[3];

cachesize_paging

-

char cachesize_res; (nur auf BS2000-Systemen)

cachesize_res

-

char cardlth[3]; (nur auf BS2000-Systemen)

cardlth

-

char catid_a[4]; (nur auf BS2000-Systemen)

catid_a

-

char catid_b[4]; (nur auf BS2000-Systemen)

catid_b

-

union kc_clear_char clrch;

clrch

-

char clrch_type;

clrch_type

x(IR)

char conn_users[10];

conn_users

x(GPD)

char destadm[8];

destadm

-

char dputlimit1_day[3];

dputlimit1_day

-

char dputlimit1_hour[2];

dputlimit1_hour

-

char dputlimit1_min[2];

dputlimit1_min

-

char dputlimit1_sec[2];

dputlimit1_sec

-

char dputlimit2_day[3];

dputlimit2_day

-

char dputlimit2_hour[2];

dputlimit2_hour

-

char dputlimit2_min[2];

dputlimit2_min

-

char dputlimit2_sec[2];

-

char gssbs[10];

gssbs

-

char hostname[8];

hostname

-

char ipcshmkey[10]; (nur auf Unix-, Linux- und Windows-Systemen)

ipcshmkey

-

char ipctrace[10]; (nur auf Unix-, Linux- und Windows-Systemen)

ipctrace

-

char kaashmkey[10]; (nur auf Unix-, Linux- und Windows-Systemen)

kaashmkey

-

char kb[10];

kb

-

char kdcfile_name[42];

kdcfile_name

-

char kdcfile_operation;

kdcfile_operation

-

char keyvalue[4];

keyvalue

-

char locale_lang_id[2]; (nur auf BS2000-Systemen)

locale_lang_id

-

char locale_terr_id[2]; (nur auf BS2000-Systemen)

locale_terr_id

-

char locale_ccsname[8]; (nur auf BS2000-Systemen)

locale_ccsname

-

char lputbuf[4];

lputbuf

-

char lputlth[10];

lputlth

-

char lssbs[4];

lssbs

-

char mp_wait_sec[5]

mp_wait_sec

-

char nb[10];

nb

-

char net_access; (nur auf Unix-, Linux- und Windows-Systemen)

net_access

-

char nrconv[2];

nrconv

-

char osi_scratch_area[5];

osi_scratch_area

-

char osishmkey[10]; (nur auf Unix-, Linux- und Windows-Systemen)

osishmkey

-

char pgpool_pages[10];

pgpool_pages

-

char pgpool_warnlevel1[2];

pgpool_warnlevel1

-

char pgpool_warnlevel2[3];

pgpool_warnlevel2

-

char pgpoolfs[5];

pgpoolfs

-

char pisizelth[5]; (nur auf Unix- und Linux-Systemen)

-

char recbuf_pages[10];

-

char recbuf_lth[10];

recbuf_lth

-

char recbuffs[3];

recbuffs

-

char reqnr[3]; (nur auf BS2000-Systemen)

reqnr

-

char seclev; 4


-

char sat; (nur auf BS2000-Systemen)

kc_max_par_str - Maximalwerte der Anwendung (MAX-Parameter) (utm70_adm_de, #185)

-

char semarray_startkey[10]; (nur auf Unix-, Linux- und Windows-Systemen)

semarray_startkey

-

char semarray_number[4]; (nur auf Unix-, Linux- und Windows-Systemen)

semarray_number

-

char semkey[10][10]; (nur auf Unix-, Linux- und Windows-Systemen)

semkey

-

char signon_value[3];

signon_value

-

char signon_restr;

signon_restr

x (GIR)

char signon_fail[3];

signon_fail

x (GIR)

char sm2;

sm2

-

char spab[10];

spab

-

char syslog_size[10];

syslog_size

-

char tasks[3];

tasks

-

char tasks_in_pgwt[3];

tasks_in_pgwt

-

char tracerec[5];

tracerec

-

char trmsglth[10];

trmsglth

-

char uslog;

uslog

-

char vgmsize[3]; (nur auf BS2000-Systemen)

vgmsize

-

char xaptpshmkey[10]; (nur auf Unix-, Linux- und Windows-Systemen)

xaptpshmkey

-

char mpgpool_pages[10]; 4


-

char mpgpool_res; 4

-

char rtimer; 4


-

char spin_lock_asyn[10]; 4


-

char spin_lock_cache[10]; 4


-

char spin_lock_kaa[10]; 4


-

char spin_lock_ipc[10]; 4


-

char spin_lock_pcmm[10]; 4


-

char xopen_cpic_dspl[5]; 4


-

char xopen_cpic_lth[5]; 4


-

char xopen_xatmi_dspl[5]; 4


-

char xopen_xatmi_lth[5]; 4


-

char xopen_tx_dspl[5]; 4


-

char xopen_tx_lth[5]; 4


-

char max_statistics_msg;

max_statistics_msg

-

char max_open_asyn_conv[10];

max_open_asyn_conv

-

char dead_letter_q_alarm[10];

dead_letter_q_alarm

-

char max_suspended_ta[3]; 4


-

char atac_redelivery[3];

atac_redelivery

-

char dget_redelivery[3];

dget_redelivery

-

char principal_lth[3]; (nur auf BS2000-Systemen)

principal_lth

-

char privileged_lterm[8];

privileged_lterm

-

char cache_location;

cache_location

-

char data_compression;

data_compression

-

char hostname_long[64];

hostname_long

-

char move_bundle_msgs;

move_bundle_msgs

1

Feldinhalt mit KC_MODIFY_OBJECT modifizierbar; siehe Abschnitt  "obj_type = KC_MAX_PAR"

2

Die Bedeutung der Felder ist an der in dieser Spalte angegebenen Stelle beschrieben.

3

Entfallene Funktion aus einer früheren UTM-Version; das Feld wird von UTM mit Leerzeichen belegt.

4

UTM-internes Feld zur Unterstützung der Diagnose bestimmter Fehlersituationen; der Feldinhalt ist für einen Anwender irrelevant und wird deswegen im Folgenden nicht beschrieben.

Die Felder der Datenstruktur haben die folgende Bedeutung:

applimode


gibt an, ob es sich bei der UTM-Anwendung um eine UTM-S- oder UTM-F-Anwendung handelt.


'S'

Die Anwendung ist als UTM-S-Anwendung generiert (Secure).


'F'

Die Anwendung ist als UTM-F-Anwendung generiert (Fast).

appliname


Name der UTM-Anwendung. Dieser Name wird bei der statischen Generierung mit dem Generierungstool KDCDEF in MAX APPLINAME definiert.
appliname ist der Name der Anwendung, der von Terminals beim Verbindungsaufbau angegeben werden muss.

asyntasks


enthält die maximale Anzahl der Prozesse der Anwendung, die die Bearbeitung von Aufträgen an Asynchron-Transaktionscodes übernehmen dürfen. asyntasks ist der Grenzwert für die aktuelle Anzahl der Prozesse zur Bearbeitung von Asynchron-Aufträgen, die beim Start der Anwendung oder durch die Administration dynamisch eingestellt werden kann.

blksize


gibt die Größe einer UTM-Seite an. Die Größe wird bei der KDCDEF-Generierung festgelegt und beträgt 2K, 4K oder 8K. Mögliche Werte:

'2': die Größe einer UTM-Seite beträgt 2K.

'4': die Größe einer UTM-Seite beträgt 4K.

'8': die Größe einer UTM-Seite beträgt 8K.

bretrynr


Nur auf BS2000-Systemen: gibt an, wie oft UTM versuchen soll, eine Nachricht an das Transportsystem (BCAM) zu übergeben, wenn BCAM die Nachricht nicht sofort übernehmen kann. Wird diese Anzahl in bretrynr überschritten, dann wird die Verbindung zum Dialog-Partner abgebaut. Der Wert von bretrynr hat Einfluss auf die Performance Ihrer UTM-Anwendung.

Bei der Ausgabe von Asynchron-Nachrichten an einen Dialog-Partner mit 
ptype='APPLI' (TS-Anwendung, die keine Socket-Anwendungen sind) hat bretrynr keine Bedeutung. Wird eine solche Nachricht vom Transportsystem wegen einer temporären Engpass-Situation abgewiesen, dann gibt UTM den Prozess zunächst frei, baut die Verbindung aber nicht ab. Nach einer Wartezeit von 3 Sekunden versucht UTM erneut bis zu dreimal, die Nachricht an BCAM zu übergeben. Gelingt die Übergabe auch dann nicht, wird wiederum 3 Sekunden gewartet, bevor die nächsten 3 Versuche unternommen werden etc.

Minimalwert: '1' 
Maximalwert: '32767' (theoretischer Wert)

cacheshmkey


Nur auf Unix-, Linux- und Windows-Systemen: enthält den Schlüssel für das Shared Memory Segment, in dem die Anwendungs-globalen Puffer für die Dateizugriffe liegen. cacheshmkey ist auf Unix- und Linux-Systemen ein globaler Parameter. cacheshmkey ist eine Dezimalzahl.

cachesize_pages


gibt die Größe des Cache-Speichers in Anzahl UTM-Seiten an. Die Größe einer UTM-Seite wird im Feld blksize zurückgeliefert. Über den Cache-Speicher werden alle Zugriffe auf den Pagepool abgewickelt, d.h. alle Ein- und Ausgaben von LSSBs, GSSBs, TLS, LPUT- und FPUT-Nachrichten, MPUT-Nachrichten, sowie einige UTM-Verwaltungsdaten. Das Schreiben auf KDCFILE erfolgt erst dann, wenn im Cache-Speicher kein Platz mehr ist oder wenn die Transaktion beendet wird.

cachesize_paging


gibt an, wieviel Prozent des Cache-Speichers bei Engpass-Situationen auf einmal auf die KDCFILE geschrieben werden, damit der Speicherplatz im Cache für andere Daten verwendet werden kann. Der Wert von cachesize_paging beeinflusst die Performance Ihrer UTM-Anwendung.

UTM lagert bei einem Paging mindestens 8 UTM-Seiten aus, auch wenn der Wert von cachesize_paging weniger UTM-Seiten entspricht.

Minimalwert: '0', d.h. es werden 8 UTM-Seiten ausgelagert
Maximalwert: '100' (%)

cachesize_res


Nur auf BS2000-Systemen: gibt an, ob der Cache-Speicher resident angelegt ist oder nicht. Der Feldinhalt ist wie folgt zu interpretieren:


'R'

Der Cache-Speicher ist resident angelegt.


'N'

Der Cache-Speicher ist pageable, d.h. nicht resident angelegt.

cardlth


Länge der Ausweisinformation in Byte, die UTM abspeichert, wenn ein Ausweisleser ergänzend zur Berechtigungsprüfung beim Anmelden (KDCSIGN) verwendet wird. Die Ausweisinformation kann in einem Teilprogramm mit dem KDCS-Aufruf INFO gelesen werden.

catid_a


Nur auf BS2000-Systemen: enthält die Katalogkennung (CAT-ID), die Ihrer KDCFILE mit dem Suffix A auf dem BS2000-System zugeordnet ist.

catid_b


Nur auf BS2000-Systemen: ist nur relevant, wenn Sie die KDCFILE doppelt führen .
catid_b enthält dann die Katalogkennung, die Ihrer KDCFILE mit dem Suffix B zugeordnet ist. Wird die KDCFILE nur einfach geführt, dann ist catid_b = catid_a.

clrch


(clear character)
enthält das Zeichen, mit dem der Kommunikationsbereich (KB) und der Standard Primäre Arbeitsbereich (SPAB) der Teilprogramme am Ende eines Dialog-Schritts überschrieben werden.

Wurde bei der Generierung kein Zeichen definiert, dann ist clrch mit Leerzeichen belegt und clrch_type='N'. Die Speicherbereiche werden dann am Ende des Dialog-Schritts nicht überschrieben.

Wurde bei der KDCDEF-Generierung ein Zeichen definiert, dann enthält clrch dieses Zeichen. Ist das Zeichen hexadezimal, dann wird jedes Halb-Byte als ein Zeichen dargestellt.

clrch wird in Form folgender Union zurückgeliefert:

union kc_clear_char

char x[2];

char c;


Das Feld x ist belegt, wenn clrch als Hexadezimalzeichen zurückgeliefert wird.Das Feld c ist belegt, wenn clrch als alphanumerisches Zeichen zurückgeliefert wird.

Dem Feld clrch_type können Sie entnehmen, wie der Inhalt von clrch zu interpretieren ist.

clrch_type


gibt an, wie der Inhalt des Feldes clrch zu interpretieren ist. Es bedeutet:


'X'

In clrch steht ein hexadezimales Zeichen.


'C'

In clrch steht ein abdruckbares, alphanumerisches Zeichen.


'N'

Es wurde kein clrch -Zeichen definiert.

conn_users


maximale Anzahl der Benutzer, die gleichzeitig bei der UTM-Anwendung angemeldet sein dürfen. Unter Benutzer versteht man die Anzahl der Benutzerkennungen, die gleichzeitig angemeldet sein dürfen. Ist die Anwendung ohne Benutzerkennungen generiert, dann ist durch conn_users die Anzahl der Clients beschränkt, die sich über LTERM-Partner an die Anwendung anschließen.

Benutzerkennungen, die mit Administrationsberechtigung generiert wurden, können sich auch dann noch an die UTM-Anwendung anmelden, wenn die maximale Anzahl der gleichzeitig arbeitenden Benutzerkennungen bereits erreicht wurde.

conn_users='0' bedeutet, dass die Anzahl der gleichzeitig aktiven Benutzer nicht beschränkt ist.

Minimalwert: '0' 
Maximalwert: '500000' 
Auf Unix-, Linux- und Windows-Systemen darf beim Modifizieren kein größerer Wert angegeben werden als der Wert, der in der Generierung festgelegt wurde (MAX CONN-USERS).

destadm


enthält den Empfänger, an den UTM die Ergebnisse von KDCADM-Administrationsaufrufen sendet, die asynchron verarbeitet wurden (Asynchron-Transaktionscodes von KDCADM). Der Empfänger kann ein LTERM-Partner oder ein Asynchron-TAC oder eine TAC-Queue sein.

Enthält destadm Leerzeichen, dann ist kein Empfänger definiert. Die Ergebnisse der Asynchron-Transaktionscodes von KDCADM gehen verloren. In diesem Fall sollten Sie z.B. mit KC_MODIFY_OBJECT einen Empfänger definieren.

dputlimit1_day 
dputlimit1_hour
dputlimit1_min
dputlimit1_sec


bestimmen die obere Grenze des Zeitintervalls, in dem ein zeitgesteuerter Auftrag ausgeführt werden muss. Zeitgesteuerte Aufträge werden mit dem KDCS-Aufruf DPUT erzeugt. Ein Teilprogrammaufruf und damit auch ein DPUT-Aufruf mit absoluter Zeitangabe kann sich so weit verzögern, dass der gewünschte Ausführungszeitpunkt des DPUTs bereits überschritten wurde. Dieser Zeitpunkt, an dem ein zeitgesteuerter Auftrag ausgeführt werden soll (angegeben beim DPUT-Aufruf), darf maximal um die in dputlimit1 angegebene Zeitspanne nach dem Zeitpunkt des DPUT-Aufrufs liegen. dputlimit1 wird wie folgt angegeben:

Anzahl Tage (dputlimit1_day) + Anzahl Stunden (dputlimit1_hour) + Anzahl Minuten (dputlimit1_min) + Anzahl Sekunden (dputlimit1_sec). Es gilt also:

Ausführungszeitpunkt < DPUT-Aufrufzeitpunkt + dputlimit1

dputlimit2_day
dputlimit2_hour
dputlimit2_min
dputlimit2_sec


bestimmen die untere Grenze des Zeitintervalls, in dem ein zeitgesteuerter Auftrag (DPUT-Aufruf) ausgeführt werden muss. Der Zeitpunkt, an dem ein zeitgesteuerter Auftrag ausgeführt werden soll (angegeben beim DPUT-Aufruf), darf maximal um die in dputlimit2 angegebene Zeitspanne vor dem Zeitpunkt des DPUT-Aufrufs liegen. dputlimit2 wird wie folgt angegeben:

Anzahl Tage (dputlimit2_day) + Anzahl Stunden (dputlimit2_hour) + Anzahl Minuten (dputlimit2_min) + Anzahl Sekunden (dputlimit2_sec).

Es gilt also:
Ausführungszeitpunkt > DPUT-Aufrufzeitpunkt - dputlimit2

Liegt der angegebene Ausführungszeitpunkt zwischen der in dputlimit2 festgelegten Grenze und dem Aufrufzeitpunkt, so wird der DPUT sofort in einen FPUT umgewandelt.

gssbs


Maximale Anzahl von GSSBs (globale Sekundärspeicherbereiche), die gleichzeitig in der Anwendung existieren können.

hostname


BS2000-Systeme: 
hostname enthält den Namen des virtuellen Hosts, auf dem (aus Sicht von BCAM) die Anwendung läuft.

Unix-, Linux- und Windows-Systeme: 
hostname enthält den Namen des Hosts, der als Absenderadresse angegeben wird, wenn eine Verbindung von der UTM-Anwendung aus aufgebaut wird.
Ist dieser Name länger als 8 Zeichen, dann kann der vollständige, bis zu 64 Zeichen lange Name dem Feld hostname_long entnommen werden. Das Feld hostname enthält in diesem Fall die ersten 8 Zeichen des langen Namens.

ipcshmkey


Nur auf Unix-, Linux- und Windows-Systemen: enthält den Schlüssel für das Shared Memory Segment, das zur Interprozess-Kommunikation zwischen den Workprozessen einerseits und externen Prozessen der Anwendung andererseits dient. ipcshmkey ist auf Unix-, Linux- und Windows-Systemen ein globaler Parameter. ipcshmkey ist eine Dezimalzahl.

ipctrace


Nur auf Unix-, Linux- und Windows-Systemen: enthält die Anzahl der Einträge im Trace-Bereich des IPC.

UTM schreibt Einträge in den Trace-Bereich des IPC (Shared Memory Segment für die Interprozess-Kommunikation), wenn die UTM-Anwendung im Testmodus läuft (TESTMODE=ON). Diese Einträge enthalten interne Informationen für Diagnosezwecke. Wird die in ipctrace enthaltene Zahl an Einträgen überschritten, dann überschreibt UTM bereits vorhandene Einträge vom ältesten an.

kaashmkey


Nur auf Unix-, Linux- und Windows-Systemen: enthält den Schlüssel für das Shared Memory Segment, in dem die Anwendungs-globalen Daten abgelegt werden.
kaashmkey ist auf Unix-, Linux- und Windows-Systemen ein globaler Parameter.
kaashmkey ist eine Dezimalzahl.

kb


enthält die Länge des Kommunikationsbereiches (KB) in Byte. KB-Kopf und KB-Rückgabebereich sind bei der Längenangabe nicht berücksichtigt.

kdcfile_name


Basisname von KDCFILE, Benutzer-Protokolldatei USLOG und System-Protokolldatei SYSLOG (siehe auch openUTM-Handbuch „Anwendungen generieren“). kdcfile_name muss auch beim Start der Anwendung im Startparameter FILEBASE angegeben werden.

kdcfile_operation


gibt an, ob die KDCFILE doppelt oder einfach geführt wird. Der Inhalt von kdcfile_operation ist wie folgt zu interpretieren:


'D'

Die KDCFILE wird doppelt geführt. Wurde die KDCFILE aufgespaltet, dann werden alle KDCFILE-Dateien doppelt geführt (siehe auch openUTM- Handbuch „Anwendungen generieren“, KDCFILE).


'S'

Die KDCFILE wird einfach geführt. Wurde die KDCFILE aufgespaltet, dann werden alle KDCFILE-Dateien einfach geführt.

keyvalue


enthält die Nummer des größten Keycodes in der Anwendung und damit auch die Nummer des größten Lockcodes, der für einen Transaktionscode oder einen LTERM-Partner als Zugriffschutz vergeben werden kann.

keyvalue gibt auch die maximale Anzahl der Keycodes pro Keyset an.

locale_lang_id
locale_terr_id
locale_ccsname


Nur auf BS2000-Systemen: Diese Felder enthalten die drei Komponenten des Locale, das der UTM-Anwendung zugeordnet ist. Das Locale definiert die Standard-Sprachumgebung der Anwendung. Die Standard-Sprachumgebung wird jeder Benutzerkennung (KC_USER), jedem LTERM-Partner und jedem LTERM-Pool der Anwendung als Standardeinstellung für die Sprachumgebung zugeordnet. Die Standardeinstellung ist wirksam, solange für diese Objekte kein eigenes Locale definiert wird (siehe auch openUTM-Handbuch „Anwendungen generieren“).

locale_lang_id
enthält ein bis zu 2 Zeichen langes Sprachkennzeichen.

locale_terr_id 
enthält ein bis zu 2 Zeichen langes Territorialkennzeichen.

locale_ccsname 
(coded character set name)
enthält den bis zu 8 Zeichen langen Namen eines erweiterten Zeichensatzes (CCS-Name; siehe auch Benutzerhandbuch zu XHCS).

lputbuf


enthält die Größe des Puffers, in dem UTM die mit dem KDCS-Aufruf LPUT erzeugten Sätze zwischenspeichert, bevor sie in die Benutzer-Protokolldatei (USLOG) geschrieben werden. Der Puffer liegt im Pagepool.

Die von den Teilprogrammen erzeugten LPUT-Sätze werden solange in diesem Puffer zwischengespeichert, bis dieser voll ist. Erst dann kopiert UTM die Sätze in die Benutzer-Protokolldatei. Die Benutzer-Protokolldatei (USLOG) ist nur während dieses Kopier-Vorgangs geöffnet.

lputlth


enthält die maximale Länge der Benutzerdaten in einem LPUT-Satz.
Die Länge eines LPUT-Satzes ergibt sich aus:
lputlth + 84 Byte für den KB-Kopf + 12 Byte für Längenfelder.

lssbs


enthält die maximale Anzahl von LSSBs (Lokale Sekundäre Speicherbereiche), die innerhalb eines Vorgangs erzeugt werden können.

mp_wait_sec


(memory pool wait ) gibt an, wieviele Sekunden ein UTM-Anwendungsprogramm maximal auf den Anschluss eines Prozesses an einen Common Memory Pool wartet.

nb


(Nachrichtenbereich)
enthält die maximale Länge des Nachrichtenbereichs für KDCS-Teilprogramme.

net_access


Nur auf Unix-, Linux- und Windows-Systemen: Dieser Parameter wird nicht mehr unterstützt.

nrconv


(number of conversations) Maximalzahl der Vorgänge, die ein Benutzer gleichzeitig kellern darf. Der Wert '0' bedeutet, dass kein Vorgang gekellert werden kann.

osi_scratch_area


Größe eines UTM-internen Arbeitsbereichs, den UTM zur dynamischen Ablage von Daten benötigt, wenn mit dem OSI TP-Protokoll gearbeitet wird. Die Angabe erfolgt in KB.

In UTM-Anwendungen auf BS2000-Systemen wird dieser Arbeitsbereich während des Anwendungslaufs bei Bedarf automatisch vergrößert.

In UTM-Anwendungen auf Unix-, Linux- und Windows-Systemen ist die Größe des internen Arbeitsbereichs während des gesamten Anwendungslaufs fest. Wenn sich im Betrieb der interne Arbeitsbereich als nicht ausreichend erweist, muss die KDCDEF-Generierung mit einem höheren Wert wiederholt werden.

osishmkey


Nur auf Unix-, Linux- und Windows-Systemen: enthält den Schlüssel für das Shared Memory Segment, das bei der Kommunikation über OSI TP von OSS verwendet wird. osishmkey ist auf Unix-, Linux- und Windows-Systemen ein globaler Parameter. osishmkey ist eine Dezimalzahl.

pgpool_pages


gibt die Größe des Pagepools in Anzahl UTM-Seiten an. Die Größe einer UTM-Seite wird im Feld blksize ausgegeben.

pgpool_warnlevel1
pgpool_warnlevel2


enthalten die Warnstufen, bei denen UTM vor dem Überlauf des Pagepools warnt.

pgpool_warnlevel1 
gibt an, bei welcher Belegung des Pagepool UTM die erste Warnung (Meldung K041) ausgibt. pgpool_warnlevel1 ist eine Dezimalzahl und als Prozentangabe zu interpretieren.

pgpool_warnlevel2 
gibt an, bei welcher Belegung des Pagepool UTM die zweite Warnung ausgibt. Nach Überschreiten der Warnstufe 2 werden Asynchron-Aufträge abgewiesen. In diesem Fall erhält der Benutzer die Meldung K041, einem Teilprogramm wird ein entsprechender Returncode übermittelt. pgpool_warnlevel2 ist eine Dezimalzahl und als Prozentangabe zu interpretieren.

pgpoolfs


enthält die Anzahl der Dateien, auf die der Pagepool aufgeteilt ist. Ist pgpoolfs='0', dann liegt der Pagepool in der Hauptdatei der KDCFILE, d.h. der Pagepool wurde nicht ausgelagert.

Bei doppelter Führung der KDCFILE besteht der Pagepool der zweiten KDCFILE ebenfalls aus pgpoolfs Dateien.

pisizelth


Nur auf Unix- und Linux-Systemen: Dieser Parameter wird nicht mehr unterstützt.

recbuf_pages


enthält die Größe des Wiederanlaufbereichs pro Prozess. Die Größe wird in Anzahl UTM-Seiten angegeben. Die Größe einer UTM-Seite wird im Feld blksize ausgegeben.

In den Wiederanlaufbereich werden die Daten geschrieben, die für den Wiederanlauf nach einem Systemfehler benötigt werden. recbuf_pages beeinflusst die Performance der Anwendung: Ist dieser Bereich groß, wird die laufende Anwendung weniger belastet; der Wiederanlauf nach Systemfehlern dauert jedoch länger. Ist der Bereich klein, wird die laufende Anwendung stärker belastet; der Wiederanlauf ist jedoch schneller.

recbuf_lth


enthält die Größe des Puffers in Byte, der pro Prozess der Anwendung zur Zwischenspeicherung von Wiederanlauf-Daten zur Verfügung steht. Die Daten werden für den Wiederanlauf nach Transaktions- oder Systemfehlern benötigt.

recbuffs


gibt an, auf wieviele Dateien der Wiederanlaufbereich aufgeteilt ist.

Ist recbuffs='0' liegt der Wiederanlaufbereich in der Hauptdatei der KDCFILE, d.h. der Wiederanlaufbereich wurde nicht ausgelagert.

Bei doppelter Führung der KDCFILE besteht der Wiederanlaufbereich der zweiten KDCFILE ebenfalls aus recbuffs Dateien.

reqnr


Nur auf BS2000-Systemen: enthält die maximale Anzahl der PAM-Schreib-/Leseaufträge, die in einem UTM-Prozess gleichzeitig für eine Datei abgesetzt werden können. reqnr enthält den bei der KDCDEF-Generierung festgelegten Wert, solange dieser kleiner ist als der Wert von cachesize_pages. Ist der generierte Wert größer, wird für reqnr der Wert von cachesize_pages ausgegeben.

sat


(security audit trail, nur auf BS2000-Systemen)
gibt an, ob die SAT-Protokollierung für die Anwendung eingeschaltet ist.

Die SAT-Protokollierung kann mit dem Transaktionscode KDCMSAT ein- und ausgeschaltet werden (siehe openUTM-Handbuch „Einsatz von UTM-Anwendungen auf BS2000-Systemen“, UTM-SAT-Administration).


'Y'

Die SAT-Protokollierung ist eingeschaltet (ON).


'N'

Die SAT-Protokollierung ist nicht eingeschaltet (OFF).
Es wird nur jeder Zugriff auf den Transaktionscode KDCMSAT (außer KDCMSAT HELP) protokolliert. Alle anderen Ereignisse werden nicht protokolliert.

semarray_startkey
semarray_number


Nur auf Unix-, Linux- und Windows-Systemen: Diese Felder geben den Bereich der Schlüssel (Keys) für die Anwendungs-globalen Semaphore an. Semaphore dienen der Prozesssynchronisation. Die Schlüssel sind auf Unix-, Linux- und Windows-Systemen globale Parameter.

semarray_startkey 
enthält die Nummer des ersten Semaphoren-Schlüssels.

semarray_number 
enthält die Anzahl der Schlüssel, die für die Anwendung belegt sind.

UTM belegt diese Schlüssel, indem vom ersten Schlüssel semarray_startkey ausgehend jeweils 1 addiert wird.

Wurde bei der KDCDEF-Generierung kein Bereich von Schlüsseln definiert, dann liefert UTM in semarray_startkey und semarray_number den Wert '0' zurück. In diesem Fall liefert UTM die Semaphore-Schlüssel im Feld semkey zurück.

semkey


(semaphore  key,  nur auf Unix-, Linux- und Windows-Systemen): Liefert UTM in den Feldern  semarray_startkey  und  semarray_number  Werte ungleich '0' zurück, dann ist  semkey  mit '0' belegt. Sind die Felder  semarray_startkey  und  semarray_number  mit '0' belegt, dann enthält  semkey  die Schlüssel der Anwendung für die Anwendungsglobalen Semaphore (Prozesssynchronisation). Die Schlüssel sind im System globale Parameter. Die Schlüssel werden als Dezimalzahlen angegeben. Es werden maximal 10 Schlüssel zurückgeliefert. Wurden weniger als 10 Schlüssel generiert, dann wird der Rest des Feldes mit '0' versorgt.

signon_value


gibt an, für wieviel Prozent der Benutzerkennungen gleichzeitig ein Anmelde-Vorgang aktiv sein kann. UTM versucht entsprechend dieser Angabe, die notwendigen Betriebsmittel anzulegen (siehe Abschnitt „kc_signon_str - Eigenschaften des Anmeldeverfahrens" ).

signon_restr


gibt an, ob Einschränkungen für den Anmelde-Vorgang generiert wurden (siehe Abschnitt „kc_signon_str - Eigenschaften des Anmeldeverfahrens"):


'R'

Im 1. Teil des Anmelde-Vorgangs sind Datenbank-Aufrufe und Zugriffe auf globale UTM-Speicher verboten (RESTRICTED).


'N'

Im 1. Teil des Anmelde-Vorgangs sind Datenbank-Aufrufe und Zugriffe auf globale UTM-Speicher erlaubt.

signon_fail


gibt an, nach wievielen unmittelbar aufeinanderfolgenden erfolglosen Anmeldeversuchen eines Terminal-Benutzers UTM einen „stillen Alarm“ auslöst. Stiller Alarm bedeutet, dass UTM die Meldung K094 erzeugt, in die SYSLOG schreibt und ggf. an andere, für diese Meldung konfigurierte Meldungszeile ausgibt. Siehe Abschnitt „kc_signon_str - Eigenschaften des Anmeldeverfahrens".

Minimalwert: '1' 
Maximalwert: '100' 

sm2


gibt an, ob die UTM-Anwendung zur Überwachung der Performance Daten an openSM2 liefert.


'0'

Die Performanceüberwachung mit openSM2 ist für die UTM-Anwendung generell ausgeschlossen. D.h. die UTM-Anwendung darf keine Daten an openSM2 liefern. Die Lieferung von Daten an openSM2 kann auch durch die Administration nicht eingeschaltet werden.


'N'

Die UTM-Anwendung darf Daten an openSM2 liefern. Die Datenlieferung an openSM2 ist jedoch derzeit ausgeschaltet. Sie kann durch die Administration eingeschaltet werden.


'Y'

Die UTM-Anwendung darf Daten an openSM2 liefern. Die Lieferung von Daten an openSM2 ist eingeschaltet. Sie kann durch die Administration ausgeschaltet werden.

spab


enthält die maximale Länge des Standard Primären Arbeitsbereiches (SPAB).

syslog_size


enthält den generierten Schwellwert für die automatische Größenüberwachung der SYSLOG-Datei durch UTM. Die automatische Größenüberwachung der SYSLOG ist nur möglich, wenn die SYSLOG als Dateigenerationsgruppe (FGG) bzw.
Dateigenerationsverzeichnis angelegt ist (siehe auch openUTM-Handbuch „Einsatz von UTM-Anwendungen“). UTM schaltet auf die nächste Dateigeneration der SYSLOG-FGG um, wenn die Größe der Dateigeneration, die aktuell beschrieben wird, den Schwellwert syslog_size erreicht.

syslog_size='0' bedeutet, dass UTM die Größe der SYSLOG-Datei nicht überwacht.
UTM schreibt alle Meldungen mit dem Meldungsziel SYSLOG in dieselbe Dateigeneration.

syslog_size='0' wird immer ausgegeben, wenn die SYSLOG-Datei als einfache Datei geführt wird.

Sie können die Protokollierung auf eine andere Dateigeneration umschalten, die Größenüberwachung ein- und ausschalten oder den Schwellwert ändern (siehe KC_SYSLOG im Abschnitt "KC_SYSLOG - System-Protokolldatei administrieren" und KDCSLOG im Abschnitt "KDCSLOG - SYSLOG-Datei administrieren").

tasks


Maximale Anzahl der Prozesse, die gleichzeitig für die Anwendung eingesetzt werden können. tasks enthält den mit KDCDEF eingestellten Maximalwert (in MAX TASKS).

Die Anzahl der Prozesse, die Aufträge der Anwendung bearbeiten können, wird bei jedem Start der Anwendung über Startparameter neu festgelegt und kann während des Anwendungslaufs an die aktuellen Erfordernisse angepasst werden (siehe KDCAPPL im Abschnitt "KDCAPPL - Eigenschaften und Grenzwerte für den Betrieb ändern" und KC_MODIFY_OBJECT im Abschnitt "obj_type=KC_TASKS_PAR"). Weder die beim Start angegebene Anzahl der Prozesse noch die durch die Administration eingestellte Anzahl darf jedoch den in tasks zurückgelieferten Wert überschreiten.

tasks_in_pgwt


gibt die maximale Anzahl der Prozesse an, die gleichzeitig Aufträge mit blockierenden Aufrufen wie z.B. den KDCS-Aufruf PGWT (Program Wait) bearbeiten dürfen.

Die aktuell eingestellte Prozesszahl wird bei der Informationsabfrage mit Parametertyp KC_TASKS_PAR in kc_tasks_par_str zurückgeliefert.

Die aktuelle Anzahl der Prozesse wird beim Start der Anwendung festgelegt und kann in Engpasssituationen durch die Administration angepasst werden (siehe KDCAPPL im Abschnitt  "KDCAPPL - Eigenschaften und Grenzwerte für den Betrieb ändern" und, KC_MODIFY_OBJECT im Abschnitt  "obj_type=KC_TASKS_PAR"). Weder die beim Start angegebene Anzahl noch die durch die Administration eingestellte Anzahl darf den hier ausgegebenen Wert überschreiten.

Ist tasks_in_pgwt='0', dann sind keine blockierenden Aufrufe erlaubt.

tracerec


(trace rec ords) enthält die maximale Anzahl der Einträge im TRACE-Bereich. In diesen Bereich schreibt UTM Diagnoseinformationen, falls TESTMODE=ON gesetzt ist. 
Jeder Eintrag ist auf 32-Bit-Plattformen 64 Bytes lang und auf 64-Bit-Plattformen 128 Bytes lang.

trmsglth


(transfer message length) enthält die maximale Länge der physischen Nachrichten, die zwischen Clients, Partner-Anwendungen oder Druckern und der UTM-Anwendung ausgetauscht werden. Bei dieser Längenangabe werden Steuerzeichen, Positionierfolgen usw. mitgerechnet. Die Angabe erfolgt in Byte.

uslog


gibt an, ob die Benutzer-Protokolldatei aus Sicherheitsgründen doppelt geführt wird.


'S'

(SINGLE)
Die Benutzer-Protokolldatei wird einfach geführt.


'D'

(DOUBLE)
Die Benutzer-Protokolldatei wird doppelt geführt.


Näheres zur Benutzer-Protokolldatei finden Sie im openUTM-Handbuch „Einsatz von UTM-Anwendungen“.

vgmsize


Nur auf BS2000-Systemen: enthält die Größe des Puffers für das Vorgangsgedächtnis eines SQL-Datenbanksystems. Damit wird auch der Anteil eines Benutzers am Pagepool begrenzt. vgmsize  wird in KB angegeben.

xaptpshmkey


Nur auf Unix-, Linux- und Windows-Systemen: enthält den Schlüssel für das Shared Memory Segment, das XAPTP bei der Kommunikation über OSI TP verwendet.

xaptpshmkey ist auf Unix-, Linux- und Windows-Systemen ein globaler Parameter. xaptpshmkey ist eine Dezimalzahl.

max_statistics_msg


zeigt an, ob in der Anwendung stündlich die Statistikmeldung K081 erzeugt wird oder nicht (siehe openUTM-Handbuch „Meldungen, Test und Diagnose“ K081 und openUTM-Handbuch „Anwendungen generieren“ MAX STATISTICS-MSG).


'Y'

die Statistikmeldung K081 wird jede Stunde erzeugt und in die SYSLOG-Datei geschrieben.

Bei der Ausgabe der Meldung werden einige Anwendungs-spezifische Statistikwerte auf Null gesetzt.


'N'

die Statistikmeldung K081 wird nicht erzeugt.

Die Anwendungs-spezifischen Statistikwerte können dann bei Bedarf durch die Administration zurückgesetzt werden (siehe KC_MODIFY_OBJECT, KC_CURR_PAR im Abschnitt "obj_type = KC_CURR_PAR").

max_open_asyn_conv


enthält die maximale Anzahl der Asynchron-Vorgänge, die gleichzeitig offen sein dürfen.

dead_letter_q_alarm


steuert die Überwachung der Anzahl von Nachrichten in der Dead Letter Queue. Jedesmal, wenn der Schwellwert erreicht ist, wird die Meldung K134 ausgegeben. Bei einem Schwellwert 0 ist die Überwachung ausgeschaltet.

atac_redelivery


enthält die maximale Anzahl wiederholter Zustellungen einer Nachricht an einen Asynchron-Vorgang bei abnormaler Beendigung des Vorgangs.

dget_redelivery


enthält die maximale Anzahl wiederholter Zustellungen einer Nachricht an eine Service-gesteuerte Queue beim Rücksetzen der Transaktion.

principal_lth


Nur auf BS2000-Systemen: enthält die maximale Länge eines Kerberos-Principals in Bytes (siehe openUTM-Handbuch „Anwendungen generieren“, MAX PRINCIPAL-LTH=).

privileged_lterm


enthält den Namen des privilegierten LTERMs (siehe openUTM-Handbuch „Anwendungen generieren“, MAX PRIVILEGED-LTERM=).

cache_location


gibt den Ablageort des UTM-Cache zurück:


'P'

Der UTM-Cache ist im Programmraum angelegt.

Für Unix-, Linux- und Windows-Systeme wird hier immer der Wert 'P' zurückgegeben.


'D'

Auf BS2000-Systemen ist der UTM-Cache in einem oder mehreren Datenräumen angelegt (siehe openUTM-Handbuch „Anwendungen generieren“, MAX CACHESIZE=).

data_compression


gibt an, ob die Datenkomprimierung per Generierung erlaubt ist:


'Y'

die Datenkomprimierung ist erlaubt.


'N'

die Datenkomprimierung nicht erlaubt.


Siehe openUTM-Handbuch „Anwendungen generieren“, KDCDEF-Anweisung MAX DATA-COMPRESSION=.

hostname_long


BS2000-Systeme: 
hostname_long enthält den Namen des virtuellen Hosts, auf dem (aus BCAM-Sicht) die UTM-Anwendung läuft.

Unix-, Linux- und Windows-Systeme: 
hostname_long enthält den Namen des Hosts, der als Absenderadresse angegeben wird, wenn eine Verbindung von der UTM-Anwendung aus aufgebaut wird.

move_bundle_msgs


enthält den Wert, der im Parameter MOVE-BUNDLE-MSGS der MAX-Anweisung generiert ist:


'Y'

wartende Asynchron-Nachrichten eines Slave-LTERMs, Slave-LPAPs oder Slave-OSI-LPAPs, für das keine Verbindung zur Partneranwendung aufgebaut werden kann, werden von UTM auf einen anderen Slave des gleichen Bündels umgehängt.


'N'

wartende Asynchron-Nachrichten an einem Slave werden nicht umgehängt.