SINF - Systeminformationen ausgeben

Allgemeines

Anwendungsgebiet:	Abfragen und Zugriff zu Listen und Tabellen; siehe "Abfragen und Zugriff zu Listen und Tabellen"
Makrotyp:	S-Typ, MF-Format 1: (Standardform/E-Form/L-Form); siehe "S-Typ-Makroaufrufe"

• Seit BS2000/OSD-BC V1.0 stehen mit NSIINF und NSIOPT zwei neue Makros zur Verfügung, die die volle Funktionalität des Makros SINF enthalten. Die Funktionalität des SINF wurde auf dem Stand BS2000 V10.0 eingefroren. Für Neuentwicklungen sollten die Makros NSIINF und NSIOPT verwendet werden.

Makrobeschreibung

Der Makro SINF informiert über

CPU:	Seriennummern und Identifikationen der verfügbaren CPUs
BS2000:	Bezeichnung und Version des Betriebssystems, sowie Adressierungsmodus des Betriebssystems
Speicher:	Größe des (physikalischen) Hauptspeichers und Anfangsadresse des Betriebssystems im virtuellen Adressraum
HSI:	HSI-Basistyp
Server:	Server-Typ (Modellreihe)
Systemparameter:	Für den nichtprivilegierten Anwender wichtige Systemparameter, wie DEFLUID oder TEMPFILE.

Die ausgewählte Information wird in ein anzugebendes Feld übertragen. Pro Makroaufruf kann nur eine Information abgefragt werden (siehe Liste am Ende der Operandenbeschreibung).

Makroaufrufformat und Operandenbeschreibung

SINF

INFO='info' / adr / (r)

,FIELD=adr / (r)

,LENGTH=länge / (r)

[,PARMOD=24 / 31]

[,MF=(E,..) / L]

INFO=

bezeichnet die Information, die ausgegeben werden soll.

'info'
info = Kurzbezeichnung der Information. Mögliche Angaben sind der Liste am Ende der Operandenbeschreibung zu entnehmen.

adr
symbolische Adresse eines Feldes, das die Kurzbezeichnung für info enthält. Feldlänge = 8 Byte; Eintrag linksbündig mit nachfolgenden Leerzeichen.

(r)
r = Register mit dem Adresswert adr.

FIELD=
bezeichnet die Adresse des Feldes, in das die Information ausgegeben wird. Feldlänge >= Länge der Information (siehe Liste). Die Information wird linksbündig eingetragen.

adr
symbolische Adresse des Feldes.

(r)
r = Register mit dem Adresswert adr.

LENGTH=
beschreibt die Feldlänge des bei FIELD angegebenen Feldes. Die Länge ist der nachfolgenden Liste zu entnehmen. Bei falscher Längenangabe erfolgt kein Eintrag.
Für Systemparameter des Typs C erfolgt die Ausgabe auch in ein zu kleines Ausgabefeld, wenn vom Inhalt des Systemparameters nur Leerzeichen abgeschnitten werden (siehe z.B. Systemparameter DEFLUID).

länge
Länge in Byte, entsprechend der Liste. Angabe als Dezimalzahl.

(r)
r = Register mit der Angabe länge.

MF=
Zur allgemeinen Beschreibung des Operanden MF, der dazugehörenden Operandenwerte und der evtl. nachfolgenden Operanden (z.B. für einen Präfix) siehe Abschnitt „S-Typ-Makroaufrufe“. Die gültigen MF-Werte sind zu Beginn der Makrobeschreibung bei „Makrotyp“ angegeben und aus dem Aufrufformat ersichtlich.

PARMOD=
steuert die Makroauflösung. Es wird entweder die 24-Bit- oder die 31-Bit-Schnittstelle generiert.
Wenn PARMOD nicht spezifiziert wird, erfolgt die Makroauflösung entsprechend der Angabe für den Makro GPARMOD oder der Voreinstellung für den Assembler (= 24-Bit-Schnittstelle).

24

Die 24-Bit-Schnittstelle wird generiert. Datenlisten und Befehle benutzen 24-Bit-Adressen (Adressraum <= 16 MB).

31
Die 31-Bit-Schnittstelle wird generiert. Datenlisten und Befehle benutzen 31-Bit-Adressen (Adressraum <= 2 GB).

Liste der Informationen, die abgefragt werden können

Bezeichnung (info=)	Länge in Byte	Erläuterung der ausgegebenen Werte
CONFNAME	8	Server-Typ (Modellreihe) z.B.: S210-F (im alten Format). Ist der Server- Typ im System nicht eingetragen, wird 7.000'   ' ausgegeben. Hinweis Künftig sind die im alten Format ausgegebenen Server-Bezeichnungen möglicherweise nicht mehr eindeutig. Daher wird die Ausgabe im neuen erweiterten Format (INFO=CONFNAMX) empfohlen.
CONFNAMX	21	siehe "NSIINF - Systeminformationen ausgeben".
CPUID	64	Identifikationen der CPUs. Die Ausgabe gliedert sich in 8 Elemente von jeweils 8 Byte Länge: Das i-te Element enthält die Identifikation der i-ten CPU in sedezimaler Darstellung, wie sie von der Hardware übergeben wird. Steht die i-te CPU nicht zur Verfügung, enthält das i-te Element binär Null (X'00...00' ).
CPUSER	3	Seriennummer der ersten CPU.
	6	Byte 0- 2: Seriennummer der ersten CPU. Byte 3- 5: Seriennummer der zweiten CPU.
	12	Byte 0- 2: Seriennummer der ersten CPU. Byte 3- 5: Seriennummer der zweiten CPU. Byte 6- 8: Seriennummer der dritten CPU. Byte 9-11: Seriennummer der vierten CPU. Ist eine CPU nicht vorhanden, wird in das entsprechende Feld X'000000' eingetragen. Die Angaben haben keine Beziehung zu den CPU-Adressen.
HSIBASE	6	siehe "NSIINF - Systeminformationen ausgeben".
HSILINE	2	siehe "NSIINF - Systeminformationen ausgeben".
HSITYPE	4	Eigenschaften des aktuellen HSI-Typs werden angezeigt. Ausgabe: XS31 Adressierbarer Speicherbereich > 16MB; alle Adressen werden je nach Adressierungsmodus als 24-Bit- oder 31-Bit-Adressen interpretiert.
HSIVM	2	siehe "NSIINF - Systeminformationen ausgeben".
MEMSIZE	4	Größe des für die Software nutzbaren (physikalischen) Hauptspeichers (Angabe in Byte).
OSAMODE	2	informiert über den Adressierungsmodus des Betriebssystems. Ausgabe: 31 31-Bit-Adressierungsmodus (Adresslänge = 31Bit).
OSID	12	Byte 0-7: Programmname des Betriebssystems; z.B. 'BS2V190' . Byte 8-11: Version, z.B. 'V190' .
SYSBASE	4	Anfangsadresse des Betriebssystems im virtuellen Adressraum.
< <Systemparameter>		Wert des Systemparameters

Rückinformation und Fehleranzeigen

Register R1 wird überschrieben.

R15:

+---------------+
|   |   |   |   |
| | | | | | |a|a|
+---------------+

Über die Ausführung des Makros SINF wird im rechtsbündigen Byte des Registers R15 ein Returncode übergeben.

X'aa'	Erläuterung
X'00'	Der Makroaufruf war erfolgreich.
X'04'	Ungültige Adresse oder ungültiges Register. Keine Aktion.
X'08'	Interner REQM-Aufruf nicht ausgeführt. Keine Aktion.
X'0C'	Ungültige Angabe im Operand INFO. Keine Aktion.
X'10'	Falsche Längenangabe für das Ausgabefeld. Keine Aktion.
X'14'	Ein unzulässiger Systemparameter wurde bei INFO angegeben. Keine Aktion.
X'18'	Falsches Makroformat angegeben.