Workflow Manager ChangeMan Attachment · Unzip the download file to a temporary folder. A folder named ‘host’ is created, which contains all ... - used in TOOL_REXX_Delete_Undelete_Package

Workflow Manager ChangeMan Attachment

Micro FocusThe Lawn22-30 Old Bath RoadNewbury, Berkshire RG14 1QNUKhttp://www.microfocus.com

Copyright © Micro Focus . All rights reserved.

MICRO FOCUS, the Micro Focus logo and are trademarks or registered trademarks of MicroFocus IP Development Limited or its subsidiaries or affiliated companies in the UnitedStates, United Kingdom and other countries.

All other marks are the property of their respective owners.

2014-10-15

ii

Contents

Introduction ........................................................................................................ 4Workflow Manager ChangeMan Attachment ......................................................................4Software requirements ........................................................................................................ 4

Installation .......................................................................................................... 5General considerations ...................................................................................................... 5Basic installation procedure ................................................................................................ 5

Download and unzip the software ............................................................................ 5Upload the software to the mainframe .................................................................... 5Receive the software ................................................................................................6

The ChangeMan Attachment .............................................................................7Overview of REXX procedures ........................................................................................... 7

Server and REXX customization .....................................................................15Add the ChangeMan workflow model to the Master Configuration file ............................ 15Add the EXEC dataset to the z/Server User Task .............................................................15Optional: Add the EXEC datasets to ISPF.conf ................................................................16Dataset security ................................................................................................................ 16Customizing REXX procedures .........................................................................................16

General customization ............................................................................................16TAUCMBLI - Baseline component list ....................................................................17TAUCMCLI - Package component list ................................................................... 17TAUCMGPL - Library list for packages ..................................................................18TAUCMPDS - Promotion component list ............................................................... 18TAUCMRSC - Remote syntax check ..................................................................... 18TAUCMSSV - Staging version component list .......................................................18TAUCMSS2 - Staging version component list for compare ................................... 18TAUCMSYL - Determine SYSLIB concatenation ...................................................18TAUCMXA1 - Allocation exit .................................................................................. 19TAUCMXA2 - Dynamic allocation exit ....................................................................19

Customizing the ChangeMan model ............................................................. 20Workflow Modeler job view ................................................................................................20ChangeMan ERO option ................................................................................................... 20

TAUCMGRC - Get root containers ........................................................................ 20Model - filter types ................................................................................................. 20

Common customizations ...................................................................................................21Conditions .............................................................................................................. 21Component types ................................................................................................... 21User options ........................................................................................................... 22Property cluster ...................................................................................................... 22Build dialog .............................................................................................................22SYSLIB concatentation .......................................................................................... 23

Contents | 3

IntroductionThe Workflow Manager ChangeMan Attachment consists of mainframe components that have to beinstalled in a z/OS environment.

This document is intended for system programmers and/or ChangeMan administrators installing andconfiguring the Workflow Manager ChangeMan Attachment on their z/OS host system.

Herein, this document refers to the Workflow Manager ChangeMan Attachment components asChangeMan components.

Workflow Manager ChangeMan AttachmentSerena ChangeMan ZMF (ChangeMan) supports the development of mainframe applications under ISPF.

With the Workflow Manager ChangeMan Attachment, you can:

• Provide the ChangeMan development process in an Eclipse-based development environment.• Customize the ChangeMan development process to suit your needs.• Model and customize the Eclipse-based ChangeMan user interface without any programming effort.• Seamlessly integrate existing home-grown and third party tools.

Software requirementsTo use the ChangeMan Attachment, the following software must be installed and configured correctly:

• Enterprise Developer version 2.2 Update 1 or later• Serena ChangeMan ZMF

4 | Introduction

Installation

General considerationsYou should decide on a dataset prefix that matches the naming conventions in your company. Thisdocument uses the prefix HLQ.CMG in all further specifications.

Basic installation procedure

Download and unzip the softwareDownload the ChangeMan Attachment from the download link you will receive from Micro Focus.

Unzip the download file to a temporary folder. A folder named ‘host’ is created, which contains allmainframe installation components in binary XMIT format.

There are no client components to install.

Upload the software to the mainframeThe unzipped ChangeMan Attachment contains two XMIT files. Upload both files from the ‘host’ folder, inbinary format, to sequential datasets with a record length of 80 and a block size of 3120, using thefollowing procedure.

Firstly, on z/OS, allocate the datasets to use as the upload target files. To do this, create a dataset with thesame characteristics as the sample job below (or by submitting the job below). If you choose to submit thefollowing job, note the following:

• hlq is the high level qualifier you choose to use for this dataset.• Before submitting, add a job card and modify the parameters to meet your site's requirements.• Optionally, add a valid VOLSER and/or change the UNIT parameter.

//ALLOC1 EXEC PGM=IEFBR14 //* //FTPALLOC DD DSN=hlq.CMG.EXEC.XMIT, // DISP=NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // BLKSIZE=3120, //* VOL=SER=vvvvvv, // UNIT=SYSALLDA, // SPACE=(TRK,(45,15))

To upload the files, you can use FTP from a command prompt. In the sample dialog shown below,commands or other information entered by a user are displayed in bold, and the values in the followingtable are assumed:

User input Description

mvsaddr TCP/IP address or hostname of the z/OS system

Installation | 5

User input Description

tsouid Your TSO user ID

tsopw Your TSO password

hlq High-level qualifier used for the dataset you allocated inthe job above

C:\>ftp mvsaddr Connected to mvsaddr. 220-FTPD1 IBM FTP CS V1R10 at custom.com, 12:03:32 on 2011-08-02. 220 Connection will close if idle for more than 5 minutes. User (mvsaddr:(none)): tsouid 331 Send password please. Password: tsopw 230 tsouid is logged on. Working directory is "tsouid.". ftp> cd .. 250 " " is the working directory name prefix. ftp> cd hlq 250 "hlq." is the working directory name prefix. ftp> binary 200 Representation type is Image ftp> put d:\host\hlq.CMG.EXEC.XMIT 200 Port request OK. 125 Storing data set hlq.CMG.EXEC.XMIT 250 Transfer completed successfully.

Executing this procedure, transfers the following files to your mainframe system:

• HLQ.CMG.EXEC.XMIT• HLQ.CMG.XML.XMIT

Receive the softwareUse the TSO RECEIVE command to create the partitioned datasets from the sequential XMIT files.HLQ.CMG is the assumed installation prefix.

Enter TSO or Workstation commands below:===> receive indataset('hlq.CMG.EXEC.XMIT')

When prompted, enter:

INMR906A Enter restore parameters or 'DELETE' or 'END' +restore dataset('hlq.CMG.EXEC’)

The result is a partitioned dataset containing REXX procedures.

Repeat the RECEIVE process for the XML dataset.

6 | Installation

The ChangeMan Attachment

Overview of REXX proceduresAll REXX procedures within the ChangeMan Attachment are listed below.

The following table contains a short description of each procedure, where it is used in the model, and theChangeMan XML services used.

REXX Name Description

TAUCMAPP Approve a package

- used in TOOL_REXX_ApprovePackage

- uses PACKAGE.SERVICE.APPROVE

TAUCMAUD Audit a package

- used in TOOL_REXX_AuditPackage

- uses PACKAGE.SERVICE.AUDIT

TAUCMAUL Reset Audit Lock flag

- used in TOOL_REXX_ResetAuditLock

- uses PACKAGE.GEN_PARMS.UPDATE

TAUCMBAK Backout a package

- used in TOOL_REXX_BackoutPackage

- uses PACKAGE.SERVICE.BACKOUT

TAUCMBLC Retrieve a ChangeMan baseline component list

- used in TOOL_REXX_ListBaselineComponents

- uses DSS.SERVICE.LIST

TAUCMBLD Build a ChangeMan component in stage library

- used in TOOL_REXX_BuildComponent

- uses CMPONENT.APL_DPRC.CHECK

- uses CMPONENT.SERVICE.BUILD

TAUCMBLI Retrieve a ChangeMan baseline component list

- used in TOOL_REXX_GetBaselineComponents


TAUCMBL2 Build a ChangeMan component in stage library usingoptions from history (no option dialog popup)

- used in TOOL_REXX_BuildComponentSimple


- uses CMPONENT.SERVICE.BUILD

TAUCMBRL Retrieve a compressed list from a stage library

- used inTOOL_REXX_GetComponentPhysicalList_Browse

The ChangeMan Attachment | 7


- uses CMAN utility SERCOPY to retrieve a component

TAUCMBR2 Retrieve an SSV version of a component for compare

- used in TOOL_REXX_GetSSV_Browse

- uses BASELIB.SERVICE.LIST

- uses PACKAGE.GEN_PRMS.LIST

- uses CMPONENT.SSV_VER.RETRIEVE

TAUCMBRS Retrieve an SSV version of a component

- used in TOOL_REXX_GetSSV_Browse



- uses CMPONENT.SSV_VER.RETRIEVE

TAUCMBRW Retrieve a component from a library (stage or baseline)

- used in GetComponentPhysicalMember_Browse

- uses CMPONENT.BROWSE.SERVICE

TAUCMCIN Check in ChangeMan components in a stage library fromext. dataset

- used inTOOL_REXX_CheckInFromPersLib

- used inTOOL_REXX_CheckInFromPersLib_MultipleComponents

- usesCMPONENT.SERVICE.CHECKIN

TAUCMCLI Retrieve a ChangeMan package component list

- used in TOOL_REXX_GetPackageComponents

- uses CMPONENT.PKG_COMP.LIST

- uses CMPONENT.PKG_LOD.LIST

TAUCMCL2 Retrieve a ChangeMan staged component list


TAUCMCL3 Retrieve a ChangeMan package load dependencies list


TAUCMCL4 Retrieve a ChangeMan package load dependencies list

- used in TOOL_REXX_GetSourceLoad


TAUCMCOU Check out a ChangeMan component

- used in TOOL_REXX_CheckOutFromBaseline

- used in TOOL_REXX_CheckOutFromBaselineBAS

- uses CMPONENT.SERVICE.CHECKOUT

TAUCMCPA Create a ChangeMan package

- used in TOOL_REXX_CreatePackage

- uses PACKAGE.SERVICE.CREATE

8 | The ChangeMan Attachment


TAUCMCPH Retrieve a Component history

- used in TOOL_REXX_GetComponentHistory

- uses CMPONENT.HISTORY.LIST

TAUCMCPY Copy a component

- used in TOOL_REXX_CopyComponent

- uses CMPONENT.SERVICE.BROWSE

TAUCMDCO Delete a ChangeMan component in stage library

- used in TOOL_REXX_DeleteComponent

- uses CMPONENT.PKG_COMP.DELETE

TAUCMDPA Memo (Un-)Delete a ChangeMan package

- used in TOOL_REXX_Delete_Undelete_Package

- uses PACKAGE.SERVICE.DELETE

TAUCMFRZ Freeze a ChangeMan package

- used in TOOL_REXX_FreezePackage

- uses PACKAGE.SERVICE.FREEZE

TAUCMGAP Get Application list for Model

- used in TOOL_REXX_GetApplications

- uses PARMS.APL.LIST

TAUCMGBL Get baseline library for a ChangeMan application

- used in TOOL_REXX_GetLibraryTypes


TAUCMGB2 Get baseline library for a ChangeMan application


TAUCMGCO Retrieve a component from a stage library and lock it

- used inTOOL_REXX_GetComponentPhysicalMember


TAUCMGDL Get datasets matching the generic PDS search criterion

TAUCMGLA Get language names for a ChangeMan application

- used in TOOL_REXX_ListLanguages

- uses PROCS.APL.LIST

TAUCMGLI Get language names for a ChangeMan application

- used in TOOL_REXX_ListLanguages


TAUCMGML Get member list matching the PDS member searchcriterion

TAUCMGPL Get library for a ChangeMan application package

- used in TOOL_REXX_GetPackageLibraryTypes


TAUCMGPR Get build procedure and language names for aChangeMan application



- used inTOOL_REXX_RetrieveBuildProcedureAndLanguage


TAUCMGP2 Get valid build procedures for a language name

- used in TOOL_REXX_LockComponent


TAUCMGRC Get root containers for model ChangeMan application

TAUCMHIS Retrieve a specific component history

- used in TOOL_REXX_GetComponentInfo

- uses CMPONENT.HISTORY.LIST

- uses CMPONENT.HISTORY.LISTBASE

TAUCMIMP Retrieve a ChangeMan Impact Analysis list

- used in TOOL_REXX_GetIAComponents

- used in TOOL_REXX_GetIADown

- used in TOOL_REXX_GetIAUp

- uses IMPACT.TABLE.LIST

TAUCMLCK Lock a ChangeMan component in stage library

- used in TOOL_REXX_LockComponent

- uses CMPONENT.SERVICE.LOCK

TAUCMLST Retrieve a listing from stage library

- used in TOOL_REXX_ListReleases


TAUCMNEW Create a new dummy component and lock it

- used in TOOL_REXX_NewComponent

- uses CMPONENT.SERVICE.CHECKIN

TAUCMNTY Browse global notification file

- used in TOOL_REXX_GetNotyFile

- uses NOTYFILE.SERVICE.DOWNLOAD

TAUCMPDS Retrieve a ChangeMan promoted component list

- used in TOOL_REXX_GetPromotionComponents


TAUCMPGD Get package description

- used in TOOL_REXX_GetPackageDescription

- uses PACKAGE.GEN_DESC.LIST

TAUCMPGI Get package implementation description

- used in TOOL_REXX_GetPackageInstruction

- uses PACKAGE.IMP_INST.LIST

TAUCMPGS Retrieve a ChangeMan production site list

- used in TOOL_REXX_GetProductionSites



- uses SITE.PKG.LIST

TAUCMPIS Insert package installation sites

- used in TOOL_Rexx_InsertPackageSites

- uses SITE.PKG.CREATE

TAUCMPKI Retrieve specific package info

- used in TOOL_REXX_GetPackageGeneralParms


TAUCMPLI Retrieve a ChangeMan package list for model

- used in TOOL_REXX_GetPackages

- uses PACKAGE.GENERAL.SEARCH

TAUCMPL2 Retrieve a ChangeMan package list for model

- used in TOOL_REXX_RetrievePackageIDs


TAUCMPL3 Retrieve a ChangeMan package list for mode

- used in TOOL_REXX_RetrievePackageNames


TAUCMPPD Delete a participating package

- used in TOOL_REXX_DeleteParticipatingPackage

- uses PACKAGE.PRT_PKGS.MDELETE

TAUCMPPG Get participating package list

- used in TOOL_REXX_GetParticipatingPackages

- uses PACKAGE.PRT_PKGS.LIST

TAUCMPPI Insert participating package

- used in TOOL_Rexx_InsertParticipatingPackage

- uses PACKAGE.PRT_PKGS.MCREATE

TAUCMPRH Retrieve a component/package promotion history

- used in TOOL_REXX_GetPromotionHistory

- uses CMPONENT.PRM_HIST.LIST

TAUCMPRL Get promotion libraries for a ChangeMan application

- used in TOOL_REXX_GetPromoLibraryTypes

- uses PROMLIB.LIBRARY.LIST

TAUCMPRM Promote a package or package components

- used in TOOL_REXX_DemoteComponentOrPackage

- uses PACKAGE.CHECK.PROMOTE

- uses PACKAGE.SERVICE.DEMOTE

- uses PACKAGE.SERVICE.PROMOTE

TAUCMPRN Retrieve a promotion name list

- used in TOOL_REXX_GetPromotionLevel

- uses PROMLIB.SITE.LIST

TAUCMPRS Retrieve a promotion site list



- used in TOOL_REXX_GetPromotionSites


TAUCMPSD Delete package installation sites

- used in TOOL_Rexx_DeletePackageSites

- uses SITE.PKG.DELETE

TAUCMPUD Update package description

- used in TOOL_Rexx_UpdatePackageDescription

- uses PACKAGE.GEN_DESC.UPDATE

TAUCMPUG Update specific package info

- used in TOOL_Rexx_UpdatePackageGeneralParms

- uses PACKAGE.GEN_PRMS.UPDATE

TAUCMPUI Update package implementation description

- used in TOOL_Rexx_UpdatePackageInstruction

- uses PACKAGE.IMP_INST.UPDATE

TAUCMPUS Update package installation sites

- used in TOOL_Rexx_UpdatePackageSites

- uses SITE.PKG.UPDATE

TAUCMP2D Get member to be demoted

- used in TOOL_REXX_RetrieveDemotionComponents

- uses CMPONENT.PRM_HIST.LIST

TAUCMP2M Get member that could be promoted

- used in TOOL_REXX_RetrievePromotionComponents

- uses PACKAGE.PRM_CMP.LIST

TAUCMP2N Get promotion names for a ChangeMan application

- used in TOOL_REXX_RetrievePromotionLevelNames


TAUCMP2S Get promotion site names for a ChangeMan application

- used in TOOL_REXX_RetrievePromotionSites


TAUCMP3S Get production site names for a ChangeMan application

- used in TOOL_REXX_RetrieveProductionSites

- uses PRODLIB.SERVICE.LIST

TAUCMREC Recompile a ChangeMan component in stage library

- used in TOOL_REXX_RecompileComponent


- uses CMPONENT.SERVICE.RECOMP

TAUCMREL Relink a ChangeMan component in stage library

- used in TOOL_REXX_RelinkComponent


- uses CMPONENT.SERVICE.RELINK



TAUCMREV Revert a package

- used in TOOL_REXX_RevertPackage

- uses PACKAGE.SERVICE.REVERT

TAUCMRLI Retrieve a ChangeMan release list for model

- used in TOOL_REXX_GetReleases

- uses RLSMRLSE.SERVICE.SEARCH

TAUCMRSC Remote syntax check for a ChangeMan component

- used in TOOL_REXX_RemoteSyntaxCheck


TAUCMSCD Delete a scratch entry

- used in TOOL_REXX_DeleteScratchComponent

- uses PACKAGE.PKG_UTIL.DELETE

TAUCMSCI Insert a scratch entry

- used in TOOL_REXX_InsertScratchComponent

- uses PACKAGE.PKG_UTIL.CREATE

TAUCMSCL Retrieve a ChangeMan scratch component list

- used in TOOL_REXX_GetScratchComponents

- uses PACKAGE.PKG_UTIL.LIST

TAUCMSS2 Retrieve an SSV version list for compare dialog

- used in TOOL_REXX_GetSSVComponents

- uses CMPONENT.SSV_VER.LIST

TAUCMSSV Retrieve an SSV version list

- used in TOOL_REXX_GetSSVComponents


- uses PACKAGE.PRT_PKGS.LIST


- uses PROMLIB.LIBRARY.LIST

TAUCMSYL Building the SYSLIB concatenation for edit

- used in TOOL_REXX_GetSYSLIB

- uses CMPONENT.SSV_VER.LIST

TAUCMUNL Unlock a ChangeMan component in stage library

- used in TOOL_REXX_UnlockComponent

- uses CMPONENT.SERVICE.UNLOCK

TAUCMVAP Get application list for model

- used in TOOL_REXX_ListApplications

- uses PARMS.APL.LIST

TAUCMVAR Retrieve ChangeMan area names for a release

- used in TOOL_REXX_ListReleaseAreas

- uses RLSMAREA.SERVICE.LIST

TAUCMVRE Get reason codes for ChangeMan unplanned changes



- used in TOOL_REXX_ListReasonCodes

- uses REASONS.SERVICE.LIST

TAUCMVRL Retrieve ChangeMan release names for model

- used in TOOL_REXX_ListReleases

- uses RLSMRLSE.SERVICE.SEARCH

TAUCMVSI Get site names for a ChangeMan application

- used in TOOL_REXX_RetrieveSiteNames

- uses SITE.APL.LIST

TAUCMXA1 Create a temporary dataset to be used by models forChangeMan

All temporary datasets used by a model for ChangeManare created with this exitprocedure.

TAUCMXA2 Exit for dynamic allocations of the ZMF environment

Verify and customize the ZMF system dataset names.


Server and REXX customizationBefore using the ChangeMan Attachment for the first time, you must perform some initial customization.

Add the ChangeMan workflow model to the MasterConfiguration file

Edit the Master Configuration file and insert the following reference to the ChangeMan workflow model:

* * APPLICATION for CHANGEMAN V2 * User: * application name Appl: ChangeMan Application Subsys P <- Label in the Model view * location of the application configuration file Conf: mvs:'hlq.CMG.XML(CMED222)' <- Your ChangeMan model * application version number Version: 2.2.2 * process information INFO: * properties for this application Property: PROP_Subsystem=P <- Your ChangeMan subsystem * end of application definition. Do not delete this line EndAppl: EndUser:

You must customize the Conf: entry to reference the installed XML dataset. If the ChangeMan attachmentis used within Rational Developer for System z with the IBM RSE daemon as server, refer to the CMRD221model member.

Add the EXEC dataset to the z/Server User TaskWithin the z/Server User Task, you must concatenate the received dataset HLQ.CMG.EXEC to theSYSEXEC allocation.

We recommend that you customize the JCL of the z/Server User Task to perform this allocation (seeScheduler and user server configuration in the z/Server Installation Guide for details on how to set up aUser Server):

…… //IVPISPF EXEC PGM=IKJEFT1B,PARM='%IVPINIT1 &PORT ', // DYNAMNBR=200,REGION=0M //STEPLIB DD DSN=&TAURHLQ..LOADLIB,DISP=SHR //SYSEXEC DD DSN=&TAURHLQ..EXEC,DISP=SHR // DD DSN=HLQ.CMG.EXEC,DISP=SHR // DD DSN=&TAURHLQ..REXX,DISP=SHR //ISPPLIB DD DSN=&ISPFHLQ..SISPPENU,DISP=SHR // DD DSN=ISF.SISFPLIB,DISP=SHR //ISPSLIB DD DSN=&ISPFHLQ..SISPSENU,DISP=SHR // DD DSN=ISF.SISFSLIB,DISP=SHR //ISPMLIB DD DSN=&ISPFHLQ..SISPMENU,DISP=SHR // DD DSN=ISF.SISFMLIB,DISP=SHR ……

Server and REXX customization | 15

Alternatively, you can dynamically allocate by customizing the exit procedure TAUTOXA1.

Optional: Add the EXEC datasets to ISPF.confIf the ChangeMan Attachment is used within Rational Developer for System z with the IBM RSE daemonas server, you must add the installation EXEC datasets to the configuration file ISPF.conf in the USSconfiguration path of the RSE daemon.

Dataset securityThe ChangeMan Attachment uses several datasets to communicate between ChangeMan and the clientsoftware. All datasets defined in the certain exits (especially TAUCMXA1) should adhere to the followingsecurity rules.

As all actions/jobs are running under the authority of the developer’s TSO userid, the user must haveALTER rights to these datasets. Also, all actions in ChangeMan, started via XML service calls, are handledunder a specific ChangeMan userid, and need the same rights to access datasets used within an XMLservice on the ChangeMan server.

Therefore, we recommend that you use your TSO userid as the first-level qualifier/dataset schema forChangeMan temporary work datasets. This ensures a regular cleanup process across all relevant datasets.

Customizing REXX proceduresAs ChangeMan is a highly flexible system, you must change some routines to reflect your implementationof ChangeMan.

Check the REXX routines described in the following topics.

General customizationRegarding the ChangeMan Attachment, the following table listing the procedure adaptations are of specialimportance.

REXX procedure Description

TAUZCAPP If the ChangeMan Attachment is used within EnterpriseDeveloper with z/Server as server, adjust the reference tothe location of the Master Configuration file, as required.

Default: HLQ.ZSERVER.MASTER

TAULAPPL If the ChangeMan Attachment is used within RationalDeveloper for System z with the IBM RSE daemon asserver, adjust the reference to the location of the masterconfiguration file, as required.

Default: HLQ.ZSERVER.MASTER

TAUTOXA1 Tool interface exit: use this exit for dynamic allocations orto set ISPF environment variables necessary to run yourspecific ChangeMan application.

Use this exit to allocate the ChangeMan librariesnecessary to run ChangeMan services in the user’s ISPFenvironment (z/Server User Task). There is a sampleallocation procedure in TAUCMXA2.

16 | Server and REXX customization

REXX procedure Description

If the ChangeMan Attachment runs in simulation mode(without a valid ChangeMan subsystem), the ISPF sharedpool variable TAUQUAL has to be defined, pointing to thefirst qualifier of the simulation test datasets:

tauqual = 'HLQTEST'

Call ISPF '0 VPUT (TAUQUAL) SHARED'

TAUTOXA2 General allocation exit: use this exit to allocate temporaryfiles, for example, for Remote Syntax Check.

TAUTOXCA Exit for Assembler Remote Syntax Check: customize theload libraries, as required.

TAUTOXCC Exit for COBOL Remote Syntax Check: customize loadlibraries, as required.

TAUTOXCP Exit for PLI Remote Syntax Check: customize loadlibraries, as required.

Skeleton name Description

TAUTOXIS Skeleton for batch support: allocates an ISPF batchenvironment

This skeleton is not used within the standard ChangeManAttachment because batch jobs are normally submittedfrom the ChangeMan server.

TAUTOXJC Skeleton for batch support: defines a default job card.

This skeleton is not used within the standard ChangeManAttachment because batch jobs are normally submittedfrom the ChangeMan server.

Regardless of the ChangeMan Attachment, you must perform some customization after the installation ofthe z/Server. Refer to ISPF exits and Master configuration in the Workflow Manager Configuration Guide.

TAUCMBLI - Baseline component listAdapt the named library types in the exit to link them to the file suffixes you use.

Library type SRC is linked to the suffix COB by default.

Adapt the list of dependent library types to your needs. Defaults are LOD and LST.

Note: This procedure returns an output parameter called ‘Property Set name’; although not currentlysupported, you must still return a non-blank value (e.g. NONE).

TAUCMCLI - Package component listAdapt the named library types in the exit to link them to the file suffixes you use.





TAUCMGPL - Library list for packagesAdapt the stems of source types, listing types (compressed listings in terms of ChangeMan) and load typesto suit your needs.

By default, SRC is the only source type, LST is the only listing type, and LOD is the only load type.

TAUCMPDS - Promotion component listAdapt the named library types in the exit to link them to the file suffixes you use.




TAUCMRSC - Remote syntax checkThis is a sample REXX procedure that compiles a source outside of ChangeMan and returns the Compilermessages to the client. The REXX procedure supports COBOL, PLI and Assembler. Use this procedure tosupport your standard compile options.

TAUCMSSV - Staging version component listAdapt the named library types in the exit to link them to the file suffixes you use.




TAUCMSS2 - Staging version component list forcompareAdapt the named library types in the exit to link them to the file suffixes you use.




TAUCMSYL - Determine SYSLIB concatenationAdapt the named library type in the exit to link them to your component types, which should be includedinto your SYSLIB concatenation. Default is CPY and CPG.

Adapt the logic to your specific SYSLIB needs The basis exit is just mirroring the ChangeMan vendor logicof SYSLIB concatenation, which is not necessarily yours. Please refer to your customized ChangeManSkeleton CMN$$SYL to find out what is needed here.

18 | Server and REXX customization

TAUCMXA1 - Allocation exitThis exit allocates several temporary datasets, which are required to communicate between the mainframeand the client. These datasets are normally allocated with template <userid>.TAUCM.** . If you havedifferent allocation rules (for example, naming conventions, SMS classes, etc…), define them here.

TAUCMXA2 - Dynamic allocation exitThis exit allocates several datasets, which are required to communicate between the user’s ISPFenvironment and ChangeMan. You must ensure that you allocate all required libraries of your ChangeMansubsystem (e.g. LOAD libraries, ChangeMan parmlib etc.).

Note that this is a sample REXX procedure only, which is not called automatically in the ChangeManAttachment. If you want to use dynamic allocation of the ChangeMan datasets, call this procedure in theREXX routine TAUTOXA1.


Customizing the ChangeMan modelOut of the box, the model is ready to run without any changes, but in most customer environments,ChangeMan has been heavily customized on the mainframe, especially ISPF panels, but also workflow andother parts.

As these changes are very individual, we cannot predict where and if there is any need for you to changethe model.

If you do customize the ChangeMan model, save the model member beforehand.

Workflow Modeler job viewIn general, the Workflow Manager supports its own job view for batch jobs submitted via model definitions,using the batch job interface. The ChangeMan Attachment does not use this feature, because all jobs (e.g.build, promote, audit, etc.) are submitted from the ChangeMan server, not directly from the attachment.The attachment just builds and executes XML service calls, and these XML service calls force ChangeManto asynchronously submit jobs. This common ChangeMan behavior cannot be changed. This means thatyou must use the JES Explorer to find the output of ChangeMan submitted jobs.

ChangeMan ERO optionBy default, the actions for ChangeMan ERO are enabled in the model. If you don't have the ERO optioninstalled and you don’t want these actions and views visible, perform the following:

TAUCMGRC - Get root containersTo disable the RELEASE entry in the tree view, perform the following changes in the REXX procedureTAUCMGRC:

Change the stem variable “outrec” from:

outrec. = ''

outrec.1 = 'Releases,RELEASESROOT'

outrec.2 = 'Applications,APPLICATIONS'

outrec.0 = 2

to:

outrec. = ''

outrec.1 = 'Applications,APPLICATIONS'

outrec.0 = 1

Model - filter typesTo disable the release filter, open the Model Editor and delete the filter type definition“FILTER_ReleaseFilter” from the defined filter types.

20 | Customizing the ChangeMan model

Common customizations

ConditionsMany actions are related to certain conditions that control the options in the context menus. To changethese, you can adapt them easily in your own model.

For example:

This condition restricts the Recompile context menu entry to just the component type SRC. You couldadapt this to your used component types for program sources.

This condition restricts the capability of browsing the LOD (load modules) and LST (compressed listings)baseline components, as they cannot be browsed in the regular way.

Component typesIn many places, the actions depend on certain library types. As these library types depend on your ownChangeMan customization and implementation, the model only delivers a default value set.

The defaults are:

ChangeMan Library types

SRC program source

LST compressed listing

LOD LOAD module

JCL JCL member

Client Suffixes

COB COBOL programs

JCL JCL member

Customizing the ChangeMan model | 21

Search the model for these library types and suffixes, and replace/change them as required.

User optionsIn ChangeMan, you have the ability to use many general user options, especially for componentparameters (for example, used at build time).

To tailor it for your own use, use ChangeMan to rename properties for such things as labels and panelswith more meaningful names.

For example, change the Label property of the Audit parameter from ‘lite’ to the more meaningful label‘Audit staging libraries only’.

Property clusterAs the ChangeMan model has a huge number of properties (as ChangeMan itself has a huge amount ofmetadata), these properties are clustered by use:

Property prefix Description

PROP_ General or common properties (e. g. PROP_Applicationfor the application)

PROP_PP_ For Package parameter (e. g.PROP_PP_auditReturnCode for the audit return code)

PROP_AP_ For Audit parameter (e. g. PROP_AP_FormatReport forthe Format Report flag)

PROP_CP_ For Component parameter (e. g.PROP_CP_targetComponent for the target component atbuild)

PROP_IA_ For impact analysis data (e. g. PROP_IA_relation for therelation type)

PROP_SSV_ For staging version data (e. g. PROP_SSV_timeStampfor the version timestamp)

PROP_PR_ For promotion/demotion related data (e.g.PROP_PR_promoter for the promoter)

Most property names relate to the ChangeMan XML tag names.

Build dialogThe most customized ISPF panel in ChangeMan is the build panel for components. To adapt this to yourneeds, you have to change the delivered build action, as required. This is actionACT_BuildPackageComponent, and the dialog for it is TOOL_INDIA_BuildComponent.

22 | Customizing the ChangeMan model

SYSLIB concatentationThis is a highly dynamic process, which is different at nearly every user site. See also changes toTAUCMSYL.

The SYSLIB will be determined each time the user starts to edit a component. The Tool for this isTOOL_REXX_GetSyslib:

Depending on the use of different eclipse-based IDEs, the PROP_SYSLIBDiver has to be changed to yourneeds.

Currently for Micro Focus products, it is “;” and for IBM products “ “ (blank).

Customizing the ChangeMan model | 23

Documents

Workflow Manager ChangeMan Attachment · Unzip the download file to a temporary folder. A folder named ‘host’ is created, which contains all ... - used in TOOL_REXX_Delete_Undelete_Package