SHOW-CE-LOCK

Sperren für Katalogeinträge ausgeben

Komponente:	BS2000
Funktionsbereich:	Dateiverarbeitung
Anwendungsbereich:	FILE                                                                                                          FILE-GENERATION
Privilegierung:	STD-PROCESSING TSOS

Funktionsbeschreibung

Das Kommando SHOW-CE-LOCK ermittelt, ob für den Katalogeintrag einer Datei oder JV eine Sperre (CE-Lock) existiert. Wenn ein CE-Lock existiert, werden die TID (Task-Identifier) des Lock-Halters und die Sysid des Systems, in dem diese Task arbeitet, nach SYSOUT ausgegeben.
Solange ein CE-Lock besteht, kann der betroffene Katalogeintrag nicht geändert werden. Einen „hängenden“ CE-Lock, der z.B. wegen Fehlers bei der Rechnerkommunikation nicht mehr zurückgesetzt werden konnte, kann von der Systembetreuung zurückgesetzt werden (siehe Kommando REMOVE-CE-LOCK).

Für Shared Pubsets kann das Kommando von einem beliebigen System des Verbunds eingegeben werden.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").

Format

SHOW-CE-LOCK                                                                                                                                          

 FILE-NAME = <filename 1..54>

,OBJECT = *FILE / *JV

Operandenbeschreibung

FILE-NAME = <filename 1..54>
Name der Datei oder JV, deren Katalogeintrag bezüglich bestehender CE-Locks untersucht werden soll. Eine Dateigeneration darf nicht relativ angegeben werden.

OBJECT = *FILE / *JV
Gibt an, ob der Katalogeintrag einer Datei oder einer JV zu untersuchen ist.

 

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando ohne Fehler ausgeführt
2	0	DMS1342	Kein CE-Lock vorhanden
	1	CMD0202	Syntaxfehler
	32	CMD0221	Interner Fehler
	32	CMD2009	Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar)
	64	CMD0501	Katalog ist nicht verfügbar
	64	DMS0505	Fehler bei Rechnerkommunikation
	64	DMS0512	Katalog ist im System nicht bekannt
	64	DMS1343	Für den Pubset läuft gerade ein Masterwechsel
	64	OPS0001	SDF-P meldet Speichermangel (mögl. Reaktion: FREE-VARIABLE und Kommandowiederholung)

Ausgabe in S-Variable

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung
Name der Datei bzw. JV	var(*LIST).NAME	S	<filename 1..54>
Sysid des Systems, in dem der Lock-Halter arbeitet	var(*LIST).SYSID	S	<sys-id>
Task-Identifier (TID) des Lock-Halters	var(*LIST).TID	S	<x-text 4..4>