Sun Mainframe Batch Manager Software, Release 10.0.0
Updated User Documentation

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

--------------------------------
MBM 10.0.0p1   -  113826-01
--------------------------------

1. The job editor's startup script now verifies that the Java(tm) version is at 
least 1.4. (BugID 4756983)

If the version is lower than 1.4.0, the following message is displayed:

"ERROR - Current java version: '$JAVAVER'  version 1.4.0 or above is required."

where JAVAVER is the current version of Java if the JDKROOT environment variable
is set to a version lower than 1.4.0.

2. IDCAMS Utility Limitations

  Limitation: A comment may not be continued over multiple lines in the 
  IDCAMS SYSIN data using the line continuation character (-) or the string
  continuation character (+).

  Workaround: Remove the comment or make each comment a separate line. 

  Example 1

  REPRO /* my comment +
   continued */ -

  Should be changed to:

  REPRO - 
   /* my comment continued */ -
   
  Example 2 

  REPRO -
    /* my comment -
       continued */ -

  Should be changed to:

  REPRO - 
    /* my comment continued */ -


  Limitation: If a DELETE statement includes a CATALOG parameter, not all 
  cases of embedded spaces are supported.

  Workaround: Remove any spaces within the parentheses.

  Example

  DELETE (MY.DATASET) CATALOG(MYCATLOG/ MYPASSWD)

  Should be changed to:

  DELETE (MY.DATASET) CATALOG(MYCATLOG/MYPASSWD)


  Limitation: A REPRO step where the INFILE or INDATASET parameter specifies 
  a base GDG (the concatenation of all GDG intances) might fail if no
  occurrences exist.
  
  Limitation: The ENVIRONMENT(DUMMY) syntax parameter of REPRO INFILE/INDATASET
  is not supported in the current version. The parameter is ignored by Sun MBM.
  
  Workaround: Remove the ENVIRONMENT subparameter.

  Example

  REPRO INFILE(DD1 ENVIRONMENT(DUMMY)) OUTFILE(DD2)

  Should be changed to:

  REPRO INFILE(DD1) OUTFILE(DD2)
  
3. Changes to the sample applications changes the references to the sample
directory in the Sun Mainframe Batch Manager Software Installation Guide 
from oracle 1 to oracle (BugId 4779655). In the section "Using the
Oracle Sample Application," Step 10 on page 44 requires the following
changes: 

   -The path name in substep b should be $EBMHOME/samples/oracle/ish.
   -The path name in substep c should be $EBMHOME/samples/oracle/ishp.
   -The path name in substep d should be $EBMHOME/samples/oracle

4. Fix to BugId 4705343, which allows a VSE job to restart properly and
report if a restart step is not found, resulted in a new error message.
This fix was made to the Sun MBM 10.0.0 release, but the message was not
documented in the Sun MBM Message Guide.

   MA2557 (I) Job submitted in RESTART mode : %s
   
   Description: Informational message indicating the stepname[.pstepname] 
   of the restart.

5. Changes and additions to the documentation in the Sun MBM User's Guide
on the dostrans command. (BugId 4706411)

   The current documentation for the -E option is incorrect and should be
   deleted or ignored.
   
   The new -E option translates '&' to '\$' in instream data. If you do not
   use the -E option, the default behavior of dostrans is to translate the
   '&' to '\&'.
   
   The new -D option does not translate '$' to '\$' in instream data. If you 
   do not use the -D option, the default behavior of dostrans is to change 
   '$' to '\$'.
   
   Note that using the -E and -D options results in non-standard
   mainframe behavior.
   
The following examples illustrate these changes. The first example shows the
original JCL. The other examples show how the JCL is translated based on the
dostrans options used.
   
Original JCL:
--------------
// JOB tstinstop
// EXEC PGM=IDCAMS,PARM='TEST'
   $dollar test with -E
   &ampersand test with -D
/&


dostrans tstinstop -f
---------------------
BEGINJOB
ASSGNDD ddname='SYSIN' type='INSTREAM' << !
   \$dollar test with -E
   \&ampersand test with -D
!
EXECPGM pgmname='IDCAMS' stepname='STEP0001' parm='TEST'
ENDJOB


dostrans tstinstop -f -E
------------------------
BEGINJOB
ASSGNDD ddname='SYSIN' type='INSTREAM' << !
   \$dollar test with -E
   \${ampersand} test with -D
!
EXECPGM pgmname='IDCAMS' stepname='STEP0001' parm='TEST'
ENDJOB

dostrans tstinstop -f -D
-------------------------
BEGINJOB
ASSGNDD ddname='SYSIN' type='INSTREAM' << !
   $dollar test with -E
   \&ampersand test with -D
!
EXECPGM pgmname='IDCAMS' stepname='STEP0001' parm='TEST'
ENDJOB

dostrans tstinstop -f -D -E
---------------------------
BEGINJOB
ASSGNDD ddname='SYSIN' type='INSTREAM' << !
   $dollar test with -E
   ${ampersand} test with -D
!
EXECPGM pgmname='IDCAMS' stepname='STEP0001' parm='TEST'
ENDJOB

