Release 2.2 - 05/16/2006
I. New keyword: SEGMENT_OVERRIDE_JESDELIVERY_COPIES
II. New keyword: TCPIP_COMPUTER_ASSOCIATES.
Provides compatibility for those customers running CA/ACCESS.
III. All of the maintenance applied to JRB 2.1. They are listed below:
  A. Provides ability to optionally add a line (maximum 130 characters) to the separator page.
    New keywords:
REPORT_SEPARATOR_TEXT_DEFAULT
REPORT_SEPARATOR_TEXT
  B. Provides ability to specify email addresses via JCL.
    New keywords:
EMAIL_OBTAIN_ADDRESS_FROM_JCL
EMAIL_OBTAIN_ADDRESS_FROM_JCL_DEFAULT
  C. Provides ability to specify what IP address the web server listens to connects on.
    New keyword: WEB_IP@
  D. Archive Group Dynamic Creation
Provides ability for JRB to dynamically create new archive groups dynamically without
manually defining them in the $GROUPS member.
    New keywords:
ARCHIVE_DYNAM_GROUP_CAPABLE
ARCHIVE_DYNAM_GROUP
ARCHIVE_DYNAM_MOTHER_GROUP
  E. Ability to split up reports using CONTROLBREAKS
Define the location within a report that contains a field. Each time that field changes from one page to another a CONTROLBREAK will occur. The previous report segment will end and other will begin. This feature is especially powerful when used with Archive Group
Dynamic Creation.
    New keywords:
CONTROLBREAK_NAME
CONTROLBREAK_BOUNDARY
CONTROLBREAK_TEXT_COLUMN
CONTROLBREAK_TEXT_LENGTH
CONTROLBREAK_TEXT_LINE
  F. Can use segmentation in conjunction with CONTROLBREAKS
In order to select the section of a report that is applicable to a CONTROLBREAK, segmentation can be used in conjunction.
  G. NEW variable &CB(n).
Will be replaced with the report text value associated with CONTROLBREAK in relative position n within the route entry. It can be used in conjunction with CONTROLBREAKS and Archive Group Dynamic Creation to build the name of the new group being created. Can also be used in REPORT_NAME or any other field that supports variables.
  H. NEW function for the JRB utility.
FUNCTION=UPGRADE_OBSOLETE_KEYWORDS
If JRB detects the use of an obsolete keyword upon startup it will issue the message JRBE381 and terminate. You can use this new function of the JRB utility to automatically upgrade your
keywords to the correct format.
  I. Restructured the manual. Split sections previously in section IV into their own sections.
    New keywords: SSL_FTP_CERTIFICATE_LABEL
SSL_FTP_CERTIFICATE_LABEL_DEFAULT
  J. Provides SSL Client authentication for FTP deliveries
Optionally, FTP servers and require that clients provide a digital certificate.
This change supports that requirement.
    New keywords: SSL_FTP_CERTIFICATE_LABEL
SSL_FTP_CERTIFICATE_LABEL_DEFAULT
  K. Manual sections dealing with SSL support have been re-organized and clarified.
  L. Re-structured the Archive and History in HFS.
As a result documents will now be shown on the web pages from newest to oldest.
   

= I M P O R T A N T  N O T E =
BEFORE YOU BRING UP JRB you MUST run the batch utility using the new utility keyword FUNCTION=UPGRADE_ARCHIVE; Failure to do so will cause the archive to become unusable until the UPGRADE_ARCHIVE is run.
  M. Change to ARCHIVE to JES.
The confirmation pop-up window now provides the ability to specify the following characteristics of the report placed on JES:
    o OUTPUT CLASS
o FORMID
o DESTINATION
  N. Change to keywords
JESDELIVERY_FORM
JESDELIVERY_FORM_DEFAULT
SEGMENT_OVERRIDE_JESDELIVERY_FORM
  O. NEW DELIVERYTYPE=REQUE;
This new deliverytype does not actually deliver a report, is simply changes the JEScharacteristics of a report. It does not create a new JES output like DELIVERTYPE=JES does, it just changes the characteristics of the original report.
    New keywords: JES_REPORT_REQUE_NODE_DESTID
JES_REPORT_REQUE_NODE_DESTID_DEFAULT
  P. DIRECTORY WEB PAGE FILTER WINDOW CHANGES:
    1. With multiple report directory windows open each one of them may now have a filter window associated with it. Previously only the first directory window could have a filter window.
2. Removed the alert window that popped up when the ‘FILTER OFF” button was pressed.
3. The ‘FILTER OFF” button is now ‘grayed out’ and disabled unless there is actually a filter window open.
4. All filter fields now translate all input into upper case except for the ‘PROGRAMMER NAME’ field.
5. The ‘CREATION DATE TO/FROM’ fields initial values have changed:
      • The ‘TO DATE’ is now the date obtained from JRB, previously it was the date obtained from the workstation.
• The ‘FROM DATE’ is now calculated from the ‘TO DATE’.
    A number of days are subtracted from the ‘TO DATE’ to obtain the ‘FROM DATE’. The number of days subtracted are obtained from:

New keyword:
WEBPAGE_REPORT_FILTER_FROM_DATE_OFFSET
  Q. New keywords:
    FTP_TCPIP_READ_TIMEOUT
FTP_TCPIP_READ_TIMEOUT_DEFAULT
  R. New option for keyword FTP_MODE and FTP_MODE_DEFAULT.
    You can now specify
FTP_MODE=PASSIVE_POSTCONNECT
  S. Changed the FTP protocol associated with FTP_MODE=PASSIVE;
Some FTP servers were causing deliveries to hang up. Tracing revealed JRB waiting upon a TCP/READ attempting to receive the response of a ‘STOR’ FTP command.

Previously JRB would: Issue ‘PASV’, Issue ‘STOR’, then connects to the server. (PASV,STOR,CONNECT)
Now JRB will: Issue ‘PASV’, connect to the server, then Issue ‘STOR’.(PASV,CONNECT,STOR)

In order to preserve previous functionality that might be required from some servers FTP_MODE=PASSIVE_POSTCONNECT now will use the old protocol. (PASV,STOR,CONNECT)

Download Release JES Report Broker 2.2 (JRB22.exe)
Release 2.1 - 10/25/2005 
 

1) The minimum OS/390 release is now 2.10

2) Contains all the maintenance items from version 2.0  (2.0.1 through 2.0.36)

3) Provides ability to choose ‘OUTPUT’ or ‘HELD’ JES queues when archived reports are sent back to the JES output queue.         

4) Provides ability to send archived reports back to the JES output queue.

New required keyword for use in $WEB member:
WEBPAGE_ARCH2JES_CLASS                                         

5) Provides ability to use wildcards ‘*’ with the keyword:

JES_REPORT_SELECT_PROGRAMMER_NAME JES_REPORT_SELECT_PROGRAMMER_NAME_DEFAULT

6) Provides ability to submit JCL from the ‘History Directory’ web page to restore a document from backup.

New keywords:
ARCHIVE_RESTORE_JCL_JOBCARD1 – Required keyword.
3.3.27 ARCHIVE_RESTORE_JCL_JOBCARD1
ARCHIVE_RESTORE_JCL_JOBCARD2 – Required keyword.
3.3.28 ARCHIVE_RESTORE_JCL_JOBCARD2
ARCHIVE_RESTORE_JCL_TAPE_UNIT – Optional keyword.
3.3.29 ARCHIVE_RESTORE_JCL_TAPE_UNIT
ARCHIVE_RESTORE_JCL_DASD_UNIT – Optional keyword
3.3.26 ARCHIVE_RESTORE_JCL_DASD_UNIT

7) Provides control over report separator pages within a report segment.

New keywords:
SEGMENT_OVERRIDE_REPORT_SEPARATOR_PAGE SEGMENT_OVERRIDE_REPORT_SEPARATOR_USERID

8) Removes JES LRECL restriction of 4060. 

a) There will no longer be any restriction on JES LRECL.   
b) Improved use of buffering will also improve performance on document deliveries.                 

9) New keyword (REQUIRED):                                            

JES_READ_BUFFER_SIZE

10) Changed keywords:                                       

TRANSMIT_BUFFER_SIZE -
changed maximum value from 32736 to 32767.
JES_REPORT_SIGNIFICANT_LRECL -
changed maximum value from 4060 to 32760.    

11) Batch Utility Changes.                                 

Adds ability to COPY or MOVE reports from one archive group to another. 
Adds ability to specify any archive report group as a ‘target’ for a restore from backup. Previously there was no control, it restored to the original archive group.
Adds new valid value:
FUNCTION=COPY_TO_GROUP.
Adds new valid value:
FUNCTION=MOVE_TO_GROUP.
New keyword:
OVERLAY_DUPLICATE_REPORT.
New keyword:
SELECT_ONLY_BEGINING_GROUP
New keyword:
TARGET_REPORT_GROUP

12) Added new JES report selection criteria.

Adds keyword: JES_REPORT_SELECT_ACCOUNTING_FIELD 
Adds keyword: JES_REPORT_SELECT_ACCOUNTING_FIELD_DEFAULT 
Adds keyword:
JES_REPORT_SELECT_ORIGIN_NODE
Adds keyword: JES_REPORT_SELECT_ORIGIN_NODE_DEFAULT
Adds keyword:
JES_REPORT_SELECT_PRIORITY
Adds keyword:
JES_REPORT_SELECT_PRIORITY_DEFAULT
Adds keyword: JES_REPORT_SELECT_PROGRAMMER_NAME
Adds keyword: JES_REPORT_SELECT_PROGRAMMER_NAME_DEFAULT

13) Increases the maximum value of MAX_NUMBER_INTERNAL_TASKS from 512 to 1024.

14) Provides ablity to reque a report to a NULL WRITER id.

You can now specify JES_REPORT_REQUE_WRITER=****; which will set the WRITER id to NULL.

15) Added ability to control the format of the FTP server command PORT.

Added new keywords:
FTP_PORT_COMMAND_FORMAT
FTP_PORT_COMMAND_FORMAT_DEFAULT   (REQUIRED)

16) Added ability to specify a ‘COPIES=’ type parameter for DELIVERYTYPE=JES deliveries.

Adds new keyword:
JESDELIVERY_COPIES
Release 2.0 - 7/05/2005
  Functionality that added to JRB 1.1 by fixes (maintenance) are not listed here.
  New keywords have been added that affect the appearance of the Archive Group Tree web page.  They are all in support of the new ability to define multiple archive group trees (REPORT_GROUP_BEGIN_A_TREE)

a)  WEBPAGE_PREVIOUS_TREE_ICON – New optional keyword to specify a graphics file name to be used as an ICON.  It will be used as a link to a previous tree.  b)  WEBPAGE_PREVIOUS_TREE_TEXT – New Required keyword to specify the text associated with a link to a previous tree. 
c)  WEBPAGE_TOP_TREE_ICON – New optional keyword to specify a graphics file name to be used as an ICON.  It will be associated with the ‘top tree’ (the first tree defined in $GROUPS). 
d)  WEBPAGE_TOP_TREE_TEXT – New required keyword to specify the text associated with the ‘top tree’ (the first tree defined in $GROUPS
e)  REPORT_GROUP_ICON – New optional keyword to specify the name of a graphics file that will be associated with a report group. 

  New optional keyword REPORT_GROUP_BEGIN_A_TREE for the $GROUPS member provides the ability to define multiple report group trees.  Previously only one report group tree was supported.  Customers that had many thousand report groups had no choice but to put all the groups under a single tree.  Now an unlimited number of trees can be be defined.  This provides better organization and a more focused, manageable number of report groups shown in the Archive Report Group Tree web page. 
  The Sign-on web page now optionally includes a pop-up window where you can place instructions, disclaimers or a greeting.  New keywords shown below:

a)  WEBPAGE_SIGNON_POPUP_HEADING – Provide text for the heading of the pop-up. 
b)  WEBPAGE_SIGNON_POPUP_MSG – Provide text, html or graphics for the body of the pop-up. 

  New keyword SYSLOG_MESSAGE_LEVEL Controls which JRB messages are sent to the system log. 
  JRB can now optionally generate a separator page during document delivery.  The new keywords are listed below:

a)  REPORT_SEPARATOR_PAGE – Request separator page and position.
b)  REPORT_SEPARATOR_USERID – Userid to be optinally included on the separator page. 
c)  REPORT_SEPARATOR_PAGE_DEFAULT -  Request separator page and position
d)  REPORT_SEPARATOR_USERID_DEFAULT - Userid to be optionally included on the separator page.
  New substitution variables have been added.  The old substitution variables dealing with time/date were all on GMT.  New local time/date substitution variables have been added:

a)  &LJBRUNDATE - LOCAL Date the report was created in the format mm-dd-yyyy
b)  &LJULJDAT -  LOCAL current date in julian format: yyyy.ddd
c)  &LJM - LOCAL Month the report was created.  Format: mm.
d)  &LJD - LOCAL Day the report was created.  Format: dd.
e)  &LJYR - LOCAL Year the report was created.  Format: yyyy.
f)  &LJOBTIME - LOCAL Time the report was created in the format hh.mm.ss
g)  &LJH - LOCAL Hour the report was created in the format hh.
h)  &LHN - LOCAL Minutes the report was created in the format mm.
i)  &LHS - LOCAL Seconds the report was created in the format ss
  DELIVERYTYPE=JES now ‘carries forward’ the FCB of the original output to the new output.
  During startup JRB now checks for the correct version and maintenance level of HTML, JAVASCRIPT and LOADLIB. (LOADLIB had previously been checked for correct version only.  
  On the Report Group Tree web page the action taken when clicked has changed.  Clicking the group name previously expanded the group then displayed the Report Directory page.  Now clicking the group name (or ICON) will NOT expand the group, instead it will immediately display the Report Directory page