Downloading macro libraries: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (more conversion cleanup)
m (minor cleanup)
Line 5: Line 5:
the indicated location.  
the indicated location.  


Alternatively, the <b>left</b> mouse button can be clicked on  
Alternatively, you can click the <i>left</i> mouse button on  
the link for an macro library. This will result in the browser  
the link for a macro library. This will result in the browser  
prompting the user whether the file should be saved, where it  
prompting for whether the file should be saved, where it  
should be saved and under what name. Some browsers prompt  
should be saved, and under what name. Some browsers prompt  
for this information before the macro library is actually  
for this information before the macro library is actually  
downloaded, others prompt for it after. Obviously, those  
downloaded, others prompt for it after. Obviously, those  
Line 15: Line 15:
file header but continues downloading while waiting for the user response.  
file header but continues downloading while waiting for the user response.  


If the e-mail transfer is selected the macro library will be e-mailed should   
If the e-mail transfer is selected, the macro library is e-mailed and should   
be saved to a local file and then uploaded to the mainframe exactly as  
be saved to a local file, then uploaded to the mainframe exactly as  
if it had been downloaded directly. Receiving the object deck via e-mail  
if it had been downloaded directly. Receiving the object deck via e-mail  
allows the library to be sent to a different person/workstation  
allows the library to be sent to a different person/workstation  
Line 22: Line 22:


==How can the macro libraries be uploaded to the mainframe?==  
==How can the macro libraries be uploaded to the mainframe?==  
Once the macro libraries are downloaded to the workstation they must  
Once the macro libraries are downloaded to the workstation, they must  
be uploaded to the MVS, VM or VSE system on the IBM mainframe.     
be uploaded to the MVS, VM, or VSE system on the IBM mainframe.     
Any file transfer mechanism can be used including FTP and IND$FILE   
Any file transfer mechanism can be used including FTP and IND$FILE,  
but regardless of the transfer mechanism some rules must be  
but regardless of the transfer mechanism, some rules must be  
observed.   
observed.   



Revision as of 20:51, 22 January 2015

How can the macro libraries be downloaded?

The macro libraries can be downloaded by right-clicking the link for the macro library and selecting the save option (Save Link As, Save target As, Save As or something similar). Then set the appropriate target directory (and name if desired) for the file. The macro library will then be downloaded to to the indicated location.

Alternatively, you can click the left mouse button on the link for a macro library. This will result in the browser prompting for whether the file should be saved, where it should be saved, and under what name. Some browsers prompt for this information before the macro library is actually downloaded, others prompt for it after. Obviously, those that prompt after will present a considerable delay before the prompt. Opera actually prompts as soon as it receives the file header but continues downloading while waiting for the user response.

If the e-mail transfer is selected, the macro library is e-mailed and should be saved to a local file, then uploaded to the mainframe exactly as if it had been downloaded directly. Receiving the object deck via e-mail allows the library to be sent to a different person/workstation than the one initiating the request.

How can the macro libraries be uploaded to the mainframe?

Once the macro libraries are downloaded to the workstation, they must be uploaded to the MVS, VM, or VSE system on the IBM mainframe. Any file transfer mechanism can be used including FTP and IND$FILE, but regardless of the transfer mechanism, some rules must be observed.

First, the macro libraries contain binary data and hence must be transferred as binary.

Second, the format and LRECL of the file must be specified during the upload. This is because most workstation systems (including Windows, Mac OS and Unix) do not have a concept of file formats and LRECL's. This information would be lost if it were not specified during the upload. The format of the uploaded file must be F under VM systems and FB under MVS and VSE systems. The LRECL must be 80 on all systems and under MVS and VSE the blocksize can be any multiple of 80 though 3120 is a common blocksize for object libraries.

When using FTP, the characteristics (RECFM, LRECL and BLOCKSIZE) of the uploaded file can be set with the SITE and LOCSITE FTP commands. The SITE command should be used if the FTP client is on the workstation and the server is on the mainframe. In this case the SITE command might have to be sent as a "quote" to the mainframe. How this is done, depends on your workstation's FTP client. The LOCSITE command should be used if the FTP client is on the mainframe and the server is on the workstation.

Under MVS, you can upload an macro library either as a member of a Partitioned Data Set (PDS) or as an individual sequential file. A PDS is recommended as a good way to collect all your Sirius macro library uploads in one DSN, using the member name to show the product and version.

What are the Sirius Mods?

The Sirius Mods is a collection of functions and enhancements to the core Model 204 load module. These enhancements are either products in and of themselves, or they are prerequisites for products which are written in User Language. A site is authorized to download all of the Sirus Mods if it is licensed for any of the products that require these enhancements. Your authorization zap will then enable the appropriate set of products.

Products that require the Sirius Mods include:

  • Fast/Backup
  • Fast/Reload
  • Fast/Unload User Language Interface
  • Janus Network Security
  • Janus Open Server
  • Janus Open Client
  • Janus SOAP
  • Janus Specialty Data Store
  • Janus TCP/IP Base
  • Janus Web Server
  • Japanese Functions
  • SirDBA
  • SirFact
  • SirFile
  • Sirius Performance Enhancements
  • Sirius Performance Enhancements V2
  • SirLib
  • SirMon
  • SirPro
  • SirSafe
  • SirScan
  • SirTune
  • SirXref
  • Sir2000 Field Migration Facility
  • Sir2000 User Language Tools
  • Trusted Login Facility

You can determine which of these products your site is authorized for by examining your customer profile. After the Sirius Mods are installed you can verify product authorizations by issuing the SIRIUS command in an Online running a load module that includes the Sirius Mods.

Where can more documentation be found?

The Rocket M204 macro libraries are distributed on an as-is basis, so no more documentation is available.

Is there any other help available?

As always, if you have any questions about the installation of Rocket M204 products, you should not hesitate to call our technical support number at +1.800.755.4222. You can also e-mail us at m204support@rocketsoftware.com.