Downloading macro libraries

How can the macro libraries be downloaded?

The macro libraries can be downloaded by clicking on the link for the macro library with the right mouse button. This will (on most browsers) bring up a pop-up menu that will have an option Save Link As, Save target As, Save As or something similar. Select this option and 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, the left mouse button can be clicked on the link for an macro library. This will result in the browser prompting the user 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 will be e-mailed to the indicated e-mail address as an attachment. The attachment should be saved to a local file and 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 <a href="https://m204.rocketsoftware.com/dlist">your customer profile</a>. 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].