Build Toolkit plug-in properties for Z Data Tools base resources

This topic describes the properties expected by the Z Data Tools Build Toolkit plug-in for Z Data Tools base resources.

Base resources include MVS™ data set, USS files, CICS® files, CICS TD and TS queues, and MQ queues.

Property Importance Description
name Required The name of the service. Must be unique across SAR files.
description Optional The description of the service. Recommended to help manage SAR files.
version Required The version of the service.
provider Required Must be zdatatools.
file Required The name of the data resource for which the service applies. Examples: MVS.DATASET, /uss/data.dat, FI:APPLID:CICSFILE, TD:APPLID:CICSTDQ, TS:APPLID:CICSTSQ, MQ:QMGR:QNAME

where APPLID represents the application ID of the target CICS region, and QMGR represents the MQ system.

volser Optional Data resource volume serial, if applicable.
dataCcsid Optional CCSID of resource alphanumeric data in the file. Default is 037.
dbcsCcsid Optional CCSID of graphic or double-byte data. Default is 930.
template Required Name of a Z Data Tools template that maps the data resource. Example: MVS.DATASET(TEMPLATE).
language Optional Language of the copybook when the template property identifies a copybook. Can be COBOL, PLI, HLASM, or AUTO. Do not specify a language if the template property nominates a Z Data Tools template.
tmplCcsid Optional CCSID of the template or copybook. Default is 037.
timeout Optional Time in seconds for which the Z Data Tools view session can be inactive before it is terminated. Can be any value from 0 to 28800 (eight hours). The default is 300 (5 minutes).

If the value is greater than the max_timeout in the server.xml configuration, the timeout value is ignored and the max_timeout value is used instead.

connid Optional Connection ID. Associates the generated SAR file with a configuration element in the server.xml z/OS® Connect WLP server. Default is "default".
host Required The hostname or IP address of the ZCC server (HFISRV) where the template or copybook resides. The host property is only relevant during SAR creation.
port Required The port number of the ZCC server (HFISRV) where the template or copybook resides. The port property is only relevant during SAR creation.
userid Required A user ID that has read access to the template or copybook on the z/OS system running the HFISRV server. The userid property is only relevant during SAR creation.
passwd Required A password of the user ID that has read access to the template or copybook on the z/OS system running the HFISRV server. The passwd property is only relevant during SAR creation.