Lock product version
Component: | IMON-GPN |
Functional area: | System control and optimization |
Domain: | SYSTEM-MANAGEMENT |
Privileges: | SUBSYSTEM-MANAGEMENT |
Function
Systems support can use the LOCK-PRODUCT-VERSION command to lock the product version of an installation unit. The product version is then no longer available for nonprivileged users. The locked product version remains available for privileged users, (SUBSYSTEM-MANAGEMENT privilege) provided that the version is specified in the form <product-version mandatory-man-corr>.
Locking a product version may also affect the product’s START command: if the START command is called with VERSION=*STD then the highest unlocked version is invoked.
The command cannot be executed unless product installation items are entered into the SCI. This requirement is satisfied in the following cases:
The product was supplied as standard software by Fujitsu Technology Solutions using the SOLIS2 shipment procedure and was correctly installed in the system using IMON.
The product takes the form of customer-specific software which was registered in the SCI using an in-house SYSSII file (see the “IMON” User Guide [19]).
A product version lock cannot extend beyond the current system run at the latest. It is released on the following system start. A lock is also set during product installation. The UNLOCK-PRODUCT-VERSION command can also be used to release the lock during the current system run.
Format
LOCK-PRODUCT-VERSION | ||||||||||||
| ||||||||||||
Operands
PRODUCT-NAME = <text 1..30 without-sep>(...)
Specifies the name of the IMON installation unit for the software product that is to be locked.
VERSION = <product-version mandatory-man-corr>
Specifies the product version. The specification must include the release version and correction status.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed successfully | |
32 | IMO9101 | Command terminated abnormally (system error in external call; internal error in IMON-GPN) | |
64 | CMD0216 | Privileges error | |
64 | IMO9100 | Product or version not found, invalid product name |