SELPROV enables you to select the product version of an installation unit or DSSM subsystem (TU, DSSM V3.5 and higher). If multiple versions of this product are installed and accessible, you can define the version that the user will access. The version defined here is selected when the program starts or when the link is made to a subsystem.
Macro | Operands | ||||||||||||||||
SELPROV |
|
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. | |
PRODVER | |
Defines the version of the product to be loaded. Partially qualified entries are permissible: the highest matching version or (DSSM subsystem) the matching version is selected. | |
=*STD | |
Undo a version selection and enable the system default (the highest version is used). | |
=<c-string 4..7> | |
Explicit specification of the product version. | |
=<var: char:7> | |
| Symbolic address containing the specification for the product version. May not be specified with MF=L. | |
SCOPE | |
Time for which the selection is valid. | |
=*PROGRAM | |
| The selection is valid until the current or subsequent program is terminated. | |
=*TASK | |
Selection is valid until the task is terminated. | |
| =*SYSTEM | |
Selection is valid system-wide for this system session (until shutdown). This operand can be used for the functional level TPR only by a user with the SUBSYSTEM-MANAGEMENT privilege . | |
=<var: enum-of scope:1> | |
| Name of the field together with the period of validity. | |
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‘0002‘ | Product version invalid |
| X‘00‘ | X‘01‘ | X‘0005‘ | SCOPE 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‘40‘ | X‘0012‘ | No matching version available |
| X‘03‘ | X‘40‘ | X‘0012‘ | Access to specified version illegal |
| X‘00‘ | X‘40‘ | X‘0015‘ | User without SUBSYSTEM-MANAGEMENT privilege |
| X‘00‘ | X‘40‘ | X‘0019‘ | No version can be selected for the specified product |
| X’00’ | X’40’ | X’001D | DSSM subsystem cannot be connected. |
| X’00’ | X’40’ | X’001F | Version cannot be selected using DSSM. |
| 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
If a version is specified for PROGRAM and for TASK or SYSTEM, the PROGRAM specification is preemptive.
Only one version can be selected for a product. If the macro is executed twice for a product with different versions, the most recent selection is valid.
Selection with SCOPE=*SYSTEM is valid only until shutdown. The selection must be repeated in a new system session.
As a non privileged user, this macro shows you only those installation items of the TU functional status (see the section "Attributes of an installation unit" (Installation unit (IU) )).