REDUCE-PAGING-AREA

Paging-Area reduzieren

Komponente:	BS2000
Funktionsbereich:	System steuern und optimieren
Anwendungsbereich:	SYSTEM-TUNING SYSTEM-MANAGEMENT
Privilegierung:	TSOS OPERATING
Berechtigungsschlüssel:	R

Funktionsbeschreibung

Über dieses Kommando werden dem Seitenwechselbereich eine oder mehrere Paging-Dateien entzogen. Eine Paging-Datei kann entweder über das Volume, auf dem sie sich befindet, oder über die Katalogkennung des Pubsets angegeben werden. Die Pubset-Angabe ist nur für SF-Pubsets möglich. Die Angabe bezeichnet alle Paging-Dateien, die sich auf den Volumes des betreffenden SF-Pubsets befinden.

Format

REDUCE-PAGING-AREA                                                                                                                            

VOLUME = *PUBSET(...) / list-poss(256): <vsn 1..6>
	*PUBSET(...)
		|	PUBSET = list-poss(256): <cat-id 1..4>

Operandenbeschreibung

VOLUME = *PUBSET(...) / list-poss(256): <vsn 1..6>
Bestimmt die Paging-Dateien, die entzogen werden sollen.

VOLUME = *PUBSET(...)
Gibt ein oder mehrere SF-Pubsets an. Es werden alle Paging-Dateien entzogen, die sich auf den Volumes der angegebenen SF-Pubsets befinden.

PUBSET = list-poss(256): <cat-id 1..4>
Spezifiziert die SF-Pubsets über ihre Katalogkennung. 

VOLUME = list-poss(256): <vsn 1..6>
Bestimmt die Platte, auf der sich die zu entziehende Paging-Datei befindet, über ihre Volume Serial Number (VSN). Es können maximal 256 Platten angegeben werden.

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung / garantierte Meldungen
	0	CMD0001	Kommandoausführung fehlerfrei begonnen
	32	EMM2800	Die Funktion kann wegen eines internen Fehlers bei Ausführung eines bestimmten Objekts nicht fortgesetzt werden garantierte Meldungen: EMM2818, EMM2828
	64	EMM2802	Der angegebene Pubset ist unbekannt und kann in der gegebenen Konfiguration nicht identifiziert werden garantierte Meldung: EM2841
	64	EMM2805	Der MRSCAT-Eintrag des Pubsets fehlt  garantierte Meldung: EMM2824
	128	EMM2807	Die Funktion kann aus Mangel an Betriebsmitteln bei Ausführung eines bestimmten Objekts nicht fortgesetzt werden garantierte Meldungen: EMM2819, EMM2829

Bei der Angabe von Listen wird beim Auftreten eines Fehlers mit Returncode EMM2800 oder EMM2807 die Kommandobearbeitung abgebrochen.

Hinweise

• Eine Reduktion der Paging-Area wird abgelehnt, wenn dies zu einer Sättigung des virtuellen Adressraums führt.

• Die Bearbeitung des Kommandos kann sich über mehrere Minuten hinziehen. Aus diesem Grund wird das Kommando nicht in der Aufrufertask durchgeführt, sondern an eine zu diesem Zweck eingerichtete Servertask weitergereicht. Die Abschlussmeldung des Auftrags wird der Aufrufertask asynchron zugestellt. Wurde die Aufrufertask vor Zustellung der Abschlussmeldung beendet, so wird die Abschlussmeldung an die Konsole geschickt.

• Werden beim Absetzen des Kommandos mehrere Volumes angegeben (explizit oder über Pubset-Angabe), so wird für jedes Volume ein gesonderter Auftrag vergeben.

Beispiele

Die Paging-Area soll um die auf der Platte mit VSN 2OSW.0 liegende Paging-Datei reduziert werden:

/REDUCE-PAGING-AREA VOLUME=2OSW.0