Create Property Group

Tool Attribute:

Attribute Type Description
Enable System Selection Dialog Boolean Specifies whether a dialog should open to select an IDz z/OS Server connection if no valid mapping is defined in the Micro Focus z/Server connection. The behavior of the tool based on this attribute is described in the table below.

Function:

This tool creates an IDz property group with a logical name and adds the SYSLIB information to the property group used for the real-time syntax check support in IDz editors.

Parameters:

Parameter No I/O Type Description
1 [M] I String The logical name of the property group.
2 [M] I String The programming language category, see below.
3 [M] I String The full list of system libraries used to resolve dependencies (SYSLIB) and optional compile parameters, see below.
4 [O] I String A Boolean value indicating whether the property group is local.

Default Value: false

5 [O] I String A Boolean value indicating whether to replace the property group if it already exists.

Default value: false

6 [O] I String The name of an existing property group. If this parameter is set, the property group with the passed name is copied and updated with the SYSLIB information specified in the third parameter.

Behavior of the property group tools depending on the ‘Enable System Selection Dialog’ attribute:

Enable Connection Dialog Attribute IDz z/OS Server Mapping Dialog Result Result
True Not Set OK pressed IDz editor opens
True Not Set Cancel pressed Error Message
True Set and valid   IDz editor opens
True Set and invalid OK pressed IDz editor opens
True Set and invalid Cancel pressed Error Message
True Not set and no IDz z/OS Server connection available   Error Message
False Not Set   Error Message
False Set and invalid   Error Message
False Set and valid   IDz editor opens

Language category:

An IDz property group contains different named categories. The tool Create Property Group needs to know which category the SYSLIB information has to be added. The language category is not case sensitive. The following table shows the map from programming languages to the permitted IDz category values.

Property group Language Permitted values as language category
IDz local property group COBOL

PL/I

COBOL

PLI, PL1

IDz remote property group COBOL

PL/I

Assembler

C/C++

COBOL

PLI, PL1

Assembler, ASM

C_CPP, C, CPP, C/CPP

SYSLIB definition:

The SYSLIB definition in the third input parameter has to be defined with key parameters to differentiate between local and remote system files.

The following key parameters are allowed:

  • localsyslib(): for system libraries which are located locally.
  • remotesyslib(): for system libraries which are located on a remote system.
  • compileoption(): for additional compile options.

Rules:

  • The SYSLIB is the input between "key( " and the last ")" before the next key.
  • If no keys are given, the full value of the parameter SYSLIB is interpreted as system libraries which are located on a remote system.
  • If the value of the parameter SYSLIB is blank, the property group is created with default system libraries, or if the property group template exists, its system libraries are copied.
  • Local SYSLIB definitions which contain blank characters need to be put in quotation marks.
  • A semicolon in remote SYSLIB definitions is replaced with a space.

Example:

Input = localsyslib("c:\Program File\folder“) remotesyslib(hlq.dev.copylib;hlq.prod.copylib) compileoption( co1 co2)

This input is interpreted as follows:

LocalSyslib = "c:\Program File\folder“

RemoteSyslib= hlq.dev.copylib;hlq.prod.copylib

CompileOption= co1 co2