Defining Sites

A site specifies target information for a promotion process or an install process. A site may be local or remote.

Site	Description
**Local Site	A target that is on the same LPAR as the development ChangeMan ZMF instance. A target on a different LPAR from the ChangeMan ZMF instance can be defined as a local site if it shares DASD and catalogs with the ChangeMan ZMF development LPAR, and no Db2 binds are required.
**Remote Site	A target that is on a different LPAR than the development ChangeMan ZMF instance that does not share DASD and catalogs, or that requires Db2 binds.

You must define a site for each production ChangeMan ZMF environment that is a target for installs. Every promotion level definition must be associated with a site.

Perform the following steps to define a site:

On the Global Administration Options menu (CMNGAMN1), select Option 6. The Global Site List Part 1 of 2 panel (CMNGRST1) is displayed.

The first time you access this panel to define global sites, the panel is empty. This is an example of the panel after sites are entered.

CMNGRST1             Global Site List Part 1 of 2          Row 1 to 2 of 2 
Command ===> ____________________________________________ Scroll ===> CSR

    Site Name Order 
___    C001       0 
___    C002       0
**************************** Bottom of data *******************************

The following table describes the fields on the Global Site List Part 1 of 2 panel.

Field	Description
Line command	Type a line command to the left of a panel row. S - Select to see the next panel for this site name. I - Insert a blank site name row. R - Repeat an existing site name row. D - Delete an existing site name row.
Site name	Enter all production sites where ChangeMan ZMF is installed. The sites are displayed to the user during creating, updating or querying a change package.
Order	Enter a number to determine the order in which this list is displayed to users by default. Valid values are 0 to 65535. The display order option must be enabled in global parameters for the display order number to take effect.

The order of site names on the Global Site List Part 1 of 2 panel (CMNGRST1) is not significant.

Type S in the line command field for the site and press Enter.

If the ChangeMan ZMF instance you are using to make this update is DP (Development/Production) environment, the Site Information Part 2 of 2 panel (CMNGRST2)is displayed.

CMNGRST2          C001 Site Information - Part 2 of 2
Command ===> ____________________________________________

ChangeMan ZMF subsytem id . . 7 
Logical unit name . . . . . . SYSA                                 +   
JES node name . . . . . . . . Q001 
Management class  . . . . . . (Blank for default management class)   
Storage class . . . . . . . . (Blank for default storage class)   
Default unit name . . . . . . SYSDA (Generic disk unit) 
Default volume serial . . . . 
ChangeMan ZMF delay file  . . CMNTP.S7.CMNDELAY   
Ser#parm  . . . . . . . . . . CMNTP.SER820.S7.TCPIPORT   
Prd staging model dsname  . . CMNTP.S7.????.STG7.#######   
Prd staging model zFS . . . . /cmntp/s7/????/stge/#######/u        + 
Transmission vehicle  . . . . IEBCOPY (IEBCOPY or Other) 
Time difference . . . . . . . +0000 (+/- HHMM) 
IP address or DNS name . . . .                                     + 
Port . . . . . . . . . . . . . 

Site job statement information: 
    //CMNSTART JOB ,'ACCOUNT INFO', 
    // CLASS=A,MSGCLASS=X   
    //* JOB CARD FROM GLBL SITE INFO - PART 2 OF 2   
    //* SITE C001 JOB STATEMENTS

The following table describes the fields on these panels.

Field	Description
ChangeMan ZMF subsystem id	Type the subsystem ID of the target ZMF instance for this site. Not required in an A environment, and not displayed on the panel.
Logical unit name	Type the LOGICAL UNIT OR SYSTEM NAME used in Global Administration Parameters. NOTE: The Logical Unit Name for remote site definitions is 256 characters. However, delivered ZMF skeleton coding for DMBATCH SYSIN input effectively limits the usable length to 63 characters. Skeleton customization can expand the SYSIN input to more than 63 characters.
JES node name	If you are defining a remote site, type the logical unit or system name (SMF ID) that is used by your transmission software to locate the target site.
Management class	Enter the management class for SMS managed dataset allocation. Leave blank for default class.
Storage class	Enter the storage class for SMS managed dataset allocation. Leave blank for default class.
Default unit name	Type the generic device name for DASD where staging libraries, install JCL libraries, and other package distribution data sets are dynamically allocated. This field is optional if the Default Volume Serial field is used.
Default volume serial	Type the DASD volume serial number where staging libraries, install JCL libraries, and other package distribution data sets are dynamically allocated. This field is optional if Default Unit Name field is used. This field is required if the Default Unit Name field is blank.
ChangeMan ZMF delay file	Type the fully qualified data set name (no quotes) for the VSAM Delay file at the target site. (Not applicable for A environments.)
Ser#parm	Enter the fully-qualified dataset name for the SER#PARM data set for installs (apostrophes not needed). (Not applicable for A environments.)
Prd staging model dsname	Enter the model dataset name for staging libraries in the site environment. Four question marks (????) in the dataset name will be replaced with the appropriate application mnemonic. Seven pound signs (#######) will be replaced with the change package number. This identifies the libraries for each site to the development site. For rules for coding a staging model path name, see the field description for ’Staging Library Model Dataset Name’ on Global Parameters - part 7 of 8 panel (CMNGGP07).
Prd staging model zFS	Enter the model zFS directory for staging libraries in the site environment. Four question marks (????) in the zFS file name will be replaced with the appropriate application mnemonic. Seven pound signs (#######) will be replaced with the change package number. This identifies the zFS directory for each site to the development site.
Transmission vehicle	Select the data transmission vehicle ChangeMan ZMF will use to transmit messages, change packages, and other data between the development system and the other sites. This variable will be used in file tailoring of site promote and install jobs. Type IEBCOPY if you are defining a local site and shared DASD. Type OTHER if you are defining a remote site and the transmission vehicle is XCOM, BDT, etc. This will require skeleton file tailoring of the site promote and install jobs.
Time difference	The time difference parameter is used to verify that the package install date and time that you enter when you create a package is a time that has not already passed at a remote site. Enter the time difference between the site you are working on and the development site where change packages are created. Enter the hours and minutes in the form +HHMM if the site time is ahead (east) of the development site or -HHMM if the site time is behind (west) the development site. The default time difference is +0000.
IP address or DNS name	Type a dotted decimal IP address or a text DNS up to 16 characters long if you are defining a site that is a P instance or another DP instance. IP ADDRESS OR DNS NAME is required to initiate package backout and revert for P instances from the D or DP site where the package originated. As a simple rule, always make an entry in this field when it appears on a global site definition panel. NOTE: IP ADDRESS OR DNS NAME and PORT on this panel are not used by SERNET to create the #SERx member in the SER#PARM library. SERNET uses the location of the started task and specified SERNET keyword options to build the SER#PARM member.
Port	Enter the port number of the remote site started task for remote connection to this site if you made an entry in the IP ADDRESS OR DNS NAME field. As a simple rule, always make an entry in this field when it appears on a global site definition panel.
Site job statement information	Enter up to 4 lines of standard valid job card information. ChangeMan ZMF will overlay the JOB name you specify with the JOB name it submits for install jobs.

...

When you finish updating fields on the Site Information Part 2 of 2 panel, press Enter to return to the Global Site List Part 1 of 2 panel.
When you finish updating site information on the Global Site List Part 1 of 2 panel, press PF3 or type End and press Enter to store the site definitions in the ChangeMan ZMF package master file.

Note

If you want to use a DP environment like an A (ALL) environment without defining production libraries:
1. Define a Global Site (=A.G.6) with:
a. Site Name that is the same as the Site Node Name in Global Parameters, and...
b. Logical Unit Name that is the same as the Logical Unit Or System Name in Global Parameters.
2. Define this site as the only site in each application in Application Administration (=A.A.8).
3. Define each baseline library type with Install In Prod set to N in every application in Application Administration (=A.A.B).
With this configuration, several jobs are executed at package installation that perform no function other than to record completion in the package master and/or trigger submission of the next installation job.