CustomPac FTPCSI Utility User Guide

Similar documents
CustomPac FTPCSI Utility User Guide

CustomPac FTPCSI Utility User Guide

Transporting files between MVS and MVS or between MVS and a Workstation

Workflow Manager Endevor Attachment

Workflow Manager - ENDEVOR Attachment

Dino Explorer. MVS Data Collector for Mainframe Assessment

CA ACF2 for z/os Adapter Installation and Configuration Guide

Chapter 2 TSO COMMANDS. SYS-ED/ Computer Education Techniques, Inc.

ISPF Users Boot Camp - Part 2 of 2

Appendix B WORKSHOP. SYS-ED/ Computer Education Techniques, Inc.

Program Directory for IBM WebSphere Application Server OEM Edition for z/os for Rational Team Concert for System z V Program Number 5724-V82

ISPF at EI&O UFIT. UF Information Technology. EI&O Document ID: D0040 Last Updated: 06/28/2002

Self-test ISPF/PDF basics

CA FAVER VSAM Data Protection

MS15: MQSeries for MVS/ESA Archive log housekeeping Version 1.1. User Guide. Document Number MS15. November 7, 2002

2010/04/19 11:38. Describing a unique product that shows the mainframe in a completely different way.

IBM Tivoli Advanced Reporting for DFSMShsm. User s Guide. Version 1 Release 1 SC

IBM InfoSphere Optim for z/os Version 7 Release 2. Batch Utilities

z/os Learning Center: Introduction to ISPF Unit 1: The Basics of ISPF and Data Sets Module 3: ISPF Data Set Basics

IBM Education Assistance for z/os V2R1

Installation Instructions for SAS 9.4 Installation Kit for FTP Format on z /OS

IBM. Program Directory for. IBM z Systems Development and Test Environment Tools. V Program Number 5725-G39 FMID HALMB00.

eft213 NetEx/eFT for IBM z/os Systems Release Memo To Users June 2018 MTU-eFT213-R5.4.7

Program Directory for IBM z Systems Development and Test Environment Tools

IBM z Systems Development and Test Environment Tools User's Guide IBM

Uni Hamburg Mainframe Summit z/os The Mainframe Operating. Part 2 TSO, ISPF und Unix Shell. Introduction to the new mainframe

Installing AX Server with PostgreSQL (multi-server)

Configuring ISPF for Fun and Profit

TSO/ISPF TIPS By:

IBM. OMEGAVIEW and OMEGAVIEW II for the Enterprise. Configuring OMEGAVIEW and OMEGAVIEW II for the Enterprise. Tivoli. Version 3.1.

Compute (Bridgend) Ltd

IBM Tivoli Advanced Reporting for DFSMShsm. User s Guide. Version 2 Release 2 SC

IBM. TSO/E User's Guide. z/os. Version 2 Release 3 SA

PowerExchange Logger: Changing the Size of the Active Logs

INNOVATION TECHSUPPORT

z/os Introduction and Workshop Data Sets

RA/2 RACF CLI Version 1 - Release 1

IBM Content Manager for z/os V8.5 Fix Pack 2 Resource manager running under IBM HTTP Server powered by Apache V8.5.5 Readme

z/os Version 2 Release 3 TSO/E User's Guide IBM SA

CA-View Extract User Dialog

IBM Transaction Analysis Workbench for z/os. Lab

File-Aid for MVS. Features included in this test script for File-Aid MVS are:-

Hitachi Device Manager Mainframe Agent Release Notes Contents

Oracle Tuxedo Mainframe Adapter for TCP

Perceptive TransForm E-Forms Manager

z/os Introduction and Workshop Unix System Services 2009 IBM Corporation 2017 IBM Corporation

Tools for z/os UNIX System Services

Lab Overview In this lab, you will learn how to perform the following tasks with Encryption Facility for z/os:

Hands-on Lab: Setting up the z/os LDAP Server with the dsconfig utility.

Managing WLM on your desktop

PDSUPDTE. 4. When the length of STRING2 is less than that of STRING1, blanks are inserted after the next pool of two blanks following STRING1.

Redpaper. HFS to zfs Migration Tool. Front cover. ibm.com/redbooks. Installing the migration tool. Using the migration tool. Migration tool REXX execs

IBM. IBM Software Manufacturing Solutions. Attached to this memorandum: Summary of Changes. List of Program Material. Installation Instructions.

Objectives of this Lab

Hosting IBM Product Infocenters on z/os

Version 1 Release 6. IBM Autonomics Director for Db2 for z/os User's Guide IBM SC

NetRexx on the Big Iron

Migrating to Tivoli Decision Support for z/os (TDSz) Version 1.8.2

I52901

BEA MessageQ. MVS Client User s Guide

Booting a Galaxy Instance

MQAUSX-ISPF-GUI for z/os User Guide

IBM Education Assistance for z/os V2R1

CA Chorus Software Manager

LMS. Laret Melsch Systems

z/os Basic Skills: Introduction to ISPF Unit 3: Using the ISPF utilities Module 3: Using the ISPF move/copy utility

IBM. Candle OMEGAMON Platform. Configuring IBM Tivoli Candle Management Server on z/os. Tivoli. Version 360 GC

CA Panvalet. Installation Guide. r14.6. Third Edition

JCL Utilities. A Access Method Services... 4:8 Alternate Indexes and Paths... 4:5 AMS Commands... 4:8 anyname DD Statement... 9:5

MVS/QuickRef - Tailoring QW

Compute (Bridgend) Ltd

HostExplorer Keyboard Mapping Maher Saad, Chestnut Residence, University of Toronto

Installation Guide r12.5, Second Edition

RACF Adapter Installation and Configuration Guide

ServerPac Internet Delivery Installation Checklist

ShopzSeries Support Topics

Interactive System Productivity Facility (ISPF)

z/os Learning Center: Introduction to ISPF Unit 1: The Basics of ISPF and Data Sets Module 2: The ISPF PDF Primary Options Menu

Installation and Maintenance Instructions for SAS 9.2 Installation Kit for Basic DVD Installations on z/os

Backup data from Management Tool... 1 Install i-vu CCN Standard Restore data from backup... 3 Access the startup screen...

Version 2 Release 3. IBM IMS Configuration Manager for z/os User's Guide IBM SC

SUREedge DR Installation Guide for Windows Hyper-V

CA Deliver. Installation Guide. Release 12.2

Installation Instructions for SAS 9.4 Installation Kit for Basic Cartridge Installations on z /OS

COMP 3400 Mainframe Administration 1

Micro Focus. Data Express. Requirements and Installation Procedures

IBM. DFSMS Using the Interactive Storage Management Facility. z/os. Version 2 Release 3 SC

IMS Configuration Manager: Hands-on Lab

IBM Tools Base for z/os Version 1 Release 6. IMS Tools Knowledge Base User's Guide and Reference IBM SC

Chicago Interface Group, Inc. FastLIST. Administrator Guide. Release 12.0

IBM. MVS Interactive Problem Control System (IPCS) User's Guide. z/os. Version 2 Release 3 SA

Hardware Interface Service

WAM!NET Submission Icons. Help Guide. March 2015

COMPUTER EDUCATION TECHNIQUES, INC. (JCL ) SA:

IBM Workload Simulator (WSim) Version 1 Release Program Number 5655-I39. General Enhancements. September 17, 2004

CA TPX Session Management

//JOBNAME JOB //STEPNAME EXEC //DDNAME DD //* comment - upper or lower case /*...end of JCL stream

z/os Learning Center: Introduction to ISPF Unit 1: The Basics of ISPF and data sets Module 4: Working with data sets

JCL MOCK TEST JCL MOCK TEST IV

JCL MOCK TEST JCL MOCK TEST III

Transcription:

CustomPac FTPCSI Utility User Guide Version 17.11 November 2017 Owner: IBM CustomPac Development Page 1 of 47

Contents 1. Summary of changes... 4 1.1. Version 17.11... 4 1.2. Version 17.03.02... 4 1.3. Version 17.03.01... 5 1.4. Version 17.01.01... 5 1.5. Version 16.10.01... 5 2. Introduction... 7 2.1. Features... 7 2.2. Prerequisites... 7 3. Upgrading a previous version of the FTPCSI... 8 3.1. Install FTPCSI to a new dataset, keeping the old version unchanged.... 8 Transmission log migration... 8 Configuration migration... 8 3.2. Install FTPCSI to the same dataset, replacing the old version.... 8 Transmission log migration... 8 Configuration migration... 8 3.3. Replace existing ftpcsi.jar with a new version... 9 3.4. Put a new ftpcsi.jar to a separated USS directory... 9 3.5. Place both new and old ftpcsi.jar files to the same USS directory... 9 4. Downloading the FTPCSI utility... 10 5. Uploading files to z/os host... 11 5.1. Uploading fcsilib.bin... 11 5.2. Uploading ftpcsi.jar... 11 Recommended place for ftpcsi.jar... 12 Transfer directly to USS... 12 Transfer to z/os, then to USS... 12 6. Unpacking FTPCSI utility... 14 7. Configuring FTPCSI utility... 15 7.1. Configuring for a proxy server... 15 https.proxyhost... 15 https.proxyport... 15 proxy.username... 15 proxy.password... 15 Owner: IBM CustomPac Development Page 2 of 47

Example... 15 8. Working with FTPCSI utility... 16 8.1. Starting the utility... 16 8.2. Test connection... 16 8.3. Prepare and send CSI... 17 8.4. Prepare and send IODF... 24 8.5. Prepare CSI for sending... 28 8.6. Sending CSI files to IBM manually... 32 8.7. Prepare IODF for sending... 32 8.8. Sending IODF files to IBM manually... 35 8.9. Downloading an order from IBM... 35 Preparation... 35 Processing... 36 8.10. View history log... 39 9. Appendix A. Content of the FTPCSI utility.... 42 10. Appendix B. FTPCSI configuration file.... 44 10.1. FTPCSI configuration parameters... 44 11. Appendix C. CPPECSI invocation parameters... 46 11.1. Examples... 46 Using the default configuration... 46 Using the default test configuration... 46 Using a custom configuration in the sequential dataset... 46 Using a custom configuration in the PDS member... 46 Owner: IBM CustomPac Development Page 3 of 47

1. Summary of changes 1.1. Version 17.11 Java requirements: - Java version 8 (or higher) required to execute FTPCSI Java classes. FTPCSI utility version 17.11 has following changes: - New feature added to download an order from the IBM Download Server. - A new panel added to the workflow to comply with GDPR rules: Private data collection warning. Configuration file changes: - Parameters added: ClassDownloadOrder, ClassUploadCSI, OptsDownloadOrder, OptsUploadCSI. Program files changes: - CPPECSI changed to support new features. - CPPECSIL changed to support new features. ISPF panels changes: - Panel CPPPFTP1: option added to download an order. - Panel CPPPFTPH: header changed. - Panels added: CPPPFTPD, CPPPFTPE, CPPPFTPF, CPPPFTPG, CPPPFTPH. ISPF skeletons changes: - Job skeletons added: FCSIJCL3, FCSIJCL4. - STDPARM skeletons added: FCSISTD3, FCSISTD4. - STDPARM skeletons changed: FCSISTD1, FCSISTD2. Documentation changes: - Multiple changes to reflect new program features. 1.2. Version 17.03.02 FTPCSI utility version 17.03.02 has following bug fixes and changes: - Test connection status was not updated on the CPPPFTP1 panel after the first test execution when the FCSISTAT variable is not in the user profile. CPPPFTP1 panel changed to support variables updates. - Temporary ISPF table CPPALLZN was locked by CPPECSI that makes unable to run FTPCSI in multiuser environment. Changed to work with in-memory table. - Misleading error Global CSI not found was displayed when reading CSI dataset. Changed to show all messages of the failed REPRO program. - Panel CPPPFTPC added to display error messages. Documentation changes: - CPPPFTPC panel description added to section 8.3 and 8.5. Owner: IBM CustomPac Development Page 4 of 47

- CPPPFTPC panel added to the Appendix A Content of the FTPCSI utility. 1.3. Version 17.03.01 The FTPCSI utility version 17.03.01 has following changes and new features: - New features added: o Send IODF dataset to IBM. o Prepare IODF dataset for download to workstation. - Ticket number is not used anymore. Documentation changes: - Sections added: o 3. Upgrading a previous version of the FTPCSI o Recommended place for ftpcsi.jar (in the 5.2. Uploading ftpcsi.jar) o 8.7. Prepare IODF for sending o 8.8. Sending IODF files to IBM manually - Changed: Appendix A. Content of the FTPCSI utility. - Changed: ISPF panels images and descriptions. 1.4. Version 17.01.01 The FTPCSI utility version 17.01.01 has following changes and new features: - Proxy server authentication supported using user id and password. - Apache HttpComponents Client added to the package. The HttpComponents Client is licensed under Apache v2.0 license. - Apache v2.0 license text added to the FTPCSI package (member FCSILIC). - Defect fixed: in version 16.10 when a long configuration parameter continues on several lines, the program removes leading spaces from every line before concatenation. In version 17.01 leading spaces are not removed. - CPPECSI improvement: option STACK added to LIBDEF commands issued by the CPPECSI. The program then removes their LIBDEFs on exit. Documentation changed: - Added chapter 6.1 Configuring for proxy server. - FCSILIC added to the list of members (Appendix A. Content of the FTPCSI utility.) 1.5. Version 16.10.01 The new version of FTPCSI was released to comply with current security requirements. The FTPCSI utility version 16.10.01 has a set of changes and new features: - Transport method changed from the simple (unsecured) FTP to the secured HTTPS protocol. - Workstation not required anymore to submit a CSI request. The utility has a new panel to collect all required information from the user. This information is transferred in the single transaction with the CSI data. - It is possible now to include target CSI zones with different SRELs in a single transaction (previous version was limited to a single SREL per transaction). Owner: IBM CustomPac Development Page 5 of 47

- New Java program added to the FTPCSI utility. The program resides in the archive file ftpcsi.jar. The purpose of the program is to establish a communication path to the IBM CustomPac server and transfer a CSI data. - Design of most panels changed. - Process flow (sequence of panels) changed. - Some program parameters moved to the configuration member. The default configuration member name is FCSICONF. - New optional command line parameter CONF introduced to specify a configuration dataset/member. - Batch job changed to support new features. Owner: IBM CustomPac Development Page 6 of 47

2. Introduction FTPCSI is a z/os tool that helps you in sending your CSI and IODF data to IBM and to download an electronic order from IBM. To send CSI or IODF, the utility collects all the required information, exports your IODF data or SMP/E zones and transmits the exported data to the IBM CustomPac server. Optionally you could prepare the data and do not send it from your z/os but then send it from your workstation manually. To download an electronic order, the utility collects the required order information, retrieves order files and saves it in the USS filesystem. Do not be confused with a name of the utility that comes from the old version of the program. Despite its name the FTPCSI does not use the unsecured FTP protocol to send or receive data. Instead a secured transport is used. The utility consists of a set of REXX programs, ISPF panels and skeletons and a Java jar file. 2.1. Features The FTPCSI utility has following features: - Test from your TSO session that your host can connect to the IBM CustomPac server and transfer data using a secured protocol. - Collect the information required to submit your data (i.e. your email address, customer number and more) then export your CSI zones or IODF information and send the data to IBM. - Export your CSI zones or IODF information but do not send them to IBM. - Collect the information required to download an electronic order then get order files from IBM and save to the USS filesystem. - View a log of completed transactions. 2.2. Prerequisites Following products must be installed on your z/os to run FTPCSI utility. - ISPF/PDF version 3.5 or above - SMP/E release 1.5 or above - Java 1.8 or above Owner: IBM CustomPac Development Page 7 of 47

3. Upgrading a previous version of the FTPCSI If you have an earlier version of the FTPCSI installed on your host, you have few options when installing a new version. 3.1. Install FTPCSI to a new dataset, keeping the old version unchanged. After the installation to a new dataset you could run any of the installed versions of the utility. Transmission log migration Transmission log is stored in the CPPFLOG member. After installation to a new dataset you could optionally copy an old CPPFLOG member to a new installation dataset. This will allow you to view old log records when running a new utility. Configuration migration Configuration is stored in the FCSICONF member. We don t recommend a simple copying of an old configuration member to a new dataset. That is because a new member could introduce some new options and you will lose them after copying. We recommend you compare a new and an old FCSICONF members. Then migrate only those options that you need. 3.2. Install FTPCSI to the same dataset, replacing the old version. Please backup your previous version before the installation. After the installation, you may have some old members that are not used by a new version of the utility. Transmission log migration Transmission log is stored in the CPPFLOG member. You don t need to migrate CPPFLOG as it is not replaced by a new version. The utility will use the old copy of the log. Configuration migration Configuration is stored in the FCSICONF member. The new installation will replace an old FCSICONF member and you will lose your customization. Use a backup copy to restore your configuration if required. We don t recommend a simple copying of the old configuration member to a new FCSICONF as a new member could introduce some new options. We recommend you compare a new and the old FCSICONF members. Then migrate only those options that you need. Owner: IBM CustomPac Development Page 8 of 47

3.3. Replace existing ftpcsi.jar with a new version Please backup an old version of the ftpcsi.jar. In this case, you don t need to change JarPath and JarFile options in the existing FCSICONF member. Please pay your attention to this: - That could be a good choice if you don t need to run an old version of the FTPCSI utility. - That is not a good choice if you want to use an old version of the FTPCSI as some features of the new jar file could be incompatible with an old FTPCSI version. If you d like to keep an old version working, we recommend you either - to install a new version to another USS directory - or put a new jar to the same USS directory but rename a new or an old jar file. Both options will require you to write an actual jar file path and/or file name to the configuration member FCSICONF. 3.4. Put a new ftpcsi.jar to a separated USS directory That will allow you to keep and run an old version of the FTPCSI utility. You don t need to change JarPath and JarFile options of the old FCSICONF member. You must change JarPath option of the new FCSICONF member. 3.5. Place both new and old ftpcsi.jar files to the same USS directory Please backup an old version of the ftpcsi.jar. That will allow you to keep and run an old version of the FTPCSI utility. This option will require you to change file name either of a new or an old jar file. We recommend you use version identifier in the file name like ftpcsi.161001.jar or ftpcsi.170101.jar. Depending on which jar file was renamed you must change JarFile option of a new or an old FCSICONF member. Owner: IBM CustomPac Development Page 9 of 47

4. Downloading the FTPCSI utility You can download the utility from the IBM CustomPac web server. Use the link below to download the FTPCSI package to your workstation: https://www.ibm.com/services/ca/en/custompac/csi/dftp/dftp_sub_uploadcsi.html?lnk=hm After downloading the archive, you need to extract files to your hard disk: - fcsilib.bin FTPCSI partitioned dataset binary image - ftpcsi.jar FTPCSI jar file Owner: IBM CustomPac Development Page 10 of 47

5. Uploading files to z/os host 5.1. Uploading fcsilib.bin When fcsilib.bin is extracted from the downloaded archive, you have to upload it to your z/os host. You could use either FTP or any communication package available for your installation. Use BINARY transfer mode when uploading fcsilib.bin to z/os. Allocate a z/os host file with following attributes: - LRECL=80 - BLKSIZE=3120 - RECFM=FB. Here is an example of using FTP to upload fcsilib.bin to z/os host: $ ftp your.host Connected to your.host. 220-SUBSYS IBM FTP CS V2R2 at YOUR.HOST, 13:41:52 on 2016-12-05. 220 Connection will close if idle for more than 5 minutes. Name (your.host:yourid): 331 Send password please. Password: 230 YOURID is logged on. Working directory is "YOURID.". Remote system type is MVS. ftp> pwd Remote directory: YOURID.' ftp> binary 200 Representation type is Image ftp> quote site recfm=fb lrecl=80 blksize=3120 200 SITE command was accepted ftp> put fcsilib.bin local: fcsilib.bin remote: fcsilib.bin 229 Entering Extended Passive Mode ( 3074 ) 125 Storing data set YOURID.FCSILIB.BIN 100% ********************************** 168 KiB 116.34 KiB/s 00:00 ETA 250 Transfer completed successfully. 172800 bytes sent in 00:02 (67.48 KiB/s) ftp> ls fcsilib.bin 229 Entering Extended Passive Mode ( 3075 ) 125 List started OK Volume Unit Referred Ext Used Recfm Lrecl BlkSz Dsorg Dsname USER05 3390 2016/12/05 1 15 FB 80 3120 PS FCSILIB.BIN 250 List completed successfully. ftp> quit 221 Quit command received. Goodbye. $ 5.2. Uploading ftpcsi.jar You have to put the ftpcsi.jar file to z/os USS directory. To achieve this, you can transfer the file to a USS folder directly or transfer the file to a z/os sequential dataset and then copy it to the USS. You must specify a path to the ftpcsi.jar file in the FCSICONF member before the first run. Owner: IBM CustomPac Development Page 11 of 47

Recommended place for ftpcsi.jar We have no recommendations on where to store your copy of ftpcsi.jar, but you must follow few simple rules: - Store ftpcsi.jar in a place available for read to a user that will run the FTPCSI utility. - Write a location of the ftpcsi.jar to the FCSICONF member, option JarPath. This will allow FTPCSI to find the jar file. - If you have few versions of the FTPCSI installed on your host, we recommend you have an own ftpcsi.jar for every FTPCSI installation. You could put every ftpcsi.jar to an own directory or place all these jars to the same directory but with different file names (you could use a name like ftpcsi.vrm.jar where vrm is a version identification). Then specify correct JarPath and JarFile options of the FCSICONF member for every FTPCSI installation. Please also review the section 3. Upgrading a previous version of the FTPCSI to understand installation options for ftpcsi.jar. Transfer directly to USS Use the access method available for your installation to transfer the ftpcsi.jar to the USS. The most common method is FTP. It is available on most z/os systems. Another option is the SCP program that is based on the ssh protocol. Use the BINARY transfer mode when uploading the file to USS. Here is an example of using FTP to upload the ftpcsi.jar to USS: $ ftp your.host Connected to your.host. 220-SUBSYS IBM FTP CS V2R2 at YOUR.HOST, 11:19:39 on 2016-12-05. 220 Connection will close if idle for more than 5 minutes. Name (your.host:yourid): 331 Send password please. Password: 230 YOURID is logged on. Working directory is "YOURID.". Remote system type is MVS. ftp> binary 200 Representation type is Image ftp> cd /your/directory 250 HFS directory /your/directory is the current working directory ftp> put ftpcsi.jar local: ftpcsi.jar remote: ftpcsi.jar 229 Entering Extended Passive Mode ( 3044 ) 125 Storing data set /your/directory/ftpcsi.jar 100% ********************************** 474 KiB 121.63 KiB/s 00:00 ETA 250 Transfer completed successfully. 485684 bytes sent in 00:04 (100.49 KiB/s) ftp> quit 221 Quit command received. Goodbye. $ Transfer to z/os, then to USS Use either FTP or any communication package available for your installation. Use BINARY transfer mode when uploading ftpcsi.jar to z/os. Allocate a z/os dataset of the undefined record format: - RECFM=U Owner: IBM CustomPac Development Page 12 of 47

After the file is transferred to z/os use TSO OPUT command to copy the ftpcsi.jar file to some USS directory. Use the BINARY option. Here is an example of using FTP: $ ftp your.host Connected to your.host. 220-FTPDM1 IBM FTP CS V2R2 at YOUR.HOST, 12:18:52 on 2016-12-05. 220 Connection will close if idle for more than 5 minutes. Name (your.host:yourid): 331 Send password please. Password: 230 YOURID is logged on. Working directory is "YOURID.". Remote system type is MVS. ftp> binary 200 Representation type is Image ftp> cd 'hlq' 250 "HLQ." is the working directory name prefix. ftp> quote site recfm=u lrecl=1024 blksize=1024 200 SITE command was accepted ftp> put ftpcsi.jar local: ftpcsi.jar remote: ftpcsi.jar 229 Entering Extended Passive Mode ( 3052 ) 125 Storing data set HLQ.FTPCSI.JAR 100% ********************************** 474 KiB 120.17 KiB/s 00:00 ETA 250 Transfer completed successfully. 485684 bytes sent in 00:04 (98.46 KiB/s) ftp> ls ftpcsi.jar 229 Entering Extended Passive Mode ( 3056 ) 125 List started OK Volume Unit Referred Ext Used Recfm Lrecl BlkSz Dsorg Dsname USER0A 3390 2016/12/05 1 15 U 1024 1024 PS FTPCSI.JAR 250 List completed successfully. ftp> quit 221 Quit command received. Goodbye. $ Here is an example of the OPUT command: oput hlq.ftpcsi.jar /your/directory/ftpcsi.jar binary Owner: IBM CustomPac Development Page 13 of 47

6. Unpacking FTPCSI utility The fcsilib.bin is created with TSO TRANSMIT and you should restore it using the TSO RECEIVE command: TSO RECEIVE INDATASET('hlq.FCSILIB.BIN') The command will extract a partitioned dataset containing FTPCSI utility members. By default an extracted PDS name is tsoprefix.fcsilib.vvvrrmm. You could specify a desired PDS name in response to the TSO RECEIVE prompt: INMR906A Enter restore parameters or 'DELETE' or 'END' + Press Enter to use the default name. To install to another dataset, you could reply with DS( ftpcsi.instlib ) You must customize the FCSICONF member before the first run. Owner: IBM CustomPac Development Page 14 of 47

7. Configuring FTPCSI utility By default, the FTPCSI utility reads a configuration member FCSICONF. You must update the FCSICONF member before the first execution. Set the following parameters: JavaPath path to the java executable file. Leaving it empty will call to the java program that is available through the USS PATH variable. JarPath path to the ftpcsi.jar file. JarFile name of the ftpcsi.jar file (the default name specified in the FCSICONF is ftpcsi.jar, but you could rename the file as required by your installation). 7.1. Configuring for a proxy server If your z/os host is behind a proxy server, you may need to add following JavaOpts parameters to allow FTPCSI to work with your proxy. https.proxyhost Specify a proxy server address in the parameter https.proxyhost: -Dhttps.proxyHost=x.x.x.x https.proxyport Specify a proxy port in the parameter https.proxyport: -Dhttps.proxyPort=port proxy.username Specify a proxy user id in the parameter proxy.username: -Dproxy.username=user proxy.password Specify a proxy user password in the parameter proxy.password: -Dproxy.password=password Example Here is an example of the JavaOpts configuration parameter that will allow FTPCSI to work with a proxy server 192.168.1.1 (port 8080, user id fcsiuser and password secret ): JavaOpts = -Dfile.encoding=UTF-8 -Dhttps.proxyHost=192.168.1.1 -Dhttps.proxyPort=8080 -Dproxy.username=fcsiuser -Dproxy.password=secret Please note that there are two spaces in the beginning of every line except the first line. Owner: IBM CustomPac Development Page 15 of 47

8. Working with FTPCSI utility 8.1. Starting the utility To start the FTPCSI utility, issue the following command from your TSO session: TSO EXEC ftpcsi.instlib(cppecsi) The main panel CPPPFTP1 will be displayed. CPPPFTP1 ---------------------- Method Selection ------------------------------ Option ===> There are 2 methods to prepare and send files to IBM. The first method is to prepare files on your z/os and then send to IBM with the same job. The second method is to prepare files on your z/os, then download to your workstation and send from the workstation. --------------------------- Status: PASSED 0. Test connection between your z/os and IBM. Date : 2017/11/09 04:08 --------------------------- Use options 1 and 2 if the connection test status is PASSED. 1. Prepare and send CSI 6. Download order from IBM 2. Prepare and send IODF Use options 1, 2, 6 if the connection test status is PASSED. 3. Prepare CSI for download to workstation 4. Prepare IODF for download to workstation 5. View history log. Enter option or Press PF3 to exit Version 17.11.00 A status and a time of the last connection test is displayed in the frame on the right side of the panel. You could select one of these options: Option 0 test connection to the IBM CustomPac server. Option 1 prepare CSI and send zones information to IBM. Option 2 prepare and send IODF data to IBM. Option 3 prepare CSI but do not send any data to IBM. You can use prepared files to upload CSI data manually from your workstation. Option 4 prepare IODF data but do not send to IBM. You can use prepared file to upload IODF data manually from your workstation. Option 5 view a log of transactions sent to IBM. Option 6 download electronic order from IBM. A SHOWCONF command is available for this panel to display a list of parameters fetched from the configuration dataset. 8.2. Test connection On the CPPPFTP1 panel enter option 0 and press Enter. A pop-up window will be displayed. A connection test will run in the background. Owner: IBM CustomPac Development Page 16 of 47

A Connection completed or Connection failed message is displayed after the test. Starting connection test... Connecting to host... Connection completed Starting connection test... Connecting to host... Connection failed Press Enter to view log Press Enter to view log Press Enter to view the connection log. ********************************* Top of Data ********************************** Env: PATH=/usr/lpp/java/J8.0_64/bin:$PATH Command: java -Dfile.encoding=UTF-8 -cp /u/nkv/dev/fcsi/ftpcsi.jar com.ibm.cpp.cs RC: 0 *** STDOUT *** 2017-11-10 11:54:15.386 Logging configuration loaded from the internal resource [ 2017-11-10 11:54:15.429 Version 17.11 2017-11-10 11:54:15.455 Test mode on 2017-11-10 11:54:15.456 URL: https://www-03.ibm.com/cgi-bin/services/ca/en/custom 2017-11-10 11:54:16.231 Start testing connection. 2017-11-10 11:54:16.247 Uploading... 2017-11-10 11:54:17.414 Testing connection is completed successfully. Have a nice *** STDERR *** Press F3 to continue. Upon return to the main panel CPPPFTP1 a connection status and time are updated on the screen. workstation and send from the workstation. --------------------------- Status: PASSED 0. Test connection between your z/os and IBM. Date : 2017/11/10 04:54 --------------------------- If the test status is FAILED, the FTPCSI utility cannot send your data to IBM from this z/os system. You can use the options 3 or 4 to prepare and then download files to your workstation. Then upload these files from the workstation to the IBM CustomPac web server. 8.3. Prepare and send CSI On the main panel CPPPFTP1 choose option 1. The CPPPFTP3 panel will be displayed. CPPPFTP3 --------------------- Global CSI Dataset ----------------------------- Command ==> Step 1 of 4 Enter name of the Global CSI dataset that you will send to IBM: (enter the full dataset name) SMPE.ZOS22.GLOBAL.CSI Press Enter to continue or F3 to return Enter name of the global CSI dataset that you will send to IBM. Then press Enter. Owner: IBM CustomPac Development Page 17 of 47

If the program for some reason cannot read the CSI dataset, you will see a panel CPPPFTPC displaying error messages. ------------------------------ Global CSI Dataset ----------------------------- C 4 Command ==> Row 1 to 5 of 5 E (e Can't access CSI 'MY.GLOBAL.CSI'. RC=12. M > P Repro outfile(icsigrep) indataset('my.global.csi') count(300) IKJ56228I DATA SET MY.GLOBAL.CSI NOT IN CATALOG OR CATALOG CAN NOT BE IDC0005I NUMBER OF RECORDS PROCESSED WAS 0 IDC0014I LASTCC=12 ************************** Bottom of data *************************** If messages are too long to fit on the screen you can use F10 and F11 keys to scroll the list to the left or right. According to ISPF conventions you must place a cursor on the list of messages and press F10 or F11 to scroll. An indicator above the list will show you whether a hidden text is on the right or on the left of the window: < a text is on the left use F10 to scroll to the left; > a text is on the right use F11 to scroll to the right; <> a text is on the right and on the left use F10 or F11 to scroll. Owner: IBM CustomPac Development Page 18 of 47

If a CSI dataset name is correct, the program will read a list of target zones from the global CSI dataset and display the list on the next CPPPFTP4 panel. CPPPFTP4 -------------------- Select Target Zones ---------- Row 1 to 15 of 15 Command ===> Scroll ===> CSR Step 2 of 4 Global CSI: SMPE.ZOS22.GLOBAL.CSI Select target zone(s) and press Enter to continue. Enter 's' to include a zone to the CSI submit request 'd' to remove a zone from the selection list S Type Name Dataset TARGET ARM#01T SMPE.ARMHSM.NWPM.VSPMTG1.T00.CSI TARGET CRP#01T SMPE.CAT.NWPM.VSPMTG1.T00.CSI TARGET DLA#01T SMPE.DLA.NWPM.VSPMTG1.T00.CSI TARGET MVST100 SMPE.ZOS22.MVS.TARGET.CSI TARGET MVST110 SMPE.ZOS22.MVS.TARGET.CSI TARGET MVST114 SMPE.ZOS22.MVS.TARGET.CSI TARGET NVW#01T SMPE.NETVA.NWPM.VSPMTG1.T00.CSI TARGET NVW#02T SMPE.NETVB.NWPM.VSPMTG2.T00.CSI TARGET OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET OPS#02T SMPE.OPSA.NWPM.VSPMTG2.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.T00.CSI TARGET SAU#02T SMPE.SAMVSA.NWPM.VSPMTG2.T00.CSI TARGET TAD#01T SMPE.TAD4Z.NWPM.VSPMTG1.T00.CSI TARGET WSE#01T SMPE.WSEDO.NWPM.VSPMTG2.T00.CSI ******************************* Bottom of data ******************************** Select zones that you will send to IBM. To select a zone, use option s. Selected zones are marked with a symbol >. To exclude a zone, use option d. If a zone was previously selected, a symbol > would disappear. Owner: IBM CustomPac Development Page 19 of 47

CPPPFTP4 -------------------- Select Target Zones ---------- Row 1 to 15 of 15 Command ===> Scroll ===> CSR Step 2 of 4 Global CSI: SMPE.ZOS22.GLOBAL.CSI Select target zone(s) and press Enter to continue. Enter 's' to include a zone to the CSI submit request 'd' to remove a zone from the selection list S Type Name Dataset TARGET ARM#01T SMPE.ARMHSM.NWPM.VSPMTG1.T00.CSI TARGET CRP#01T SMPE.CAT.NWPM.VSPMTG1.T00.CSI > TARGET DLA#01T SMPE.DLA.NWPM.VSPMTG1.T00.CSI TARGET MVST100 SMPE.ZOS22.MVS.TARGET.CSI TARGET MVST110 SMPE.ZOS22.MVS.TARGET.CSI > TARGET MVST114 SMPE.ZOS22.MVS.TARGET.CSI TARGET NVW#01T SMPE.NETVA.NWPM.VSPMTG1.T00.CSI TARGET NVW#02T SMPE.NETVB.NWPM.VSPMTG2.T00.CSI TARGET OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET OPS#02T SMPE.OPSA.NWPM.VSPMTG2.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.T00.CSI TARGET SAU#02T SMPE.SAMVSA.NWPM.VSPMTG2.T00.CSI TARGET TAD#01T SMPE.TAD4Z.NWPM.VSPMTG1.T00.CSI TARGET WSE#01T SMPE.WSEDO.NWPM.VSPMTG2.T00.CSI ******************************* Bottom of data ******************************** Select at least one target zone. Press Enter when you are ready to continue. The CPPPFTP8 panel will be displayed allowing you to enter your order data. CPPPFTP8 ----------------- Parameters for CSI Upload ------ Selected 2 zone(s) Command ===> Step 3 of 4 Customer number.. 9999999 E-mail...... your.email@your.domain Country...... Costa Rica Enter '/' for a list of countries Order number... DF995241 Offering..... 1 1. ProductPac 2. RefreshPac 3. OMISLoad Press Enter to continue or F3 to return Enter appropriate data. To select a country from the list, enter a slash / symbol in the Country field and press Enter. Owner: IBM CustomPac Development Page 20 of 47

A pop-up window will appear. Select a country from the list using s option and press Enter. CPPPFTP2 Row 1 to 16 of 132 Cmd=> Scroll=> CSR Use 's' to select a country from the list S Countries Afghanistan Algeria Angola Anguilla Antigua and Barbuda Argentina Aruba Australia Austria Bahamas Bahrain Bangladesh Barbados Belgium Bermuda Bolivia When all parameters are entered, press Enter to go to the next panel. You will see a warning message explaining that IBM will collect your personal data. ------------------- Private data collection warning ------------------- This form collects your email so that we can associate it with request you made. IBM could use this email to send important updates for your request. Check out the IBM Online Privacy Statement Highlights: https://www.ibm.com/privacy/us/en/ I consent to having IBM collect my email: _ (mark to confirm) Press Enter to continue or F3 to return. If you agree to send your personal data to IBM, enter any character to the input field and press Enter. Otherwise press F3 to cancel processing. Owner: IBM CustomPac Development Page 21 of 47

The next is CPPPFTP5 Jobcard information panel. CPPPFTP5 -------------------- Jobcard Information ----------------------------- Command ===> Step 4 of 4 Please update jobcard below : //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* +---------------------------------------------------------------------+ + A job will be created for you to complete the selected task. + + Please follow the instruction below to continue + + + + - Press Enter to generate JCL + + - Review the job, then SUBMIT for execution + + - Review the job output, check that all steps are completed with + + RC=0, except for ZONEEXP which may expect a RC of 4 + + - Save the generated JCL, in case you need to restart the job + +---------------------------------------------------------------------+ Press Enter to continue or F3 to return On the CPPPFTP5 panel modify JCL JOB statement. Then press Enter. Owner: IBM CustomPac Development Page 22 of 47

The program will create a batch job for you to prepare and send data to IBM. Review and change the job if required then submit using the SUBMIT command. File Edit Edit_Settings Menu Utilities Compilers Test Help ISREDDE2 SYS17062.T041522.RA000.NKV.R0144087 Columns 00001 00080 Command ===> Scroll ===> CSR ****** ***************************** Top of Data ******************************* ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', 000002 // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, 000003 // NOTIFY=&SYSUID 000004 //* 000005 //*************************************************************** 000006 //* 000007 //* This job will extract zones from 000008 //* SMPE.ZOS22.GLOBAL.CSI 000009 //* and send following extracted zone(s) to IBM server. 000010 //* 000011 //* You could also send these datasets to IBM by yourself from the site 000012 //* where you have downloaded this application. 000013 //* 000014 //* NKV.IBMCPP.FCSI.GLOBAL 000015 //* NKV.IBMCPP.FCSI.TDLA#01T 000016 //* NKV.IBMCPP.FCSI.TMVST114 000017 //*************************************************************** 000018 //*------------------------------------------------------------------- 000019 //* DELETE EXPORT CSI FILES IN CASE OF RERUN 000020 //*------------------------------------------------------------------- 000021 //DELETE EXEC PGM=IDCAMS,COND=(0,LT) 000022 //SYSPRINT DD SYSOUT=* 000023 //SYSIN DD * 000024 DELETE 'NKV.IBMCPP.FCSI.GLOBAL' 000025 DELETE 'NKV.IBMCPP.FCSI.TDLA#01T' 000026 DELETE 'NKV.IBMCPP.FCSI.TMVST114' 000027 SET LASTCC=00 000028 SET MAXCC=00 000029 /* 000030 //*------------------------------------------------------------------- 000031 //* EXPORT zones to temporary data sets 000032 //*------------------------------------------------------------------- 000033 //ZONEEXP EXEC PGM=GIMSMP,COND=(0,LT) 000034 //SYSPRINT DD SYSOUT=* 000035 //SMPLOG DD SYSOUT=* After the JCL completion check the job output to ensure that all steps are executed successfully with a return code 0. If there are any errors that you can fix, correct the JCL and restart the job. Owner: IBM CustomPac Development Page 23 of 47

After the exit from the JCL EDIT screen, the final panel CPPPFTP6 will be displayed to show that the CSI submit request is completed. CPPPFTP6 ----------------- Order Complete Information ------------------------- Command ==> If you have submitted the job to complete the selected task, read the following instructions: +---------------------------------------------------------------------+ + REVIEW THE JOB OUTPUT AND VERIFY THAT ALL STEPS ARE COMPLETED + + WITH RETURN CODE 0 (EXCEPT FOR ZONEEXP STEP WHICH MAY HAVE A + + RETURN CODE OF 4) + +---------------------------------------------------------------------+ Press Enter or F3 to continue 8.4. Prepare and send IODF On the main panel CPPPFTP1 choose option 2. The CPPPFTP9 panel will be displayed. CPPPFTP9 ------------------------ IODF Dataset -------------------------------- Command ==> Step 1 of 3 Enter name of the IODF dataset that you will send to IBM: (enter the full dataset name) CPACTST.IODF00 Press Enter to continue or F3 to return Enter name of the IODF dataset that you will send to IBM. Then press Enter. The program will check the dataset name and if the dataset is cataloged the program will jump to the next panel CPPPFTPA. CPPPFTPA ----------------- Parameters for IODF Upload ------------------------- Command ===> Step 2 of 3 Customer number.. 9999999 E-mail...... your.email@your.domain Country...... Costa Rica Enter '/' for a list of countries Order number... DF995241 Press Enter to continue or F3 to return To select a country from the list, enter a slash / symbol to the Country field and press Enter. Owner: IBM CustomPac Development Page 24 of 47

A pop-up window will appear. Select a country from the list using s option and press Enter. CPPPFTP2 Row 1 to 16 of 132 Cmd=> Scroll=> CSR Use 's' to select a country from the list S Countries Afghanistan Algeria Angola Anguilla Antigua and Barbuda Argentina Aruba Australia Austria Bahamas Bahrain Bangladesh Barbados Belgium Bermuda Bolivia When all parameters are entered, press Enter to go to the next panel. You will see a warning message explaining that IBM will collect your personal data. ------------------- Private data collection warning ------------------- This form collects your email so that we can associate it with request you made. IBM could use this email to send important updates for your request. Check out the IBM Online Privacy Statement Highlights: https://www.ibm.com/privacy/us/en/ I consent to having IBM collect my email: _ (mark to confirm) Press Enter to continue or F3 to return. If you agree to send your personal data to IBM, enter any character to the input field and press Enter. Otherwise press F3 to cancel processing. Owner: IBM CustomPac Development Page 25 of 47

The next is CPPPFTP5 Jobcard information panel. CPPPFTP5 -------------------- Jobcard Information ----------------------------- Command ===> Step 3 of 3 Please update jobcard below : //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* +---------------------------------------------------------------------+ + A job will be created for you to complete the selected task. + + Please follow the instruction below to continue + + + + - Press Enter to generate JCL + + - Review the job, then SUBMIT for execution + + - Review the job output, check that all steps are completed with + + RC=0, except for ZONEEXP which may expect a RC of 4 + + - Save the generated JCL, in case you need to restart the job + +---------------------------------------------------------------------+ Press Enter to continue or F3 to return On the CPPPFTP5 panel modify JCL JOB statement. Then press Enter. Owner: IBM CustomPac Development Page 26 of 47

The program will create a batch job for you to prepare and send data to IBM. Review and change the job if required then submit using the SUBMIT command. File Edit Edit_Settings Menu Utilities Compilers Test Help ISREDDE2 SYS17062.T061113.RA000.NKV.R0147394 Columns 00001 00080 Command ===> Scroll ===> CSR ****** ***************************** Top of Data ******************************* ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', 000002 // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, 000003 // NOTIFY=&SYSUID 000004 //* 000005 //*************************************************************** 000006 //* 000007 //* This job will extract IODF from 000008 //* CPACTST.IODF00 000009 //* and send following extracted IODF to IBM server. 000010 //* 000011 //* You could also send this dataset to IBM by yourself from the site 000012 //* where you have downloaded this application. 000013 //* 000014 //* NKV.IBMCPP.FCSI.IODF.TRS 000015 //* 000016 //*************************************************************** 000017 //* 000018 //*------------------------------------------------------------------- 000019 //* DELETE work files in case of rerun 000020 //*------------------------------------------------------------------- 000021 //DELETE EXEC PGM=IDCAMS,COND=(0,LT) 000022 //SYSPRINT DD SYSOUT=* 000023 //SYSIN DD * 000024 DELETE 'NKV.IBMCPP.FCSI.IODF.REPRO' 000025 DELETE 'NKV.IBMCPP.FCSI.IODF.TRS' 000026 SET LASTCC=00 000027 SET MAXCC=00 000028 /* 000029 //*------------------------------------------------------------------- 000030 //* REPRO IODF file 000031 //*------------------------------------------------------------------- 000032 //REPRO EXEC PGM=IDCAMS 000033 //SYSPRINT DD SYSOUT=* 000034 //IODF DD DISP=SHR,DSN=CPACTST.IODF00 000035 //TIODF DD DSN=NKV.IBMCPP.FCSI.IODF.REPRO, After the JCL completion check the job output to ensure that all steps are executed successfully with a return code 0. If there are any errors that you can fix, correct the JCL and restart the job. Owner: IBM CustomPac Development Page 27 of 47

After the exit from the JCL EDIT screen, the final panel CPPPFTP6 will be displayed to show that the IODF submit request is completed. CPPPFTP6 ----------------- Order Complete Information ------------------------- Command ==> If you have submitted the job to complete the selected task, read the following instructions: +---------------------------------------------------------------------+ + REVIEW THE JOB OUTPUT AND VERIFY THAT ALL STEPS ARE COMPLETED + + WITH RETURN CODE 0 (EXCEPT FOR ZONEEXP STEP WHICH MAY HAVE A + + RETURN CODE OF 4) + +---------------------------------------------------------------------+ Press Enter or F3 to continue 8.5. Prepare CSI for sending In a case when you cannot send your data from z/os system you can use option 3 to prepare files but do not send them to IBM. Later you could download your files to a workstation and use an Internet browser to submit CSI data to IBM manually. On the main panel CPPPFTP1 enter option 3 and press Enter. A panel CPPPFTP3 will be displayed. CPPPFTP3 --------------------- Global CSI Dataset ----------------------------- Command ==> Step 1 of 3 Enter name of the Global CSI dataset that you will send to IBM: (enter the full dataset name) SMPE.ZOS22.GLOBAL.CSI Press Enter to continue or F3 to return Enter name of the global CSI dataset that you will send to IBM. Then press Enter. If the program for some reason cannot read the CSI dataset, you will see a panel CPPPFTPC displaying error messages. ------------------------------ Global CSI Dataset ----------------------------- C 4 Command ==> Row 1 to 5 of 5 E (e Can't access CSI 'MY.GLOBAL.CSI'. RC=12. M > P Repro outfile(icsigrep) indataset('my.global.csi') count(300) IKJ56228I DATA SET MY.GLOBAL.CSI NOT IN CATALOG OR CATALOG CAN NOT BE IDC0005I NUMBER OF RECORDS PROCESSED WAS 0 IDC0014I LASTCC=12 ************************** Bottom of data *************************** If messages are too long to fit on the screen you can use F10 and F11 keys to scroll the list to the left or right. According to ISPF conventions you must place a cursor on the list of messages Owner: IBM CustomPac Development Page 28 of 47

and press F10 or F11 to scroll. An indicator above the list will show you whether a hidden text is on the right or on the left of the window: < a text is on the left use F10 to scroll to the left; > a text is on the right use F11 to scroll to the right; <> a text is on the right and on the left use F10 or F11 to scroll. If the dataset name is correct the program will read a list of target zones from the global CSI dataset and display the list on the next CPPPFTP4 panel. CPPPFTP4 -------------------- Select Target Zones ---------- Row 1 to 15 of 15 Command ===> Scroll ===> CSR Step 2 of 3 Global CSI: SMPE.ZOS22.GLOBAL.CSI Select target zone(s) and press Enter to continue. Enter 's' to include a zone to the CSI submit request 'd' to remove a zone from the selection list S Type Name Dataset TARGET ARM#01T SMPE.ARMHSM.NWPM.VSPMTG1.T00.CSI TARGET CRP#01T SMPE.CAT.NWPM.VSPMTG1.T00.CSI TARGET DLA#01T SMPE.DLA.NWPM.VSPMTG1.T00.CSI TARGET MVST100 SMPE.ZOS22.MVS.TARGET.CSI TARGET MVST110 SMPE.ZOS22.MVS.TARGET.CSI TARGET MVST114 SMPE.ZOS22.MVS.TARGET.CSI TARGET NVW#01T SMPE.NETVA.NWPM.VSPMTG1.T00.CSI TARGET NVW#02T SMPE.NETVB.NWPM.VSPMTG2.T00.CSI TARGET OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET OPS#02T SMPE.OPSA.NWPM.VSPMTG2.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.T00.CSI TARGET SAU#02T SMPE.SAMVSA.NWPM.VSPMTG2.T00.CSI TARGET TAD#01T SMPE.TAD4Z.NWPM.VSPMTG1.T00.CSI TARGET WSE#01T SMPE.WSEDO.NWPM.VSPMTG2.T00.CSI ******************************* Bottom of data ******************************** Select zones that you will send to IBM. To select a zone, use option s. Selected zones are marked with a symbol >. To exclude a zone, use option d. If a zone was previously selected a symbol > would disappear. Owner: IBM CustomPac Development Page 29 of 47

CPPPFTP4 -------------------- Select Target Zones ---------- Row 1 to 15 of 15 Command ===> Scroll ===> CSR Step 2 of 3 Global CSI: SMPE.ZOS22.GLOBAL.CSI Select target zone(s) and press Enter to continue. Enter 's' to include a zone to the CSI submit request 'd' to remove a zone from the selection list S Type Name Dataset TARGET ARM#01T SMPE.ARMHSM.NWPM.VSPMTG1.T00.CSI TARGET CRP#01T SMPE.CAT.NWPM.VSPMTG1.T00.CSI > TARGET DLA#01T SMPE.DLA.NWPM.VSPMTG1.T00.CSI TARGET MVST100 SMPE.ZOS22.MVS.TARGET.CSI TARGET MVST110 SMPE.ZOS22.MVS.TARGET.CSI > TARGET MVST114 SMPE.ZOS22.MVS.TARGET.CSI TARGET NVW#01T SMPE.NETVA.NWPM.VSPMTG1.T00.CSI TARGET NVW#02T SMPE.NETVB.NWPM.VSPMTG2.T00.CSI TARGET OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET OPS#02T SMPE.OPSA.NWPM.VSPMTG2.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.T00.CSI TARGET SAU#02T SMPE.SAMVSA.NWPM.VSPMTG2.T00.CSI TARGET TAD#01T SMPE.TAD4Z.NWPM.VSPMTG1.T00.CSI TARGET WSE#01T SMPE.WSEDO.NWPM.VSPMTG2.T00.CSI ******************************* Bottom of data ******************************** Select at least one target zone. Press Enter when you are ready to continue. A next panel CPPPFTP5 with Jobcard information will be displayed. CPPPFTP5 -------------------- Jobcard Information --------- Selected 2 zone(s) Command ===> Step 3 of 3 Please update jobcard below : //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* +---------------------------------------------------------------------+ + A job will be created for you to complete the selected task. + + Please follow the instruction below to continue + + + + - Press Enter to generate JCL + + - Review the job, then SUBMIT for execution + + - Review the job output, check that all steps are completed with + + RC=0, except for ZONEEXP which may expect a RC of 4 + + - Save the generated JCL, in case you need to restart the job + +---------------------------------------------------------------------+ Press Enter to continue or F3 to return On the CPPPFTP5 panel modify JCL JOB statement. Then press Enter. Owner: IBM CustomPac Development Page 30 of 47

The program will create a batch job for you to prepare CSI data. Review the job if required and submit using the SUBMIT command. File Edit Edit_Settings Menu Utilities Compilers Test Help ISREDDE2 SYS17062.T043559.RA000.NKV.R0144852 Columns 00001 00080 Command ===> Scroll ===> CSR ****** ***************************** Top of Data ******************************* ==MSG> -Warning- The UNDO command is not available until you change ==MSG> your edit profile using the command RECOVERY ON. 000001 //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', 000002 // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, 000003 // NOTIFY=&SYSUID 000004 //* 000005 //*************************************************************** 000006 //* 000007 //* This job will extract zones from 000008 //* SMPE.ZOS22.GLOBAL.CSI 000009 //* 000010 //* Binary transfer the following output datasets to your workstation. 000011 //* 000012 //* To send these datasets to IBM, return back to the web site, 000013 //* where you have downloaded this application. 000014 //* 000015 //* NKV.IBMCPP.FCSI.GLOBAL 000016 //* NKV.IBMCPP.FCSI.TDLA#01T 000017 //* NKV.IBMCPP.FCSI.TMVST114 000018 //*************************************************************** 000019 //*------------------------------------------------------------------- 000020 //* DELETE EXPORT CSI FILES IN CASE OF RERUN 000021 //*------------------------------------------------------------------- 000022 //DELETE EXEC PGM=IDCAMS,COND=(0,LT) 000023 //SYSPRINT DD SYSOUT=* 000024 //SYSIN DD * 000025 DELETE 'NKV.IBMCPP.FCSI.GLOBAL' 000026 DELETE 'NKV.IBMCPP.FCSI.TDLA#01T' 000027 DELETE 'NKV.IBMCPP.FCSI.TMVST114' 000028 SET LASTCC=00 000029 SET MAXCC=00 000030 /* 000031 //*------------------------------------------------------------------- 000032 //* EXPORT zones to temporary data sets 000033 //*------------------------------------------------------------------- 000034 //ZONEEXP EXEC PGM=GIMSMP,COND=(0,LT) 000035 //SYSPRINT DD SYSOUT=* The job header contains a list of datasets that the job will create for you. Each of these datasets contains a packed data of the corresponding zone. For the above example, there are: NKV.IBMCPP.FCSI.GLOBAL NKV.IBMCPP.FCSI.TDLA#01T NKV.IBMCPP.FCSI.TMVST114 You will need these names to download datasets to your workstation. After the JCL completion check the job output to ensure that all steps are executed successfully with a return code 0. If there are any errors that you can fix, correct the JCL and restart the job. Owner: IBM CustomPac Development Page 31 of 47

After you exit the JCL EDIT screen, the final panel CPPPFTP7 will be displayed to indicate that you have completed the CSI prepare request. CPPPFTP7 ----------------- Order Complete Information ------------------------- Command ==> If you have submitted the job to prepare CSI or IODF files for sending to IBM, read the following instructions: +---------------------------------------------------------------+ + REVIEW THE JOB OUTPUT AND VERIFY THAT ALL STEPS ARE COMPLETED + + SUCCESSFULLY WITH RETURN CODE 0 + +---------------------------------------------------------------+ To complete the process and send your files to IBM, you are required to download created files to your workstation and return to the CustomPac web page to continue CSI or IODF submission. Press Enter or F3 to continue 8.6. Sending CSI files to IBM manually If for some reason the FTPCSI utility cannot send prepared CSI files to IBM, you can send them manually from the CustomPac or IBMLink web site. If you are a IBMLink user, you can go to the IBMLink website http://www.ibmlink.ibm.com and use the appropriate option to upload the CSI profile. If you are a CustomPac user, you can go to the IBM CustomPac website https://www.ibm.com/services/ca/en/custompac/csishipment/newcsimain.html and follow the guide to upload your CSI profile. 8.7. Prepare IODF for sending On the main panel CPPPFTP1 choose option 4 Prepare IODF for download to workstation. The CPPPFTP9 panel will be displayed. CPPPFTP9 ------------------------ IODF Dataset -------------------------------- Command ==> Step 1 of 2 Enter name of the IODF dataset that you will send to IBM: (enter the full dataset name) CPACTST.IODF00 Press Enter to continue or F3 to return Enter name of the IODF dataset that you will send to IBM. Then press Enter. Owner: IBM CustomPac Development Page 32 of 47

The program will check the dataset name and if the dataset is cataloged the program will jump to the next panel CPPPFTP5 Jobcard information. CPPPFTP5 -------------------- Jobcard Information ----------------------------- Command ===> Step 2 of 2 Please update jobcard below : //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* +---------------------------------------------------------------------+ + A job will be created for you to complete the selected task. + + Please follow the instruction below to continue + + + + - Press Enter to generate JCL + + - Review the job, then SUBMIT for execution + + - Review the job output, check that all steps are completed with + + RC=0, except for ZONEEXP which may expect a RC of 4 + + - Save the generated JCL, in case you need to restart the job + +---------------------------------------------------------------------+ Press Enter to continue or F3 to return On the CPPPFTP5 panel modify JCL JOB statement. Then press Enter. Owner: IBM CustomPac Development Page 33 of 47