zAdviser Administration

BMC AMI zAdviser Enterprise On-Prem leverages machine learning to continuously measure and improve an organization’s mainframe DevOps processes and development outcomes. Based on key performance indicators (KPIs), zAdviser measures software development and delivery quality, velocity, and efficiency, empowering enterprise IT leaders to make evidence-based decisions in support of their continuous improvement efforts.

zAdviser Administration is an interactive guide that helps in configuring data streams for zAdviser Enterprise On-Prem.

zAdviser Enterprise On-Prem. records are collected and written to SMF, and these records are then transferred to BMC in one of five ways. The Administration guide helps in configuring the record transfer method that works for your organization, including the JCL Configuration required.

zAdviser Enterprise On-Prem ADMINISTRATION LOGIN

Manual SMF data extraction and upload process

This section provides instructions for administrators on how to manually extract and upload SMF data to zAdviser. This process is required in the following scenarios:

There has been an interruption in streaming data to zAdviser and backfilling is necessary.
You are installing zAdviser for the first time and want to pre-fill the system with 30–90 days of historical SMF data.

The following are the steps to manually add data to zAdviser:

Step 1: Extract and Convert SMF Data to CSV

Use the following JCL to extract SMF records from the mainframe and convert them into a CSV file

//Specify a Valid Job Card
//*
//* DUMP ZADVISER SMF RECORDS (NON-LOGSTREAM)
//*
//STEP1    EXEC PGM=IFASMFDP
//SMFIN    DD   DISP=SHR,DSN=SMF.DATASET
//OUTDD1   DD   DISP=(,PASS),DSN=&&SMFOUT,
//         UNIT=VIO,SPACE=(CYL,(30,30),RLSE),
//         DCB=(RECFM=VBS,LRECL=32760,BLKSIZE=4096)
//SYSPRINT DD   SYSOUT=*
//SYSIN    DD   *
INDD(SMFIN,OPTIONS(DUMP))
DATE(START,END)         <--- Specify the Start and End dates for the SMF Extract (Format: YYYYDDD)
OUTDD(OUTDD1,TYPE(###)) <--- Replace ### with the SMF record number specified in the LMCLxx member for SMF_ID
//*
//* CONVERT TO .CSV
//*
//STEP2    EXEC PGM=ROICOPY
//STEPLIB DD   DISP=SHR,DSN=BMC.AMI.DEVX.ECC.LOADLIB
//         DD   DISP=SHR,DSN=BMC.AMI.DEVX.ECC.AUTHORIZED.LOADLIB
//ROIIN    DD   DISP=(MOD,PASS),DSN=&&SMFOUT
//SYSUDUMP DD   DUMMY
//CSVOUT   DD   DSN=ZADVISER.ROICOPY.CSV, <--- Update the name of the file that you will be creating.
//         DISP=(NEW,CATLG,DELETE),
//         EATTR=OPT,VOL=SER=SYSDA,
//         UNIT=SYSDA,SPACE=(CYL,(25,25),RLSE),
//         DCB=(DSORG=PS,LRECL=1184,RECFM=U,BLKSIZE=32760)

Step 2: Download the CSV file

Transfer the ZADVISER.ROICOPY.CSV dataset to your local machine.
Make sure the file is downloaded in ASCII format.

Step 3: Upload the file to zAdviser

Log in to the zAdviser Administration page.
Navigate to the Manual Upload section.
Select and upload the ASCII CSV file.

Step 4:Data Ingestion

The uploaded file will be ingested into zAdviser automatically as part of the scheduled ingestion process. You can monitor the ingestion status from the Admin dashboard.

Uploading SCM, ITSM, and Product Usage Data to zAdviser

You can upload the SCM, ITSM, and Product Usage data to be ingested into zAdviser by selecting the appropriate category and sub-category (if applicable) and following the provided guidelines.

Supported categories and file formats

Category	Sub-category	Accepted File Format(s)
SCM	Changeman, Endevour	CSV, TXT
ITSM	Jira	CSV
Product Usage	None	CSV

Upload limitations

File Quantity: A maximum of 5 files can be uploaded at once.
File Size: Each file must not exceed 100 MB in size.

Handling larger files

If files exceed the upload limits (either in quantity or size), you can transfer them using SCP to the specified path displayed on the right-hand pane after selecting your category and sub-category.

Type your

Browser Session: Keep your browser open throughout the upload process to monitor the progress of each file in real-time.
Category Selection: You can select only one category and its corresponding sub-category at a time for file uploads.

Processing and confirmation

After successfully uploading the ITSM and SCM files, processing will begin within the next hour. Upon successful completion, you will receive an email confirmation (if email notifications are configured). You can then view updates on the respective dashboards in Kibana.