Cullen Programming

Virtual Machine Resource System Monitor

Installation, Configuration and Setup

Obtain a trial copy of the product from us in the following way:

Perform a direct download of the VM Archive file (VMARC) from our FTP Site.

Download the product using your browser to either your LINUX, Windows or Apple computer. The downloaded file will be in VMARC format.
(VM Archive format -- The VMARC utility and instructions are available, at no charge, from IBM's website)

Start the download by selecting the version for your zVM:

VMRSMZ for zVM v5.3 (deprecated)

VMRSMZ for zVM v5.4

VMRSMZ for zVM v6.2 (deprecated)

VMRSMZ for zVM v6.3 (deprecated)

VMRSMZ for zVM v6.4

VMRSMZ for zVM v7.1

This will download

VMRSMZxx.VMARC

,where xx represent the version numbers.

Next, upload the .VMARC file(s) to your CMS userid using one of the two methods below:

METHOD 1 (initiated on non-CMS platform such as Windows, Linux or Apple):

You may use your FTP client (such as Filezilla or gFTP) to upload to your CMS userid using the additional parameters to ensure that the transfer takes place in BINARY. If you use this method then ensure that your CMS userid is logged off so that VM's FTPSERVE can get write access to your A-Disk (virtual x'0191').

BINARY

METHOD 2 (initiated from CMS):

This transfer method makes use of the FTP command from your CMS userid to access the VMARC file on your PC Server. Ensure that you enter the FTP command parameter of BINARY and LOCSITE FIX 80.

BINARY
LOCSITE FIX 80
GET xxxxxxxx.VMARC (REPLACE

Now that the VMARC file has been moved to CMS, log on to your CMS userid and type the command:

FILELIST * VMARC A

You should see the VMARC file(s)

xxxxxxxx VMARC A

Exit FILELIST.

For a first-time customer:
From the CMS command prompt run the VMARC file through the following pipeline command. This will reblock the file to a logical record length of 80 and fixed record format.
(Note Pipelines is a standard part of VM/CMS. The default stage separator is the | character. You are free to use any keyboard character not used otherwise in the command line itself )
We suggest piping the output to file ABC, as below, so that you don't overlay the original file.
Also note the > and < characters in the PIPE command are for reading from and writing to a file.

PIPE ( SEP | ) < VMRSMZxx VMARC A | FBLOCK 80 00 | > ABC VMARC A F 80

Next, unpack the resultant file using the VMARC facility.

VMARC UNPK ABC VMARC A (REPLACE

For the current customer:
Use the PIPEUNPK EXEC from prior product install.

PIPEUNPK VMRSMZnn VMARC A

This will generate the following files on your A-disk:

VMRSMZ EXEC
VMRSMZ MODULE
PIPEUNPK EXEC

If you have the VM privilege classes set for your userid, then you are now ready to run the monitor.
Issue the supplied CMS exec named

VMRSMZ

which will set the environment and then invoke the program module.

Now refer to our User's Guide.

Virtual Machine Requirements

CMS virtual machine non-XC mode.
 Privilege class: 'G + E' (to permit Diagnose Instruction X'04' sampling)
 Minumum required virtual machine size: 64M
 Terminal: any emulated IBM 3270 Model 2, 3 or 4
 Overhead: minimal, most of the time monitor is in an enabled wait between sampling intervals. 
 No VM/CP System Control Program 'hooks'.
 No changes to any other product or feature.

All information feeds are by way of sampling the CP Data Areas and Control Blocks using the Diagnose X'04' instruction.

Very quick guide

Start: exec VMRSMZ
Stop: HX or PF3
Functions: HELP | ?
VMSYSTEM
VMUSERS
VMGUEST --> VDEV | VDEVMI
VMCHANS
VMSTORAG
VMDEVICE
RDEV
VMEMORY --> nnnnnnnn
CP

When you are satisfied with the product's performance please review the licensing options for our professional version and make your purchase. You will be provided with a licensed download link.

[Return to Index]

[Return to Cullen Programming Home Page]