Common Tape System › Distributed Tape Support (DTS) › Requirements › DTS Control Statements Contained in CTODTS00

DTS Control Statements Contained in CTODTS00

Control Member Name

DTS will read a member from the CAI.CTAPOPTN library on startup to define the remote servers and establish certain global defaults. The default name of the member is CTODTS00. The last two characters may be changed, and the PARM parameter on the START command can be changed to reflect the new member name.

Control Statements

Selectable DTS defaults are established with the GLOBAL control statement. Remote server definitions are established with the SRVDEF control statement. All control statement keywords and operands must be uppercase.

GLOBAL Control Statement

The GLOBAL control statement is coded as follows:

GLOBAL    TCPNAME=tcpipname,
[MAXTASK=nn,]
[PREFIX=perfixname,]
[UNIT=unitname,]
[VOL=volser,]
[MSGLEVEL=nn,]
[STORCLAS=storageclassname,]
[DATACLAS=dataclassname,]
[MGMTCLAS=managementclassname,]
[TRACE/NOTRACE]

TCPNAME=

A required parameter that specifies the name of the TCPIP address space on the mainframe where CTS is running.

MAXTASK=

An optional parameter from 1 to 10 that specifies the maximum number of concurrent data retrieval operations that can be active at any one time. This specification is used to throttle resource utilization when multiple servers require data retrieval at the same time. All data retrieval sessions are queued up and serviced by the available data retrieval subtasks.

UNIT=

An optional parameter that specifies a valid unitname to be used to dynamically allocate the distributed tape inventory file.

VOL=

An optional parameter that specifies the volume serial number to use when allocating the distributed tape inventory file.

MSGLEVEL=

An optional parameter that specifies the level of messaging that will occur. Valid values are 0 through 9. The default is 0 which will list only the most important messages. This can be changed with a console command during execution. Setting this to 9 will provide supplementary information that can be used to diagnose abnormalities.

STORCLAS=

An optional parameter that specifies a valid SMS storage class to be used when allocating the distributed tape inventory file.

DATACLAS=

An optional parameter that specifies a valid SMS data class to be used when allocating the distributed tape inventory file.

MGMTCLAS=

An optional parameter that specifies a valid SMS management class to be used when allocating the distributed tape inventory file.

TRACE/NOTRACE

An optional parameter that will display all iSponsors found on a remote backup server when DTS connects to it.

SRVDEF Control Statement

The SRVDEF control statement is coded as follows:

SRVDEF     NAME=srvdefname,
SERVER=servername,
[SCHD=schdname,]
[LOG/NOLOG]
[TRACE/NOTRACE]

NAME=

Any 1 to 8 character name for this SRVDEF entry. The first character must be alphabetic. This name is used as the lowest level qualifier in constructing the data set name of the Distributed Tape Inventory File for this server. DTS will create these files as needed.

SERVER=

The DNS name or IP address of the remote server running the backup product you wish to manage.

SCHD=

The name of the CTSSCHD schedule event which is to trigger a query session for this server. For example, if SCHD=HOURLY is specified, you must ensure the SCHD component of CTS is started and contains a definition for HOURLY.

LOG/NOLOG

An optional parameter specifying whether print logging of received data is desired. If set to LOG, a SYSOUT DD with the name of this SRVDEF will be dynamically allocated. NOLOG is the default.

TRACE/NOTRACE

An optional parameter that will display all iSponsors found on a remote backup server when DTS connects to it. If this parameter is specified, it will override the specification in the GLOBAL specification.