Model 204 installation on IBM z/VSE: Difference between revisions
No edit summary |
|||
| Line 267: | Line 267: | ||
==Preparing site-specific CDTB, FUNU, and MSGU modules== | ==Preparing site-specific CDTB, FUNU, and MSGU modules== | ||
<div id="FUNU_7.5"></div> | |||
===CDTBASMC, FUNUASMC, and MSGUASMC jobs=== | ===CDTBASMC, FUNUASMC, and MSGUASMC jobs=== | ||
If you use translation tables or user-written functions, you must change the source code in the CDTB.A, FUNU.A, and MSGU.A sublibrary members to accommodate the requirements of your site, as shown in the following table. | If you use translation tables or user-written functions, you must change the source code in the CDTB.A, FUNU.A, and MSGU.A sublibrary members to accommodate the requirements of your site, as shown in the following table. | ||
<p class="caption">Customizable user modules</p> | <p class="caption">Customizable user modules</p> | ||
| Line 283: | Line 285: | ||
It is recommended that if you think your site will make use of the TCP/IP Sockets Interface for Model 204, link the FUNU.A member during the installation process, even if you have not yet developed your own functions. This ensures access to the $ASCII and $EBCDIC functions. | It is recommended that if you think your site will make use of the TCP/IP Sockets Interface for Model 204, link the FUNU.A member during the installation process, even if you have not yet developed your own functions. This ensures access to the $ASCII and $EBCDIC functions. | ||
<div id="FUNU_7.5_assemble"></div> | |||
===Assembling CDTB, FUNU, and MSGU=== | |||
The following table identifies the JCL to assemble CDTB, FUNU, and MSGU and catalog the object decks into the Model 204 sublibrary. | The following table identifies the JCL to assemble CDTB, FUNU, and MSGU and catalog the object decks into the Model 204 sublibrary. | ||
<p class="caption">JCL library member for user modules</p> | <p class="caption">JCL library member for user modules</p> | ||
| Line 364: | Line 366: | ||
<div id="bvp204"></div> | <div id="bvp204"></div> | ||
==Linking the $$BVP204 phase== | ==Linking the $$BVP204 phase== | ||
<!--Caution: <div> above--> | <!--Caution: <div> above--> | ||
Revision as of 20:41, 17 March 2015
Note: This page is currently under construction.
This page describes the steps required to upgrade from Rocket Model 204 version 7.4 to version 7.5, on the IBM z/VSE operating system.
In order to upgrade to Model 204 version 7.5, you must have version 7.4 and the latest Autofix set of Early Warnings installed on your system. |
To upgrade to version 7.5 simply download, upload, and link the 7.5 object modules available from the downloads page to install the 7.5 components.
Before you begin
- In order to upgrade to version 7.5, you must have version 7.4 and Autofix release EW3044 installed on your system.
Autofix release EW3044 includes:
- Early Warnings for Model 204 through 740EW172
- Early Warnings for Dictionary/204 through 740DI016
- For system requirements for version 7.5, see the 7.5 Release notes.
- You must have either a Rocket M204 user ID or a Sirius user ID to download the installation files.
- The sublibrary containing the object has the authorization zap (covering your licensed processors) preapplied, so you do not need to get a new authorization zap from the website.
(The preapplied zap will authorize Model 204 itself and any separately purchased products such as MQ/204 and SirScan.) - The object files also have the maintenance zaps (as of the time the stream was prepared) preapplied, so you do not need to apply any maintenance as part of this installation. (You will only need to apply any new maintenance when it becomes available for this release.)
Overview of upgrading steps
Review the following high-level summary of steps before you begin downloading the Model 204 version 7.5 files.
For an example, see Example workflow for 7.5: download through installation.
Use your Rocket M204 user ID to download the Model 204 object source and JCL, including M204CATP.
- Upload (FTP) the CATV750 job to the POWER RDR queue, CLASS=0, in binary format. This job will catalog object, source, and JCL into each Model 204 sublibrary: Jrrr, and Vrrr.
- Upload, modify, and submit the M204CATP job. M204CATP allocates VSAM managed space for the Model 204 library, defines the sublibraries, and catalogues procedures.
- From the VSE console, release each job from the RDR queue. For example, R rdr,catv740. At the pause, enter the DLBL statements for your Model 204 library.
- If you have your own user $functions (FUNU), you must do the following steps:
- modify FUNU for 64-bit addressing considerations and store the modified source in your V750 sublibrary.
- If you have any user-defined messages (MSGU), store them in your V750 sublibrary.
- Assemble FUNU (and MSGU, if applicable), with the output object file stored in your V750 sublibrary.
- If you use customized modules, such as CDTB, modify them as needed and assemble them.
- Create the system history file.
- Apply the CPU ID zap.
- If your z/VSE site runs under z/VM, copy and link the $$BVP204 phase.
- If you use the CICS interface, customize it, and then assemble and link the CICS modules.
- Link the ONLINE phase.
- If you use the IFAM1 phase, link it.
- Link the Model 204 utility programs.
- If you use SoftSpy, upgrade it for 7.5.
Model 204 disk space requirements
The following table summarizes the minimum disk space requirements for the libraries as well as other information to help you calculate EXTENT information for Model 204 files.
Minimum disk space requirements
| Disk type | Minimum Model 204 library requirement | Bytes/track | Model 204 pages/track |
|---|---|---|---|
| 3380 | 720 tracks | 47476 | 7 |
| 3390 | 604 tracks | 56664 | 8 |
| 9345 | 736 tracks | 46456 | 6 |
| FBA | 67000 blocks | 512 bytes/block | 13 blocks/page |
Building the object and macro libraries
To build the object and macro libraries, you must download the object library and macro library and upload (FTP) each library to the mainframe.
Downloading
- Using your Rocket M204 user ID and password, log in to the Model 204 object file download page.
- Click the Download object file link beside the object library that you want to download.
- Go to the Model 204 macro library download page.
- Click the Download macro library link beside the macro library that you want to download.
Uploading (FTP)
Once the object file and macro library are downloaded to your workstation, FTP them to the z/VSE system on the IBM mainframe.
Specify these characteristics for the upload files:
| transfer format: | binary |
| record format: | FB |
| record size: | 80 for object and macro libraries |
| block size: | 6400 for object and macro libraries |
| storage size for both: | primary: 10 CYL; secondary: 5 CYL |
For details on how to download and upload, see Downloading and uploading Model 204 installation components.
Reserving a partition
Rocket recommends a minimum partition size of eight megabytes (8M) when installing Model 204.
Some Model 204 installation JCL might assign system files/devices (SYSIPT, SYSPCH, etc.) to disk; z/VSE requires that this JCL be run in a static partition.
Space requirement for the Model 204 library
The M204CATP job distributed with the Model 204 software will allocate the appropriate space for the Model 204 library. In the sublibrary name, rrr represents the release level, such as 750.
| Sublibrary | Required library blocks |
|---|---|
| Jrrr | 700 |
| Vrrr | 17,800 |
Overview of the Model 204 library
M204LIB contains all the materials needed to run the Model 204 z/VSE configurations (ONLINE, BATCH204, BATCH2, and IFAM1), and utilities. M204LIB is composed of sublibraries: Jrrr, Vrrr, Errr, and Drrr, where rrr is the release level, such as 750. Model 204 does not contain pre-linked phases. You must link all phases that you want to use.
Allocating library space, defining sublibraries, and cataloging procedures
The M204CATP job allocates VSAM managed space for the Model 204 library, defines the sublibraries, and catalogs the two Model 204 procedures.
- FTP the m204catp.jcl file to the mainframe in ASCII format.
- Modify the M204CATP job as noted in the m204catp.jcl file.
- Submit the M204CATP job.
CICS interface installation
The Model 204 CICS interface allows CICS complete access to Model 204 facilities and supports CICS pseudo conversational programs.
Note: It is not necessary to install the CICS interface if it has been installed for a previous version of Model 204. The load modules from the older version are compatible with version 7.5 of Model 204.
Requirements
- CICS Transaction Server support
Rocket M204 supports the CICS Transaction Server versions 3.1, 3.2, 4.1, and 4.2.
- Supporting TPROCESS COBOL applications
If your CICS TPROCESS application was originally linked with AMODE=24, you must relink the CICS TPROCESS application specifying AMODE=31 because AMODE=24 is not supported.
CICS interface overview
For an overview of the CICS interface, including storage requirements and a listing of CICS interface components, see CICS interface.
Installing the CICS interface
- Customize the interface by editing the CICFG copy member and replacing it in the distribution library as CICFG.A. then proceed with the CICSASM and CICSLINK jobs.
For information on customizations needed for using the CICS Standard Mapping Service, see CICS interface.
- Update the CICS System Definition (CSD) using one of the following methods:
- Resource Definition Online (CEDA).
- The IBM DFHSCDUP offline utility, to process the definitions in batch.
- Processing the CICS Program Control Table (PCT) and Program Processing Table (PPT)
- Assemble, translate, and catalog the Model 204 CICS Interface modules, using the following jobs:
- Relink the IFAM2 transactions requiring pseudo conversational support with IFENTPS.
- Relink all user process-to-process partners with IFPPCI.
Updating the CICS System Definition (CSD)
You can update the CSD by using CEDA, by using the DFHCSDUP utility, or by processing the CICS Program Control Table (PCT). Use the values in the following table, where appropriate, for the method you choose. Information about using CEDA follows the table.
CICS System Definition values
| User program | Program name | Transaction ID | Modifiable CICFG symbol |
TWA size |
|---|---|---|---|---|
| IFAM2 pseudo conversational | DFHPSF | DFHPSF is accessed by using a CICS LINK. It is never invoked with a transaction ID from a terminal. | ||
| Full-screen interface | M204PSFS | M204 | &TRN | 88 |
| Screen copy transaction | M204CRPS | U204 | ||
| Screen print transaction | M204PRNT | P204 | &COP | 88 |
CEDA (the Resource Definition Online transaction) or the DFHCSDUP utility defines the transactions and programs to the CSD file.
If you are not using tables, then define the transactions and programs by using CEDA and the values in the previous table, as in the following example:
CEDA DEFine PROG(program_name) GRoup(group_name) LANGuage(ASSEMBLER) RELoad(NO) RESident(NO) (Except for DFHPSF, RESident(YES)) STatus(ENABLED) CEDA DEFine TRANsaction(trans_ID) GRoup(group_name) PROgram(program_name) TWASIZE(twa_size_value) . . . CEDA CHeck GRoup(group_name) CEDA INstall GRoup(group_name)
You can use a transaction ID for a user program that is different from the value shown in the previous table. However, if you do so, you must change the associated CICFG symbol shown in the table.
As shown in the preceding example, group_name is any valid group name for the user site.
Note: Remember to add the groups to the GRPLIST for the particular CICS region. If the groups are not added, they are not installed during each CICS initialization.
Processing the PCT and PPT
The JCL library members PCTNTRY and PPTNTRY have the Program Control Table (PCT) and the Program Processing Table (PPT) default values shown in the following code. You can update the CSD by adding to or modifying these default values and then assembling the tables.
PCT: Program Control Table
The Program Control Table (PCT) assigns user programs to their related CICS transaction identifiers (the transaction codes). Entries are required for both the 3270 full-screen interface and the screen print transaction.
The JCL library member PCTNTRY contains the PCT default values shown in the following code:
DFHPCT TYPE=ENTRY,PROGRAM=M204PSFS,TRANSID=M204,TWASIZE=88 DFHPCT TYPE=ENTRY,PROGRAM=M204PRNT,TRANSID=P204,TWASIZE=88 DFHPCT TYPE=ENTRY,PROGRAM=M204CRPS,TRANSID=U204
The following entry in the PCT is required for all user IFAM2 transactions:
DFHPCT TYPE=ENTRY,PROGRAM=program_name,TRANSID=xxxx,TWASIZE=88
Use the values in the previous table if you are updating the PCT. If you use a transaction ID for a user program that is different from the value shown in that table, you must change the associated CICFG symbol.
PPT: Program Processing Table
The Program Processing Table (PPT) stores program attributes. Entries are required for the 3270 full-screen interface, direct printer support, and the IFAM2 interface.
The JCL library member PPTNTRY contains the PPT default values shown in the following code.
Note: In the first line of the PPT, be sure to set the RES parameter to YES, otherwise, the transaction does not complete successfully.
DFHPPT TYPE=ENTRY,PROGRAM=DFHPSF,RES=YES,PGMLANG=ASSEMBLER DFHPPT TYPE=ENTRY,PROGRAM=M204CRPS,PGMLANG=ASSEMBLER DFHPPT TYPE=ENTRY,PROGRAM=M204PRNT,PGMLANG=ASSEMBLER DFHPPT TYPE=ENTRY,PROGRAM=M204PSFS,PGMLANG=ASSEMBLER DFHPPT TYPE=ENTRY,PROGRAM=OBPLTSD,PGMLANG=ASSEMBLER
Assembling the CICS Interface modules
Assemble, in the sequence listed, the CICS Interface modules listed in the assembly step in the CICS installation steps table.
Some assemblies display a warning message (DFHEIMSG 4) because the CSA address is release-dependent. If the interface program is running in the release under which it was assembled, ignore the warning.
After the modules are successfully built, relink as directed in "CICS installation steps."
Preparing site-specific CDTB, FUNU, and MSGU modules
CDTBASMC, FUNUASMC, and MSGUASMC jobs
If you use translation tables or user-written functions, you must change the source code in the CDTB.A, FUNU.A, and MSGU.A sublibrary members to accommodate the requirements of your site, as shown in the following table.
Customizable user modules
| If you use... | Then do this... | Using this job |
|---|---|---|
| $CODE and $DECODE functions to encode and decode character strings | Edit your own translation tables into the CDTB.A member | CDTBASMC |
| Your own User Language functions | Add them to the FUNU.A member | FUNUASMC |
| Error messages with your own User Language functions | Modify the MSGU.A member | MSGUASMC |
The FUNU.A member contains one user function, $SEP, which adds separators when a date is entered in the format mm/dd/yy. MSGU.A also contains one sample error message.
You can use FUNU.A and MSGU.A to write your own user functions. The steps for installing the modules, as well as assembly considerations, are provided here.
It is recommended that if you think your site will make use of the TCP/IP Sockets Interface for Model 204, link the FUNU.A member during the installation process, even if you have not yet developed your own functions. This ensures access to the $ASCII and $EBCDIC functions.
Assembling CDTB, FUNU, and MSGU
The following table identifies the JCL to assemble CDTB, FUNU, and MSGU and catalog the object decks into the Model 204 sublibrary.
JCL library member for user modules
| Member | Assembles and catalogs user modules |
|---|---|
| CDTBASMC | CDTB (code table) |
| FUNUASMC | FUNU (functions) |
| MSGUASMC | MSGU (messages) |
Once the modules are assembled and cataloged, link the Model 204 phases to contain user code tables and/or user functions, specifying the M204LIB.Vrrr sublibrary containing the CDTB, FUNU, and MSGU modules in the search list.
The M204LIB.Vrrr sublibrary members LKONLN and LKB204 distributed with this version contain the INCLUDE statements for CDTB, FUNU, and MSGU.
Assembly considerations for FUNU and MSGU
Some of the Model 204 macros and copy code needed to assemble FUNU and MSGU contain assembly language statements that are not supported by the z/VSE assembler. An assembly error occurs in the following circumstances:
-
EQU statement specifies a length attribute or type attribute. The following example from the VARDEFS copy book illustrates the error:
VISLVL EQU 0,1 FIELD SECURITY LEVEL
The error generated for this statement is:
IPK122 INVALID DELIMITER, ',1'
-
EQU statement specifies a value that is too long or too large by assembler
rules. The following example from the STARTS macro illustrates the error:
MAXFS EQU 16777216/(4096*8) .MAX NUMBER OF INTERNAL FILE SEGMENTS
The error generated for this statement is:
IPK117 VALUE OF SELF-DEFINING TERM '16777216' TOO LARGE
See the z/VSE assembler error message IPK117 for more information.
-
Symbol defined by an EQU statement of the type described above is
referenced in a subsequent assembler statement. The following example
from the STARTS macro illustrates the error:
IVBN EQU ((MAXFS+7)/8). MAX # OF BYTES IN SEGMENT BIT PATTERN
Where the error occurs because MAXFS is undefined (see the example in the second bullet, above), the error generated for this statement is:
IPK149 SYMBOL 'MAXFS' NOT PREVIOUSLY DEFINED
-
In FUNU, some undefined symbols generate the following statement:
QW9 ***** UNDEFINED *****
The error generated for this statement is:
IPK149 SYMBOL 'QW9' NOT PREVIOUSLY DEFINED
The text generated is executable and executes properly (barring logic errors) unless code that references an undefined symbol is executed.
Assembling FUNU and MSGU generates the errors described. However, in FUNU, no assembly errors occur within the FUNUTAB table entries or within the code for a user function (between the $name ENTER statement that begins the function and the LEAVENUM, LEAVESTR, or LEAVEF0 macro that terminates it). In MSGU, no assembly errors occur after the MSGU$ CSECT statement. CDTB receives no assembly errors.
z/VSE assembler errors
Rocket Software takes no responsibility for the errors generated by the z/VSE assembler. It is your responsibility to ensure that you do not code user functions referencing symbols that are undefined due to an assembler error.
Linking the $$BVP204 phase
The following information applies only to z/VSE sites running under z/VM.
The $$BVP204 phase is a transient: it is required for the z/VM-directed output feature, and it is invoked by Model 204 to issue diagnostic instructions in order to pass CP commands to z/VM.
Linking $$BVP204 to the system library improves performance.
LINK$BVP job
To link $$BVP204, use the LINK$BVP job from the JCL library.
This is a required step in a Model 204 installation on z/VSE running under z/VM.
COPYVMPR job
To copy $$BVP204 to the System Residence Library, use the COPYVMPR job from the JCL library.
This is a required step in a Model 204 installation on z/VSE running under z/VM.
Installing terminal access methods and communications features
This section presents basic steps for installing these terminal access methods and communications features:
- Model 204 Virtual Telecommunications Access Method (VTAM) Interface.
- Horizon intersystem communication feature, which is required for Connect* support. This feature is provided in a limited edition without encryption. See “Installation considerations.”
- Parallel Query Option/204, which enables distributed file processing.
General VTAM installation steps
The basic steps for installing these features with Model 204 are:
- Link edit Model 204 with the appropriate object modules after commenting out the INCLUDEs for any features (PQO, Horizon, VTAM) not used at your site.
Note: The installation task list for each feature includes this step; however, you need to link edit Model 204 only once, after you apply the CPU ID zap and apply all available Early Warnings.
- Complete the Model 204 installation.
Installing the VTAM Interface
Installing Model 204 with VTAM requires defining Model 204 as a VTAM application program. Model 204 provides 3270 support, as well as VTAM support for full-screen terminals that are not 3270-compatible, by providing a mechanism for writing exit routines to convert data outside of the VTAM 3270 interface.
Rules governing data conversion exit routine coding are described in System management. To install the VTAM Interface, perform these steps:
| Step | Task | Job |
|---|---|---|
| 1. | Make sure that the link job contains INCLUDE LKVTAM. | LINKONLN |
| 2. | Define Model 204 as a VTAM application node using an APPL statement in VTMAPPL.B. | |
| 3. | Link edit the Model 204 ONLINE phase. | LINKONLN |
Specifying a VTAMNAME
The network name of the Model 204 run is specified for VTAM in the Model 204 system parameter VTAMNAME. The VTAMNAME parameter in CCAIN is the same as the APPL statement name field.
The value of VTAMNAME is a string composed of 1-8 characters. The default is M204. VTAMNAME can be specified by the system manager on the User 0 parameter line.
For more information on VTAM parameters, see System management and Commands.
Installing the Horizon Interface
The Horizon intersystem communication feature is required for Connect* and TCP/IP support.
To install the Horizon Interface, perform these steps:
| Step | Task | Job |
|---|---|---|
| 1. | Make sure that the link job contains INCLUDE LKHRZN. | LINKONLN |
| 2. | Link edit the Model 204 ONLINE phase. | LINKONLN |
For more information about Horizon, see the Rocket Model 204 Horizon: Intersystem Processing Guide.
Installing Parallel Query Option/204
Parallel Query Option/204 (PQO) enables distributed file processing.
To install PQO, perform these steps:
| Step | Task | Job |
|---|---|---|
| 1. | Make sure that the link job contains INCLUDE LKPQO. | LINKONLN |
| 2. | Link edit the Model 204 ONLINE phase. | LINKONLN |
For more information about PQO, see the Parallel Query Option/204 User’s Guide.
Installing CRAM
The Cross-Region Access Method (CRAM) lets two or more Model 204 users in two or more partitions communicate with each other. CRAM is used by:
- BATCH2
- CICS Interface
- IFAM2
See Defining the user environment (CCAIN) for more information about CRAM.
Linking the CRAM phases
To link the CRAM phases (CRAMSWT, CRAMZWT, IGCLM244, and SNAPCRAM), use the LINKCRAM job from the JCL library.
Cataloging procedures
After you have upgraded to Model 204 7.5, you can store some of the more frequently used JCL in the form of cataloged procedures. The jobs to catalog these procedures are distributed in the JCL sublibrary.
To catalog procedures, modify each procedure as follows:
- Add POWER JCL
- Add the appropriate DLBL, EXTENT, and ASSGN information
The jobs assume that the M204JCL procedure is in the system library (IJSYSRS.SYSLIB). All other Rocket-supplied procedures are cataloged into the JCL sublibrary. The JCL to catalog frequently used procedures follows. Determine the new file, library volumes, and extents; then modify the procedures before cataloging them.
Procedures that can be cataloged
As needed, you can modify and catalog the following procedures using the jobs listed in the following table.
Jobs for cataloging frequently used procedures
| Procedure name | Catalog job | Description |
|---|---|---|
| M204DECR | CATDECR | Decryption files |
| M204MSHP | CATMSHP | System history file |
| M204WRK1 | CATWRK1 | Work file for decryption, translation, and assembly |
| M204WRK2 | CATWRK2 | Work file for decryption, translation, and assembly |
| M204SYS | CATSYS | System files (CCASYS, CCASTAT, CCATEMP) |
| M204DD | DDINST, DDRINST | Dictionary/204 files |
Cataloging procedures for end-user products
For end-user products, such as Dictionary/204, you catalog the procedure that contains file information specific to that product as part of the installation procedure.
For example, the M204DD procedure, which contains file information about Dictionary/204, is cataloged in the DDINST job.
Link editing the Model 204 phases
You must link all required phases and any optional phases that you want to use, including utilities and sort exits.
When applying maintenance (Early Warnings), you must link or relink the phase affected by the Early Warning.
To link any of the Model 204 phases, run the job listed for that phase in the following table. This table also lists utilities you might need and the jobs used to link or relink them.
Phases listed as Optional might be needed at your site depending on your installation requirements.
Executable phases and jobs used for linking or relinking
| Phase or utility | Purpose / Notes | Job | For more details, see ... |
|---|---|---|---|
| $$BVP204 | z/VM-directed output logical transient. Required on z/VSE systems running under z/VM. | LINK$BVP | Linking the $$BVP204 phase |
| ALLOCATE | Initializes Model 204 database files
Required for Installation JCL, Dictionary/204, and SQL installation | LINKALOC | ALLOCATE utility in z/VSE |
| AUDIT204 | Generates an audit trail for printing out later, and produces statistical reports and analysis | LINKAUDT | AUDIT204 utility |
| BATCH2 | Establishes a User Language connection to a Model 204 ONLINE running in a separate region Optional; recommended for CRAM testing. | LINKBAT2 | BATCH2 (TCP/IP) |
| BATCH204 | Handles a single user in batch mode Required to complete installation
| LINKB204 | Linking the BATCH204 phase |
| CRAMSWT | CRAM non-master subtask | LINKCRAM | Installing CRAM |
| CRAMZWT | CRAM master subtask | LINKCRAM | Installing CRAM |
| DFHPSF | CICS/IFAM2 Interface | PSFASM | Updating the CICS System Definition (CSD) |
| HASH15 | Sort exit for M204HASH | LINKHA15 | Using M204HASH in the z/VSE environment |
| IFAM1 | Host Language Interface single-thread configuration
Link or relink when:
| LINKIFM1 | IFAM1 |
| IGCLM244 | CRAM load module | LINKCRAM | Installing CRAM |
| LISTDOS | Dictionary/204 Cross-Reference
Required only for the Dictionary/204 Cross Reference utility | LINKXREF | “Installing the Cross-Reference facility” on page 75 |
| M204CRPS | CICS full-screen printer routine | CRPSASM | Updating the CICS System Definition (CSD) |
| M204PRNT | CICS 3270 print routine | PRNTASMC | “CICS IFAM2 applications” on page 31 |
| M204PSFS | CICS full-screen remote User Language interface routine | PSFSASM | Updating the CICS System Definition (CSD) |
| MERGEJ | Media recovery journal merge utility | LINKMRGJ | Using the MERGEJ utility |
| OI15 | File Load utility sort exits | LINKOI15 | Deferred update feature |
| OI35 | File Load utility sort exits | LINKOI35 | Deferred update feature |
| ONLINE | Link online; Required.
Link or relink when:
| LINKONLN | Linking the ONLINE phase |
| SNAPCRAM | CRAM control block SNAP dump routine | LINKCRAM | Installing CRAM |
| UTILC | Prints the Model 204 checkpoint file | LINKUTLC | Obtaining checkpoint information (UTILC) |
| UTILJ | Prints and copies Model 204 journal files | LINKUTLJ | Using the UTILJ utility |
| UTLA | Prints the Model 204 audit trail | LINKUTLA | z/VSE and the audit trail |
| XDECDOS | Decryption utility Required only if you purchased special features that require decryption | LINKXDEC | “Errr sublibrary” on page 12, “CATDECR job” on page 18 |
| XREFDOS | Dictionary/204 Cross-reference facility Required only for the Dictionary/204 Cross Reference utility | LINKXREF | “Installing the Cross-Reference facility” on page 75 which describes how to define the Drrr sublibrary before running the LINKXREF job. |
| ZBLDTAB | Initializes the Model 204 password table. Required to allocate and initialize CCASTAT. | LINKZBTB | Storing security information (CCASTAT) |
| ZCTLTAB | Convert CCASTAT for the Password Expiration feature. Required to convert an existing CCASTAT data set to allow data control of passwords. | LINKZCTB | Storing security information (CCASTAT) |
Linking the ONLINE phase
LINKONLN is the JCL member for linking the ONLINE phase and contains INCLUDE statements for a base loadlist and for each feature, as shown in the following table.
Loadlists for ONLINE and features
| Loadlist | ONLINE or feature |
|---|---|
| LKHRZN | Horizon |
| LKONLN | Modules common across all features |
| LKPQO | Parallel Query Option/204 |
| LKVTAM | VTAM |
Because the features for CICS do not affect the ONLINE phase, no specific loadlists are necessary for this feature. The sample LINKONLN JCL is prepared to link ONLINE with Horizon and VTAM.
Linking the IFAM1 phase
LINKIFM1 is the JCL member for linking the IFAM1 phase and contains INCLUDE statements for a base loadlist as shown in the following table.
Loadlists for IFAM1 and features
| Loadlist | IFAM1 or feature |
|---|---|
| LKIFM1 | IFAM1 |
The sample LINKIFM1 JCL is prepared to link IFAM1.
LINKIFM1 JCL example // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.Vrrr // EXEC PROC=M204Vrrr DLBL for Vrrr M204 library // LIBDEF PHASE,CATALOG=M204LIB.Vrrr // LIBDEF OBJ,SEARCH=M204LIB.Vrrr // OPTION CATAL PHASE IFAM1,* REPLACE=YES INCLUDE LKIFM1 ENTRY IFII1 /* // EXEC LNKEDT /* /&
where rrr is the release level, such as 750.
Linking the BATCH204 phase LINKB204 is the JCL member for linking the BATCH204 phase and contains INCLUDE statements for a base loadlist, as shown in the following table.
Loadlists for BATCH204 and features
| Loadlist | BATCH204 or feature |
|---|---|
| LKBTCH | BATCH204 |
The following sample LINKB204 JCL is prepared to link BATCH204.
LINKB204 JCL example
// EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.Vrrr // EXEC PROC=M204Vrrr DLBL for Vrrr M204 library // LIBDEF PHASE,CATALOG=M204LIB.Vrrr // LIBDEF OBJ,SEARCH=M204LIB.Vrrr // OPTION CATAL PHASE BATCH204,* REPLACE=YES INCLUDE LKBTCH ENTRY MAINTASK /* // EXEC LNKEDT /* /&
where rrr is the release level, such as 750.
Link editing messages
When link editing any Model 204 programs, the following messages appear one or more times in the output listing:
2139I DUPLICATE SECTION DEFINITION: COPR *** SECTION IGNORED *** 2158I NO CSECT LENGTH SUPPLIED
These messages result from the linkage editor flagging any duplicate CSECT as an error in a new release of system software. If the message reads exactly as above, you can ignore it. If, however, the error message displays anything other than COPR, contact Technical Support.
Also, you will typically see Unresolved External warnings for the following references, which you may ignore: FORTRAN modules such as DTRNH, DSQRT, and so on.
Creating password and file group data sets
Before running ONLINE, BATCH204, or IFAM1 programs, prepare the following files:
| File | Type of data set |
|---|---|
| CCAGRP | File group data set (required for file groups) |
| CCASTAT | Password data set (required) |
| CCATEMP | Scratch data set (required). See Allocating CCATEMP for information about the scratch data set. |
CCAGRP—Using permanent file groups
Before you can define permanent file groups in Model 204, you must allocate and initialize the CCAGRP file. See the Model 204 documentation wiki for information about Storing and using file group definitions (CCAGRP).
ALOCGRUP job
Follow these steps to name and size the CCAGRP file:
- Allocate CCAGRP with the ALOCGRUP job.
- Modify the ONLINE, BATCH204, and IFAM1 JCL streams.
- Issue the CREATEG command to initialize CCAGRP.
CCASTAT—Building the Model 204 password table
If your site intends to use Model 204 security features, you must build the password table in the CCASTAT file. To access CCASTAT, modify the ONLINE, BATCH204, and IFAM1 JCL streams.
ZBTBRUN job
Follow these steps to build the password table by creating CCASTAT:
- Allocate and initialize the CCASTAT file by running the ZBTBRUN job, which executes the ZBLDTAB utility program. The amount of disk storage allocated must be sufficient to contain:
- Two Model 204 pages (each page is 6184 bytes) for CKD devices.
- Minimum allocation of 26 blocks for FBA devices.
- ZBTBRUN does not usually produce a return code. Look at the listing for any indication of a problem.
- Modify ONLINE, BATCH204, and IFAM1 JCL streams. When executing the ONLINE, BATCH204, or user-written IFAM1 program that uses this security file, add this label information in the execution JCL
stream:
// DLBL CCASTAT,'M204.CCASTAT',0,SD // EXTENT SYSnnn,volser,,,start,length
Updating the password table
You must provide the full CCASTAT file information for the execution of ONLINE or BATCH204 if you plan to update the password table with the LOGCTL command. When you update the password table, Model 204 opens the file as an output data set and completely rewrites it. It is suggested that you set the retention period for the CCASTAT data set at zero to avoid operator intervention.
Activating security
In addition, to activate the security facilities of Model 204, turn on UPSI switch 3 (SYSOPT=16):
// UPSI xxx1xxxx
You can use the LOGCTL command to create entries in the password table.
Creating a Password Expiration CCASTAT
If your site would like to use the optional security feature that allows date control of passwords, you must convert an existing CCASTAT data set. This conversion may be run at any time and is irreversible.
Note: It is strongly recommended that you save a copy of the original CCASTAT file before converting it.
(If you need to create a CCASTAT file, consult the wiki topic on CCASTAT.)
Running the ZCTBRUN job
Follow these steps to convert a CCASTAT data set using the ZCTLTAB utility.
- Read the description of ZCTLTAB options, and read the comments found in the job ZCTBRUN.
- Save a copy of the original, unconverted CCASTAT file.
- Modify job ZCTBRUN as needed and run it. This will run ZCTLTAB to convert the CCASTAT data set.
Allocating CCATEMP
CCATEMP is a required data set used by Model 204 as the system scratch file.
Allocate CCATEMP before running jobs that execute an ONLINE, BATCH204, or IFAM1 program.
- Calculate the size of CCATEMP:
Allocate a minimum of 25 pages per user if your site uses file groups, otherwise allocate 20 pages per user.
- Allocate CCATEMP with the ALOCTEMP job.
Upgrading SoftSpy for 7.5
To upgrade SoftSpy for version 7.5, download, upload, and restore the SoftSpy procedure file, SPYPROC, which is distributed in a dump format.
- Download SPYPROC, in binary form, from the SOUL files download page to a workstation file.
- Upload (FTP) the file from your workstation to your z/VSE system.
- RESTORE the file into a Model 204 SOUL file.
For detailed instructions, see Downloading and restoring SOUL files.