The IMOSHIU macro enables you to view information about the installation units contained in the standard SCI, see "Installation unit (IU) ".
Possible inputs are an installation unit or a formatted file generated beforehand with the SHOW functions of IMON. You also have the option of selecting installation units interactively in interactive mode (see also “Selection of installation units” in the menu mode on "View menu ").
The output is directed to SYSOUT, to SYSLST, to the formatted file specified during input, or to another formatted file that can be generated, extended or overwritten.
If you are a nonprivileged user, this macro will show only the installation units to which nonprivileged DMS access is possible (i.e. no TPR installation units).
Macro | Operands | ||||||||||||||||||||||||||||||
IMOSHIU |
|
Operands
The MF, PREFIX, MACID, and PARAM parameters are described in “Macro forms” on "Macro syntax ".
UTYPE | |
Input mode used to select installation units. | |
=*UNIT | |
| Select installation units by UNAME, UVERS and UCORSTA | |
=*ALL | |
| Select all installation units of the SCI. | |
=*DIALOG | |
| The installation units will be selected interactively (see also “Selection of installation units” in the menu mode on "View menu "). | |
=*FILE | |
Select the installation units from a formatted file (INFF). | |
| UNAME | |
| Name of the installation unit. | |
=<c-string: 1..30> | |
| Specification of the name of the installation unit. | |
=<var: char:30> | |
Symbolic address containing the specification for the name of the installation unit. | |
UVERS | |
Version of the installation unit. | |
=*ALL | |
| Select all versions of the installation unit. | |
=*HIGH | |
| Select the highest version of the installation unit. | |
=<c-string: 3..5> | |
| Specifies the version of the installation unit. | |
=<var: char:5> | |
| Symbolic address containing the specification for the version of the installation unit. | |
UCORSTA | |
Correction state of the installation unit. | |
=*ALL | |
| Select all correction states of the installation unit. | |
=*HIGH | |
| Select the highest correction state of the installation unit. | |
=*LOW | |
| Select the lowest correction state of the installation unit. | |
=<c-string: 3..3> | |
| Specification of the correction state of the installation unit. Format: <aso>. | |
=<var: char:3> | |
Symbolic address containing the specification for the correction state of the installation unit. | |
INFF | |
Name of the formatted file to be used as input. | |
=<c-string: 1..54> | |
| Name of the formatted file. | |
=<var: char:54> | |
Symbolic address containing the name of the formatted file. | |
| INSITEM | |
| Show/do not show installation items. | |
=*YES | |
| Show installation items. | |
=*NO | |
| Do not show installation items. | |
REPLEV | |
| Reporting level for installation unit attributes. | |
=*MINIMUM | |
| Show the names of the installation units only. | |
=*ALL | |
| Show the names and attributes of the installation items. | |
OUTTYPE | |
| The target for output. | |
=*SYSOUT | |
| Output the information to SYSOUT. | |
=*INFILE | |
| Output the information to the formatted file used as input. | |
=*FILE | |
| Output the information to a formatted file (OUTNAME). | |
=*SYSLST | |
| Output the information to SYSLST. | |
OUTNAME | |
| Name of the formatted file to be used as output. | |
=<c-string: 1..54> | |
| Name of the formatted file. | |
=<var: char:54> | |
Symbolic address containing the name of the formatted file. | |
WRMODE | |
| Overwrite or extend the file. | |
=*REPLACE | |
| Generate the formatted file or overwrite an existing file. | |
=*EXTEND | |
| Generate the formatted file or extend an existing file. | |
SYSLST# | |
| SYSLST number. | |
=0 | |
| Output the information to standard SYSLST. | |
=<integer 1..99> | |
| Specifies the SYSLST number. | |
=<var: int:1> | |
| Symbolic address containing the specification for the SYSLST number. | |
Macro return codes
| (SC2) | SC1 | Maincode | Meaning |
| X‘00‘ | X‘00‘ | X‘0000‘ | Function successfully executed |
| X‘00‘ | X‘01‘ | X‘0001‘ | Function not permitted in batch mode |
| X‘00‘ | X‘01‘ | X‘0002‘ | Output invalid |
| X‘00‘ | X‘01‘ | X‘0003‘ | SYSLST number invalid |
| X‘00‘ | X‘01‘ | X‘0004‘ | Parameter list invalid |
| X‘00‘ | X‘40‘ | X‘0013‘ | Cannot access the SCI, function not executed |
| X‘00‘ | X‘40‘ | X‘0014‘ | Specified unit not found in the SCI, function not executed, no formatted file created |
| X‘00‘ | X‘40‘ | X‘0015‘ | Error accessing input file (library element), function not executed |
| X‘00‘ | X‘40‘ | X‘0016‘ | Error accessing output file, function not executed |
| X‘00‘ | X‘40‘ | X‘0017‘ | Information missing. Units contained in the formatted file (UTYPE=*FILE) not present in the SCI. |
| X‘00‘ | X‘40‘ | X‘0019‘ | SHOW output written to SYSLST only partially or not at all |
| X‘20‘ | X‘0100‘ | System error | |
| X‘20‘ | X‘0101‘ | Internal error | |
| X’00’ | X’01’ | X’FFFF’ | Function is not supported |
| X’00’ | X’03’ | X’FFFF’ | Interface version is not supported |
| X‘03‘ | X‘00‘ | X‘0000‘ | Warning: Information output is partial, user does not have SUBSYSTEM-MANAGEMENT privilege |
| X‘03‘ | X‘40‘ | X‘0014‘ | User does not have SUBSYSTEM-MANAGEMENT privilege |
| X‘03‘ | X‘40‘ | X‘0017‘ | User does not have SUBSYSTEM-MANAGEMENT privilege |
Notes
An MNOTE is generated if:
- UTYPE =*UNIT and UNAME was not specified.
- UTYPE =*FILE and INFF was not specified.
- UTYPE =*ALL / *DIALOG and UNAME / INFF was specified.
- UTYPE =*UNIT / *ALL / *DIALOG and OUTTYPE =*INFILE.
- OUTTYPE =*FILE and OUTNAME was not specified.
- OUTTYPE =*SYSOUT and REPLEV =*ALL.
If UTYPE =*ALL / *DIALOG / *FILE is specified, the values specified for UNAME, UVERS and UCORSTA are ignored.
If OUTTYPE =*SYSOUT / *SYSLST / *INFILE is specified, the value specified for WRMODE is ignored.
If OUTTYPE =*SYSOUT / *FILE / *INFILE is specified, the value specified for SYSLST# is ignored.
The information is edited so as to be legible if the output is directed to SYSOUT or SYSLST.
If the information is directed to a formatted file, the output is compressed and is not legible for the user.
If the information in the SCI changes after the formatted file is generated, the information that is output is no longer current.