SirAud installation

From m204wiki
Revision as of 00:19, 13 October 2016 by JAL (talk | contribs) (→‎CMS installation: minor formatting)
Jump to navigation Jump to search

You can install SirAud from a product tape or from an object deck downloaded from the Rocket Software web site. Installation from tape is described below in MVS installation and CMS installation. Installation from the web is described in the following section, Installation from the web.

All SirAud distributions come with all maintenance pre-applied: up to the time the tape was cut for tape installations, and up to the time the object deck was downloaded for web installations.

If you are a user of a previous version of SirAud, see the SirAud Release Notes for the version you are installing. The SirAud Release Notes highlights changes in the new version, and it lists any compatibility issues with the previous version.

Installation from the web

You can download the SirAud object files from the Rocket Software web site. The download process requires a user ID and password.

  1. Click the Support navigation link to go to the Customer Service page (https://support.rocketsoftware.com/rsp-portal/rsp/login), a public page that explains how to get the required user ID and password and that also contains links to the various download pages.
  2. Click the Download object files link to go to a protected page (https://m204.rocketsoftware.com/maint/objlist) that contains a dynamically-generated list of the various add-on products that you may download.

    The page also contains a Click here link that causes the page to be re-displayed with detailed download and installation instructions. These instructions supersede any information on this m204wiki page.

  3. On the Download object files page, select the link to the currently available SirAud object file for the version you require. This file is used for all the versions of Model 204 that are currently supported by SirAud.

CMS installation

SirAud is distributed on a single, 9-track, 6250 BPI magnetic tape containing the distribution files in VMFPLC2 format. You will need approximately 30 4K-byte blocks of CMS disk space to load the files.

  1. Mount the installation tape on a tape unit with a virtual address of 181.
  2. Issue the following command to load the installation tape contents to disk.

    VMFPLC2 LOAD * * A

  3. Define and format a minidisk to receive the product distribution tape.

    Note that all add-on products you have ordered will be contained in a single file on the tape. Refer to the tapemap supplied with the distribution kit for the minimum number of blocks required to contain the installation files, or simply allocate a 3400 4K-byte block minidisk, which is sufficient regardless of the number of products you are installing.

  4. Attach a tape drive at virtual address 181 to the owner of the installation minidisk defined in the previous step. Mount the product distribution tape on this tape drive.

    The product distribution tape consists of 1 physical file in VMFPLC2 DUMP format. The file contains the following items:

    File name Contents
    SIRAUD LOADLIB The SIRAUD load module.
    SIRAUD EXEC EXEC to invoke SirAud. This contains all necessary GLOBALs, and all necessary FILEDEFs except for JOURNAL, required to run SirAud in a CMS environment.
    SIRAUD NAMES A file used by SIRAUD EXEC with the CMS NAMEFIND command. The principal purpose of SIRAUD NAMES is to minimize changes to SIRAUD EXEC from version to version, keeping most updates localized in SIRAUD NAMES.

    In addition, your tape will contain the Rockzap facility, whose use is optional. Its installation and usage is described in the RockZap M204wiki pages.

  5. After unloading the SirAud load module, you can customize it to your site's needs, if necessary; see SirAud default customization.

MVS installation

SirAud is distributed on a single 9-track, 6250 BPI magnetic tape containing the following files in IEBCOPY format. Installation of SirAud consists of simply loading the distribution files to disk and modifying the sample JCL to conform to local standards.

The following JCL will load the installation tape files. Note that this step will also load any other add-on products you have ordered. The space allocations should be sufficient regardless of which products will be installed.

//LOADSIR JOB 0,CLASS=A,MSGCLASS=X,NOTIFY=ME //* //* Load Sirius products from tape //* //LIB EXEC PGM=IEBCOPY,REGION=0M //T1 DD UNIT=TAPE,LABEL=(1,SL), // DISP=(OLD,PASS),DSN=SIRIUS.LIB //T2 DD UNIT=TAPE,LABEL=(2,SL), // DISP=(OLD,PASS),DSN=SIRIUS.LOAD //T3 DD UNIT=TAPE,LABEL=(3,SL), // DISP=(OLD,PASS),DSN=SIRIUS.ULSPF //* //D1 DD DISP=(,CATLG),SPACE=(CYL,(10,0,5), // DSN=SIRIUS.LIB,UNIT=SYSDA //D2 DD DISP=(,CATLG),SPACE=(CYL,(50,0,2), // DSN=SIRIUS.LOAD,UNIT=SYSDA //D3 DD DISP=(,CATLG),SPACE=(CYL,(25,0,2), // DSN=SIRIUS.ULSPF,UNIT=SYSDA //SYSPRINT DD SYSOUT=* //SYSIN DD * COPY INDD=T1,OUTDD=D1 COPY INDD=T2,OUTDD=D2 COPY INDD=T3,OUTDD=D3 /*

The tape contains three files, each in IEBCOPY format, but only the first two are used for SirAud installation. The relevant members for SirAud in these two files are described in the following list:

Member Contents
SIRIUS.LIB Contains object files and JCL for linking and running SirAud under MVS.
SIRIUS.LOAD Contains the SIRAUD load module.

In addition, your tape will contain the Rockzap facility; use of Rockzap is optional. Rockzap usage and installation instructions are described in the RockZap M204wiki pages.

After unloading the SirAud load module, you can customize it to your site's needs, if necessary; see SirAud default customization.

See also