HostBridge Logo

HostBridge Support

Tools



All that is required is a COBOL copybook. The COBOL must be properly formatted and have one, and only one, 01 level wrappering the entire data structure.

To generate the JavaScript object go to https://tools.hostbridge.com/copybook, and follow the instructions on the page.

The following page allows you to generate a JavaScript object that describes a 3270 screen from captures performed using the HostBridge Application Explorer. Creating web services using HostBridge does not require the use of these screen objects, but they can provide a layer of abstraction between the web services you create and the 3270 screens they interact with. The object can provide consistent field names and transformations into and out of the screen. If the screen should change only the object must be updated, not all of the services that use the object.

To use this page just capture the screens you wish to have JavaScript objects generated for using the HostBridge Application Explorer. Rename the capture file to *.zip and unzip it. Select the options for the generated code and upload the unzipped .hsg screen files.

To generate a JavaScript screen object go to https://tools.hostbridge.com/fieldgen, and follow the instructions on the page.

Just the Links

For those of you that are not much on RTFM here are just the nuts:

Format of the files

Many times the files you are sending to HostBridge come from your host. Depending on the type of file they must be prepared differently.

Load modules, system dump, CICS dumps

These types of files must be sent to HostBridge in binary. Unfortunately simply downloading the files in binary is insufficient, the attributes of the file are lost and are near impossible to restore. The files have to be download in binary but they must be either TERSED or put into TRANSMIT format prior to downloading.

TRANSMIT

This is the easiest way to put your file in to a safe format prior to transmission. Use the following TSO command to put your file into TRANSMIT format:

TRANSMIT SUPPORT.HOSTBRDG DSN('input-dataset-name') OUTDSN('output-dataset-name.XMT')

Then send 'output-dataset-name.XMT' to HostBridge via one of the methods below. Remember this must be sent to us in binary, not text or ASCII.

TERSE

Tersing a file requires running a batch job but has the added benefit of compressing the file while it is putting it into the safe format. If you have a very large file and slow transmission links tersing a file will be better than TRANSMIT. Below is a example job to TERSE a file:

//TERSE    JOB (ACCT#),TIME=99
//PACK EXEC PGM=AMATERSE,PARM=PACK                                  
//SYSPRINT DD SYSOUT=*
//* DATASET TO BE TERSED                                             
//INFILE   DD DISP=SHR,DSN=SYS1.DUMP.CICSD.D060208.T234500.S00026  
//* TERSED DATASET
//OUTFILE  DD DSN=IBMUSER.CICSD.SYSDUMP.TERSED,                               
//         DISP=(NEW,CATLG),UNIT=SYSDA,SPACE=(CYL,(600,100),RLSE)    
//    

Send the TERSED file to HostBridge via one of the methods below. This also must be downloaded from your host in binary, not text or ASCII.

Formatted system or CICS dumps, job listings, source code and any other non-binary files

These files should be sent to HostBridge as text files (ASCII), so when you download them from your host do not specify binary. If you download them to your PC you can zip the file for easier handling. Zipping the file(s) on your workstation often make them small enough they can be emailed or attached directly to a support ticket. Use one of the methods below to send the file(s) to HostBridge Support

Options for Uploading Your Files

Files under 50MB

Files under 50MB can be attached to your support case by:

Files over 50MB (Or if you can't login to the support web site)

Files over 50MB can not be stored directly in the support system and must be uploaded and stored separately. You have several choices available to you with varying degrees of transmission security. Choose the one best suited to you requirements. All support files stored on HostBridge systems are encrypted.

https

Uploading via https is probably the easiest way to securely send your files to HostBridge as it only requires a web browser and access to the internet.

Download the file(s) to your workstation. If the files are in TRANSMIT or TERSE format be sure to download them in binary. Go to https://tools.hostbridge.com/upload, follow the instructions on the page. Be sure and update your support ticket with information about the file you have uploaded.

FTP

Uploading via ftp is easy but may not meet your organazations security requirements for the transmission of data. After upload your files are secured on disk by encryption and access controls, you will not be able to view, download or delete your files after they are uploaded. You will have to decided if FTP is sutiable for uploading your files.

The FTP host is upload.hostbridge.com, user ID is anonymous and the password is your email address. All files have to be uploaded to the case directory. A typical FTP session from the windows command line will look something like this:

    H:\>ftp upload.hostbridge.com
    Connected to upload.hostbridge.com.
    220 HostBridge Technology Support Uploads
    200 Always in UTF8 mode.
    User (upload.hostbridge.com:(none)): anonymous
    331 Please specify the password.
    Password:
    230 Login successful.
    ftp> cd case
    250 Directory successfully changed.
    ftp> binary
    200 Switching to Binary mode.
    ftp> put 'YOUR.HOST.FILE.XMT' CASE1234.YOUR.HOST.FILE.XMT
    200 PORT command successful. Consider using PASV.
    150 Ok to send data.
    226 Transfer complete.
    ftp: 86018 bytes sent in 0.14Seconds 637.17Kbytes/sec.
    ftp> quit
    221 Goodbye.
                

FTP via batch job directly from your host:

    //FTP       JOB (ACCT#),TIME=99
    //PACK EXEC PGM=FTP                               
    //SYSPRINT  DD SYSOUT=*                  
    //OUTPUT    DD SYSOUT=*                  
    //INPUT     DD *                         
    upload.hostbridge.com
    anonymous your.email@address.com                   
    cd case         
    bin                                      
    put 'YOUR.HOST.FILE.XMT' CASE1234.YOUR.HOST.FILE.XMT     
    quit                                     
    //