Debug Configuration File

Overview

This COBOL cross-session debug configuration file determines whether any of the trigger resources are configured for debugging.

The filename is kix_cobol_dbg.cfg.

The format of a kix_cobol_dbg.cfg definition is:

ANIMSRVID;UserID;termID;SYS_ID;TransID;Program

For example,

ANIMSRVID1;UserID1;termID1;SYS_ID1;TransID11;Program11

ANIMSRVID1;UserID2;termID2;SYS_ID1;TransID1X;Program1X

ANIMSRVID2;UserID3;termID3;SYS_ID2;TransID21;Program21

ANIMSRVID2;UserID4;termID4;SYS_ID2;TransID2X;Program2X

Debug Configuration File Parameters

Table 6‑1 lists and defines debug configuration file parameters available to be referenced by the CICS application.

 

Table 6‑1 Debug Configuration Parameters

Field Name	Type	Values	Description
ANIMSRVID	X(40) or 1 ~ 999999999	Mandatory	When a transaction is running, ART for CICS uses this ANIMSRVID to enable animation for the program. For Micro Focus COBOL application programs, ANIMSRVID is a string that is required for enabling animation in COBOL. It is a character string of up to 40 characters. The string can have alphanumeric characters and the underscore character. For COBOL-IT COBOL application programs, ANIMSRVID is a number ranging from 1 to 999999999. Note: You can specify multiple ANIMSRVID with the same name; however, ART for CICS application server will only find the first ANIMSRVID that matches all required fields as the trigger resource, which is then triggered by anim / deet utility.
TermID	X(4)	Optional	Specifies the four-character identifier of the terminal on which the transaction that is to be tested will be run.
UserID	X(8)	Optional	Specifies the eight-character identifier of the user, who is to be diagnosed.
SYS_ID	X(4)	Optional	Specifies the four-character identifier of the remote system (CICS region or CICS client) where the transaction that is to be diagnosed will originate.
TransID	X(4)	Optional	Specifies the four-character identifier of the transaction that is to be diagnosed.
Program	X(30)	Optional	Specifies the name of the program that is to be diagnosed.