Umgebungsinformationen

Mit den Funktionen, die in diesem Abschnitt vorgestellt werden, lassen sich Informationen über die aufrufende Task, den Job, die Prozedur, über Benutzerschalter, Jobvariablen, Systemoptionen etc. abrufen. Die meisten dieser Funktionen werden ohne Eingabeparameter aufgerufen, da die Zuordnung zum abzufragenden Wert eindeutig ist.

Informationen über Job / Task / Dateien

Jobname	JOB-NAME( )	liefert den Jobnamen der laufenden Task; das ist der Name, der beim SET-LOGON-PARAMETERS angegeben wurde
Betriebsmodus	TASK-MODE( )	gibt aus, in welchem Betriebsmodus sich die aktuelle Task befindet
TSN	TSN( )	liefert die Auftragsnummer (TSN) der aktuellen Task
Priorität	RUN-PRIORITY( )	liefert die Prioritätsstufe der aktuellen Task
Abrechnungsnummer	ACCOUNT( )	liefert die Abrechnungsnummer der Task
Benutzerkennung	USER-IDENTIFICATION( )	liefert die Benutzerkennung der laufenden Task
Default-Catid	STD-CAT-ID( )	liefert die Katalogkennung des Default-Pubsets der Benutzerkennung der aktuellen Task
Home-Pubset	HOME-CAT-ID( )	liefert die Katalogkennung (Catid) des Home-Pubsets der Benutzerkennung der aktuellen Task
Katalogeintrag	IS-CATALOGED-FILE( )	prüft, ob die angegebene Datei katalogisiert ist
	IS-CATALOGED-JV( )	prüft, ob die angegebene Jobvariable katalogisiert ist
	IS-LIBRARY( )	prüft, ob die angegebene Datei eine Bibliothek ist
	IS-LIBRARY-ELEMENT( )	prüft, ob das angegebene Bibliothekselement existiert
Aufrufe zählen	COUNTER( )	zählt die Aufrufe von COUNTER( )
Programmname	PROG-NAME( )	liefert den Namen der aktuell geladenen Programmdatei
Pfadname	INSTALLATION-PATH( )	gibt für eine Datei den Pfadnamen gemäß der Produktversion an.
Dateiinhalt	IS-EMPTY-FILE( )	prüft, ob die Datei leer ist

SYSFILE-Management: Systemdateien

SYSCMD	SYSCMD( )	liefert *PRIMARY oder den Namen der Datei, der SYSCMD zugewiesen ist
SYSDTA	SYSDTA( )	liefert *PRIMARY oder *SYSCMD oder den Namen der Datei, der SYSDTA zugewiesen ist
SYSLST	SYSLST( )	liefert *PRIMARY oder den Namen der Datei, der SYSLST zugewiesen ist
SYSOUT	SYSOUT( )	liefert *PRIMARY oder den Namen der Datei, der SYSOUT zugewiesen ist

Datum/Zeit

Datum	DATE( )	liefert das aktuelle Tagesdatum im angegebenen Format
	DATE-VALUE( )	liefert ein bestimmtes Tagesdatum im angegebenen Format
	ELAPSED-DAYS( )	liefert die Anzahl der Differenztage zwischen zwei Datumsangaben
Wochentag	DAY( )	liefert den Namen des aktuellen Tages in der angegebenen Sprache als Abkürzung
Monat	MONTH( )	liefert den Namen des aktuellen Monats in der angegebenen Sprache als Abkürzung
Uhrzeit	TIME( )	liefert die aktuelle Uhrzeit auf die Sekunde genau, mit beliebigem Trennzeichen zwischen den verschiedenen Einheiten

Systemdaten

In diesem Abschnitt werden Funktionen zusammengefasst, die Systemdaten liefern, die sich auf die eingesetzte Hard- und Software beziehen, sowie auf Einstellungen, die der Systemverwalter für das laufende System getroffen hat. Nicht enthalten sind taskbezogene Daten oder Jobvariablen-Informationen.

Rechnername	HOST( )	liefert den internen Namen des BS2000-Rechners, auf dem die aktuelle Task läuft
Abfrage: SDF-P im System	IS-SDF-P( )	liefert TRUE, wenn SDF-P im System geladen ist
Systemparameter	SYSTEM-INFORMATION( )	liefert die Werte von Systemparametern; Eingabeparameter wie im Makro SINF
System-ID	SYS-ID( )	liefert das Systemkennzeichen
Systemlaufnummer	SESSION-NUMBER( )	liefert die interne Nummer der aktuellen Session
SDF-P-Version	SDF-P-VERSION( )	liefert die Versionsbezeichnungen der geladenen Subsysteme SDF-P und SDFPBASY

TIAM-Information

Stationsname	STATION( )	liefert den Stationsnamen der TIAM-Station
Gerätetyp	STATION-TYPE( )	liefert den Gerätetyp der TIAM-Station
Prozessorname	PROCESSOR( )	liefert den Prozessornamen der TIAM-Station

Prozedurinformationen

Die folgenden Funktionen prüfen die Einstellung von Prozedur-Eigenschaften und liefern Informationen über die aktuelle Prozedur:

Schachtelungstiefe	PROC-LEVEL( )	liefert die Schachtelungstiefe der S-Prozedur zum Zeitpunkt des Funktionsaufrufs
Protokollierung	LOGGING-MODE( )	zeigt an, ob für die aktuelle S-Prozedur Protokollierung von Kommandos oder Daten eingeschaltet ist
Spinoff	STMT-SPINOFF( )	zeigt an, ob Statement-Spinoff eingeschaltet ist
Benutzerschalter	USER-SWITCH( )	fragt den Zustand des angegebenen Benutzerschalters ab
Aufruf	EXPLICIT-CALL( )	liefert die Art des Prozeduraufrufs
	SYSTEM-CALL( )	liefert die Syntaxdatei-Hierarchiestufe für das prozeduraufrufende Kommando

Jobvariablen

Die folgenden Funktionen liefern Informationen über Jobvariablen, die den Auftrag oder das Programm überwachen. Jobvariablen gehören zum (kostenpflichtigen) Produkt JV (Jobvariablensystem) und wurden in den bisherigen BS2000-Prozeduren zur Prozedurüberwachung und -Steuerung genutzt:

Auftragsüberwachung	JOB-MONJV( )	liefert den Namen der Monitor-JV, die den aktuellen Auftrag überwacht
Programmüberwachung	PROG-MONJV( )	liefert den Namen der Monitor-JV, die das laufende Programm überwacht
Inhalt	JV( )	liefert den Inhalt der angegebene Jobvariablen
Klasse	JOB-CLASS( )	liefert die Jobklasse der aktuellen Task
Katalogeintrag	IS-CATALOGED-JV( )	prüft, ob die angegebenen Jobvariable katalogisiert ist