GETPROV returns the version selected beforehand for a product with a particular scope.
A product can be either a DSSM subsystem (TU) or an installation unit of IMON.
Macro | Operands | ||||||||||||||||
GETPROV |
|
The MF, PREFIX, MACID, and PARAM parameters are described in “Macro forms” on "Macro syntax ".
CALLER | |
Defines the type of system call if MF = E. | |
=USER | |
| System call via SVC for nonprivileged caller (TU). | |
=SYSTEM | |
| Direct system call for privileged caller (TPR). | |
PRODNAM | |
| Name of the product, see "Supply unit ". | |
=<c-string1..30> | |
| Explicit specification of the product name. | |
=<var: char:30> | |
| Symbolic address containing the specification for the name of the product. May not be specified with MF=L. | |
EXSTCHK | |
Determines whether the existence of the product is checked. | |
=*YES | |
| A check is performed as to whether the product exists. | |
=*NO | |
| No check is performed as to whether the product exists. | |
Output operands
Data field <prefix><macid>PRGV
This is the output data field for the version selected for a product with scope PROGRAM.
Data field <prefix><macid>TSKV
This is the output data field for the version selected for a product with scope TASK.
Data field <prefix><macid>SYSV
This is the output data field for the version selected for a product with scope SYSTEM.
Macro return codes
| (SC2) | SC1 | Maincode | Meaning |
| X‘00‘ | X‘00‘ | X‘0000‘ | Function successfully executed |
| X‘00‘ | X‘01‘ | X‘0001‘ | Name of product invalid |
| X‘00‘ | X‘01‘ | X‘0008‘ | Illegal use of fields reserved for the parameter area |
| X‘00‘ | X‘40‘ | X‘0011‘ | Product not found |
| X‘00‘ | X‘20‘ | X‘00FF‘ | DMS error in SCI access |
| X’00’ | X‘20‘ | X‘0100‘ | System error |
| X’00’ | X‘20‘ | X‘0101‘ | Internal error |
Notes
No information is available, the version output contains only blanks.
EXSTCHK=*NO must be specified if a high level of performance is required or if the caller is DSSM.