home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR21 / DOCPRC13.ZIP / SAMP-DOC.ZIP / TAPECOPY.DOC < prev    next >
Text File  |  1992-11-16  |  19KB  |  251 lines
  1.                                                                                 
  2.                                                                                 
  3.                                                                                 
  4.                                                                                 
  5.                                                                                 
  6.                                                                                 
  7.                                                                                 
  8.                                                                                 
  9.                                                                                 
  10.                                                                                 
  11.                                                                                 
  12.                                                                                 
  13.                                                                                 
  14.                        *************************************                    
  15.                        *                                   *                    
  16.                        *        T A P E C O P Y            *                    
  17.                        *  ON THE MVS/XA OPERATING SYSTEM   *                    
  18.                        *                                   *                    
  19.                        *************************************                    
  20.                                                                                 
  21.                                                                                 
  22.                                                                                 
  23.                                                                                 
  24.                                                                                 
  25.                                                                                 
  26.                                                                                 
  27.                                                                                 
  28.                                                                                 
  29.                                                                                 
  30.                                                                                 
  31.                                                                                 
  32.                                                                                 
  33.                                                                                 
  34.                                                                                 
  35.                                                                                 
  36.                                                                                 
  37.                                                                                 
  38.                                                                                 
  39.                                                                                 
  40.                                                                                 
  41.                                                                                 
  42.                                                                                 
  43.                                                                                 
  44.                                                                                 
  45.                                                                                 
  46.                                                                                 
  47.                                                                                 
  48.                                                                                 
  49.                                                                                 
  50.                                                                                 
  51.                                                                                 
  52.                                                                                 
  53.                                                         John S. Ward            
  54.                                                           03/15/93              
  55.  
  56. EJECT                                                                           
  57.         The TAPECOPY procedure generates JCL to copy data sets on a library     
  58.     or foreign, standard or non labeled tape to a library or foreign,           
  59.     standard or non labeled tape.                                               
  60.                                                                                 
  61.         INVOL     - The volume serial number of the input tape.                
  62.                     Required                                                    
  63.                                                                                 
  64.         INLBL     - The label type of the input tape, SL or NL.                 
  65.                     Default: SL                                                 
  66.                                                                                 
  67.         INEXPDT   - The expiration date of the input tape.  See member          
  68.                     TMSINFO in in SYS.MVS.UPDATE for information about          
  69.                     expiration dates.                                           
  70.                     Default: 99000                                              
  71.                                                                                 
  72.         OUTVOL    - The volume serial number of the output tape.                
  73.                     Default: none, Required if OUTEXPDT is 98000                
  74.                                                                                 
  75.         OUTLBL    - The label type of the output tape, SL or NL.                
  76.                     Default: SL                                                 
  77.                                                                                 
  78.         OUTEXPDT  - The expiration date of the output tape.  See member         
  79.                     TMSINFO in in SYS.MVS.UPDATE for information about          
  80.                     expiration dates.                                           
  81.                     Default: 99000                                              
  82.                                                                                 
  83.         CNTL      - The fully qualified data set name of a table describing     
  84.                     the input tape data sets.                                   
  85.                     Default: none, Required if 98000/NL INVOL                   
  86.                                                                                 
  87.         DSN       - The data set name of the 1st data set on the tape           
  88.                     Required if INEXPDT = 98000 and no CNTL                     
  89.                                                                                 
  90.         FSQN      - The file sequence numbers of the data sets to copy.         
  91.                     FSQN must be enclosed in quotes if specified.               
  92.                     Default: all files on input tape                            
  93.                                                                                 
  94.         HIQUAL    - The hi-level qualifier for the output tape data set         
  95.                     names.                                                      
  96.                     Default: USERID                                             
  97.                                                                                 
  98.         MIDQUAL   - The mid or 2nd level qualifier for the output tape data     
  99.                     set names.                                                  
  100.                     Default: none                                               
  101.                                                                                 
  102.         OUTLST    - Flag that instructs TAPECOPY to place listing of the        
  103.                     tape in HIQUAL.TCZZZ999.OUTLST(Linvol)                      
  104.                     Default: off                                                
  105.                                                                                 
  106.         SUB       - Flag that instructs TAPECOPY to submit the Tapecopy         
  107.                     job from the generated JCL in :                             
  108.                     HIQUAL.TCZZZ999.TAPECOPY(TCinvol).                          
  109.                     Default: off                                                
  110. EJECT                                                                           
  111.        If the input tape is a library (99000) tape the user may build a         
  112.     control file or they may submit a run sheet to PCG.  If the input tape      
  113.     is a private (98000) standard labeled tape the user may run TAPECOPY        
  114.     themselves without a control file.  If the input tape is a private non      
  115.     labeled tape the user must supply a control file.  TAPECOPY will always     
  116.     use a control file if it is supplied.  There are 13 parameters to           
  117.     TAPECOPY, but in most cases default values will be used for all but a       
  118.     few parameters.                                                             
  119.                                                                                 
  120.     LIBRARY TAPES                                                               
  121.                                                                                 
  122.        If the input volume is a library tape , there are two options.  The
  123.     user may submit a run sheet to the I/O window to request that PCG           
  124.     (Production Control Group) run the procedure.  The run sheet should         
  125.     specify all parameters the user wishes passed to the TAPECOPY procedure     
  126.     including HIQUAL.  PCG will run the TAPECOPY procedure which will place     
  127.     the desired JCL in:                                                         
  128.                                                                                 
  129.                      HIQUAL.TCZZZ999.TAPECOPY(TCinvol)                          
  130.                                                                                 
  131.         The user may then inspect the JCL and possibly modify it before         
  132.     submitting it.  Note that it is the responsibility of the user to submit      
  133.     the JCL generated.  PCG will not submit it.  The turnaround time on a       
  134.     run sheet submitted to PCG is 24 hours.                                     
  135.                                                                                 
  136.         The other option is to create a control file that describes the data
  137.     set on the input volume.  This method will allow the user to immediately
  138.     generate and submit the JCL.  The format of the control file is:
  139.  
  140.                        n DATA.SET.NAME RECFM LRECL BLKSIZE
  141.  
  142.         'n' is either the file sequence number of the data set on the input
  143.     tape or a '*'.  A '*' represents the file sequence number of the
  144.     previous table entry plus one.
  145.  
  146.         The user may obtain the necessary file sequence and DCB information
  147.     by running either a TINFO or requesting an OPRTINFO job on the input
  148.     tape (see member TAPEINFO in SYS.MVS.UPDATE).  The difficult part may
  149.     be in finding the full dsname of the input data sets.  Standard tape
  150.     labels contain only the last 17 characters of the data set name and non
  151.     labeled tapes have no data set names on the tape.  For security reasons
  152.     the tape management system knows the full name of all data sets in its
  153.     catalog, and it will not allow access to that data set unless the
  154.     correct full data set name is given.  PCG has the authority to scan the
  155.     tape management system catalog for the full data set name which users
  156.     do not have.  If the input tape data sets are catalogued the full
  157.     dsname is available in ISPF screen 3.4.
  158.  
  159. EJECT
  160.     PRIVATE TAPES
  161.  
  162.         If the input tape is a private (EXPDT=98000) standard labeled tape
  163.     the user must supply the data set name of the first file on the tape
  164.     in the DSN parameter.  If the input tape is non labeled a CNTL
  165.     parameter must be passed.
  166.  
  167.        If TAPECOPY is run without a control file it will submit a job with
  168.     job characters TI, which will pull the necessary information from the
  169.     tape to create the JCL to copy the tape.  The actual tapecopy job has
  170.     job characters TC.
  171.  
  172.        TAPECOPY generates data set names for the output tape in the form
  173.     HIQUAL.MIDQUAL.Fnnn.  HIQUAL defaults to the invoking userid or the
  174.     user may pass it as a parameter.  The user must have RACF authority to
  175.     write to that high level qualifier.  HIQUAL must be 6 or 7 characters.
  176.     MIDQUAL is an optional but recommended parameter that describes the
  177.     contents of the tape.  If the generated output data set names are
  178.     unsatisfactory, edit the generated JCL found in                             
  179.     HIQUAL.TCZZZ999.TAPECOPY(TCinvol).  Change the DSN in the SYSUT2 DD         
  180.     statements to the preferred data set name and submit the job.  Please
  181.     note that data set names must be unique.  If the user copies two tapes
  182.     and uses the same hi level qualifier and mid level qualifier the second
  183.     job run will have a return code of 0 but the output data sets will not
  184.     be catalogued because there is already a catalog entry with that name.                    
  185.                                                                                 
  186.         The user should not pass the FSQN parameter if a CNTL data set is       
  187.     specified.  That information is in the table.  The user should not pass     
  188.     the FSQN parameter if they wish to copy all the data sets on a tape.        
  189.     FSQN may be a list and/or range of file sequence numbers.  FSQN('9')        
  190.     FSQN('1,3,8') FSQN('1,4-7,9') are all valid examples.                       
  191.                                                                                 
  192.         Output data sets on library (99000) tapes are catalogued.  Output       
  193.     data sets on foreign (98000) data sets are not catalogued.                  
  194. EJECT                                                                           
  195.     EXAMPLES:                                                                   
  196.                                                                                 
  197.      1. If standard labeled library tape 7001 contains the data sets:           
  198.                                                                                 
  199.                             USERID.THESIS.DATA1                                 
  200.                             USERID.THESIS.DATA2                                 
  201.                             USERID.THESIS.DATA3                                 
  202.                                                                                 
  203.         The user submits a run sheet requesting:                                
  204.                                                                                 
  205.               TAPECOPY INVOL(007001) HIQUAL(USERID) MIDQUAL(THESISBK)           
  206.                                                                                 
  207.         PCG will run TAPECOPY which will place JCL in                           
  208.         USERID.TCZZZ999.TAPECOPY(TC007001) that will write a standard           
  209.         labeled library tape with the catalogued data sets:                     
  210.                                                                                 
  211.                             USERID.THESISBK.F001                                
  212.                             USERID.THISISBK.F002                                
  213.                             USERID.THESISBK.F003                                
  214.                                                                                 
  215.         when submitted.                                                         
  216.                                                                                 
  217.         If the user prefers, they may build a control file, run TAPECOPY,       
  218.         and submit the tapecopy job immediately.                                
  219.                                                                                 
  220.         Write USERID.TAPE.CNTL containing:                                      
  221.                                                                                 
  222.               * USERID.THESIS.DATA1 FB  80   3120                               
  223.               * USERID.THESIS.DATA2 FB  80   6240                               
  224.               * USERID.THESIS.DATA3 FBA 133  3192                               
  225.                                                                                 
  226.         Run TAPECOPY                                                            
  227.                                                                                 
  228.         TAPECOPY INVOL(007001) CNTL(USERID.TAPE.CNTL) OUTVOL(FOREIGN)            
  229.         OUTLBL(NL) OUTEXPDT(98000)                                              
  230.                                                                                 
  231.         This will create a foreign non labeled tape appropriate for mailing     
  232.         to another site.                                                        
  233.                                                                                 
  234.         If USERID.TAPE.CNTL contained instead:                                  
  235.                                                                                 
  236.               2 USERID.THESIS.DATA2 FB   80 6240                                
  237.               * USERID.THESIS.DATA3 FBA 133 3192                                
  238.                                                                                 
  239.         only the 2nd and the 3rd data sets would be copied.                     
  240.                                                                                 
  241.                                                                                 
  242.      2.  TAPECOPY INVOL(FOREIGN) INLBL(SL) INEXPDT(98000) DSN(DATA.SET.NAME)     
  243.          FSQN('1,3,4-9,23,45-60') OUTLST SUB                                    
  244.                                                                                 
  245.          Will copy the data sets specified in the FSQN from a foreign           
  246.          standard labeled tape to a standard labeled library tape.  The job
  247.          will automatically be submitted because of the SUB parameter, and a     
  248.          list of the the output tape will be written to:                        
  249.                                                                                 
  250.                           HIQUAL.TCZZZ999.OUTLST(FOREIGN)                       
  251.