Mit dem Makro IMOKIS (Funktion SIISHOW) kann der Inhalt einer SYSSII-Datei, d.h. alle Informationen über die Release-Unit und die zugehörigen Release-Items, ausgegeben werden. Der Umfang der Ausgabe kann im Parameter SHINFO auch beschränkt werden auf die Strukturinformationen. Die Ausgabe kann nach SYSOUT, SYSLST oder in eine Datei erfolgen.
Das Layout der Ausgabe entspricht dem Layout der Ausgabe, die im Menü-Modus über die Option 3 (SYSSII zeigen) im Hauptmenü ("SYSSII-Datei öffnen, anzeigen oder überprüfen ") bzw. über die Anweisung SHOW-SII
("SHOW-SII Inhalt einer SYSSII-Datei ausgeben ") angefordert wird (Beispiel siehe "Beispiel mit Masken des Hauptmenüs ").
| Makro | Operanden | ||||||||||||||||||||
| IMOKIA |
|
Zur Beschreibung der Parameter MF, PREFIX, MACID und PARAM siehe Abschnitt „Makroformen“ auf "Makrosyntax ".
FUNCT | Gibt die gewünschte Funktion an. |
=*SIISHOW | Den Inhalt einer SYSSII-Datei ausgeben. |
SYSSII | Name der SYSSII-Datei. |
=X’40’ | Keine Angabe. |
=<c-string 1..54> | Explizite Angabe des SYSSII-Dateinamens. |
=<var: char:55> | Symbolische Adresse, die die Angabe zum Namen der SYSSII-Datei enthält. Darf nicht zusammen mit MF=L angegeben werden. |
SHINFO | Bestimmt den Umfang der auszugebenen Informationen. |
=*ALL | Es werden alle Informationen (einschließlich Attribute, Abhängigkeiten, Parametertexte und Kommentare) über die Release-Unit und die zugehörigen Release-Items ausgegeben. |
=*MIN | Es wird nur die Strukturinformation für die Release-Unit und die zugehörigen Release-Items ausgegeben. Die Ausgabe enthält den Namen der Release-Unit, Hauptversion, Änderungsstand und Funktionszustand sowie die dazugehörigen Release-Items mit Funktionszustand und logischem Namen. |
| SHOOUT | Bestimmt das Ausgabeziel. |
=*SYSLST | Die Informationen werden nach SYSLST ausgegeben. |
=*SYSOUT | Die Informationen werden nach SYSOUT ausgegeben. |
=*FILE | Die Informationen werden in eine Datei ausgegeben. Der Name der Datei muss im Parameter SHOFIL angegeben werden. |
| SHOFIL | Bestimmt den Namen der Ausgabedatei (nur bei SHOOUT=*FILE). |
=X’40’ | Keine Angabe. |
=<c-string 1..54> | Explizite Angabe des Dateinamens. |
=<var: char:55> | Symbolische Adresse, die die Angabe zum Dateinamen enthält. Darf nicht zusammen mit MF=L angegeben werden. |
| OVERW | Gibt an, ob eine bereits existierende Ausgabedatei überschrieben werden darf. |
=*NO | Eine bereits existierende Datei darf nicht überschrieben werden. |
=*YES | Eine bereits existierende Datei wird nicht überschrieben. |
Parameterliste
IMOKIS IMOKIS MF=D 1 IMOKIS MFTST MF=D,PREFIX=I,MACID=SHO,ALIGN=F, C 1 DMACID=SHO,SUPPORT=(E,D,C,M,L),DNAME=SHO_PL 2 IMOKIS DSECT , 2 *,##### PREFIX=I, MACID=SHO ##### 1 * for show output destination 1 ISHOSLST EQU 0 show on syslst 1 ISHOSOUT EQU 100 show on sysout 1 ISHOSFIL EQU 101 show in file 1 * 1 ISHOPVER EQU 21 value for parameter list 1 * version 1 * 1 ISHOFSHO EQU 153 value for SIISHOW 1 * 1 ISHOSIAC EQU 65 show all 1 * 1 ISHOSIMC EQU 77 minimum show 1 * 1 ISHOSOWF EQU 89 overwrite show file 1 * 1 ISHOYES EQU 1 overwrite show file 1 * 1 ISHONO EQU 0 overwrite not show file 1 * 1 * PARAMETER LIST OF IMON-SIC 1 ISHOSTANDARD_HEADER FHDR MF=(C,ISHO),EQUATES=NO 2 ISHOSTANDARD_HEADER DS 0A 2 ISHOFHE DS 0XL8 0 GENERAL PARAMETER AREA HEADER 2 * 2 ISHOIFID DS 0A 0 INTERFACE IDENTIFIER 2 ISHOFCTU DS AL2 0 FUNCTION UNIT NUMBER 2 * BIT 15 HEADER FLAG BIT, 2 * MUST BE RESET UNTIL FURTHER NOTICE 2 * BIT 14-12 UNUSED, MUST BE RESET 2 * BIT 11-0 REAL FUNCTION UNIT NUMBER 2 ISHOFCT DS AL1 2 FUNCTION NUMBER 2 ISHOFCTV DS AL1 3 FUNCTION INTERFACE VERSION NUMBER 2 * 2 ISHORET DS 0A 4 GENERAL RETURN CODE 2 ISHOSRET DS 0AL2 4 SUB RETURN CODE 2 ISHOSR2 DS AL1 4 SUB RETURN CODE 2 2 ISHOSR1 DS AL1 5 SUB RETURN CODE 1 2 ISHOMRET DS 0AL2 6 MAIN RETURN CODE 2 ISHOMR2 DS AL1 6 MAIN RETURN CODE 2 2 ISHOMR1 DS AL1 7 MAIN RETURN CODE 1 2 ISHOFHL EQU 8 8 GENERAL OPERAND LIST HEADER LENGTH 2 * 1 * STD HEADER 1 * main return codes 1 ISHOOK EQU 0 Success 1 ISHOESIN EQU 1 Invalid SYSSII 1 ISHOEIPL EQU 2 Invalid Parameter List 1 * Version 1 ISHOEIOS EQU 4 Invalid Output Specification 1 ISHOEISF EQU 5 Invalid Show File Name 1 ISHOEIFC EQU 7 Invalid Function Called 1 ISHOESIF EQU 20 Bad SYSSII format 1 ISHOEDMS EQU 21 DMS error 1 ISHOEDOF EQU 23 DMS error on Output File 1 ISHOEFEX EQU 24 File existing 1 ISHOES EQU 256 System error 1 ISHOEI EQU 257 Internal error 1 * 1 ISHODMS DS H DMS ERROR 1 ISHOSII DS CL55 SYSSII FILE NAME 1 ISHOSIN DS X SHOW INFORMATION 1 ISHOSOT DS X SHOW OUTPUT TYPE 1 ISHOSFI DS CL55 SHOW OUTPUT FILE 1 ISHOOWF DS X FLAG FOR OVERWRITE SHOW FILE 1 ISHOR1 DS XL1 filler 1 1 ISHO# EQU *-ISHOSTANDARD_HEADER
Hinweise zur Programmierung
Für den Aufruf der Funktion SIISHOW können folgende Parameter auch in der Parameterleiste übergeben werden:
Der Name der SYSSII-Datei im Feld ISHOSII (siehe Parameter SYSSII).
Der Umfang der Informationsausgabe im Feld ISHOSIN (siehe Parameter SHINFO).
Für den maximalen Ausgabeumfang (SHINFO=*ALL) ist der Wert C’A’ zu setzen, für den eingeschränkten Ausgabeumfang (SHINFO=*MIN) der Wert C’M’.
Das Ausgabeziel im Feld ISHOOT (siehe Parameter SHOOUT). Je nach Ausgabeziel sind folgende Werte zu setzen:
Die Ausgabe nach SYSLST entspricht dem Wert X’00’.
Die Ausgabe nach SYSOUT entspricht dem Wert X’64’.
Die Ausgabe in eine Datei entspricht dem Wert X’65’.
Der Name der Ausgabedatei im Feld ISHOSFI (siehe Parameter SHOFIL). Bei Ausgabe nach SYSLST oder SYSOUT wird die Angabe ignoriert.
Die Angabe, ob eine bereits existierende Datei überschrieben werden soll, im Feld ISHOOWF (siehe Parameter OVERW). Der Wert X’01’ erlaubt das Überschreiben, der Wert X’00’ verhindert es.
Neben dem Returncode wird bei der Funktion SIISHOW im Falle eines DMS-Fehlers der DMS-Fehlercode (im Feld ISHODMS) in der Parameterleiste übergeben.
Makro-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
X’00’ | X’00’ | X’0000’ | Funktion erfolgreich ausgeführt |
X’00’ | X’01’ | X’0001’ | SYSSII-Dateiname (Parameter SYSSII) ungültig |
X’00’ | X’03’ | X’0002’ | Parameterliste ungültig |
X’00’ | X’01’ | X’0004 | Ausgabeziel ungültig (Parameter SHOOUT) |
X’00’ | X’01’ | X’0005 | Name der Ausgabedatei ungültig (Parameter SHOFIL) |
X’00’ | X’01’ | X’0007’ | Funktion (Parameter FUNCT) ungültig |
X’00’ | X’40’ | X’0014’ | SYSSII-Datei (Parameter SYSSII) im falschen Format |
X’00’ | X’40’ | X’0015’ | DMS-Fehler |
X’00’ | X’40’ | X’0017’ | DMS-Fehler beim Schreiben in Ausgabedatei (Parameter SHOFIL) |
X’00’ | X’40’ | X’0018’ | Ausgabedatei (Parameter SHOFIL) existiert bereits |
X’00’ | X’20’ | X’0100’ | Systemfehler |
X’00’ | X’20’ | X’0101’ | Interner Fehler |