Configuring Configuring Rational Developer for System Z Tools Configuring Property Groups

This paper is based on a session presented in May 2009 at the Enterprise Modernisation conference Bingen, Germany

A new feature added with RDz 7.5 is System Property Groups and Default Values. These are standard settings (stored centrally) available to all RDz users. Should the administrator change either of these standard settings, RDz users will be prompted when they next logon (it does not suffice to disconnect/reconnect).

The System Property Groups and Default Values are contained in the propertygroups.xml and defaultvalues.xml files, respectively.

The propertiescfg.properties file (default location /usr/lpp/rdz) contains the location (directory) of the propertygroups.xml and defaultvalues.xml files.

Example propertiescfg.properties file

# host based property groups - root configuration file

RDZ-VERSION=7.5.0.0

ENABLED=TRUE

DEFAULT-VALUES=/u/t02161a/rdz/properties

PROPERTY-GROUP=/u/t02161a/rdz/properties

TheDEFAULT-VALUES and the PROPERTY-GROUP entries specify the location of the default property values and a system property group file, respectively.

Predefined (hard-coded) values are used for any undefined DEFAULT-VALUES entries.

Tip

The exported Property Group XML file can be used as basis for the System Property Groups and Default Values.

The created propertygroups.xml file must be edited to include one or more <PROPERTY-GROUP> blocks, one block for each property group, within the <PROPERTY-GROUPS> block.

The created defaultvalues.xml file must be edited to include the <DEFAULT-VALUES> block instead of the <PROPERTY-GROUP> block. This <DEFAULT-VALUES> block contains one or more<CATEGORY-INSTANCE> blocks for each defined default setting. (COBOL_SETTINGS,JCL_OPTIONS, etc.).

Note: Any <VALUE xsi:nil="true"/> entries in the defaultvalues.xml file, for example as ADDED_STEP_ADDITIONAL_JCL, must be replaced by an empty value element, <VALUE/>.

Conversion of exported property group -> defaultvalues.xml

<?xml version="1.0" encoding="UTF-8"?>

<PROPERTY-GROUPS> ──────────────┐

<PROPERTY-GROUP> ├───►<DEFAULT-VALUES>

<NAME>ELAXFASM-demo</NAME> ─┘

<CATEGORY-INSTANCE>

<CATEGORY>ASSEMBLER_SETTINGS</CATEGORY>

<NAME>ASSEMBLER_JCL_PROCEDURE_NAME</NAME>

<VALUE>ELAXFASM</VALUE>

</PROPERTY>

<NAME>ASSEMBLER_JOB_STEPS</NAME>

</PROPERTY>

<NAME>HOST_ASSEMBLER_OPTIONS</NAME>

<VALUE>NORLD</VALUE>

</PROPERTY>

<NAME>ASSEMBLER_MACRO_LIBRARIES</NAME>

<VALUE>TEST.USERMAC</VALUE>

</PROPERTY>

<NAME>COMPILE_ERROR_FEEDBACK_ENABLED</NAME>

<VALUE>FALSE</VALUE>

</PROPERTY>

<NAME>ERROR_FEEDBACK_FILE_PREFIX</NAME>

<VALUE<HLQ>.ERRASM</VALUE>

</PROPERTY>

…

</CATEGORY-INSTANCE>

</PROPERTY-GROUP> ─┐

├───►</DEFAULT-VALUES>

</PROPERTY-GROUPS> ─┘

defaultvalues.xml(example)

<?xml version="1.0" encoding="UTF-8"?>

<DEFAULT-VALUES>

<CATEGORY-INSTANCE>

<CATEGORY>ASSEMBLER_SETTINGS</CATEGORY>

<NAME>ASSEMBLER_MACRO_LIBRARIES</NAME>

<VALUE>TEST.USERMAC</VALUE>

</PROPERTY>

<NAME>OBJECT_DATASET</NAME>

<VALUE</VALUE>

</PROPERTY>

<NAME>HOST_ASSEMBLER_OPTIONS</NAME>

<VALUE>NORLD</VALUE>

</PROPERTY>

</CATEGORY-INSTANCE>

<CATEGORY-INSTANCE>

<CATEGORY>JCL_OPTIONS</CATEGORY>

<NAME>GENERATED_JCL_DATASET</NAME>

<VALUE<HLQ>.JCL.CNTL</VALUE>

</PROPERTY>

<NAME>JOBCARD</NAME>

<VALUE>//<JOBNAME> JOB (KST,00000,PNR,XX00000),PGMR,

// MSGCLASS=V,TIME=(0,2),MSGLEVEL=(1,1)

// JCLLIB ORDER=(TSSE000.RDZ75.PROCLIB,TSSE000.TEST.PROCLIB)

</VALUE>

</PROPERTY>

</CATEGORY-INSTANCE>

</DEFAULT-VALUES>

The entries marked red italicised correspond to those shown in the following Assembler Step Options.

The associated displayed options:

Number of default value instances

<DEFAULT-VALUES> 1

<CATEGORY-INSTANCE> 1-n – the header for each category

<CATEGORY> 1 – the name of the setting

<PROPERTY> 1-n – the header for each property

<NAME> 1 – the name of the property

<VALUE> 1 – the associated value

propertygroups.xml(example)

<?xml version="1.0" encoding="UTF-8"?>

<PROPERTY-GROUPS>

<PROPERTY-GROUP>

<NAME>Assembler DebugTool</NAME>

<CATEGORY-INSTANCE>

<CATEGORY>ASSEMBLER_SETTINGS</CATEGORY>

<NAME>ASSEMBLER_JCL_PROCEDURE_NAME</NAME>

<VALUE>ELAXFADT</VALUE>

</PROPERTY>

<NAME>ASSEMBLER_MACRO_LIBRARIES</NAME>

<VALUE>TEST.USERMAC N0.C.USERMAC</VALUE>

</PROPERTY>

<NAME>OBJECT_DATASET</NAME>

<VALUE</VALUE>

</PROPERTY>

</CATEGORY-INSTANCE>

<CATEGORY-INSTANCE>

<CATEGORY>LINK_OPTIONS</CATEGORY>

<NAME>JCL_PROCEDURE_NAME</NAME>

<VALUE>ELAXFLNK</VALUE>

</PROPERTY>

<NAME>LOAD_MODULE</NAME>

<VALUE<HLQ>TEST.LOAD</VALUE>

</PROPERTY>

</CATEGORY-INSTANCE>

<CATEGORY-INSTANCE>

<CATEGORY>JCL_OPTIONS</CATEGORY>

<NAME>GENERATED_JCL_DATASET</NAME>

<VALUE<HLQ>.JCL.CNTL</VALUE>

</PROPERTY>

<NAME>JOBCARD</NAME>

<VALUE>//<JOBNAME> JOB (KST,00000,PNR,XX00000),PGMR,

// MSGCLASS=V,TIME=(0,2),MSGLEVEL=(1,1)

// JCLLIB ORDER=(TSSE000.RDZ75.PROCLIB,TSSE000.TEST.PROCLIB)

</VALUE>

</PROPERTY>

</CATEGORY-INSTANCE>

</PROPERTY-GROUP>

</PROPERTY-GROUPS>

The associated Property Group options (ASSEMBLER_SETTINGS):

Number of property group instances

<PROPERTY-GROUPS> 1

<PROPERTY-GROUP> 1-n

<NAME> 1 – the name of the property group

<CATEGORY-INSTANCE> 1-n

<CATEGORY> 1 – the setting

<PROPERTY> 1-n

<NAME> 1 – the name of the property

<VALUE> 1 – the associated value

Special processing

XML requires special processing for the following special characters

GlyphEncoding

Example

<VALUE<HLQ>.JCL.CNTL</VALUE>

resolves to

<HLQ>.JCL.CNTL

Multi-field elements

The individual entries in a list are each separated with a blank.

Example

<VALUE>TEST.USERMAC N0.C.USERMAC</VALUE>

Multi-line elements

Each line is delimited with a carriage-return (represented as ◘ below).

Example

<VALUE>//<JOBNAME> JOB (KST,00000,PNR,XX00000),PGMR,◘
// MSGCLASS=V,TIME=(0,2),MSGLEVEL=(1,1)◘
// JCLLIB ORDER=(TSSE000.RDZ75.PROCLIB,TSSE000.TEST.PROCLIB)◘

</VALUE>

resolves to

//<JOBNAME> JOB (KST,00000,PNR,XX00000),PGMR,

// MSGCLASS=V,TIME=(0,2),MSGLEVEL=(1,1)

// JCLLIB ORDER=(TSSE000.RDZ75.PROCLIB,TSSE000.TEST.PROCLIB)

Category and property names

The names of the categories and properties that can be used in the propertygroups.xml and defaultvalues.xml files follow (these names are case sensitive). The current values can be obtained from the online help.

Each category name (for example, COBOL_SETTINGS) is followed by the available property names (for example, HOST_COMPILE_OPTIONS).

COBOL_SETTINGS

HOST_COMPILE_OPTIONS
COMPILE_JCL_PROCEDURE_NAME
COMPILE_JOB_STEPS
LISTING_DATASET
OBJECT_DATASET
HOST_SYSLIB
COMPILE_ERROR_FEEDBACK_ENABLED
ERROR_FEEDBACK_FILE_PREFIX
COMPILE_ADDITIONAL_JCL
COMPILE_SYSDEBUG_DATASET
HOST_USE_CICS
HOST_CICS_LEVEL
HOST_CICS_SEPTRANSLATOR
CICS_TRANSLATOR_JCL_PROCEDURE_NAME
CICS_TRANSLATOR_JOB_STEPS
HOST_CICS_OPTIONS
HOST_CICS_SYSLIB
HOST_USE_DB2
HOST_DB2_PREPROCESSOR
HOST_DB2_JCL_PROCEDURE_NAME
HOST_DB2_JOB_STEPS
HOST_DB2_OPTIONS
HOST_DB2_SYSLIB
HOST_DB2_DBRMLOCATION
HOST_DB2_SYSTSIN
HOST_USE_IMS
HOST_IMS_LIBRARY
HOST_USER_VARIABLES
HOST_GLOBAL_VARIABLES
ADDED_STEP_ADDITIONAL_JCL
ADDED_STEP_OPTIONS
ADDED_STEP_ERROR_FEEDBACK
ADDED_STEP_ERROR_FEEDBACK_FILE_PREFIX
LOCAL_CICS_PREPROCESSOR
LOCAL_CICS_PREPROCESSOR_OPTIONS
LOCAL_COMPILE_OPTIONS
LOCAL_DB2_COPROCESSOR
LOCAL_DB2_CONNECTION
LOCAL_DB2_COPROCESSOR_OPTIONS
LOCAL_SYSLIB
LOCAL_ENVIRONMENT_VARIABLES
LOCAL_PREPROCESSOR_DESCRIPTION
LOCAL_PREPROCESSOR_NAME
LOCAL_PREPROCESSOR_OPTIONS
LOCAL_PREPROCESSOR_OUTPUT_FILE_NAME
LOCAL_PREPROCESSOR_SUPPORT_ERRFDBK
LOCAL_PREPROCESSOR_XML_LOCATION
LOCAL_PREPROCESSOR_ENVIRONMENT_VARIABLES
LOCAL_PREPROCESSOR_IS_ACTIVE

JCL_OPTIONS

JOBCARD
GENERATED_JCL_DATASET
ASSEMBLER_SETTINGS

ASSEMBLER_SETTINGS

ASSEMBLER_JCL_PROCEDURE_NAME
ASSEMBLER_JOB_STEPS
HOST_ASSEMBLER_OPTIONS
LISTING_DATASET
OBJECT_DATASET
ASSEMBLER_MACRO_LIBRARIES
COMPILE_ERROR_FEEDBACK_ENABLED
ERROR_FEEDBACK_FILE_PREFIX
COMPILE_ADDITIONAL_JCL
HOST_USER_VARIABLES
HOST_GLOBAL_VARIABLES
ADDED_STEP_ADDITIONAL_JCL
ADDED_STEP_OPTIONS
ADDED_STEP_ERROR_FEEDBACK
ADDED_STEP_ERROR_FEEDBACK_FILE_PREFIX

RUNTIME_OPTIONS

RUN_IN_BATCH
RUN_IN_BATCH_WITH_DEBUG
OPTIONS
ADDITIONAL_JCL
PROCEDURE_NAME
JOB_STEPS
PROGRAM_PARAMETERS_ENABLED
RUNTIME_OPTIONS_BEFORE_PROGRAM_PARAMETERS
PROGRAM_PARAMETERS_BEFORE_RUNTIME_OPTIONS
HOST_USER_VARIABLES
HOST_GLOBAL_VARIABLES
ADDED_STEP_ADDITIONAL_JCL
ADDED_STEP_OPTIONS

C_CPP_SETTINGS

CPP_COMPILE_JCL_PROCEDURE_NAME
CPP_COMPILE_JOB_STEPS
CPP_COMPILE_OPTIONS
CPP_COMPILE_MACROS
CPP_LISTING_DATASET
CPP_OBJECT_DATASET
CPP_COMPILE_SYSEVENT
CPP_COMPILE_SYSLIB
CPP_COMPILE_USERLIB
CPP_COMPILE_ADDITIONALJCL
CPP_HOST_USER_VARIABLES
CPP_HOST_GLOBAL_VARIABLES
C_COMPILE_JCL_PROCEDURE_NAME
C_COMPILE_JOB_STEPS
C_COMPILE_OPTIONS
C_COMPILE_MACROS
C_LISTING_DATASET
C_OBJECT_DATASET
C_COMPILE_SYSEVENT
C_COMPILE_SYSLIB
C_COMPILE_USERLIB
C_COMPILE_ADDITIONALJCL
CPP_ADDED_STEP_ADDITIONAL_JCL
CPP_ADDED_STEP_OPTIONS
C_ADDED_STEP_ADDITIONAL_JCL
C_ADDED_STEP_OPTIONS
CPP_COMPILE_USEC

System PG settings compact.doc1