Build Control
Build Control
No part of this document may be reproduced or transmitted in any form or by any means, for any purpose, without the express written permission
of TEMENOS HEADQUARTERS SA.
Table of Contents
Overview 3
Save Process 4
Release Process 5
Configuring Build Control 6
Pre-requisites 7
Steps for Configuring Build Control 8
Build Control Table 9
Pre-requisites 10
Steps for Configuring Build Control 15
[Link] 21
Using Build Control 27
Save a package 28
Release a package 29
Build Control Tool 30
Release a BCON Unit in Classic 44
2
Build Control
Overview
[Link] is a deployment tool that could be used to install Non-core T24
applications and to move packages developed locally, on-site, from one envir-
onment to another.
The basic idea is the same as [Link]. Save the details in one environment and
Release them in another. Typically, in any implementation, the developments and
configurations will be done in the Build environment and then moved to master and
UAT environments and hence the name '[Link]'
It provides the user with the facility/ability to"
l Save programs, data libraries, local ref table definitions, standard selection
descriptors and release them in another T24 environment.
l Automatic restoration of data libraries using [Link].
l Automatic authorization of restored data records using OFS.
l Release I-Descriptors.
l Update [Link] with the saved definitions.
l Compile/Catalog the programs released.
The resultant package will be saved in the path given in [Link] field, along with
an Index that will be used for Release operations.
3 Overview
Build Control
Save Process
Overview 4
Build Control
Release Process
5 Overview
Build Control
Pre-requisites
This topic specifies the pre-requisites and what needs to be generally considered to
run Build Control
Pre-requisites
System Requirements
The following are the pre-requisites for installing this package.
l T24 R13 or Above
l T24 R08 or Above
l TAFC R10 or Above
General Considerations
l When transferring object code via FTP the transport method must be set to
binary.
l When transferring data libraries via FTP the transport method must be set to
ASCII and the FTP client should be configured to preserve the case names of
the source files.
Source Codes
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
Insert Files
[Link]>I_F.[Link]
[Link]>I_F.[Link]
[Link]>I_F.[Link]
[Link]>I_F.[Link]
[Link]>I_F.[Link]
[Link]>I_F.[Link]
[Link]>I_LREF.COMMON
[Link]>I_RAPID.[Link]
[Link]>I_RAPID.[Link]
Data Records
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link].19
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
ENQUIRY>[Link]
ENQUIRY>[Link]
ENQUIRY>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
[Link]>[Link]
VERSION>BATCH,RAD
VERSION>[Link],CLOSE
VERSION>[Link],DICT
VERSION>[Link],[Link]
VERSION>[Link],[Link]
VERSION>[Link],[Link]
VERSION>[Link],MAIN
VERSION>[Link],[Link]
VERSION>[Link],PROGRAMS
VERSION>[Link],RELEASE
VERSION>[Link],[Link]
VERSION>[Link],RESULTS
VERSION>[Link],SAVE
VERSION>[Link],[Link]
VERSION>[Link],MAIN
VERSION>[Link],[Link]
VERSION>[Link],[Link]
VERSION>[Link],[Link]
VERSION>[Link],MAIN
VERSION>[Link],[Link]
VERSION>[Link],RAD
VERSION>[Link],RAD
VERSION>VERSION,RAD
Pre-Installation steps
NA
l FTP the [Link].Z to RUN directory in binary mode.
l Uncompress [Link].Z using the below command from the shell
prompt of the FTP path.
uncompress –c [Link].Z | tar –xvf
l The above command will create a directory GR0800004lib under “[Link]”
which contains all the object codes of [Link].
l Add the GR0800004lib in the JBCOBJECTLIST of the .profile as like below.
JBCOBJECTLIST=$HOME/vdflib:$HOME/GR0800004lib
l Similarly uncompress the [Link].Z to RUN directory in binary
mode.
l Uncompress [Link].Z using the below command.
uncompress –c [Link].Z | tar –xvf
l The above operation will create a directory [Link] under “[Link]”.
l Follow the Directory Creation step before installing the DL pack.
l The above operation will create the data records in IHLD status.
l Authorise the records manually which are in IHLD.
Note For TAFJ users: Provide the valid BP name to the fields
[Link] and [Link]. If [Link] is not exists since these fields
are not used by TAFJ. And also provide the above directory path which
are created for the TAFJ to the fields [Link] and
[Link].
Note: While authorising the record, system will default the field auth pri-
ority. If any of the table is not used, user can remove it from the list.
[Link]
Note: In a TAFJ environment, the sources should not be packaged within
a [Link] application. The sources must be controlled only via
the JAR files and the IDE should be used for the sources. Therefore, the
functionality of the fields 7 to 12 are now outdated and will no longer be
supported for usage on TAFJ platform.
This table is the gateway of Build Control Tool. This table is used to save and
release the [Link] pack.
Field descriptions are as follows:
22 XX<[Link]- A*- ID of Local Ref Table. Associated with the sub valued
.TABLE 15 field [Link].
23 XX- A*- ID to [Link]. Associated with the sub valued
XX<[Link]- 15 field [Link]. This field, along with TABLE ASSOC
LE records the Local Ref definition for the application spe-
cified in [Link] field. When released, this
definition will be updated in the Local Ref table for
that application and authorized using OFS.
24 XX>XX>TABLE.- A*- Sub valued field associated with [Link]
ASSOC 15
25 XX<[Link]- A*- ID to [Link]. Associated with the
ME 15 fields till [Link].41. Used to store
I -descriptor details.
77 [Link] A*- Path where [Link] will save Data Libraries. When
15 Saving, [Link] will call [Link] to save
each of the data libraries specified in the field
[Link] and then move those folders to the path
specified in [Link]. So, this path tells
[Link], where to look for the Saved data lib-
raries.
78 [Link].P- A*- Path where [Link] has to release Data Libraries.
ATH 15 When releasing, [Link] will call
[Link] and subsequently [Link] to
release & restore the data libraries. So, this path tells
[Link], where to copy the data libraries to
be released, before calling [Link]
79 [Link] A*- Operating System of the environment where this pack-
15 age was saved.
80 [Link].- A*- If set to Y and committed, the details in the fields
LOG 15 ACTIVITY, [Link] will be cleared.
81 XX<ACTIVITY A*- Multi valued field associated with [Link].
15 Updated during verification process, with the progress
of action specified – either SAVE or RELEASE.
82 XX>PROCESS.I- A*- Progress information.
NFO 50
83 [Link]- A*- Progress Error Information
OR 50
84 XX<[Link]- A*- Date and Time when the BCON saved.
E 50
85 XX. A*- T24 Release of Saved environment.
[Link]- 50
N
86 XX>[Link]- A*- T24 User who saved the Pack.
R 50
87 XX< A*- Date and Time when the BCON released.
[Link] 50
88 XX- A*- T24 Release of Released environment.
[Link]- 50
ON
89 XX> A*- T24 User who Released the Pack.
[Link] 50
91 [Link] A*- If Y is entered in this field, the user has the option to
25 enter a Flat file name and a record in that file, to be
opened as a Report.
9- RESERVED A*- Reserved Fields.
2- 25
10-
3
Save a package
Release a package
It also shows you how to release a package in the classic mode
Main Screen
1. Enter [Link], MAIN at the Command Prompt.
2. Enter the ID that you would like to give to your Build Control Package (Having
a date component will help).
3. This will open up a set of associated versions as shown below.
To save a Package
Use this screen to define the path where
l [Link] Units will be saved
l [Link] will save the data (as in ../[Link])
What Happens
l While SAVE – A new folder with the name same as the Record ID, is created
under this path and the build control unit is saved in this path (similar in func-
tion to [Link] Unit)
Programs
Use this screen to define
l [Link] where the programs/object codes ($ Files) reside,
l Selection criteria (Saved Lists should be prefixed with „SL-„ or this can be a
jQL
l statement)
What Happens
l While SAVE – A new folder with the name same as the [Link] is cre-
ated under Build Control Unit Save path and the Saved list or the Select Com-
mand is used to select the [Link] and the records are copied to the
Build Control path‟s BP folder.
l While RELEASE – The Release BP, if it doesn‟t already exist, is created in the
destination environment and the contents of the BP in Build Control unit are
copied to the Release BP. After setting JBCDEV_LIB and JBCDEV_BIN to
required values, the copied files – depending on whether they are source or
object codes, are either Compiled using [Link] or Catalogued using
CATALOG command.
DL DEFINE Units
Use this screen to
l Define the [Link] units that need to be saved as part of this package.
l Define the company from which the records defined in [Link] need to be
saved, in case there are FIN type file records.
What Happens
l While SAVE – The [Link] units are saved by invoking [Link] and
the resultant [Link] units are copied into Build Control save path.
l While RELEASE – The [Link] Units will be copied to
../[Link]/[Link] and [Link] and [Link] will
be invoked to release and restore the DL DEFINE records.
Dict Items
Use this screen to
l Define any Dictionary items – I-Descriptor definitions that need to be saved
as part of the package. (Only enter the Standard Selection ID and the I-Desc
Name. The properties will automatically be defaulted from
[Link]. Every time the Build Control is saved, these prop-
erties are refreshed automatically from [Link].)
What Happens
l SAVE – The properties – like TYPE, FIELD NO, VAL PROG and all other Stand-
ard Selection fields are saved in their corresponding fields in [Link] of
[Link].
l RELEASE – I-Descriptor name is checked in [Link] and
updated with the details from [Link]; the [Link] record is
locked, updated and written to $NAU. [Link] is used to
authorise this [Link] record and thereby rebuilding dic-
tionary.
[Link]
Use this screen to define the
l Local ref definitions for all the T24 applications that need to be part of this
package. (This Local tables should be presented in [Link])
What Happens
l While SAVE – Nothing. The definitions are validated.
l While RELEASE – based on the definitions and after ensuring that the Local
ref fields are available in [Link], the corresponding [Link]
record is updated with this definition. If the Local Ref is already attached to
the application, then the Association is overwritten with this definition.
What Happens
l While SAVE – Nothing.
l While RELEASE – A new record is locked and created in
[Link], $NAU file, on IHLD status. OFS GLOBUS MANAGER is
used to authorise that record.
l Instead of saving the [Link] record for new tables as part of
the [Link], specify the name of the table here. This proves to be helpful
when a new table is being released and an I-Descriptor also needs to be
Flat Files
Use this screen to define
l The path of flat files (Unix/NT directories – TYPE UD Files) that need to be cre-
ated when restoring this package.
What Happens
l While SAVE – Nothing
l While RELEASE – The path, folders are created and a VOC pointer is created
with ID as the last part as the ID
l In the above case, a folder in the path ../[Link]/git/[Link] will
be created and a VOC pointer will be created with ID as [Link].
Package Checklist
Use the enquiry [Link] to review the contents of the package.
l Shown below is a screen shot of this enquiry, running on a package called
TMNS000- [Link].R12.
Enquiry shows the list of Data records which are saved in the pack.
Main Screen
1. To release the pack, copy the [Link] unit to [Link]/RELEASE
directory as shown below. For Example: [Link].
If the [Link] unit contains the Object code, we should transfer the
BCON unit in Binary mode (UNIX server). If it is a NT server, the mode of
transfer does not matter.
To Release a package
Use this screen to define
1. Enter the BCON release path in the field „Release Package is Available
under‟. This release path should be same, where the [Link] Unit
has been copied over.
2. The system will default the path where the DL Units need to be copied (as in
../[Link]/[Link] or../[Link]) which may not be the same in
both Save and Release environments. Manually change the value if the sys-
tem raises an error.
3. At field input level, if the path is correct, then the system will load the remain-
ing fields based on the index file BCON_TMNS000-[Link] stored under
the release path.
4. Once validated the record, system will automatically populate the remaining
fields based on the Index file BCON_TMNS000-[Link] as shown below.
5. In the Release tab, in the field „OFS Source to be used for Authorising‟ enter
the ID of the [Link] to be used for authorising the records. At this field
input, the system will default Authorisation Priority. The user can amend this
priority as applicable.
[Link]
l With this action, [Link] releases all programs that are part of the
DL Units specified in the multi-valued field [Link].
l Saving and Releasing Programs, works exactly the same way as RELEASE. To
release a program, the ACTION could be set to [Link] or RELEASE.
l If the field [Link] is NULL, then programs will not be Com-
piled/Catalogued.
[Link]
l With this action, [Link] restores all the data records part of the DL
Units specified in the multi-valued field [Link].
l Since the sample [Link] unit [Link] also con-
tains data records, it can be used for testing [Link] alone.
l When the ACTION is set to RELEASE, [Link] automatically copies
the DL Units from [Link]/RELEASE to the DL Restore path (as in,
[Link]/[Link]), and then uses [Link] & [Link] to
release & restore those records.
l However, when the Action is set to [Link], the system assumes that the
required DL Units are already present in the DL Restore path (as in
[Link]/[Link] or ../[Link]). The user has to move the DL Units
manually under the DL Restore path before setting the Action to [Link]
[Link]
l With this action, [Link] authorises all the data records part of DL
Units specified in the multi-valued field [Link]
l Since the sample [Link] unit [Link] also con-
tains data records, it can be used for testing [Link] alone.
l This will enable Authorisation of Restored records. However, when Action is
set to [Link], the system assumes that the records have already
been restored and will only attempt to authorise them.
l Give the Description, Mnemonic, Action and Release path as shown below.
l Now the system will ask to reload the package. Press „Y‟ and enter. Now the
system should be reloaded the [Link] unit based on the index file.
l Now the system will restore the records and object codes which are packed in
the BCON unit.
l Once the Restoration processed successfully, system will ask for a sign out.
Now sign out the JBase session and re login to the new session.
l Verify the same BCON unit record in the new session as shown below.
l Now the Data records will be authorised automatically using the Build control
tool.
l Then check the session, whether all the data records are authorised suc-
cessfully.