Step 5. Complete the tar file extract dialog ($$TAREXT)

The Tar File Extract dialog is member $$TAREXT in the BMC Installer PDS.

1. Invoke the Tar File Extract dialog by entering the TSO EXECUTE command with the data set name of the BMC Installer, followed by ($$TAREXT). For example:
   TSO EX 'hlq.Unknown macro: confluence_display.
   .INS($$TAREXT)'
   where hlq is the high-level qualifier you specified when transferring the BMC Installer data set to the mainframe. The exact data set name can be found in the notes you made in Step 1. Allocate and initialize the BMC installer PDS.
   The screen in the following figure asks you to specify and confirm the data sets you specified in Step-3-Specify-DSN-for-installation-settings-ISPF-table and Step-13-Specify-data-set-name-for-generated-JCL for this order.
   Create TAR package extract JCL

                           Create TAR Package extract JCL
   Command ==> _________________________________________________________________
   Press Enter to continue or PF3 to Exit
   
   The BMC Installer dialog must be executed before running this dialog
   so that the customized Receive JCL is available for parsing by this dialog.
   If you have not executed the $$CWINST dialog, please exit this dialog and
   run it.
   
   
   This application refers to and retains variables in ISPF tables for future
   use. Please specify the dataset name for the existing ISPF tables created
   when $$CWINST was run for this order.
   
   
   The following two datasets can be the same file:
   Enter/update the DSN of the file where the ISPF tables were stored.
       hlq.CPWR.INSTLIB                                OK
   Enter/update the DSN of the file where the generated jobstreams were stored.
       hlq.CPWR.INSTLIB                                OK
   If the DSNs above are correct, press Enter to validate and/or continue.
2. Specify the data set you specified in Step-3-Specify-DSN-for-installation-settings-ISPF-table.
3. Specify the data set you specified in Step-13-Specify-data-set-name-for-generated-JCL.
4. Press Enter.
   A Building internal tables message is displayed.

5. Press Enter again when the tables have been built. The screen as shown in the following figure is displayed.
   Specify TAR package paths

                           Create TAR Package extract JCL
   Command ==> _________________________________________________________________
   Press Enter to continue or PF3 to return to previous panel.
   
   Please enter the path to the folder containing the tar file.
       _________________________________________________________________________
   Please enter the name of the tar file: ______________________________________
   Please enter the path to the folder to contain the extracted tarball.
       _________________________________________________________________________
   If the paths above are correct, press Enter to continue.
   The existence of the paths and tar file are checked and must be present.

   The tar file extract jobstream needs the paths to where the tar file is located (see Step-3-Create-z-OS-UNIX-directory-and-file-structure) and the directory you want to extract the tar file into.
   A new folder will be created under the extract path using the package ID from the $04RECV jobstream. The extracted tar file will be stored into that folder. SMP/E requires that the tar files be placed in a folder with the name of the package ID. The tar file extract jobstream will create a folder using that name in the directory pointed to by the extract path.

6. In the first field, enter the path to the tar file (must be the base ????????/rfn/tarball folder as specified in the Sample JCL to create z/OS UNIX directory and file structure figure). Do not include the name of the tar file in the path.
7. In the second field, enter the name of the tar file.
8. In the last field, enter the path to a directory that will contain the extracted tar package.
9. Press Enter.
   The dialog checks that the paths exist.

10. Press Enter again.
    The Tar File Extract dialog uses input from this dialog and from the JCL Customization Dialog to create two jobstreams:

    1. Job $20EXTAR – extract files from the staged tar file into a z/OS UNIX directory for SMPNTS (see Step-6-Extract-tar-file-contents).
    2. Job $04RCVTF – modified Receive jobstream. Use this jobstream in place of job $04RECV when performing the SMP/E install (see Step-4-Receive-From-Network-the-base-code-cumulative-maintenance-and-HOLDDATA). This jobstream will perform an SMP/E NTS Receive from data sets stored on z/OS UNIX storage.

    The following message indicates that the $20EXTAR and $04RCVTF jobstreams have been created in the data set you specified in Step-13-Specify-data-set-name-for-generated-JCL.

    JCL for tarfile extract and modified Receive jobstream created
    ***