The IMOSHSU macro enables you to view information on the supply units contained in the standard SCI, see "Supply unit ".
Possible inputs are the supply units of a SOLIS2 delivery 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 supply units” in the
menu mode auf "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.
This macro requires the SUBSYSTEM-MANAGEMENT privilege.
Macro | Operands | ||||||||||||||||||||||||||||||||
IMOSHSU |
|
Operands
The MF, PREFIX, MACID, and PARAM parameters are described in “Macro forms” on
UTYPE | |
Input mode used to select supply units. | |
=*UNIT | |
| Select supply units by UNAME, UVERS and UCORSTA | |
=*ALL | |
| Select all supply units of the SCI. | |
=*DIALOG | |
| The supply units are selected interactively (see also “Selection of supply units” in the menu mode on "View menu "). | |
=*FILE | |
Take the supply unit from a formatted file (INFF). | |
| UNAME | |
| Name of the supply unit to be shown. | |
=<c-string: 1..30> | |
| Name of the supply unit. | |
=<var: char:30> | |
Symbolic address containing the specification for the name of the supply unit. | |
UVERS | |
Version of the supply unit. | |
=*ALL | |
| Select all version designations of the supply unit. | |
=*HIGH | |
| Select the highest version designation of the supply 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 supply unit. | |
UCORSTA | |
Correction state of the supply unit. | |
=*ALL | |
| Select all correction states of the supply unit. | |
=*HIGH | |
| Select the highest correction state of the supply unit. | |
=*LOW | |
| Select the lowest correction state of the supply unit. | |
=<c-string: 1..3> | |
| Specifies the correction state of the supply unit. Format: <aso>. | |
=<var: char:3> | |
| Symbolic address containing the specification for the correction state of the supply 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. | |
| INSUNIT | |
| Show/do not show the installation units. | |
=*YES | |
| Show the installation units. | |
=*NO | |
| Do not show the installation units. | |
| REPLEV | |
| Reporting level for supply unit attributes. | |
=*MINIMUM | |
| Show the names of the supply units only. If the delivery is a delta delivery, show only the supplied installation unit. | |
=*ALL | |
Show the names of the supply units for each correction state. If the delivery is a delta delivery, show only the supplied installation unit. | |
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 used. | |
=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, 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‘00‘ | X‘40‘ | X‘001A‘ | No SUBSYSTEM-MANAGEMENT privilege |
| 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.