CustomPac FTPCSI Utility User Guide

Transcription

1 CustomPac FTPCSI Utility User Guide Version January 2017 Owner: IBM CustomPac Development Page 1 of 23

2 Contents 1. Summary of changes Version Version Introduction Features Prerequisites Downloading the FTPCSI utility Uploading files to z/os host Uploading fcsilib.bin Uploading ftpcsi.jar... 6 Transfer directly to USS... 6 Transfer to z/os, then to USS Unpacking FTPCSI utility Configuring FTPCSI utility Configuring for proxy server... 8 https.proxyhost... 8 https.proxyport... 8 proxy.username... 8 proxy.password... 8 Example Working with FTPCSI utility Starting the utility Test connection Prepare and send CSI Prepare CSI for sending Sending CSI files to IBM manually 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 Owner: IBM CustomPac Development Page 2 of 23

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

4 1. Summary of changes 1.1. 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.2. 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). - 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. 2. Introduction FTPCSI is a z/os tool that helps you in sending your CSI files to IBM. The utility collects all the required information, exports your SMP/E zones from CSI files 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. Owner: IBM CustomPac Development Page 4 of 23

5 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 your 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 data required to submit your data (i.e. your address, customer number and more) then export your CSI zones and send the data to IBM. - Export your CSI zones but do not send them to IBM. - View a log of transactions sent to IBM Prerequisites The following products are required to be installed on your z/os host to run FTPCSI utility. - ISPF/PDF version 3.5 or above - SMP/E release 1.5 or above - Java 1.6 or above 3. 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 4. Uploading files to z/os host 4.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 the following attributes: - LRECL=80 - BLKSIZE= RECFM=FB. Here is an example of using FTP to upload fcsilib.bin to z/os host: Owner: IBM CustomPac Development Page 5 of 23

6 $ 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. $ 4.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 the USS folder directly or transfer the file to a z/os sequential dataset and then copy it to the USS. 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 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 Owner: IBM CustomPac Development Page 6 of 23

7 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 host file with the undefined record format: - RECFM=U 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 5. 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 the partitioned dataset containing FTPCSI utility members. Owner: IBM CustomPac Development Page 7 of 23

8 By default the extracted PDS name is tsoprefix.fcsilib. 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 will need to customize the FCSICONF member before the first run. 6. 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 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 ): Owner: IBM CustomPac Development Page 8 of 23

9 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. 7. Working with FTPCSI utility 7.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 FTPCSI (Method Selection) OPTION ===> There are 2 methods to prepare and send CSI to IBM. The first method is to prepare files on your z/os and then send it to IBM with the same job. The second method is to prepare CSI files on your z/os, then download files to your workstation and send them from the workstation Test connection between your z/os and IBM. Status: PASSED Use option 1 if test status is "PASSED". Date : 2016/12/01 02: Prepare and send CSI to IBM from your z/os host. Use this option only if the connection test status is PASSED. 2. Prepare CSI for sending from workstation. Use this option if you did not pass the connection test. 3. View history log. View a list of transactions sent by you from this system. CSI to IBM from your workstation. 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 the options: Option 0 test connection to the IBM CustomPac server. Option 1 prepare CSI and send zones information to IBM. Option 2 prepare CSI but do not send any data to IBM. You can use prepared files to upload CSI data manually from your workstation. Option 3 view a log of transactions sent to 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 9 of 23

10 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/J7.1/bin:$PATH Command: java -Dfile.encoding=UTF-8 -jar /u/mtv/ftpcsi.jar -test URL= 03.ibm.com/cgi-bin/services/ca/en/custompac/runsubmit_ .cgi RC: 0 *** STDOUT *** Test mode on Start testing connection. Testing connection is completed successfully. Have a nice day! *** STDERR *** ******************************** Bottom of Data ******************************** Press F3 to continue. Upon return to the main panel CPPPFTP1 a connection status and time are updated on the screen Test connection between your z/os and IBM. Status: PASSED Use option 1 if test status is "PASSED". Date : 2016/12/01 02: If the test status is FAILED the FTPCSI utility cannot send your data to IBM from this z/os system. You will need to use the option 2 to prepare files and then download them 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 Global CSI Dataset COMMAND ==> Step 1 of 4 Ticket Number : 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 want to send to IBM. Then press Enter. 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. Owner: IBM CustomPac Development Page 10 of 23

11 Select Target Zones Row 1 to 12 of 12 COMMAND ===> Scroll ===> CSR Step 2 of 4 Ticket Number : 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 OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.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 want 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 Select Target Zones Row 1 to 12 of 12 COMMAND ===> Scroll ===> CSR Step 2 of 4 Ticket Number : 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 OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.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. Owner: IBM CustomPac Development Page 11 of 23

12 FTPCSI (Order data) Selected 2 zone(s) COMMAND ===> Step 3 of 4 Ticket Number : Customer number your. @your.domain Country Costa Rica Enter '/' for a list of countries Order number... DF Offering ProductPac 2. RefreshPac 3. OMISLoad Yes, please have IBM or an affilate send me . Stay informed about IBM products, services, and other offerings. If you want to stay informed by , please let us know by checking the box below. / Please do not use this information for other communications. IBM or an affiliate or selected organizations may keep you informed about IBM related products, services and other offerings through ways other than , for example, by telephone or postal mail. Press Enter to continue or F3 to return Enter appropriate data. To select a country from the list please enter a / symbol in the Country field and press Enter. A pop-up window will appear. Select a country from the list using s option and press Enter. Row 1 to 16 of 133 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 Owner: IBM CustomPac Development Page 12 of 23

13 When all parameters are entered, press Enter to go to the CPPPFTP5 Jobcard information panel FTPCSI (Jobcard Information) ---- Selected 2 zone(s) COMMAND ===> Step 4 of 4 Ticket Number : Please update jobcard below : //SENDCSI JOB (ACT,NBR),'EXPORT-CSI', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* A job will be created for you to unload the CSI file. 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. The program will create a batch job for you to prepare and send CSI data to IBM. Review and change the job if required and submit using the SUBMIT command. Owner: IBM CustomPac Development Page 13 of 23

14 File Edit Edit_Settings Menu Utilities Compilers Test Help EDIT SYS16336.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 //SENDCSI JOB (ACT,NBR),'EXPORT-CSI', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* //*************************************************************** //* //* ************************************************************ //* * This job is for ticket number only. * //* * DO NOT change the ticket number. * //* * DO NOT use this JCL for any other purpose. * //* ************************************************************ //* //* This job will extract zones from //* SMPE.ZOS22.GLOBAL.CSI //* //* Binary transfer the following output datasets from this job //* to IBM FTP Server //* //* NKV.IBMCPP.FCSI.GLOBAL //* NKV.IBMCPP.FCSI.TDLA#01T //* NKV.IBMCPP.FCSI.TMVST //* //* After the CSI file have been created and transferred, return back //* to the web site, where you have downloaded this application. to //* continue //* //*************************************************************** //* //* 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' 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. After the exit from the JCL EDIT screen, the final panel CPPPFTP6 will be displayed to show that the CSI submit request is completed. Owner: IBM CustomPac Development Page 14 of 23

15 FTPCSI (Order Complete Information) COMMAND ==> If you have submitted the job to prepare and send CSI files to IBM server, 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 7.4. Prepare CSI for sending In case when you cannot send your data from z/os system you can use option 2 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 2 and press Enter. A panel CPPPFTP3 will be displayed 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 want to send to IBM. Then press Enter. 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. Owner: IBM CustomPac Development Page 15 of 23

16 Select Target Zones Row 1 to 12 of 12 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 OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.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 want 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 Select Target Zones Row 1 to 12 of 12 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 OPS#01T SMPE.OPS.NWPM.VSPMTG1.T00.CSI TARGET RTC#01T SMPE.RTC.NWPM.VSPMTG2.T00.CSI TARGET SAU#01T SMPE.SAMVS.NWPM.VSPMTG1.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 panel will be displayed. Owner: IBM CustomPac Development Page 16 of 23

17 FTPCSI (Jobcard Information) ---- Selected 2 zone(s) COMMAND ===> Step 3 of 3 Please update jobcard below : //SENDCSI JOB (ACT,NBR),'EXPORT-CSI', // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),REGION=0M, // NOTIFY=&SYSUID //* A job will be created for you to unload the CSI file. 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. The program will create a batch job for you to prepare and CSI data. Review the job if required and submit using the SUBMIT command. Owner: IBM CustomPac Development Page 17 of 23

18 File Edit Edit_Settings Menu Utilities Compilers Test Help EDIT SYS16336.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 //SENDCSI JOB (ACT,NBR),'EXPORT-CSI', // 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 from this job //* to your workstation //* //* NKV.IBMCPP.FCSI.GLOBAL //* NKV.IBMCPP.FCSI.TDLA#01T //* NKV.IBMCPP.FCSI.TMVST //* //* After the CSI file have been created and transferred, return back //* to the web site, where you have downloaded this application. to //* continue //* //*************************************************************** //* //* 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 the CSI to temporary data sets 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. After you exit the JCL EDIT screen, the final panel CPPPFTP7 will be displayed to show that you have completed the CSI submit request. Owner: IBM CustomPac Development Page 18 of 23

19 CPPPFTP FTPCSI (Order Complete Information) COMMAND ==> If you have submitted the job to prepare CSI 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 CSI(s) to IBM, you are required to download created files to your workstation and return to the CustomPac web page to continue CSI submission. Press Enter or F3 to continue 7.5. Sending CSI files to IBM manually If for some reason the FTPCSI utility cannot send the 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 use the appropriate option to upload the CSI profile View history log On the main panel CPPPFTP1 use option 3 to open the History log panel CPPPFTPL FTPCSI (History Log) Row 1 to 2 of 2 COMMAND ==> Select records to view a list of zones Customer Ticket S Date Time Number Number 2016/10/25 08:33: /12/01 06:55: ******************************* Bottom of data ******************************** The panel presents a list of transactions sent to IBM. Use option s to select a record and view a list of zones sent by the transaction. Owner: IBM CustomPac Development Page 19 of 23

20 Cmd=> Row 1 to 3 of 3 Date : 2016/12/01 Time : 06:55:36 Ticket: Zones DLA#01T GLOBAL MVST114 *********** Bottom of data ************ 8. Appendix A. Content of the FTPCSI utility. The FTPCSI partitioned dataset contains the following members. Member Name Type Required? Description CPPECSI REXX program Y Main program CPPEFLOG REXX program Y Log update program CPPFLOG TEXT N (dynamically created) Transaction log CPPPFTP# ISPF panel Y Test connection to the IBM CustomPac server CPPPFTP1 ISPF panel Y Main panel CPPPFTP2 ISPF panel Y Country selection panel CPPPFTP3 ISPF panel Y Global CSI dataset entry panel CPPPFTP4 ISPF panel Y Target zones selection panel CPPPFTP5 ISPF panel Y Jobcard information CPPPFTP6 ISPF panel Y Order complete note for Prepare and Send CSI path CPPPFTP7 ISPF panel Y Order complete note for Prepare CSI path CPPPFTP8 ISPF panel Y Order parameters entry panel CPPPFTPL ISPF panel Y List of history records CPPPFTPZ ISPF panel Y List of zones for a history record FCSI00 ISPF messages Y List of FCSIxxxx messages FCSICNTR TEXT Y List of countries FCSICONF TEXT Y Default FTPCSI configuration file FCSIJCL ISPF skeleton Y Batch job skeleton FCSISTDP ISPF skeleton Y STDPARM DD skeleton FCSILIC TEXT Y License text Owner: IBM CustomPac Development Page 20 of 23

21 9. Appendix B. FTPCSI configuration file. The FTPCSI configuration file contains a list of parameters for the CPPECSI program. Parameters are specified in the format parm_name = value A parameter name should start in the first column. It is possible to continue a long value on the next line. To achieve this, leave a blank in the first column of the next line. If the line starts with a # symbol it is treated as a comment and the line is ignored FTPCSI configuration parameters Parameter Default value Required? Description JavaPath /usr/lpp/java/j7.1/bin N Java location. Leave the parameter blank to use the default Java program or put a correct path here. JavaOpts -Dfile.encoding=UTF-8 N Java options. It is not recommended to change this parameter. JarPath N Location of the application jar file. Leave the parameter blank to use a jar file from the Java classpath or put a correct path here. JarFile ftpcsi.jar Y Name of the application jar file. Do not change this parameter. JarOpts N Options passed to the jar file. A single option is allowed at moment: -debug. url cgi-bin/services/ca/en/custompac/ runsubmit_ .cgi Y URL to the IBM CustomPac server component. Do not change this parameter. StdParmLLQ IBMCPP.FCSI.STDPARM Y Low-level qualifier of the temporary STDPARM dataset. The program will add your TSO user id to the left of this value to create a full dataset name. Owner: IBM CustomPac Development Page 21 of 23

22 Parameter Default value Required? Description StdParmLRECL 255 Y Record length of the STDPARM dataset. 10. Appendix C. CPPECSI invocation parameters CPPECSI program accepts the following optional parameter: CONF(TEST dataset) If the parameter is not specified, the program will use a default configuration member FCSICONF. If the CONF(TEST) is specified, the program will use a default TEST configuration member FCSICONT. The FCSICONT member is not provided with the utility. You could create your own member if required. If the CONF(dataset) is specified, the program will use this configuration dataset. You could specify a sequential dataset name or a PDS with a member name Examples Using the default configuration This command will run the CPPECSI program with a default configuration member ftpcsi.instlib(fcsiconf) : TSO EXEC ftpcsi.instlib(cppecsi) Using the default test configuration This command will run the CPPECSI program with a default test configuration member ftpcsi.instlib(fcsicont). TSO EXEC ftpcsi.instlib(cppecsi) CONF(TEST) Using a custom configuration in the sequential dataset This command will run the CPPECSI program with a configuration residing in the sequential dataset your.own.dataset. Please note that you must double quotes inside the CONF parameter. TSO EXEC ftpcsi.instlib(cppecsi) CONF( your.own.dataset ) Do not use quotes for the dataset if you want to add your TSO prefix in the beginning of its name. This command will run the CPPECSI program with a configuration residing in the sequential dataset tsoprefix.own.dataset TSO EXEC ftpcsi.instlib(cppecsi) CONF(own.dataset) Using a custom configuration in the PDS member This command will run the CPPECSI program with a configuration residing in the partitioned dataset member your.own.dataset(member). Please note that you must double quotes inside the CONF parameter. TSO EXEC ftpcsi.instlib(cppecsi) CONF( your.own.dataset(member) ) Owner: IBM CustomPac Development Page 22 of 23

23 Do not use quotes for the dataset if you want to add your TSO prefix in the beginning of its name. This command will run the CPPECSI program with a configuration residing in the partitioned dataset member tsoprefix.own.dataset(member) TSO EXEC ftpcsi.instlib(cppecsi) CONF(own.dataset(member)) Owner: IBM CustomPac Development Page 23 of 23