Installing the Instrumentation Server

To use either the Instrumentation Server or Instrumentation Server ERRORONLY, create a separate address space.

About this task

The sole responsibility of this address space is to act as the Instrumentation Server manager. Do not use this separate IS address space to run any client transactions other than IBM Data Virtualization Manager for z/OS Administrator functions. Use job AVZGNSIS located in the hlq.SAVZCNTL data set to help in performing the following steps 1 and 2. To install IS and IS ERRORONLY, take the following steps:

Procedure

Create a new VSAM data set for the Instrumentation Server address space.
Increase the size of the Trace Browse data set to a minimum of 1750 cylinders for a 3390 device. This enables up to one million lines of tracing to be maintained in a single viewable Trace Browse.

Use job AVZGNSIS located in the hlq.SAVZCNTL data set to copy the following data sets:

hlq.ATH.SAVZEXEC
hlq.CMD.SAVZEXEC
hlq.EXC.SAVZEXEC
hlq.GLV.SAVZEXEC
hlq.PUB.SAVZEXEC
hlq.RPC.SAVZEXEC
hlq.SQL.SAVZEXEC
hlq.TOD.SAVZEXEC

Create a new startup JCL procedure for the Instrumentation Server address space. The AVZS member of the hlq.SAVZCNTL library contains sample JCL procedures for running the main address space (started task) as an Instrumentation Server address space.
Add the AVZS PROC to the SYS1.PROCLIB or to another procedure library. You can change the name of the procedure to reflect the Instrumentation Server, and you can change the SSID parameter in the startup procedure to reflect another valid subsystem name.
Define the new started task to the security product.
Depending on the communication protocol that you use, obtain or define a new TCP/IP port or VTAM application ID.
Create a new Data Virtualization Manager configuration member for the Instrumentation Server address space. The Data Virtualization Manager configuration member is a REXX program that is used to set product parameters. A sample Data Virtualization Manager configuration member, AVZSIN00, is shipped with the product and can be customized to configure your Instrumentation Server address space. If you use a IBM Data Virtualization Manager for z/OS subsystem name other than AVZS for Instrumentation Server, be sure to rename this member to include the first four characters of the subsystem name.
The sample AVZSIN00 contains only the required parameters for the Instrumentation Server. Make the following changes to the SIS AVZSIN00 configuration member:
1. Define the TCP/IP Port number to be used.
2. Set up the SEF data sets.
3. Set up the data set definitions.
4. Update the BROWSEMAX parameter to match the desired size of the retained Trace Browse. You need 175 cylinders per 100000 Trace Browse messages.
5. Define the Instrumentation Server parameters, as follows:
  - Use the MODIFY PARM command to set the following parameter that is located in the Data Virtualization Manager configuration member, AVZSIN00:
    “MODIFY PARM NAME(SIS/XCF) VALUE(YES)”
  - For each Data Virtualization Manager server you connect to the Instrumentation Server, add the following DEFINE statement that is located in the AVZSIN00 configuration member:
```
DEFINE SISXCF
  “CONNID(SYS1AVZS)”,
  “SISID(AVZS)”,
  “SISXCFGRP(SISAVZS)”,
  “ERRORONLY(YES)”, (for SIS ERRORONLY server)
  “MANAGER(NO)”
```
6. Make the following changes to each Data Virtualization Manager configuration member, AVZSIN00 that is connected to and sending Trace Browse messages to the Instrumentation Server. Use the MODIFY PARM command to set the following parameter:
```
“MODIFY PARM NAME(SIS/XCF)VALUE(YES)”
```
  Note: Only one Data Virtualization Manager server can send data on a particular SISID-SISXCFGRP pair to an Instrumentation Server manager. This combination must be unique in the sysplex. For the Instrumentation Server manager, the CONNID must be unique in that Data Virtualization Manager server.
Create a AVZSINEF member in the SYSEXEC concatenation, where AVZS refers to the new Instrumentation Server subsystem name you are creating. A sample AVZSINEF is included in the distributed hlq.SAVZEXEC data set.
Start the Instrumentation Server address space.
Recycle all the Only one IBM Data Virtualization Manager for z/OS Servers connected to the Instrumentation Server address space. After these are recycled, view the transmitted Trace Browse messages from any Only one IBM Data Virtualization Manager for z/OS Server ISPF application by specifying the Instrumentation Server subsystem name in the SIS SSID field on the Only one IBM Data Virtualization Manager for z/OS Server Primary Option Menu.