Dictionary/204 installation guide
Overview
Dictionary/204 Is a set of application subsystems (known as APSYs) running inside a Model 204 Online that provide full-screen and web-based tools to help programmers, DBAs, and system managers handle the complexities of User Language and file and system management.
Installing Dictionary/204 requires downloading the M204PROC
file and restoring it to your environment, setting up some subsidiary Model 204 files, and verifying that the environment has the appropriate parameter settings.
Upgrades to Dictionary/204 can almost always be handled by restoring a fresh copy of the M204PROC
file.
A summary of the Dictionary/204 installation steps
The following checklist specifies in brief the steps to follow installing Dictionary/204, whether for z/VM CMS, z/OS, or z/VSE. The sections Installing Dictionary/204 on IBM z/VM CMS, Installing Dictionary/204 on IBM z/OS, and Installing Dictionary/204 on IBM z/VSE describe these steps in greater detail for each operating system.
- Allocate the space required for the
M204PROC
data set, and RESTORE it from the DUMP files found on the website.In addition, there might be any number of other data sets required for the Dictionary/204 components you are installing. These are listed in Installation checklist (z/VM CMS), Installation checklist (z/OS), and Installation checklist (z/VSE).
- Update the Online JCL or EXEC:
- Add the DD cards, FILEDEFs, or DLBLs for the Dictionary/204 files.
- Update CCAIN parameters:
- Start the Online, using an
ONLINE
load module that contains Model 204 version 7.5 or higher. - Make sure that the Online has dump files allocated for backing up the Dictionary files.
- Create backups of all Dictionary/204 files.
- To install an update to Dictionary/204,
open file
M204PROC
and execute the following command:INCLUDE DICN.DDRINST
Run DICN.DDRINST using the JCL provided in RKOBJLIB called DDRINSTJ.
- Verify the success of the installation by compiling each Dictionary/204 subsystem.
- Use the subsystem named
DICTADMIN
to customize the Dictionary/204 environment.
Preparing for Dictionary/204 installation
The Dictionary/204 products are implemented as Model 204 subsystems.
The code for all the component subsystems resides in the file named M204PROC
which is typically downloaded from the product section of the website.
Obtaining product installation files
The files necessary for the installation are available from the Rocket Software website.
To download product files from the Rocket website:
- On the Rocket M204 Customer Care page, click the Download SOUL files link.
- After providing your registered customer login information, download the latest version of the
Dictionary/204
file (which is labeled "M204PROC" followed by a version number).A "Click here" link on this page provides Help on downloading format, some information about different browser behaviors, file sizing information, and more.
Determining eligible products
To download files or maintenance from the Rocket M204 Customer Care area of the Rocket website, you must have a registered Rocket user ID (contact Technical Support if you need an ID). The website will show only products for which your organization is up to date on maintenance or rental payments. If a product does not appear on your download page and you believe it should, contact Technical Support.
System requirements
- Dictionary/204 operates in a Model 204 Online region.
In the rest of this document, "Online" refers to a region of Model 204 running an ONLINE load module containing Version 7.5 or higher
User privileges
The installing user must have:
- Update access to the JCL or EXECs that bring up the host Online.
- System Manager privileges, as well as access to all of the Dictionary/204 subsystems and the JCL or EXEC that runs the Online Model 204 region.
New installation or reinstallation
- Sites that have never installed Dictionary/204 must use the new installation, as there are a number of files to allocate and Model 204 parameters to update.
- Sites that are re-installing the latest version of Dictionary/204
can either reinstall Dictionary/204 (using DDRINST) or perform a new installation (using DDINST) to create a new set of Dictionary/204 files.
If you are upgrading from a previous version or maintenance level, your site already has the Dictionary files that contain information about your environment.
New installation
Note: If you have never installed Dictionary/204 before, you must use these instructions. If you have installed Dictionary before, you can do a new install using these instructions if desired.
You can verify the Dictionary/204 version in the title of any Dictionary/204 screen. The installation steps are as follows:
- In the Rocket M204 Customer Care page of the Rocket website, click the Download SOUL files link.
- Download the latest version of the
M204PROC
file (which is labeled "All Dictionary/204 products in one file" followed by a version number). - Verify that the Online in which you are installing contains a version of Model204 equal to or greater than the Dictionary/204 version.
- Restore the
M204PROC
file into a 6000-page file on your mainframe. The DDNAME for this file in your Model 204 regions is alsoM204PROC
. - In file
M204PROC
, run the procedureDICN.DDINST
to install the downloaded release.
The Dictionary/204 APSYs can be set to AUTOSTART
if you like.
Reinstallation for existing Dictionary/204 sites
You can verify the Dictionary/204 version in the title of any Dictionary/204 screen. The reinstallation steps are as follows:
- In the Rocket M204 Customer Care page of the Rocket website, click the Download SOUL files link.
- Download the latest version of the
M204PROC
file (which is followed by a version number). - Verify that the Online in which you are installing contains a version of Model204 equal to or greater than the Dictionary/204 version.
- Restore the
M204PROC
file into a 6000-page file on your mainframe. The DDNAME for this file in your Model 204 regions is alsoM204PROC
.If you are upgrading from a previous release, simply overlay your old
M204PROC
file. - Since this update process requires updating CCASYS, you must bring up a single user Online, or run the installation as a batch process with the SYSOPT X'01' bit turned off.
- Make sure that dump files are allocated to the Online, as shown below:
//DUMPCSYS DD DISP=SHR,DSN=ccasys.dump.dataset //DUMPLINK DD DISP=SHR,DSN=datalink.dump.dataset //DUMPDCTL DD DISP=SHR,DSN=d204dctl.dump.dataset //DUMPRPT DD DISP=SHR,DSN=d204rpt.dump.dataset //DUMPDSYS DD DISP=SHR,DSN=d204sys.dump.dataset //DUMPMETA DD DISP=SHR,DSN=metadata.dump.dataset
Note: No dump data set is required for M204TEMP or M204PROC.
The size of each dump data set should be equal to the size of the corresponding Dictionary file. The DCB is:
DCB=(LRECL=6184,BLKSIZE=6184,RECFM=F)
Make sure these DD statements are also part of that JCL:
//CCASYS DD DISP=SHR,DSN=your.current.ccasys //DATALINK DD DISP=SHR,DSN=your.current.datalink //D204RPT DD DISP=SHR,DSN=your.current.d204rpt //D204SYS DD DISP=SHR,DSN=your.current.d204sys //METADATA DD DISP=SHR,DSN=your.current.metadata //M204DCTL DD DISP=SHR,DSN=your.current.m204dctl //M204PROC DD DISP=SHR,DSN=v76.version.m204proc //M204TEMP DD DISP=SHR,DSN=your.current.m204temp
Note: Running the installation job (
DICN.DDRINST
) creates the backups of the Dictionary files. - Run the procedure
DICN.DDRINST
(fileM204PROC
) to install the downloaded release.
Run DICN.DDRINST using the JCL provided in RKOBJLIB called DDRINSTJ.
The Dictionary/204 subsystems can be set to AUTOSTART
if you like.
Installing Dictionary/204 on IBM z/VM CMS
This section gives instructions for installing Dictionary/204 on z/VM CMS, including z/VM CMS system and software requirements.
Review Preparing for Dictionary/204 installation for details about general Dictionary/204 system requirements.
The M204PROC
Model 204 file, which contains the SOUL code that runs Dictionary/204, can be obtained from the Rocket website.
The following table lists the required files needed to complete an installation of Dictionary/204.
File name | Contents |
---|---|
METADATA | Required for the installation of Dictionary/204. |
DATALINK | Required for the installation of Dictionary/204. |
M204TEMP | Required for the installation of Dictionary/204. |
D204RPT | Required for the installation of Dictionary/204. |
D204SYS | Required for the installation of Dictionary/204. |
M204DCTL | Required for the installation of Dictionary/204. |
Allocate space for the Dictionary/204 files, and restore them from the dump files downloaded from the Rocket website, as described in the following steps.
Installation checklist (z/VM CMS)
- Define and format a minidisk to hold the Dictionary/204 installation files. 1500 4096-byte z/VM CMS blocks should be sufficient in all cases. This requires a 22-cylinder z/VM CMS minidisk on a 3390.
- Allocate space for the required Dictionary/204 data sets. A skeleton exec,
D204FDEF
, is provided for this purpose. Modify this exec to perform the allocations on the appropriate minidisks. Allocate space for the following data sets:M204PROC 6000 pages; must always be allocated. METADATA 400 pages; must always be allocated. DATALINK 400 pages; must always be allocated. M204TEMP 150 pages; must always be allocated. D204RPT 110 pages; must always be allocated. D204SYS 400 pages; must always be allocated. M204DCTL 100 pages; must always be allocated. Attention: If you are upgrading from a previous release, modify the D204FDEF EXEC to use the old Dictionary/204 files for the upgrade.
The installation process uses these files to install a new version of Dictionary/204.
- Modify the RESPROC EXEC to specify the
M204PROC
dump file andM204PROC
file to be loaded. - Restore the
M204PROC
file with the D204 RESPROC exec.To carry out the install, you must customize the FILEDEF inside the D204FDEF exec to conform to local standards. In addition, modify LOGONSM CCAIN to contain a valid login ID and password. If, for example, you are using the
M204PROC
file for the first time, make sure it is created, opened, and initialized before the RESTORE. - To run the D204 exec for a new install, make sure the Online execs and load modules are on an accessed disk, then enter this command:
EXEC D204 INSTALL
- To run the D204 exec for a REINSTALL, make sure the Online execs and load modules are on an accessed disk, then enter this command:
EXEC D204 REINSTALL
- Complete steps 3 through the end in the "Installing Dictionary/204 on IBM z/OS" section.
Installing Dictionary/204 on IBM z/OS
This section gives instructions for installing Dictionary/204 on IBM z/OS, including the z/OS system and software requirements. If, like most sites, you download products and updates from the Rocket website, see the instructions in Reinstallation for existing Dictionary/204 sites.
Installation checklist (z/OS)
- Allocate the space required for the Dictionary/204 files. If you are creating a new
M204PROC
file from scratch, this will not be a problem. But if you are restoring into your existingM204PROC
file, you will have to CREATE the file first (to wipe out existing content) before you execute the RESTORE.An example command sequence follows:
CREATE FILE M204PROC END CREATE OPEN FILE M204PROC IN M024PROC RESTORE 192 FROM <whatever>
M204PROC 6000 pages METADATA 400 pages DATALINK 400 pages M204TEMP 150 pages D204RPT 110 pages D204SYS 400 pages M204DCTL 100 pages Attention: If you are upgrading from a previous release, keep your old copies of Dictionary/204 files. The installation process uses these files to determine whether to perform upgrade actions or new-installation actions.
- Restore
M204PROC
, noting the following:- Rename database DSNs to conform to local standards.
- Provide a valid logon ID and password for the CCAIN stream for this job.
If, for example, you are using the
M204PROC
file for the first time, make sure it is created, opened, and initialized before the RESTORE.
- Update the Online JCL or EXEC:
Add DD (z/OS) cards or FILEDEFs (z/VM CMS) or DLBLs (z/VSE) for the Dictionary/204 files. The following list identifies the files for which DD cards or FILEDEFs might be needed:
- M204PROC
- METADATA
- DATALINK
- M204TEMP
- M204DCTL
- D204SYS
- D204RPT
- Verify that the Online environment allows the use of file groups and APSY subsystems.
- To use permanent file groups, the Online must have allocated an
initialized
CCAGRP
file, and the SYSOPT parameter must contain the2
bit. - To use APSYs, an Online must have allocated an initialized CCASYS file
(with all fields defined), and the SYSOPT parameter must contain the
1
bit.For more information about APSYs and file groups, see File groups and System requirements for Application Subsystems.
- To use permanent file groups, the Online must have allocated an
initialized
- Modify the User 0 stream.
Adjust these parameters:
NFILES Increase by the number of Dictionary/204 files. NDCBS Increase by the number of Dictionary/204 files. NDIR Increase by the number of Dictionary/204 files. NORQS Verify setting is at least 5. - Start the Model 204 Online region, verifying that it points to a load module containing the Model204 Online.
- Issue
OPEN FILE M204PROC
(no password is required), and execute the following command:INCLUDE DICN.DDRINST
Run DICN.DDRINST using the JCL provided in RKOBJLIB called DDRINSTJ.
This procedure performs all installation functions for new users, and all upgrade functions for reinstalling users. No user profiles or other site-specific customization will be lost. If any problems are encountered while running this procedure, correct the problem and re-execute.
During APSY execution, some error messages are not suppressed, to aid in diagnosing any installation problems. For example, you will be able to see if an installation failed because a file was enqueued in a different Online, and so on.
- Add users to the appropriate SCLASSes for any private or semi-public Dictionary/204 APSYs.
The installing user is automatically added to the administration SCLASS in all Dictionary/204 APSYs.
- Verify the installation of the subsystem(s) by compiling all of the subsystems.
Enter ... To test the ... START SUBSYS DICTIONARY DICTIONARY MENU START SUBSYS DICTADMIN DICTIONARY ADMINISTRATION START SUBSYS DOCUMENT Documentation environment START SUBSYS FILEMGMT File building tool START SUBSYS SUBSYSMGMT Defining APSY subsystems START SUBSYS DICTREPORT Dictionary report subsystem START SUBSYS XREF Cross reference reporting subsystem If any of these subsystems fails to compile, ensure that the subsystem is STOPped, and run it under
TEST DEBUG
mode. For example, to determine why DICTIONARY failed to compile, enter:TEST DEBUG DICTIONARY
- This step is optional.
Modify the online input stream so User 0 initializes (compiles) the Dictionary/204 subsystems.
Do this by placing one or more of the following in User 0's input stream:
START SUBSYS DICTIONARY START SUBSYS DOCUMENT START SUBSYS DICTADMIN START SUBSYS FILEMGMT START SUBSYS SUBSYSMGMT START SUBSYS DICTREPORT START SUBSYS XREF
This ensures that the subsystems are started for non-administrative users, and it shifts the overhead of compilation to a non-peak computing period.
- Review the Dictionary/204 server size section, below, for specific requirements of individual APSY components of Dictionary/204.
Note: CCATEMP usage may increase with Dictionary/204.
CCATEMP should be monitored (VIEW TEMPSIZE
, VIEW TEMPMAX
) to ensure that sufficient space is allocated to accommodate the additional activity.
Installing Dictionary/204 on IBM z/VSE
This section gives instructions for installing Dictionary/204 on IBM z/VSE, including z/VSE system and software requirements.
If like most sites, you download products and updates from the Rocket website, see the instructions in Reinstallation for existing Dictionary/204 sites.
Installation checklist (z/VSE)
- Allocate the space required for the Dictionary/204 files. If you are creating a new
M204PROC
file from scratch, this will not be a problem. But if you are restoring into your existingM204PROC
file, you will have to CREATE the file first (to wipe out existing content) before you execute the RESTORE.A sample command sequence follows:
CREATE FILE M204PROC END CREATE OPEN FILE M204PROC IN M024PROC RESTORE 192 FROM <whatever>
M204PROC 6000 pages METADATA 400 pages DATALINK 400 pages M204TEMP 150 pages D204RPT 110 pages D204SYS 400 pages M204DCTL 100 pages Attention: If you are upgrading from a previous release, keep your old copies of Dictionary/204 files. The installation process uses these files to determine whether to perform upgrade actions or new-installation actions.
- Restore
M204PROC
, noting the following:- Rename database DSNs to conform to local standards.
- Provide a valid logon ID and password for the CCAIN stream for this job.
If, for example, you are using the
M204PROC
file for the first time, make sure it is created, opened, and initialized before the RESTORE.
- Update the Online JCL or EXEC:
Add DD (z/OS) cards or FILEDEFs (z/VM CMS) or DLBLs (z/VSE) for the Dictionary/204 files. The following list identifies the files for which DD cards or FILEDEFs might be needed:
- M204PROC
- METADATA
- DATALINK
- M204TEMP
- M204DCTL
- D204SYS
- D204RPT
- Verify that the Online environment allows the use of file groups and application subsystems.
- To use permanent file groups, the Online must have allocated an
initialized
CCAGRP
file, and the UPSI parameter must contain the00000010
bit. - To use application subsystems, an Online must have allocated an initialized CCASYS file
(with all fields defined), and the UPSI parameter must contain the
00000001
bit.For more information about application subsystems and file groups, see File groups and System requirements for Application Subsystems.
- To use permanent file groups, the Online must have allocated an
initialized
- Modify the User 0 stream.
Adjust these parameters:
NFILES Increase by the number of Dictionary/204 files. NDCBS Increase by the number of Dictionary/204 files. NDIR Increase by the number of Dictionary/204 files. NORQS Verify that the setting is at least 5. - Start the Model 204 Online region, verifying that it points to a load module containing the Model204 Online.
- Issue
OPEN FILE M204PROC
(no password is required), and execute the following command:INCLUDE DICN.DDRINST
This procedure performs all installation functions for new users and all upgrade functions for reinstalling users. No user profiles or other site-specific customization will be lost. If any problems are encountered while running this procedure, correct the problem and re-execute.
During APSY execution, some error messages are not suppressed, to aid in diagnosing any installation problems. For example, you will be able to see if an installation failed because a file was enqueued in a different Online, and so on.
- Add users to the appropriate SCLASSes for any private or semi-public Dictionary/204 APSYs.
The installing user is automatically added to the administration SCLASS in all Dictionary/204 APSYs.
- Verify the installation of the subsystem(s) by compiling all of the subsystems.
Enter ... To test the ... START SUBSYS DICTIONARY DICTIONARY MENU START SUBSYS DICTADMIN DICTIONARY ADMINISTRATION START SUBSYS DOCUMENT Documentation environment START SUBSYS FILEMGMT File building tool START SUBSYS SUBSYSMGMT Defining APSY subsystems START SUBSYS DICTREPORT Dictionary report subsystem START SUBSYS XREF Cross reference reporting subsystem If any of these subsystems fails to compile, ensure that the subsystem is STOPped, and run it under
TEST DEBUG
mode. For example, to determine why DICTIONARY failed to compile, enter:TEST DEBUG DICTIONARY
- This step is optional.
Modify the online input stream so User 0 initializes (compiles) the Dictionary/204 subsystems.
Do this by placing one or more of the following in User 0's input stream:
START SUBSYS DICTIONARY START SUBSYS DOCUMENT START SUBSYS DICTADMIN START SUBSYS FILEMGMT START SUBSYS SUBSYSMGMT START SUBSYS DICTREPORT START SUBSYS XREF
This ensures that the subsystems are started for non-administrative users, and it shifts the overhead of compilation to a non-peak computing period.
- Review Dictionary/204 server size for specific requirements of individual APSY components of Dictionary/204.
Note: CCATEMP usage might increase with Dictionary/204.
CCATEMP should be monitored (VIEW TEMPSIZE
, VIEW TEMPMAX
) to ensure that sufficient space is allocated to accommodate the additional activity.
Dictionary/204 server size
The minimum Dictionary/204 server size requirements are listed below. The actual server size requirements might vary slightly because of table settings in the local Online Model 204 regions, and because of slight differences between UTABLE requirements in different versions of Model 204.
Subsystem name | Minimum server |
---|---|
DICTIONARY | 455K |
DOCUMENT | 455K |
DICTADMIN | 455K |
FILEMGMT | 455K |
SUBSYSMGMT | 455K |
DICTREPORT | 455K |
XREF | 455K |