home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR21 / DOCPRC13.ZIP / SAMP-DOC.ZIP / SUBT.DOC < prev    next >
Text File  |  1992-11-08  |  9KB  |  112 lines

  1.                                                                                 
  2.                                                                                 
  3.                                                                                 
  4.                                                                                 
  5.                                                                                 
  6.                                                                                 
  7.                                                                                 
  8.                                                                                 
  9.                                                                                 
  10.                                                                                 
  11.                                                                                 
  12.                                                                                 
  13.                                                                                 
  14.                        *************************************                    
  15.                        *                                   *                    
  16.                        *              S U B T              *                    
  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/18/93              
  55.  
  56. EJECT
  57.  
  58.     SUBJECT: NEW SUBT MACRO FOR SUBMITTING JCL FROM         DATE:02/01/93
  59.              ISPF/PDF EDIT                                                      
  60.                                                                                 
  61.        Due to the new CPU time batch restrictions on the MVS system, a new       
  62.     ISREDIT MACRO called SUBT has been written.  It works very much like        
  63.     the SUB command for submitting a JCL program from the edit panel in         
  64.     ISPF/PDF.  The purpose of SUBT is to simplify the task of specifying        
  65.     a CPU time limit for a job you submit directly out of edit.  With the        
  66.     new batch time restrictions if time is not specified on the job card         
  67.     of a batch job, the system will set time to the maximum value and your      
  68.     job will not run until after-hours.                                         
  69.                                                                                 
  70.        The way SUBT accomplishes this is by building a job card for you and      
  71.     temporarily inserting it on top of your code.  For this reason your         
  72.     job stream can not already contain a job card.  Unlike the SUB command       
  73.     which checks for the existence of a job card before creating one, SUBT       
  74.     will just insert another one.  So if you already have a job card on          
  75.     your JCL run stream, make sure you have coded the time parameter and         
  76.     use the Sub command as usual.                                               
  77.                                                                                 
  78.        When entered from the command line while in edit mode, SUBT builds       
  79.     your job card for you with a default time of 5 CPU seconds.  A job with      
  80.     a time of 5 seconds or less has the maximum chance of beginning             
  81.     execution quickly.  See the member BATCHCPU in SYS.MVS.UPDATE for more
  82.     information on coding the time parameter for the batch job time             
  83.     control.  SUBT will also set the jobname on your job card to your            
  84.     userid plus 'X' as the default, but you can override both of these           
  85.     defaults if you wish.                                                       
  86.                                                                                 
  87.        The syntax for the SUBT is as follows:                                   
  88.                                                                                 
  89.        SUBT           - A job card will be created with your userid plus         
  90.                         'X' and a time value of 5 seconds.  (both defaults)
  91.                                                                                 
  92.        SUBT B         - A job card will be created with your userid plus         
  93.                         'B' and a time value of 5 seconds.  (time default)
  94.                                                                                 
  95.        SUBT AA,45     - A job card will be created with your userid plus         
  96.                         'AA' and a time value of 45 seconds.                    
  97.                                                                                 
  98.        After you have entered the SUBT command, you will either be returned     
  99.     to the EDIT panel (where you see the contents of your job stream) or         
  100.     back to the member selection list in EDIT.  The reason for this is that     
  101.     when the SUBT command temporarily inserts a job card on top of your          
  102.     JCL run stream, the changed dataset bit is set.  If you have not made        
  103.     any changes to the member before the SUBT command, then you will be         
  104.     brought back to the member selection list.  In this way you will not        
  105.     be rewriting your member every time you use the SUBT command.  If you       
  106.     have made changes to the member before using the SUBT command, you will     
  107.     be returned to the EDIT panel as normal.                                    
  108.                                                                                 
  109.     NOTE: The Subt command is only supported for interactive use only.          
  110.           This command is not to be used in the batch environment.              
  111.                                                                                
  112.