CustomPac FTPCSI Utility User Guide

Transcription

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

2 Contents 1. Summary of changes Version Version Version Version Version Introduction Features Prerequisites Upgrading a previous version of the FTPCSI Install FTPCSI to a new dataset, keeping the old version unchanged Transmission log migration... 8 Configuration migration Install FTPCSI to the same dataset, replacing the old version Transmission log migration... 8 Configuration migration Replace existing ftpcsi.jar with a new version Put a new ftpcsi.jar to a separated USS directory Place both new and old ftpcsi.jar files to the same USS directory Downloading the FTPCSI utility Uploading files to z/os host Uploading fcsilib.bin Uploading ftpcsi.jar Recommended place for ftpcsi.jar Transfer directly to USS Transfer to z/os, then to USS Unpacking FTPCSI utility Configuring FTPCSI utility Configuring for a proxy server https.proxyhost https.proxyport proxy.username proxy.password Owner: IBM CustomPac Development Page 2 of 47

3 Example Working with FTPCSI utility Starting the utility Test connection Prepare and send CSI Prepare and send IODF Prepare CSI for sending Sending CSI files to IBM manually Prepare IODF for sending Sending IODF files to IBM manually Downloading an order from IBM Preparation Processing View history log Appendix A. Content of the FTPCSI utility Appendix B. FTPCSI configuration file FTPCSI configuration parameters Appendix C. CPPECSI invocation parameters Examples Using the default configuration Using the default test configuration Using a custom configuration in the sequential dataset Using a custom configuration in the PDS member Owner: IBM CustomPac Development Page 3 of 47

4 1. Summary of changes 1.1. Version Java requirements: - Java version 8 (or higher) required to execute FTPCSI Java classes. FTPCSI utility version 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 Version FTPCSI utility version 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

5 - CPPPFTPC panel added to the Appendix A Content of the FTPCSI utility Version The FTPCSI utility version 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 Version The FTPCSI utility version 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 when a long configuration parameter continues on several lines, the program removes leading spaces from every line before concatenation. In version 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 The new version of FTPCSI was released to comply with current security requirements. The FTPCSI utility version 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

6 - 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

7 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 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 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 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

8 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 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 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

9 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 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 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 jar or ftpcsi 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

10 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: 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

11 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= 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 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= 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 KiB/s 00:00 ETA 250 Transfer completed successfully 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 USER /12/ FB 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

12 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 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 KiB/s 00:00 ETA 250 Transfer completed successfully bytes sent in 00:04 ( 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

13 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 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= 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 KiB/s 00:00 ETA 250 Transfer completed successfully 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 /12/ U 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

14 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

15 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) 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 (port 8080, user id fcsiuser and password secret ): JavaOpts = -Dfile.encoding=UTF-8 -Dhttps.proxyHost= 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

16 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. CPPPFTP 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: 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 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 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

17 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 *** :54: Logging configuration loaded from the internal resource [ :54: Version :54: Test mode on :54: URL: :54: Start testing connection :54: Uploading :54: 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: 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 Prepare and send CSI On the main panel CPPPFTP1 choose option 1. The CPPPFTP3 panel will be displayed. CPPPFTP 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

18 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

19 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. CPPPFTP 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

20 CPPPFTP 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. CPPPFTP Parameters for CSI Upload Selected 2 zone(s) Command ===> Step 3 of 4 Customer number your. @your.domain Country Costa Rica Enter '/' for a list of countries Order number... DF Offering 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

21 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 so that we can associate it with request you made. IBM could use this to send important updates for your request. Check out the IBM Online Privacy Statement Highlights: I consent to having IBM collect my _ (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

22 The next is CPPPFTP5 Jobcard information panel. CPPPFTP 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 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

23 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.T RA000.NKV.R Columns 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 //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* //*************************************************************** //* //* This job will extract zones from //* SMPE.ZOS22.GLOBAL.CSI //* and send following extracted zone(s) to IBM server //* //* You could also send these datasets to IBM by yourself from the site //* where you have downloaded this application //* //* NKV.IBMCPP.FCSI.GLOBAL //* NKV.IBMCPP.FCSI.TDLA#01T //* NKV.IBMCPP.FCSI.TMVST //*************************************************************** //* //* DELETE EXPORT CSI FILES IN CASE OF RERUN //* //DELETE EXEC PGM=IDCAMS,COND=(0,LT) //SYSPRINT DD SYSOUT=* //SYSIN DD * DELETE 'NKV.IBMCPP.FCSI.GLOBAL' DELETE 'NKV.IBMCPP.FCSI.TDLA#01T' DELETE 'NKV.IBMCPP.FCSI.TMVST114' SET LASTCC= SET MAXCC= /* //* //* EXPORT zones to temporary data sets //* //ZONEEXP EXEC PGM=GIMSMP,COND=(0,LT) //SYSPRINT DD SYSOUT=* //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

24 After the exit from the JCL EDIT screen, the final panel CPPPFTP6 will be displayed to show that the CSI submit request is completed. CPPPFTP 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. CPPPFTP 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 your. @your.domain Country Costa Rica Enter '/' for a list of countries Order number... DF 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

25 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 so that we can associate it with request you made. IBM could use this to send important updates for your request. Check out the IBM Online Privacy Statement Highlights: I consent to having IBM collect my _ (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

26 The next is CPPPFTP5 Jobcard information panel. CPPPFTP 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 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

27 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.T RA000.NKV.R Columns 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 //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* //*************************************************************** //* //* This job will extract IODF from //* CPACTST.IODF //* and send following extracted IODF to IBM server //* //* You could also send this dataset to IBM by yourself from the site //* where you have downloaded this application //* //* NKV.IBMCPP.FCSI.IODF.TRS //* //*************************************************************** //* //* //* DELETE work files in case of rerun //* //DELETE EXEC PGM=IDCAMS,COND=(0,LT) //SYSPRINT DD SYSOUT=* //SYSIN DD * DELETE 'NKV.IBMCPP.FCSI.IODF.REPRO' DELETE 'NKV.IBMCPP.FCSI.IODF.TRS' SET LASTCC= SET MAXCC= /* //* //* REPRO IODF file //* //REPRO EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //IODF DD DISP=SHR,DSN=CPACTST.IODF //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

28 After the exit from the JCL EDIT screen, the final panel CPPPFTP6 will be displayed to show that the IODF submit request is completed. CPPPFTP 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. CPPPFTP 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

29 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. CPPPFTP 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

30 CPPPFTP 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. CPPPFTP 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 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

31 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.T RA000.NKV.R Columns 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 //FCSI JOB (ACT,NBR),'EXPORT-CSI-IODF', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* //*************************************************************** //* //* This job will extract zones from //* SMPE.ZOS22.GLOBAL.CSI //* //* Binary transfer the following output datasets to your workstation //* //* To send these datasets to IBM, return back to the web site, //* where you have downloaded this application //* //* NKV.IBMCPP.FCSI.GLOBAL //* NKV.IBMCPP.FCSI.TDLA#01T //* NKV.IBMCPP.FCSI.TMVST //*************************************************************** //* //* DELETE EXPORT CSI FILES IN CASE OF RERUN //* //DELETE EXEC PGM=IDCAMS,COND=(0,LT) //SYSPRINT DD SYSOUT=* //SYSIN DD * DELETE 'NKV.IBMCPP.FCSI.GLOBAL' DELETE 'NKV.IBMCPP.FCSI.TDLA#01T' DELETE 'NKV.IBMCPP.FCSI.TMVST114' SET LASTCC= SET MAXCC= /* //* //* EXPORT zones to temporary data sets //* //ZONEEXP EXEC PGM=GIMSMP,COND=(0,LT) //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

32 After you exit the JCL EDIT screen, the final panel CPPPFTP7 will be displayed to indicate that you have completed the CSI prepare request. CPPPFTP 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 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 and use the appropriate option to upload the CSI profile. If you are a CustomPac user, you can go to the IBM CustomPac website and follow the guide to upload your CSI profile Prepare IODF for sending On the main panel CPPPFTP1 choose option 4 Prepare IODF for download to workstation. The CPPPFTP9 panel will be displayed. CPPPFTP 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

33 The program will check the dataset name and if the dataset is cataloged the program will jump to the next panel CPPPFTP5 Jobcard information. CPPPFTP 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 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