Skip to content

Installation Requirements

This chapter describes requirements for installing a ChangeMan ZDD server in your mainframe environment.

System Requirements

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

Operating System

ChangeMan ZDD 8.1.3 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

You need the following system software to run ChangeMan ZDD in your mainframe environment:

  • One of the following external security systems:

    • IBM Security Server RACF®
    • CA ACF2™
    • CA Top Secret®

  • SAF (System Authorization Facility) to interface to your security system.

  • At least IBM TCP/IP V3R1 for MVS. For TCP/IP V3R2, you must be at PUT level 9706 or above.

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 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 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

The SERCOMC libraries unloaded from the download image or distribution CD require approximately 16 cylinders of 3390 disk space.

License for ChangeMan ZDD Server

Licenses are required to activate Micro Focus Serena products on authorized CPUs. Licenses are delivered to customers as XML-format documents attached to an email. If you do not have a license for ChangeMan ZDD, contact your account representative.

ChangeMan ZDD Product Compatibility

ChangeMan ZDD uses these enabling technologies delivered in SERCOMC libraries:

  • Sernet

  • SER10TY License Manager

  • Common Utilities

  • XML Services

If you are installing Sernet as a dedicated ChangeMan ZDD server, use the files unloaded from the ChangeMan ZDD download image or distribution CD to ensure that the mainframe server software is compatible with the ChangeMan ZDD client software installed on PCs.

If you intend to use an existing Sernet started task for a ChangeMan ZDD server, or if you intend to connect ChangeMan ZDD to ChangeMan ZMF, review the ChangeMan ZDD Readme for information about software release level compatibility.

You can avoid compatibility problems between ChangeMan ZDD and other products by using JOBLIB and STEPLIB instead of adding product load libraries or SERCOMC load libraries to the LINKLIST.

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 CA Panvalet PTF's 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 procedure.

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 option LIB to tell Sernet the new name.

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 Sernet.

Micro Focus Serena Products

Programs for Micro Focus Serena enabling technologies are delivered in the SERCOMC libraries with all Micro Focus Serena mainframe products. Use STEPLIB and JOBLIB with these 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 Micro Focus Customer Care 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 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 dataset created during a SERCOPY reallocate function, preventing SERCOPY from renaming the dataset 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 procedure:

//NPDSFAST DD DUMMY

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.

You must suppress StopX37/II in a ChangeMan ZDD server by coding the following DD statement in the Sernet started procedure:

//X37IGN DD DUMMY

Load Library APF Authorization

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

IPL

When you install Sernet, IPL your system if you need to accomplish the following:

  • APF authorize Sernet load libraries if you use a static APF list.

  • Permanently APF authorize Sernet 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 SER10TY License Manager gives you a choice of storing licenses for Micro Focus Serena 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 SER10TY 4.3 User’s Guide for information about applying licenses.

Back to top