A new promote process has been incorporated into release 6.78 of HostBridge.  This process  (called the JavaScript Source Manager) allows you to properly back up, delete, display, extract, list, restore, or promote scripts that reside (or are to reside) in an HB.js repository.   The process is independent of  the status of the repository; it will work whether or not the repository is currently being used by an active CICS region, and does not require any alternate indexes to be built and will work against repositories that are defined with any VSAM SHAREOPTIONS.  It can be used to replace all preexisting Promote functions for HB.js (although the old ones will still work and will still be supported).

This has been accomplished with new HostBridge modules HBR$JSSM and HBR$VSDY.  It will work with any HostBridge release including and subsequent to 6.02, and is generally available as of HostBridge release 6.78.

To implement the new promote process, please do the following:

  1. Copy the following attachment to your computer: JSSM_LIBRARY.XMT.    This file contains the two new modules mentioned above in transmit format.
  2. Using FTP and binary transfer, upload the new modules to your mainframe.  The target file on the mainframe must be a sequential file in fixed block format with a record length of 80 (any block size is acceptable).
  3. Using the TSO RECEIVE command,  copy the transmit file to a load library.
  4. Copy the following attachment to your computer: JSSM_JCL.XMT.    This file contains seven JCL streams that can be used to execute the new promote process.  The file is in transmit format.
  5. Using FTP and binary transfer, upload the new modules to your mainframe.  The target file on the mainframe must be a sequential file in fixed block format with a record length of 80 (any block size is acceptable).
  6. Using the TSO RECEIVE command,  copy the transmit file to a PDS suitable for containing JCL members.
  7. Modify the sample JCL members to create jobs to perform the various promote functions, conforming to your standards.
  8. Ensure that the module HBR$VSDY resides in a load library that is in the program concatenation for the CICS(s) where HostBridge is installed.
  9. Add the following definitions to the RDO group where your HostBridge definitions reside and install them: 
* 
* NOTE THAT THE FIRST TWO DEFINITIONS ARE NOT REQUIRED IF YOU         
* ALREADY HAVE A GENERIC CONNECTIONS/SESSIONS DEFINITION IN           
* THE REGION WHERE THESE DEFINITIONS ARE BEING INSTALLED              
*                                                                     
DEFINE CONNECTION(HBIG)                                               
       GROUP(***HBGRUP***)                                            
       DESCRIPTION(GENERIC CONNECTION - DYNAMIC PROMOTE)              
       ACCESSMETHOD(IRC)                                              
       PROTOCOL(EXCI)                                                 
       CONNTYPE(GENERIC)                                              
       SINGLESESS(NO)                                                 
       DATASTREAM(USER)                                               
       RECORDFORMAT(U)                                                
       QUEUELIMIT(NO)                                                 
       MAXQTIME(NO)                                                   
       AUTOCONNECT(NO)                                                
       INSERVICE(YES)                                                 
       ATTACHSEC(IDENTIFY)                                            
       BINDSECURITY(NO)                                               
       USEDFLTUSER(NO)                                                
       XLNACTION(KEEP)                                                
                                                                      
DEFINE SESSIONS(HBIG)                                                 
       GROUP(***HBGRUP***)                                            
       DESCRIPTION(GENERIC SESSIONS - DYNAMIC PROMOTE)                
       CONNECTION(HBIG)                                               
       PROTOCOL(EXCI)                                                 
       MAXIMUM(0,0)                                                   
       RECEIVEPFX(RG)                                                 
       RECEIVECOUNT(4)                                                
       SENDSIZE(4096)                                                 
       RECEIVESIZE(4096)                                              
       SESSPRIORITY(0)                                                
       AUTOCONNECT(NO)                                                
       BUILDCHAIN(YES)                                                
       USERAREALEN(0)                                                 
       IOAREALEN(4096,4096)                                           
       RELREQ(NO)                                                     
       DISCREQ(NO)                                                    
       NEPCLASS(0)                                                    
       RECOVOPTION(SYSDEFAULT)                                        
                                                                      
DEFINE TRANSACTION(HBMI)                                              
       GROUP(***HBGRUP***)                                            
       DESCRIPTION(EXCI SERVER MIRROR TRANSACTION - PAUT OR JSUT)     
       PROGRAM(DFHMIRS)                                               
       TWASIZE(4)                                                     
       PROFILE(DFHCICSA)                                              
       STATUS(ENABLED)                                                
       TASKDATALOC(BELOW)                                             
       SHUTDOWN(DISABLED)                                             
       DTIMOUT(10)                                          
       SPURGE(YES)                                          
       TPURGE(YES)                                          
       DUMP(YES)                                            
                                                            
DEFINE PROGRAM(HBR$VSDY)                                    
       GROUP(***HBGRUP***)                                  
       LANGUAGE(COBOL)                                      
       DESCRIPTION(COMMON RESOURCE IO HANDLER - DYNP)       
       DATALOCATION(ANY)
You are now ready to run the batch jobs with the new load modules.

Documentation for the new promote process can be found here.

Please contact HostBridge Support if you have any questions about this new capability.

 

© 2022 HostBridge Technology, LLC
Unless otherwise noted, all rights reserved.