LISTDSJ TSO Command for MVS 3.8J / Hercules

Date: 4/29/2019  Release V1R0M0
Author: Larry Belmontes Jr.
        https://ShareABitofIT.net/LISTDSJ-for-MVS-3-8J   


Assumptions:
------------
- Running MVS 3.8J and Hercules on a PC 
- Using 3270 Terminal Emulator
- 3270 Terminal Emulator has a File Transfer Function
  to send files from PC to HOST and vice-versa    
- Access to User ID, HERC01
- Access to existing PDS, HERC01.TEST.CNTL
  
  
Install using 3270 emulator file transfer                   
-----------------------------------------

 NOTE: Although not required to install LISTDSJ, two user-mods 
       are required before using LISTDSJ.                       

 1) Download ZIP file to your PC.                
  
 2) Unzip the downloaded file into a temp directory on your PC.

 3) Log on to MVS 3.8J using user id (e.g. HERC01).                                         

 4) Position session screen to TSO READY prompt                                                                                       
                                                                                                                              
 5) Upload $INST01 installation job deck to MVS 3.8J                            
                                                                                                                              
    - Using the 3270 terminal emulators transfer file or equivalent function      
      (you may need to refer to your terminal emulator help function / documentation
       for exact user dialog), upload $INST01                                             
      - Below are illustrative highlights that may differ from your 3270 emulator
        file transfer dialog
        - Provide the PC file to send location for $INST01
          (e.g. C:\TEMPDIR\$INST01)
        - Provide the HOST file location to receive $INST01
          (e.g. HERC01.TEST.CNTL($INST01))
                              
 6) Start a MVS 3.8J editor (RPF or RFE), edit member $INST01 in the                     
    uploaded PDS (e.g. HERC01.TEST.CNTL).  Review JCL, modify and save. 
                                                                          
     - $INST01 installs TSO components on your system into SYS2 libraries.
                      
 7) Submit $INST01.                                                                
                                                                          
 8) Review JOB output.  All return codes should be zero except for                      
    last step (VALDAT6).  This is normal.                                                   
                                                                          
    - For reference, you can compare your output to the installation and                                                  
      validation output (LISTDSJ1.PDF) provided in the install ZIP file.                           
                                                                            
 9) LISTDSJ TSO Components installation is complete.                           
                                                                            
    - If you do NOT have ISPF 2.0 installed on our system,
      you are complete with the installation.                         
                                                                            
      Congratulations!                                                       
                                                                            
    - Otherwise, proceed to the next step.                    
                                                                            
------                                                                      
                                                                            
10) Upload $INST02 installation job deck to MVS 3.8J.                           
                                                                                                                              
    - Using your 3270 terminal emulators transfer file or equivalent function      
      (you may need to refer to your terminal emulator help function / documentation
       for exact user dialog), upload $INST02                                             
      - Below are illustrative highlights that may differ from your 3270 emulator
        file transfer dialog
        - Provide the PC file to send location for $INST02
          (e.g. C:\TEMPDIR\$INST02)
        - Provide the HOST file location to receive $INST02
          (e.g. HERC01.TEST.CNTL($INST02))
                              
11) Start a MVS 3.8J editor (RPF or RFE), edit member $INST02 in the                     
    uploaded PDS (e.g. HERC01.TEST.CNTL).  Review, modify ISPF library
    names per your ISPF 2.0 configuration.  Save changes.                   
                                                                          
     - $INST02 installs ISPF 2.0 components into ISPF libraries.            
                      
12) Submit $INST02.                                                                
                                                                          
13) Review JOB output.  All return codes should be zero.                                
                                                                          
    - For reference, you can compare your output to the installation and                                                  
      validation output (LISTDSJ2.PDF) provided in the install ZIP file.                           
                                                                            
14) Test the ISPF 2.0 LISTDSJ application.                  
    - Start ISPF 2.0
    - From the ISPF Main Menu, select option 6, COMMAND panel
    - Enter the TSO Command
       %CLISTDIJ

    - This will display the LISTDSJ panel,                         
      - Type HERC01.TEST.CNTL for the NAME of the DSN
      - Hit <ENTER>                                                         
      - Results for HERC01.TEST.CNTL are displayed               
                                                                            
15) LISTDSJ ISPF 2.0 Components installation is complete.                 
                                                                            
                                                                            


Enjoy LISTDSJ!

