GetMultiTierPackageInfo

Multi Tier Deployment

Minor Business Rule

Object Name: B98826

Parent DLL: CINSTALL

Location: Client

Language: C

This is my new text. It should be gone after I run spec merge.

Data Structure

D98826 - Multi Tier Deployment

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szMachineUBERunsOn	MKEY	char	OPT	NONE
The Location or Machine Key indicates the name of the machine on the network (server or workstation).
szUBEMachineLocation	LOCAT	char	OPT	NONE
The name of the deployment location.
szPackageName	PKGNAME	char	OPT	NONE
A package describes where on the server to find the components you want to deploy to workstations. There are three package types: Full: Contains the full suite of system applications (all specifications). Partial: A minimum configuration of the system. This package type allows users to load the desired applications at run-time rather than initially installing all applications. Update: System objects contained in this type of package are loaded after the workstation receives the package and the user signs on to the system. If the update package includes objects without the corresponding specifications, old versions of the application are deleted from the workstation and replaced by the current version the next time the user accesses that application. Update packages are always deployed on the date and time specified by the system administrator.
szCodePathF98825	PATHCD	char	OPT	NONE
The path code is a pointer to a set of OneWorld objects, and is used to keep track of sets of objects and their locations within OneWorld.
szMachineFromF98825	MKEY	char	OPT	NONE
The Location or Machine Key indicates the name of the machine on the network (server or workstation).
cPrimaryDepServerUBE	DEPSRVPRM	char	OPT	NONE
This field specifies whether a deployment server is the primary deployment server for a specific location.
szParentLocation	PARLOC	char	OPT	NONE
The name of the parent location.
mnNumericParameter	PARMSCHNUM	MATH_NUMERIC	OPT	NONE
Stores the value to pass when the parameter for a scheduled job is numeric.
szDeploymentServername	DEPSRVNM	char	OPT	NONE
The name of the specific server that is being used for deployment.
mnSystemStatus	PARMSCHNUM	MATH_NUMERIC	OPT	NONE
Stores the value to pass when the parameter for a scheduled job is numeric.
mnDataStatus	PARMSCHNUM	MATH_NUMERIC	OPT	NONE
Stores the value to pass when the parameter for a scheduled job is numeric.
mnHelpStatus	PARMSCHNUM	MATH_NUMERIC	OPT	NONE
Stores the value to pass when the parameter for a scheduled job is numeric.
mnComponentStatus	PARMSCHNUM	MATH_NUMERIC	OPT	NONE
Stores the value to pass when the parameter for a scheduled job is numeric.
jdObjectDeploymentDate	DEPLDATE	JDEDATE	OPT	NONE
Date to deploy updated objects to the listed machine.
mnObjectDeploymentTime	DEPLTIME	MATH_NUMERIC	OPT	NONE
Time to deploy updated objects to the listed machine.

Related Functions

None

Related Tables

F9603 Software Package Header
F9631 Software Package Detail
F9650 Machine Master
F9651 Machine Detail

GetOSVersion

Multi Tier Deployment

Minor Business Rule

Object Name: B98826

Parent DLL: CINSTALL

Location: Client

Language: C

Data Structure

D98826C - GetOSVersion data structure

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szDatabasePath	DATP	char	REQ	NONE
The name that identifies the data source.
szOSVersion	OSVERSION	char	OPT	NONE

Related Functions

None

Related Tables

F9603 Software Package Header
F9631 Software Package Detail
F9650 Machine Master
F9651 Machine Detail

VerifyBuildForServer

Multi Tier Deployment

Minor Business Rule

Object Name: B98826

Parent DLL: CINSTALL

Location: Client

Language: C

Functional Description

Purpose
When a package is being deployed to a Deployment server it is possible that not all of the server
builds in that package apply or are relevant for that Deployment server.  By relevant it is meant that
for instance a package might have been built for the AS400 and the HP9000 but the particular deployment
server that it is being deployed to does not have an AS400 as part of it's children.  Therefore the
AS400 build for that package should not be deployed to that deployment server.  This function will be
used when displaying available builds in a package that can be deployed to the server, so only those
that are valid are allowed to be selected.

Setup Notes and Prerequisites

Special Logic

Technical Specification
2.1Parameters:
Data Item Data Structure DescriptionI/ORequiredNotes
MKEYDeploymentServerNameIYThe name of the Deployment Server
DATPServerNameIYThe name of the server the build was  For
LOCATSourceLocationIYThe location of the source deployment server
EV01AllowedOYWhether or not the server is valid for the Deployment Server

2.2Related Tables
Table Table Description
F98611Data Source Master
F9650Machine Master
F9654Locations

2.3Related Business Functions
Source NameFunction Name

2.4Processing

1.Determine if the ServerName passed in is a valid Server for the DeploymentServerName that is passed in.

a)Get the host type of ServerName

i.Get SRVR from F98611using value of DATP as a key.
ii.Get HSTTYP from F9650 using MKEY (assign value of SRVR) and USAGE equal '20' as a key.

b)Get the location of DeploymentServerName (this is the destination deployment server) from F9650 using MKEY equal
DeploymentServerName and USAGE equal '15' as a key.
c)Qstore (MMLOCAT)
d)Store MMLOCAT
e)If the location of the source deployment server is equal to location in location array:

i.Fetch from F9650 where USAGE equal '20', HSTTYP equal HSTTYP of ServerName, LOCAT equal stored location and DEPSRVNM equal
DeploymentServerName.
ii.If rows found, return 1 in the Allowed parameter
iii.Else return 0 in the Allowed parameter

a)Else

i)Fetch from F9650 where USAGE equal '20', HSTTYP equal HSTTYP of ServerName and MMLOCAT equal stored location
ii)If rows found, return 1 in the Allowed parameter
iii)While (qretrieve)

(1)Store location retreived from queue in tempLoc
(2)Select Keyed from F9654 where PARLOC equal tempLoc
(3)While (fetch from F9654 successful)

(a)TempLoc = DLLOCAT (location from F9654 fetch)
(b)Qstore (tempLoc)
(c)Fetch from F9650 where USAGE equal '20', HSTTYP equal HSTTYP of ServerName and MMLOCAT equal tempLoc.
(d)If rows found, return 1 in the Allowed parameter
(e)END

(4)END

Data Structure

D98826A - Validate Build for Server Data Structure

Parameter Name Data Item Data Type Req/Opt I/O/Both

szMachineKey MKEY char REQ INPUT

The Location or Machine Key indicates the name of the machine on the network (server or workstation).

szDatabasePath DATP char REQ INPUT

The name that identifies the data source.

cReturnCode EV01 char REQ OUTPUT

An option that specifies the type of processing for an event.

Related Functions

None

Related Tables

F9603 Software Package Header

F9631 Software Package Detail

F9650 Machine Master

F9651 Machine Detail

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szMachineKey	MKEY	char	REQ	INPUT
The Location or Machine Key indicates the name of the machine on the network (server or workstation).
szDatabasePath	DATP	char	REQ	INPUT
The name that identifies the data source.
cReturnCode	EV01	char	REQ	OUTPUT
An option that specifies the type of processing for an event.