My colleague Ingo shared the following hint on VSE-L some time ago. It is also documented in the readme.txt file that is part of the z/VSE Installed Software Report (ISR) Tool package. You can download it from the connectors and tools section on the z/VSE web site.
The z/VSE Installed Software Report Tool can be used to create an Installed Software Report that is used by IBM Shopz to determine which software components and which PTFs are installed on z/VSE. Such a report is required when you want to order Preventive Service Planning (PSP) critical service fixes for your z/VSE installation.
By default the z/VSE Installed Software Report Tool provides a graphical user interface (GUI) that automates the process and interfaces with the z/VSE systems using FTP. Therefore this automatic process requires TCP/IP and a FTP server running in z/VSE.
If you do not have TCP/IP running in z/VSE, you may manually create the Installed Software Report as follows:
-
Run the following MSHP retrace products job:
* $$ JOB JNM=SHOPZPRD,CLASS=0,DISP=D,PRI=9
* $$ LST LST=SYSLST,CLASS=0,DISP=H,PRI=9
// JOB SHOPZPRD SHOPZ VSE INSTALLED SOFTWARE REPORT GENERATOR
// OPTION LOG
// EXEC LIBR
ACCESS S=IJSYSRS.SYSLIB
LIST SPLEVEL.PROC
/*
// EXEC MSHP
RETRACE PRODUCTS
/*
/&
-
Run the following MSHP retrace PTFs job:
* $$ JOB JNM=SHOPZPTF,CLASS=0,DISP=D,PRI=9
* $$ LST LST=SYSLST,CLASS=0,DISP=H,PRI=9
// JOB SHOPZPTF SHOPZ VSE INSTALLED SOFTWARE REPORT GENERATOR
// OPTION LOG
// EXEC LIBR
ACCESS S=IJSYSRS.SYSLIB
LIST SPLEVEL.PROC
/*
// EXEC MSHP
RETRACE PTFS
/*
/&
* $$ EOJ
-
Download the two job listings to your workstation (e.g. using 3270 file transfer using IND$FILE).
Please make sure you download the listings in ASCII without control characters (e.g. using the IND$FILE option NOCC).
See the VSE/ESA Programming and Workstation Guide manual, chapter "File Transfer To and From VSE/POWER Queues", sections “Receiving VSE/POWER Queue Entries to the Workstation” and “SEND/RECEIVE Command Syntax and Options” for further details regarding 3270 file transfer using IND$FILE. You can download the manual in PDF format from the z/VSE PDF Library.
-
Run the z/VSE Installed Software Report Tool by entering the following command in its installation directory:
Windows: run.cmd <prod-listing> <ptf-listing> <output-file> [<exclude-CLCs>]
Mac/Linux: ./run.sh <prod-listing> <ptf-listing> <output-file> [<exclude-CLCs>]
To exclude certain Component Level Codes (CLCs), specify the list of CLCs to be excluded as the last parameter. The CLCs should be separated by comma, e.g. 300,1FY.
I greatly appreciate your feedback either in the comments or via the z/VSE contact form.
Disclaimer: My posts and opinions are my own.