The contents of a SYSSII file, i.e. all information on the release unit and the release items belonging to it, can be output with the IMOKIS macro (SIISHOW function). The scope of the output can be limited to the structure information only in the SHINFO parameter. The output can be sent to SYSOUT, SYSLST or a file.
The layout the output corresponds to 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 example on "Example with masks from the main menu ").
Macro | Operand | ||||||||||||||||||||||
IMOKIS |
|
See the “Macro forms” section on "Macro syntax " for descriptions of the MF, PREFIX, MACID and PARAM parameters.
FUNCT =*SIISHOW SYSSII =X’40’ =<c-string 1..54> =<var: char:55> | Specifies the desired function. Output the contents of a SYSSII file. Name of the SYSSII file. No specification. Explicit specification of the SYSSII file name. Symbolic address containing the name of the SYSSII file. May not be specified together with MF=L. |
SHINFO =*ALL | Determines the scope of the information to be output. All information (including the attributes, dependencies, parameter text and comments) on the release unit and the release items belonging to it are output. |
=*MIN | Only the structure information for the release unit and the release items belonging to it are output. The output contains the name of the release unit, main version, correction state and function state as well as the corresponding release items with their function states and logical names. |
SHOOUT =*SYSLST =*SYSOUT =*FILE | Specifies the output destination. The information is output to SYSLST. The information is output to SYSOUT. The information is output to a file. The name of the file must be specified in the SHOFIL parameter. |
SHOFIL =X’40’ =<c-string 1..54> =<var: char:55> | Specifies the name of the output file (only for SHOOUT=*FILE). No specification. Explicit specification of the file name. Symbolic address containing the file name. May not be specified together with MF=L. |
OVERW =*NO =*YES | Specifies if an existing output file may be overwritten. An existing file may not be overwritten. An existing file may be overwritten. |
Parameter list
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
Programming notes
The following parameters can also be passed in the parameter list for the SIISHOW function
call:
The name of the SYSSII file in the ISHOSII field (see the SYSSII parameter).
The scope of information to be output in the ISHOSIN field (see the SHINFO parameter).
The value C’A’ is to be set to obtain the maximum scope of output (SHINFO=*ALL), and the value C’M’ is to be set to obtain a limited amount of output
(SHINFO=*MIN) .
The output destination in the ISHOOT field (see the SHOOUT parameter). The following values must 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’.
The name of the output file in the ISHOSFI field (see the SHOFIL parameter). This is ignored when the output is sent to SYSLST or SYSOUT.
The specification if an existing file is to be overwritten in the ISHOOWF field (see the OVERW parameter). 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 for the SIISHOW function in addition to the return code when a DMS error occurs.
Macro return code
(SC2) | SC1 | Maincode | Meaning |
| X’00’ | X’00’ | X’0000’ | Function successfully executed |
| X’00’ | X’01’ | X’0001’ | SYSSII filename (SYSSII parameter) invalid |
| X’00’ | X’03’ | X’0002’ | Invalid parameter list |
| X’00’ | X’01’ | X’0004’ | Output destination invalid (SHOOUT parameter) |
| X’00’ | X’01’ | X’0005’ | Name of the output file invalid (SHOFIL parameter) |
| X’00’ | X’01’ | X’0007’ | Function (FUNCT parameter) invalid |
| X’00’ | X’40’ | X’0014’ | SYSSII file (SYSSII parameter) in the wrong format |
| X’00’ | X’40’ | X’0015’ | DMS error |
| X’00’ | X’40’ | X’0017’ | DMS error while writing to the output file (SHOFIL parameter) |
| X’00’ | X’40’ | X’0018’ | Output file (SHOFIL parameter) already exists |
| X’00’ | X’20’ | X’0100’ | System error |
| X’00’ | X’20’ | X’0101’ | Internal error |