Model 204 installation on IBM z/VSE: Difference between revisions

Revision as of 20:43, 26 January 2017

Overview

This topic describes the steps required to upgrade to Rocket Model 204 version 7.5 or later on the IBM^® z/VSE^® operating system.

For information on the new features available in version 7.5, see the 7.5 Release notes.

If you are skipping any versions when upgrading, be sure to read the release notes for those versions as well.

The new version number is referred to as 7.x, where x can be 5 or later.

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. In addition, you must catalog procedure files in the V7x0 (e.g., V750) sublibrary that include DLBL/EXTENT information for existing or new Model 204 files.

Before you begin

Model 204 version 7.5 does not include new Dictionary/204 files or new CCASTAT and CCASYS files. You will be using your existing 7.4 versions of these files.
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 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.x files.

Each step links to a section with detailed instructions. Note that some steps (such as assembling custom modules) might not apply to your installation. Once you have started, you can proceed directly through the steps (detail sections are consecutive) or return to this list for context.

Allocate and initialize the Model 204 library.
Download the Model 204 object file and macro library. You will need your Rocket M204 user ID.
Populate the Model 204 library from the downloaded streams in the previous step.
If you have your own user $functions (FUNU), you must do the following steps:
1. modify FUNU for 64-bit addressing considerations and store the modified source in your V7x0 sublibrary.
2. If you have any user-defined messages (MSGU), store them in your V7x0 sublibrary.
3. Assemble FUNU (and MSGU, if applicable).
If you use customized modules, such as CDTB, modify them as needed and assemble them.
Link the following phases and utility programs:
1. ONLINE phase
2. IFAM1 phase, if you use it
3. BATCH204 phase, if you use it
4. Model 204 phases and utility programs, such as CRAM phases
If you use the CICS interface, customize it, and then assemble and link the CICS modules.
If your z/VSE site runs under z/VM, copy and link the $$BVP204 phase.
Allocate CCATEMP, a required data set used by Model 204 as the system scratch file.
If you use SoftSpy, upgrade it for 7.x.
Verify that your upgrade was successful.

Space and partition requirements

Model 204 disk space requirements

Use the minimum disk space requirements for the libraries when calculating EXTENT information for Model 204 files.

Rocket recommends a minimum library size of 1200 tracks for disk type 3390.

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 (such as SYSIPT and SYSPCH) to disk. z/VSE requires that this JCL be run in a static partition.

Preparing the Model 204 environment

To prepare the Model 204 environment: run the M204CATP job, allocate CCATEMP, and catalog frequently used procedures.

Running M204CATP

The M204CATP job performs the following tasks:

allocates VSAM managed space for the Model 204 library (M204LIB)
defines the sublibraries V7x0 and J7x0 (e.g., V750 and J750)
catalogs two Model 204 procedures, M204V7x0 (e.g., M204V750) and M204JCL, which help facilitate access to the Model 204 sublibraries

To run the M204CATP job:

Access the M204CATP job stream text file and save it on your workstation.
Upload the job stream to the mainframe in ASCII format.
Modify the M204CATP job as noted in the file.
Submit the M204CATP job.

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 by modifying and submitting the ALOCTEMP job.
Modify the M204SYS procedure to point to the newly allocated CCATEMP.

Cataloging additional procedures

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 J7x0 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 V7x0 sublibrary.
Determine the new file, library volumes, and extents; then modify the procedures before cataloging them.

Procedures that can be cataloged

The following shows the procedures that can be cataloged and the job that must be modified for each procedure.

Determine the files, library volumes, and extents that you need for the procedures.
Modify the catalog jobs with this information.
Catalog the procedures.

Jobs for cataloging frequently used procedures
Procedure name	Catalog job	Description
M204WRK1	CATWRK1	Work file for translation and assembly
M204WRK2	CATWRK2	Work file for translation and assembly
M204SYS	CATSYS	System files (CCASTAT and CCATEMP)
M204DD	CATDD	Dictionary/204 files and CCASYS

Work file procedures

You must catalog work file procedures in the CATWRK1 and CATWRK2 jobs for the following jobs that perform translation or assembly:

CICS jobs
CDBTASMC, FUNUASMC, MSGUASMC jobs

The CCASTAT and CCASYS files from version 7.4 are compatible with version 7.x.

Building the object and macro sublibrary

To build the object and macro sublibrary, you must download the object file and macro library and upload each 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. It contains the CATV7x0 (e.g., CATV750) job stream and is saved on your workstation as M204V7x.OBJ (e.g., M204V75.OBJ).
Go to the Model 204 macro library download page.
Click the Download macro library link beside the macro library that you want to download. It contains the M204VSE job stream and is saved on your workstation as M204V7x_VSE.MAC (e.g. M204V75_VSE.MAC).

For details on how to download, see Downloading and uploading Model 204 installation components.

Once the object and macro files are downloaded to your workstation, upload them to the z/VSE system on the IBM mainframe.

Upload format and size

You can use any file transfer mechanism to upload the files, including FTP and IND$FILE.

Specify these characteristics for the upload files:

transfer format:	binary
record format:	FB
record size:	80 for each downloaded file
block size:	6400 for each downloaded file
storage size for both:	primary: 10 CYL; secondary: 5 CYL

Populating the library

Upload the M204V7x.OBJ (e.g., M204V75.OBJ) file to the POWER RDR queue, CLASS=0, in binary format. This file contains the CATV7x0 job stream, which catalogs object and JCL into the Model 204 sublibrary, V7x0.
From the VSE console, release the CATV7x0 job stream from the RDR queue (e.g., r rdr,catv750). At the pause, enter the DLBL statements for your Model 204 library.
Upload the M204V7x_VSE.MAC (e.g., M204V75_VSE.MAC) file to the POWER RDR queue, CLASS=0, in binary format. This file contains the M204VSE job stream, which catalogs source and macros into the Model 204 sublibrary, V7x0.
From the VSE console, release the M204VSE job stream from the RDR queue (r rdr,m204vse). At the pause, enter the DLBL statements for your Model 204 library.

Preparing site-specific FUNU, MSGU, and CDTB modules

FUNUASMC, MSGUASMC, and CDTBASMC jobs

If you use translation tables or user-written functions, you must change the source code in the FUNU.A, MSGU.A, and CDTB.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
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
$CODE and $DECODE functions to encode and decode character strings	Edit your own translation tables into the CDTB.A member	CDTBASMC

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 FUNU, MSGU, and CDTB

The following table identifies the JCL to assemble FUNU, MSGU, and CDTB, and catalog the object decks into the Model 204 sublibrary.

JCL library member for user modules
Member	Assembles and catalogs user modules
FUNUASMC	FUNU (functions)
MSGUASMC	MSGU (messages)
CDTBASMC	CDTB (code table)

Once the modules are assembled and cataloged, link the Model 204 phases to contain user code tables and/or user functions, specifying the V7x0 (e.g., V750) sublibrary (which contains the FUNU, MSGU, and CDTB modules) in the search list.

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.

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.

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.

Most of the utility phases from Model 204 version 7.4 will continue to perform correctly when used with version 7.x. Phases that you must relink for 7.x are listed as Required in the following table.

Executable phases and jobs used for linking or relinking
Phase or utility	Required / Optional	Purpose / Notes	Job	For more details, see ...
$$BVP204	Required (for z/VSE under z/VM)	z/VM-directed output logical transient. Required on z/VSE systems running under z/VM.	LINK$BVP	Linking the $$BVP204 phase
ALLOCATE	Required	Initializes Model 204 database files Required for Installation JCL, SQL installation, and Dictionary/204	LINKALOC	ALLOCATE utility in z/VSE
AUDIT204	Required	Generates an audit trail for printing out later, and produces statistical reports and analysis	LINKAUDT	AUDIT204 utility
BATCH2	Optional	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	Required	Handles a single user in batch mode Required to complete installation Link or relink when: Installing user modules FUNU, MSGU, CDTB Installing or upgrading to a new release of Model 204 Moving to a different release of CICS (M204 CICS Interface)	LINKB204	Linking the BATCH204 phase
CRAMSWT	Optional	CRAM non-master subtask	LINKCRAM	Linking the CRAM phases
CRAMZWT	Optional	CRAM master subtask	LINKCRAM	Linking the CRAM phases
DFHPSF	Optional	CICS/IFAM2 Interface	PSFASM	Updating the CICS System Definition (CSD)
HASH15	Optional	Sort exit for M204HASH	LINKHA15	Using M204HASH in the z/VSE environment
IFAM1	Optional	Host Language Interface single-thread configuration Link or relink when installing or upgrading to a new release of Model 204. (You can ignore UNRESOLVED ADCON messages.)	LINKIFM1	IFAM1
IGCLM244	Optional	CRAM load module	LINKCRAM	Linking the CRAM phases
M204CRPS	Optional	CICS full-screen printer routine	CRPSASM	Updating the CICS System Definition (CSD)
M204L	Optional	Loads a Model 204 phase above the line	LINKMLOD	Link editing the M204L phase
M204PRNT	Optional	CICS 3270 print routine	PRNTASMC	Updating the CICS System Definition (CSD)
M204PSFS	Optional	CICS full-screen remote User Language interface routine	PSFSASM	Updating the CICS System Definition (CSD)
MERGEJ	Required	Media recovery journal merge utility	LINKMRGJ	Using the MERGEJ utility
OI15	Optional	File Load utility sort exits	LINKOI15	Deferred update feature
OI35	Optional	File Load utility sort exits	LINKOI35	Deferred update feature
ONLINE	Required	Link online. Link or relink when: Installing user modules FUNU, MSGU, CDTB Installing or upgrading to a new release of Model 204 Moving to a different release of CICS (M204 CICS Interface)	LINKONLN	Linking the ONLINE phase
SNAPCRAM	Optional	CRAM control block SNAP dump routine	LINKCRAM	Linking the CRAM phases
UTILC	Required	Prints the Model 204 checkpoint file	LINKUTLC	Obtaining checkpoint information (UTILC)
UTILJ	Required	Prints and copies Model 204 journal files	LINKUTLJ	Using the UTILJ utility
UTLA	Optional	Prints the Model 204 audit trail	LINKUTLA	z/VSE and the audit trail
ZBLDTAB	Optional	Initializes the Model 204 password table. Required to allocate and initialize CCASTAT.	LINKZBTB	Storing security information (CCASTAT)
ZCTLTAB	Optional	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 the Model 204 core and all features. Uncomment the features that you are going to use.

Because the features for CICS do not affect the ONLINE phase, there are no INCLUDE statements for CICS.

Linking the IFAM1 phase

LINKIFM1 is the JCL member for linking the IFAM1 phase and contains an INCLUDE statement for the Model 204 core.

The following sample LINKIFM1 JCL is used to link IFAM1.

// JOB LINKIFM1 * LINKIFM1 links the IFAM1 phase /* /* To adapt this procedure to your installation: /* 1. Modify JOB statement /* 2. Modify the following in the job stream: /* ASSGN - this jcl assumes standard assignments /* for the logical units (SYS000) referenced /* in EXTENT statements. Add as needed: /* (e.g., // ASSGN SYS000,cuu) /* DATE - expiration date of dataset /* LENGTH - length of dataset in blocks/tracks /* if a MODEL 204 distribution file, see installation /* guide for number of 6184 byte pages /* START - starting location of dataset /* VOLSER - volume serial of dataset /* /* (-- For Rocket Support only: filename=LINKIFM1 7.7 2016/11/14 --) /* // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.V770 // EXEC PROC=M204V770 DLBL for V770 M204 library // LIBDEF PHASE,CATALOG=M204LIB.V770 // LIBDEF OBJ,SEARCH=M204LIB.V770 // OPTION CATAL PHASE IFAM1,* REPLACE=YES INCLUDE LKIFM1 ENTRY IFII1 /* // EXEC LNKEDT /* /&

Linking the BATCH204 phase

LINKB204 is the JCL member for linking the BATCH204 phase and contains an INCLUDE statement for the Model 204 core and all features. Uncomment the features that you are going to use.

The EVCP module is a subset of the RSQL module. The code in EVCP contains code to process complex pattern matching. The code in RSQL contains the modules in EVCP along with the modules to support the SQL engine.

To link an ONLINE with RSQL and not EVCP, uncomment the following line in the JCL:

* INCLUDE LKSQLONL /* Uncomment for Remote SQL and Pattern

To link an ONLINE with EVCP instead of RSQL, uncomment the following line:

* INCLUDE LKNOSONL /* Uncomment for Pattern Matcher

The following sample LINKB204 JCL is used to link BATCH204.

LINKB204 JCL example

// JOB LINKB204 * LINKB204 links/catalogs the MODEL 204 BATCH204 phase /* /* Note: if using LE functions in MODEL 204, /* - add INCLUDE statements for LE modules /* - concatenate appropriate sublibrary to search. /* /* (-- For Rocket Support only: filename=LINKB204 7.7 2016/11/14 --) /* // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.V770 // EXEC PROC=M204V770 DLBL for V770 M204 library // LIBDEF PHASE,CATALOG=M204LIB.V770 // LIBDEF OBJ,SEARCH=M204LIB.V770 // OPTION CATAL PHASE BATCH204,* REPLACE=YES * INCLUDE LKNOSONL /* Uncomment for Pattern Matcher * INCLUDE LKSQLONL /* Uncomment for Remote SQL and Pattern Matcher ENTRY MAINTASK /* // EXEC LNKEDT /* /&

Link editing the M204L phase

To run above the line (in 31-bit addressing space), you need to link the M204L program, which acts as an intermediary to load Model 204 phases above the line.

In the PARM clause of the EXEC statement, indicate the Model 204 load module that M204L will load above the line.

In the following example, ONLINE will be loaded above the line and then invoked:

// EXEC M204L,SIZE=AUTO,PARM='ONLINE'

The following sample LINKMLOD JCL is used to link M204L.

// JOB LINKMLOD * LINKMLOD links/catalogs the MODEL 204 M204L phase * * (-- For Rocket Support only: filename=LINKMLOD 7.7 2016/11/14 --) * // EXEC PROC=M204JCL DLBL for JCL sublibrary // LIBDEF PROC,SEARCH=M204LIB.V770 // EXEC PROC=M204V770 DLBL for V770 M204 library // LIBDEF PHASE,CATALOG=M204LIB.V770 // LIBDEF OBJ,SEARCH=M204LIB.V770 // OPTION CATAL ACTION ERRLMT(500) PHASE M204L,* REPLACE=YES INCLUDE M204L ENTRY M204L /* // EXEC LNKEDT /* /&

Linking the CRAM phases

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 CRAM (IODEV=11, 23, 29) for more information about CRAM.

To link the CRAM phases (CRAMSWT, CRAMZWT, IGCLM244, and SNAPCRAM), use the LINKCRAM job from the J7x0 (e.g., J750) sublibrary.

Linking the Model 204 utility phases

Most of the utility phases from Model 204 version 7.4 will continue to perform correctly when used with version 7.x.

However, you must use the 7.x version of the following utilities, which are sensitive to the Model 204 journal and checkpoint format. The link jobs are available in the J7x0 sublibrary.

Utility	Description	Link job
ALLOCATE	Initialize Model 204 database files	LINKALOC
AUDIT204	Extract from journal, with report stats and analysis	LINKAUDT
MERGEJ	Merge concurrent journal streams	LINKMRGJ
UTILC	Information from checkpoint stream	LINKUTLC
UTILJ	Information from journal stream; add EOF markers	LINKUTLJ

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. However, if 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.

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 phases from the older version are compatible with version 7.x 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:
- CRPSASM
- ENTPSASM
- OPLTASMC
- PPCIASM
- PRNTASMC
- PSFASM
- PSFSASM
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.	N/A	N/A
Full-screen interface	M204PSFS	M204	&TRN	88
Screen copy transaction	M204CRPS	U204	N/A	N/A
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 sublibrary members PCTNTRY and PPTNTRY have the Program Control Table (PCT) and the Program Processing Table (PPT) default values shown in the following sections. 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 sublibrary 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 sublibrary 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 interface installation section.

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 the CICS interface installation section.

Linking the $$BVP204 phase

Notes: Information about linking $$BVP204 applies only to z/VSE sites running under z/VM.
It is not necessary to link the $$BVP204 phase if it has been installed for a previous version of Model 204. The phases from the older version are compatible with version 7.x of Model 204.

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 J7x0 sublibrary (e.g., J750).

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 J7x0 sublibrary (e.g., J750).