IMOKIS Output contents of SYSSII file

Function call

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

Programming notes

The following variables must be passed in the parameter list when calling the function:

sii_name	Name of the SYSSII file.
show_info	Scope of the information output. The value C’A’ is to be set to obtain the maximum amount of output, and the value C’M’ is to be set to obtain a limited amount of output.
show_output_type
	Output destination. The following values are to be set depending on the output destination: The output to SYSLST corresponds to the value X’00’. The output to SYSOUT corresponds to the value X’64’. The output to a file corresponds to the value X’65’.
show_output_file	Name of the output file. It is ignored when the output is sent to SYSLST or SYSOUT.
overwrite_file	Specifies if an existing file is to be overwritten. The value X’01’ allows overwriting and the value X’00’ prevents it.

The DMS error code (in the ISHODMS field) is passed in the parameter list (dms_error variable) in addition to the return code when a DMS error occurs.

The layout of the output information matches the layout of the output requested in the menu mode using option 3 (Show SYSSII) in the main menu ("Open, display or check SYSSII file ") or via the SHOW-SII statement ("SHOW-SII Output contents of SYSSII file ", see the example on "Example with masks from the main menu ").

Parameter list

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                   */
};