MKS Implementer 2006 Administration Guide

Object Version Stamping
number to the right of the decimal increments by one. When promoted to production, the
number to the left of the decimal increments by one and the number to the right of the
decimal resets to zero.
NOTE Promoting without locks causes the version number to increment only when
the object is promoted to a *PRD environment.
Scenario Example
Object A in *PRD environment is version 2.0. Object A is checked out to *TST
environment. Object A in *PRD is still 2.0. Object A in *TST is version 2.1.
Object A version 2.1 is promoted to *QAC environment.
Object A is concurrently checked out to *TST environment, making it version 2.2.
Object A in *PRD is still version 2.0. Object A in *QAC is still version 2.1.
Object A version 2.2 is promoted to *QAC environment. Object A now has two lock
records in the *QAC environment—one is version 2.1 and the other is version 2.2.
Object A version 2.2 in *QAC is promoted to *PRD. Object A in *PRD environment is
now version 3.0.
Method 3: User-Defined Version
You can define a program with a versioning scheme of up to 30 characters, which is the
length of the Revision field that displays on various panels in Implementer. However,
because the field updated in the actual object description is only seven characters long, only
the first seven characters of the version number are recorded in the object’s description. Thus,
to update the object description parameter on the actual object, define your program with a
number scheme of seven characters or less. To apply object versioning without actual object
stamping, the versioning scheme can be up to 30 characters.
The versioning program must exist in the same library on all host and remote systems. If the
program references objects, for example, files or data areas, the library containing the objects
must be in the user’s interactive library list and in the library list of the Implementer job
description MWIJOBD.
Define your versioning program with an entry parameter group as described next.
Parameter Length Description
Description 512, alpha Data passed into the versioning program. See format
requirements in the next table.
Version Number 30, alpha Parameter the version number is returned in.
Return Value 10, alpha Returns blanks if no errors occur. If a value is returned, the
version number is ignored.
149