IMOKIS Inhalt einer SYSSII-Datei ausgeben

Funktionsaufruf

#define IMOKISPLVERSION          /* value for parameter list version */
#define IMOKIS_SHOW              /* value for SIISHOW function       */
void SIIENTR(struct IMOKIS_pl *);

Hinweise zur Programmierung

Für den Aufruf müssen in der Parameterliste folgende Variablen übergeben werden:

sii_name show_info	Name der SYSSII-Datei. Umfang der Informationsausgabe. Für den maximalen Ausgabeumfang ist der Wert C’A’ zu setzen, für den eingeschränkten Ausgabeumfang der Wert C’M’.
show_output_type	Ausgabeziel. 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’.
show_output_file	Name der Ausgabedatei. Bei Ausgabe nach SYSLST oder SYSOUT wird die Angabe ignoriert.
overwrite_file	Gibt an, ob eine bereits existierende Datei überschrieben werden soll. Der Wert X’01’ erlaubt das Überschreiben, der Wert X’00’ verhindert es.

Neben dem Returncode wird im Falle eines DMS-Fehlers der DMS-Fehlercode (Variable dms_error) in der Parameterleiste übergeben.

Das Layout der Ausgabeinformationen 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 ").

Parameterliste

struct IMOKIS_pl {
        /* STD HEADER                                                 */
        struct ESMFHDR STANDARD_HEADER;
        unsigned short dms_error;       /* DMS ERROR                  */
        char sii_name[55];              /* SYSSII FILE NAME           */
        unsigned char show_info;        /* SHOW INFORMATION           */
        unsigned char show_output_type; /* SHOW OUTPUT TYPE           */
        char show_output_file[55];      /* SHOW OUTPUT FILE           */
        unsigned char overwrite_file;   /* FLAG FOR OVERWRITE SHOW    */
                                        /* FILE                       */
        char R1[1];                     /* filler 1                   */
};