Select product version
Component: | IMON-GPN |
Functional area: | Program control |
Domain: | PROGRAM |
Privileges: | STD-PROCESSING |
Function
This command allows nonprivileged users to select the product version of an installation unit or a DSSM subsystem (TU, as of DSSM V3.5). If more than one version of this product is installed and accessible, it is possible to specify the version with which the user wishes to work. When starting the associated program or when setting up a connection to a subsystem, the selected version is used.
The following applies in the case of command calls sharing the same scope (SCOPE operand):
Only one version of a product can be selected.
If the command is executed twice with different versions of the same product as the last specified version applies.
The SHOW-SELECTED-PRODUCT-VERSION command provides information on the current version selection.
Privileged function
Systems support can use SCOPE=*SYSTEM to select the product version of an installation unit for the duration of the session.
Format
SELECT-PRODUCT-VERSION |
PRODUCT-NAME = <text 1..30 without-sep> ,VERSION = *STD / <product-version> ,SCOPE = *TASK / *PROGRAM / *SYSTEM |
Operands
PRODUCT-NAME = <text 1..30 without-sep>
Specifies the name of the software product. For subsystems loaded by DSSM this is the name of the subsystem and/or the name of the IMON installation unit. In relation to DBL, it is the name of a load unit.
VERSION =
Specifies the version of the product to be loaded. The full version need not be specified. In this case, the most suitable version is selected or, in the case of a DSSM subsystem, the exact version is selected.
VERSION = *STD
An earlier version selection is canceled. This means that the system presetting applies again (the highest version is used).
VERSION = <product-version>
Specifies the version of the software product. When loading the software the DBL uses only this version for external reference resolution.
SCOPE =
Specifies how long the selection is to apply for.
SCOPE = *TASK
The selection is valid until the end of the task.
SCOPE = *PROGRAM
The selection is valid until the end of the current or subsequent program.
SCOPE = *SYSTEM
This operand value can only be used by privileged users with the SUBSYSTEM-MANAGEMENT privilege.
The selection (installation units only) is valid throughout the system for this session (until shutdown). This setting cannot be made for DSSM subsystems.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command successfully executed | |
32 | IMO9101 | Command terminated abnormally. Internal error in IMON-GPN | |
64 | CMD0216 | Privilege error | |
64 | IMO9100 | Command not executed. Installation unit or version not found |
Notes
The command is accepted for a product and an explicitly specified version in the following two cases:
The product name is registered as an installation unit in the SCI: in this case, the version that is explicitly specified in the VERSION operand must exist.
The product name is not registered in the SCI: in this case, it must be possible to connect a corresponding DSSM subsystem. This means that the subsystem is declared in the DSSM subsystem catalog under the specified name and version and that it has been started.