Sun Mainframe Batch Manager Software, Release 9.2.0
Updated User Documentation

This file contains updates to the user documentation 
released with Sun MBM 9.2.0. If there are no documentation 
updates for a patch release, it is so noted.

--------------------------------
Sun MBM 9.2.0p5    -  112305-05 
--------------------------------

1. Changes to the sample applications changes the references to the sample
directory in the Sun Mainframe Batch Manager Quick Start Guide (BugId 4779655).
In Chapter 8, Sections 8.1 and 8.2, replace all occurrences of oracle1 
with oracle.

2. Sun MBM now allows an output format of VSAM to be processed by the SyncSort
sort product. (BugId 4800916) This requires the following documentation 
changes:

   Sun Mainframe Batch Manager Migration Guide, Chapter 7
   
   - page 7-6: In Section 7.2.2, remove from the Note "SyncSort does not
               support VSAM output files."
   - page 7-8: In Section 7.2.5, Table 7-3, the values for the SYSIN Exists
               column should be changed for VS-VS to "SyncSort supports."
   - page 7-24: Remove Section 7.2.7.2 "Syncsort support for MTP VSAM 
               input files."
               
   Sun Mainframe Batch Manager Message Guide, Chapter 9
   
   - page 9-24: Remove the error "ERROR: VSAM to VSAM is not supported for
                SyncSort."

3. Documentation errate in MBM 9.2 User's Guide (BugId 4791140, 4742973).

   - On Pg.5-37, the environment variable for the entry "control=spacing" 
   should be "ddname_CONTROL spacing" but it says "ddname_COMPACT spacing".

   
   - On Pg.5-38, the descriptions of the free options, should be as follows:

     END: Deallocate at the end of the job step. The default.
     CLOSE: Deallocate when the program closes the SYSOUT file.

   - On Pg.5-39, the description of LINE/PAGE for prmode is wrong. For the
   prmode option, the descriptions for the LINE and PAGE options should be 
   as follows:

     LINE: Schedule to a line mode printer.
     PAGE: Schedule to a page mode printer.
     
   - On pages 7-36 and 7-37, the references to the EBM_DATE_FORMAT and
   LC_TIME environment variables are confusing. The following statement
   clarifies how these variables affect the histprt command output:
   
     The EBM_DATE_FORMAT and LC_TIME environment variables affect the 
      date/time stamp of the histprt entry (the Date column of the 
      histprt output).
      
   - On page 7-32, the status codes for the ebmsys command are incorrect. 
   They should be as follows:
   
     Subm: Submitted 
     Run: Running 
     Susp: Suspended 
     Abrt: Aborted 
     Fin: Finished 
     Rdy: Ready to run
     
   - In Section 2.3, the text associated with Figure 2.3 does not match
   the figure. It should be changed to:
   
     Figure 2.3 shows an example of job classes. For example, Class a shows
     that there are 2 jobs running (Active Threads), and Class e shows 
     that there are 2 jobs pending because there are no available activities
     (Available Threads) in this class.
     
   - Figure 4.10 is incorrect. It should be the 
   
      <node>: Submit Job To Subsystem <subsystem>
      
     message box that is displayed after you click the Submit Job and 
     Notify button.
 

4. Documentation errata in MBM 9.2 Migration Guide (BugId 4753612).

   - In Table 5.7, recfm should be recfmt.
 
   - On Pg.5-59, in the code example containing "=..." in the last line,
     remove the equal sign (=).
 
   - On Pg.5-61, delete the "Dummy DD assignment" paragraph.
   
   - On Pg.5-58, "~xnn" should be "/xnn".
 
   - On Pg.5-70. "numberK | numberM" should be "{numberK | numberM}".
 
   - On Pg.5-72: 
     - "//TESTPAR IF ( RC T 4 AND (RC LT 12 | RC = 16 )) THEN" should be 
       "//TESTPAR IF ( RC LT 4 AND (RC LT 12 | RC = 16 )) THEN".
      
     - "0, 1, 2, or 16" should be "0, 1, 2, 3 or 16".
        
     - "//TESTPAR IF ( RC T 4 AND RC LT 12 ) | RC = 16 ) THEN" should be 
       "//TESTPAR IF (( RC LT 4 AND RC LT 12 ) | RC = 16 ) THEN".
   
   - On Pg.5-73, in Table 5.8, the example for the NOT operator should be: 
     //TESTNOTA IF NOT (RC = 8 | RC > 10) THEN 
     //TESTNOTB IF (RC NE 8 AND RC <= 10) THEN
  
   - In Table 5.9, Pg.5-74: 
     - Add "ABEND=FALSE" in "NOT ABEND" keyword column. 
     - "stepname.ABEND" should be "NOT stepname.ABEND". 
     - "stepname.procstepname.ABEND" should be 
       "NOT stepname.procstepname.ABEND". 
   
   - In Table 5.9, Pg5-75, "NOTRUN" in keyword column should be "NOT RUN". 
   
   - On Pg.5-76, 
     "USER.PROCLIB1__LIBFS/sys1/user/proclib10 
     USER.PROCLIB2__LIBFS/sys1/user/proclib20" 
 
     should be all bold.
   
   - On Pg.5-77, 
     "//jobnameJOB" should be "//jobname JOB"
  
   - The NR suboperand description in Section 5.12.2.8 is different from
     the description in Section 5.16.2.11. 
     
     - In Section 5.12.2.8, the description for both NR and NC should say 
       "If the step fails, ...
       
     - In Section 5.16.2.11, the second sentence of the NR operand 
       description should say that "the operator may perform a job restart.
       They are not to perform a step restart.
   
   - On Pg.5-85, Section 5.16.2.14: 
     "TIME=(minutes[ ,seconds ]) | 1440" 
     
     should be :
     "TIME={(minutes[ ,seconds ]) | 1440}".
   
   - On Pg.5-91, Section 5.17.1.6: 
     "CLASS=class-id | *" 
    
     should be: 
     "CLASS={class-id | *}".
 
   
   - On Pg.5-92, Section 5.17.1.8: 
     "CONTROL=PROGRAM" should be bold and "//JOBWORK JOB" should not be 
     bold.
 
   - On Pg.5-93, Section 5.17.1.10, 
     "DATACK=BLOCK | UNBLOCK | BLKCHAR | BLKPOS" 
     
     should be: 
     "DATACK={BLOCK | UNBLOCK | BLKCHAR | BLKPOS}".
   
   - On Pg.5-93, Section 5.17.1.11, 
     "DEFAULT=YES | Y | NO | N"
      
     should be: 
     "DEFAULT={YES | Y | NO | N}".
   
   - On Pg.5-96, Section 5.17.1.14: 
     "FLASH={overlay-id | (overlay-id[ ,count ] | (,count) | NONE | ST D}" 
     
     should be:
     "FLASH={overlay-id | (overlay-id[ ,count ] ) | (,count) | NONE | ST D}". 
   
   - On Pg.5-106, Section 5.17.2, the banner in the translated results
     is out-of-date.
 
   - On Pg.5-107, Section 5.19: 
     "//procname PROC [ parameter-name=value [ ,parameter-name=value, ]... 
     [ comments ]"
  
     should be:
     "//procname PROC [ parameter-name=value [ ,parameter-name=value, ]... ] 
     [ comments ]".
  

   - On Pg.5-108, Section 5.20, the example should be as follows:

     SET statement with parameters set to AA&&A and 'B B&&B':
   
       ...
       //SETPRMS SET PARMA=AA&&A,PARMB='B B&&B'
       ...
     
       is translated to:
   
       ...
       SETPARM parms='PARMA=AA_A,PARMB=B_B/x26/x26B'
       ...
   
   - On Pg.5-109, Section 5.21, delimiter description is not correct. 
  
     Change "a specific user" to "the end of record transmission."
   
   - On Pg.5-109, Section 5.22, the "/*ROUTE" statement is missing. 
  
     The following is the description of the /*ROUTE statement:

     /*ROUTE Statement
  
     The /*ROUTE statement is used to specify the destination of sysout data 
     sets that are not routed by a DEST parameter or to identify the network 
     node where the job is to execute. 
  
     Sun MBM supports the PRINT parameter on JES2 /*ROUTE statement. mvstrans
     generates a SETPRINT macro and ignores all other parameters during
     translation.
  
     The following translation example shows how mvstrans translates different
     formats of the /*ROUTE PRINT statement.
  
       ... 
       /*ROUTE PRINT S007 
       /*ROUTE PRINT S007.OUTR 
       /*ROUTE PRINT S007:OUTR 
       /*ROUTE PRINT S007/OUTR 
       /*ROUTE PRINT S007(OUTR) 
       ...
     
     is translated to:
  
       ... 
       SETPRINT dest= S007  printid= ALL  scope= JOB  overridedd= N  
       SETPRINT dest= S007.OUTR  printid= ALL  scope= JOB  overridedd= N  
       SETPRINT dest= S007.OUTR  printid= ALL  scope= JOB  overridedd= N  
       SETPRINT dest= S007.OUTR  printid= ALL  scope= JOB  overridedd= N  
       SETPRINT dest= S007.OUTR  printid= ALL  scope= JOB  overridedd= N  
       ...
 
  
   - On Pg.5-110, Section 5.22, "//**DATASET" should be "//*DATASET". 
   
   - On Pg.5-110, Section 5.22, Table 5.12 should include "//*PROCESS". 
   
   - On Pg.5-111, Section 5.23.2.1: 
     "BURST | B={Y | N}" should be "{BURST | B}={Y | N}".
   
   - On Pg.5-111, Section 5.23.2.2: 
     "BYTES | M=nnnnnn" should be "{BYTES | M}=nnnnnn".
  
   - On Pg.5-112, Section 5.23.2.3: 
     "CARDS | C=nnnnnnnn" should be "{CARDS | C}=nnnnnnnn". 
     "where 
      nnnnnnnn A 1 to 8 decimal digit value." 
      nnnnnnnn should be italic.
   
   - On Pg.5-112, Section 5.23.2.4: 
     "COPIES | C=nnn" should be "{COPIES | C}=nnn". 
     "where 
      nnn A 1 to 3-decimal digit value in the range 1 through" 
      nnn should be italic.
   
   - Section 5.23.2.x have the same type of corrections as 5.23.2.4.
   
   - On Pg.5-24, Section 5.23.2.7, "thousands of bytes" should be 
     "thousands of lines".
   
     "LINES | L=nnnnn 
      where 
      nnn A 1 to 6-digit value 0 to 999999." 
      
     should be:
      
    "{LINES | L}=nnnnnn 
     where 
     nnnnnn A 1 to 6-digit value 0 to 999999." 
     nnnnnn is 6-digit.
       
   - Section 5.24.2.x have the same type of errata as Section 5.23.2.4.
 
   - On Pg.5-120, Section 5.24.2.8: 
     - "OUTPUT JCL statement" should be "/*OUTPUT statement".
      
     - "a DD for a sysout dataset" should be "a /*OUTPUT statement".
    
   - On Pg.5-121, Section 5.24.2.8: 
     - "NnnRrrrr | NnnRrrrr | NnnnnRrr" should be 
       "NnnRrrrr | NnnnRrrr | NnnnnRrr".
      
     - "nn is a number from 1 through 1000 that identifies a node."
      
       should be: 
     
       "nnnn, nnn and nn is a number from 1 through 1000 that identifies 
       a node." 
  
     - "rrrr, rr is a number from 1 through 9999 that identifies a remote
       work station unit." 
   
       should be:
     
       "rrrr,rr, rr is a number from 1 through 9999 that identifies a remote
       work station unit."
  

   - On Pg.5-124, Section 5.24.2.13, "OUTPUT statement" should be 
     "/*OUTPUT statement".
  
   - On PG.5-124, Section 5.24.2.14, "OUTPUT statement" should be 
     "/*OUTPUT statement".
  
   - On Pg.5-126, Section 5.24.2.17, in the example, remove MODTRC=(CHR1,CHR2).
   
   - On Pg.7-19, Section 7.2.6.4.1:
 
     sortout file 
     D004 
     D004 
     A001 
     B002 
     B002 
     A001 
     C003 
     C003 
    
     should be:
     
     sortout file 
     D004 
     D004 
     A001 
     A001 
     B002 
     B002 
     C003 
     C003
  


5. Documentation errata in the Sun MBM PPF User's Guide, Release 9.2 
(BugId 4746848).

   - There should be description for suffix ..NP and ..SC in File_Map.

     In Section 3.3, append to the first paragraph:
     The suffix "..NP" is used to denote standard named pipe files between 
     two jobs executing on the same local host. The suffix "..SC" denotes a 
     socket being shared between two jobs via a socket connection.

   - In Section 3.3, the example for XSUBMIT and XWAIT should be changed to 
     one which has procedures XSUBMIT and XWAIT in it.

     On page 3-3, the XSUBMIT/XWAIT example JCL should be as follows, and
     is associated with the second bullet item above it. Note it should be
     a JOB not a PROC, so also change the //PROC8  PROC of the first JCL 
     example under 3.4 to //JOB8  JOB:

     //JOB8    JOB
     //XSTEP01 EXEC PROC=XSUBMIT
     //SYSIN   DD *
     +/STEP01  EXEC PGM=CB001
     +/INPUT1  DD DSN=HOME.EBMTEST.DATA.AAA,DISP=(OLD,CATLG,CATLG)
     +/OUTPUT1 DD DSN=HOME.EBMTEST.DATA.CCC,DISP=(NEW,PASS,DELETE)
     //STEP02  EXEC PGM=CB002
     //INPUT2  DD DSN=HOME.EBMTEST.DATA.CCC,DISP=(OLD,DELETE,DELETE)
     //OUTPUT2 DD DSN=HOME.EBMTEST.DATA.BBB,DISP=(NEW,CATLG,CATLG)
     //XWAIT01 EXEC PROC=XWAIT,XSTEPNAME=XSTEP01,COND=EVEN
     //STEP03  EXEC PGM=IEBUPDATE
     ........
     ........

   - In Section 3.3, the example for RUNPGM should be changed to one which 
     has the RUNPGM utility in it.

     On page 3-3, under the RUNPGM box, replace both sets of JCL with the 
     following:

     //JOB8    JOB
     //STEP102 EXEC PGM=RUNPGM
     //INPUT1  DD   DSN=HOME.EBMTEST.DATA.AAA,DISP=(OLD,CATLG,CATLG)
     //OUTPUT1 DD   DSN=HOME.EBMTEST.DATA.CCC,DISP=(NEW,PASS,DELETE)
     //INPUT2  DD   DSN=HOME.EBMTEST.DATA.CCC,DISP=(OLD,DELETE,DELETE)
     //OUTPUT2 DD   DSN=HOME.EBMTEST.DATA.BBB,DISP=(NEW,CATLG,CATLG)
     //SYSIN   DD   *
     //FUNC=CB001
     //FUNC=CB002
     /*
     //STEP03 EXEC  PGM=IEBUPDATE
     ........
     ........


   - In Section 3.8.2, RUNPBM should be changed to RUNPGM.

     This error is in the 4th bullet.

   - In Figure 3.1, the colon (:) should be changed to a period (.), as 
     follows:
     
       At the bottom, PRIMER.ACCT.MF:SEQ2
   
       should be:
   
       PRIMER.ACCT.MF.SEQ2



--------------------------------
Sun MBM 9.2.0p4    -  112305-04 
--------------------------------

1. Documentation in the Sun Mainframe Batch Manager User's Guide, Release 9.2 
   for the subjob and unikixjob commands incorrectly described the -d option. 
   (BugID 4733909)

   Documentation for the -d <disp> option of the subjob and unikixjob commands 
   should say:
 
     -d d: Dispatch, or make eligible, the job for execution.

2. Documentation errata in the Sun Mainframe Batch Manager Message Guide. 
   (BugID 4737392)
 
   Corrections are as follows:

   Pg.2-52, BS1759(s) should be BS1759(S). (NOTE the capital 'S')
   Pg.4-26, Duplicate IP4362(S) messages. Remove the second instance of
            the message. In the first instance change (S) to (I); change
            'searcing in' to 'Searching in'; change 'Informational message.'
            to 'Informational message on COBPATH being searched'.
   Pg.9-11, MA1108(S) action should be "Contact technical support".

3. The -c option has been added to the dostrans command. It is used to preserve 
   the case of the file names when validating DOS/VSE JCL jobs.



--------------------------------
Sun MBM 9.2.0p3    -  112305-03 
--------------------------------
No documentation updates


--------------------------------
Sun MBM 9.2.0p2    -  112305-02 
--------------------------------

1. Support for CoSort 7.5.3 that supports VSAM files.  

2. dostrans translator now supports the mfrcdv output type. 

3. Support for Oracle 9i.


--------------------------------
Sun MBM 9.2.0p1    -  112305-01 
--------------------------------
No documentation updates

