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 specified in the Micro Focus z/Server connection. The behavior of the tool based on this attribute is described in the table below.
Enable Advanced Properties	Boolean	Specifies whether the optional input parameters will be visible.

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 is false.
5 [O]	I	String	A Boolean value indicating whether to replace the property group if it already exists. Default value is 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 to. 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

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