Skip to content

Installation Requirements

This chapter describes requirements for installing ChangeMan® ZMF in your mainframe environment.

System Requirements

This section defines operating system and software requirements, memory requirements, and disk storage requirements.

Operating System

ChangeMan ZMF runs without modification on all IBM and plug-compatible mainframes running z/OS®. See the Readme for a link to current information about OEM software compatibility testing.

Software Requirements

Refer to the current platform matrix on the support website to determine what system software to run ChangeMan ZMF in your mainframe environment.

  • You will need one of the following external security systems:

    • IBM Security Server RACF®

    • CA ACF2®

    • CA Top Secret®

  • The MVS SAF (System Authorization Facility) is used to interface to your security system.

If you intend to use ChangeMan ZMF to distribute components to remote CPUs for testing or installation, you need one of the following data transport systems:

  • Bulk Data Transfer (BDT)

  • Connect:Direct® (formerly NDM)

  • NetMaster

  • Netview® FTP

  • XCOM 6.2

Memory Requirements

SERNET runs as a started task on each CPU that employs SERNET services. You may run multiple SERNET instances on a single processor to test SERNET or its applications, to run different products at different release levels of SERNET, or to achieve separation of control.

The recommended region size for a SERNET instance is zero megabytes (REGION=0M), which provides the absolute maximum memory above and below the line. SERNET does virtually all work in memory above the line, without spilling to DASD. To support hundreds System Requirements of concurrent users, a large amount of virtual memory is used. The symptom of insufficient memory is abend S878.

Note

If there are system exits that disallow REGION=0M, then set the SERNET region size to at least 48 megabytes (REGION=48M). Consider removing exits that limit memory acquisition, such as IEALIMIT, which limits an address space from acquiring more than 32 megabytes above the line, or increase the maximum allowed to at least 48 megabytes

Each SERNET instance obtains 64 bytes of CSA (Common System Area subpool 245) to hold a SubSystem Communications Vector Table (SSCVT) control block. One SSCVT is required for each SERNET started task on a processor. To avoid fragmenting memory, this short piece of memory is never released (FREEMAIN). When SERNET is shut down and restarted, it reuses the same anchor block until the next IPL clears it out.

Almost all SERNET mainframe programs are written in reentrant assembly language. Most load modules have been given the RENT attribute at link-edit time as well as AMODE=31. Some load modules reside below the line using RMODE=24, but most reside above the line using RMODE=ANY. All memory that can be managed above the line is acquired there for memory constraint relief.

DASD Space Requirements

Eight VSAM KSDS files and two VSAM LDS files are created during the installation process. The recommended minimum total primary allocation is 94 cylinders of 3390 disk.

ISPF Profile Library Allocation

When you use the ISPF interface to ChangeMan ZMF, it creates up to three members in your ISPF profile library (ISPPROF).

**Name **Function **Description
xxxxPROF ZMF ISPF profile Used to store ZMF user variables from the ISPF profile variable pool between ZMF sessions. Panel variables like job card images and package create fields are saved to the profile at the end of a ZMF session (VPUT) and retrieved at the start of a new session (VGET) so that panel fields can be pre-filled.
xxxxEDIT ISPF edit Transparent to ZMF
xxxxEDRT ISPF edit recovery Transparent to ZMF

If you license the ChangeMan ZMF M+R Option, it creates an additional ISPF profile library member.

**Name **Function **Description
CDFPROF M+R ISPF profile Used to store M+R user variables from the ISPF profile variable pool between ZMF sessions.

The profile name prefix xxxx is set by the NEWAPPL parameter in the ZMF logon CLIST. If prefixes are made unique for each ZMF instance, your profile library will contain up to four members for the first ZMF instance that you use, and up to three more members for each additional ZMF instance you use.

ISPF profile libraries for users of ChangeMan ZMF must be allocated with sufficient primary, secondary, and directory space to allow ZMF to create and update the profile members discussed here. This applies to all ISPF applications that run with ISPF NEWAPPL(xxxx).

REXX Runtime Environment

XMLSERV is an XML page prototype tool delivered with ChangeMan ZMF that you can use to experiment with XML Services.

A REXX runtime environment is required to execute this program. If you have not installed a REXX runtime environment in your z/OS system, and you attempt to execute program XMLSERV, the program will fail with this message:

IRX0159E The run time processor EAGRTPRC is not available

See the IBM TSO/E Customization manual for information about setting up a REXX runtime environment.

ChangeMan ZMF Product Compatibility

The Software Compatibility topic in the ChangeMan ZMF Readme tells you how to identify what versions of OEM software products are compatible with the base ChangeMan ZMF product.

You can avoid many compatibility problems between ChangeMan ZMF and other products by using JOBLIB and STEPLIB instead of adding ChangeMan load libraries to the LINKLIST.

If you want to run ChangeMan ZMF with other products under one SERNET instance, examine the compatibility chart to see whether there is a potential conflict. Contact Micro Focus Customer Care if you have questions about how to resolve compatibility issues.

CA Panvalet® and CA Librarian® Compatibility

SERNET includes program SERIFACE as an interface to CA Panvalet and CA Librarian. The source for SERIFACE is delivered in the SERCOMC ASMSRC library, but you do not need to customize SERIFACE to use CA Panvalet or CA Librarian with ChangeMan ZMF.

CA Panvalet must be at Release 12 or 14. Missing PTFs can cause problems. If the PAM module has been link-edited with the RENT option, SERIFACE abends with an S0C4. PAM is not reentrant and must be link-edited with the NORENT parameter.

The CA Panvalet or CA Librarian product library must be available for calls from SERNET. If the product library is not in the LINKLIST, then add the library to the STEPLIB in the SERNET started task JCL, the STEPLIB in ChangeMan ZMF cataloged procedures, and your custom JOBLIB skeleton, CMN$$DSN.

At startup, SERNET tries to load modules LIBR for CA Librarian and PAN#1 for CA

Panvalet. If the load is successful, the interface to these products is enabled. If you have renamed program LIBR, use SERNET keyword parameter LIB to tell SERNET the new name. See LIB.

Software Conflicts

If you use any of the software products described in this section, read the information provided to determine if you must take action to prevent conflicts with ChangeMan ZMF or SERNET.

Library Concatenations

SER* modules are delivered with all Serena mainframe products. Use STEPLIB and JOBLIB with Serena mainframe products instead of LINKLIST concatenations to avoid problems with software release compatibility.

Abend-AID® (from Compuware Corporation)

If an abend occurs, Abend-AID generates a formatted dump. However, some SERNET problems cannot be solved without a full dump, so Support accepts only full dumps when helping you with abends.

If your installation uses Abend-AID and you always want full dumps from SERNET, code the following DD statement in the SERNET started task procedure and any JCL that executes SERNET programs.

//ABNLIGNR DD DUMMY

PDSFAST (from Software Engineering of America)

At one time, PDSFAST would enqueue the temporary data set created during a SERCOPY reallocate function, preventing SERCOPY from renaming the data set and finishing the recovery. This problem has been fixed by the vendor.

PDSFAST and SERCOPY contain compression facilities that interfere with each other. Since you cannot suppress the SERCOPY compression facility when SERCOPY is executed by the SERNET started task (parameters are generated internally), you must suppress the compression facility in PDSFAST for copy tasks initiated by SERNET.

Suppress PDSFAST compression for ChangeMan ZMF by adding this DD statement to the SERNET started task procedure:

//NPDSFAST DD DUMMY

...

CA PDSMAN® (from Computer Associates)

If ChangeMan ZMF manages a very active production load library as a baseline, and CA PDSMAN option ISPF STATS is set to NO, you may receive the following messages from Audit:

+IKJ56225I DATA SET PRODT.CMNT.BASE.ACTP.LOD ALREADY IN USE, TRY LATER+
+IKJ56225I DATA SET IS ALLOCATED TO ANOTHER JOB OR USER

These messages may indicate that Audit is unable to get a shared enqueue on a baseline library because the CA PDSMAN puts a very brief exclusive enqueue on a library to update directory statistics when a member is accessed. If there is no evidence that another job has an exclusive enqueue on the library, the problem may be resolved by setting CA PDSMAN option ISPF STATS to YES. You may also define a separate library to use as a baseline and use the active library as a ChangeMan ZMF production library.

MAINVIEW® SRM StopX37/II™ (from BMC Software)

StopX37/II intercepts DASD space abends and reallocates data sets. SERCOPY executed from the SERNET started task compresses and reallocates PDS libraries. If both StopX37/ II and SERCOPY attempt to fix a space problem, the results are unpredictable.

Suppress StopX37/II for ChangeMan ZMF by coding the following DD statement in the SERNET started task procedure:

//X37IGN DD DUMMY

VSAM Performance Tools

There are several software products that enhance VSAM performance. These products may improve VSAM performance under SERNET and ChangeMan ZMF. However, there may be conditions where SERNET is unable to coexist with these tools.

If program CMNVINIT in install job INITIAL2 hangs in a DETECTED WAIT (DW) state, and there are no messages indicating the cause of the problem, try suppressing any VSAM performance tools that you may have running. These DD statements can be used in step JCL to suppress two popular VSAM performance products:

SST-HiperLoad Plus for VSAM (Performance Essential from Softworks)

//PSPOFF DD DUMMY

HIPER-CACHE™ (from BMC Software)

//VVHC$OFF DD DUMMY

If these DD statements solve the problem, code them in the following places:

  • In the SERNET started task procedure.

  • In the default file tailoring started procedure CMNxADSP and in any clones that you create and specify in ChangeMan ZMF administration.

Load Library APF Authorization

Some SERNET and ChangeMan ZMF load modules have an Authorization Code of 1 (AC=1). Load libraries containing these modules must be APF authorized. APF authorize all libraries in a JOBLIB or STEPLIB concatenation when one library in the concatenation is APF authorized.

IPL

When you install SERNET and ChangeMan ZMF, IPL your system if you need to accomplish the following:

  • APF authorize ChangeMan ZMF load libraries if you only use a static APF list.

  • Permanently APF authorize ChangeMan ZMF load libraries if you use a dynamic APF list.

  • Pick up new entries in your security system, such as the following in IBM Security Server RACF:

    • Static Class Descriptor Table

    • Started Procedure Table.

Note

The License Manager gives you a choice of storing licenses for mainframe products in CSA or in a PDS. If you choose to store licenses in CSA, reload the licenses to CSA when you IPL. See the latest SER10TY User Guide for information about applying licenses.