Glossary (Code Debug CICS PL/I)

AADF

Transaction used to access Abend-AID for CICS to view reports.

abend

Abnormal end of task. The termination of a task, prior to normal completion, due to an unresolved error condition.

Abend-AID for CICS

• • ====

System software product designed to analyze the cause of CICS transaction abends. It provides online diagnostics that explain the cause of the abend, the location within the program where the error occurred, and how to correct the problem.

abend code

Identifier for the current abend when an abend occurs.

Abend trap

Function that allows Code Debug CICS to notify the user when a program breakpoint, abend, or storage violation has been encountered. See trap.

ADD OFFSET

Indicates a specific screen location. The data at this location is scrolled to the top fof the data portion of the screen. If the USE ADDRESS field contains an “X”, Code Debug CICS uses the data at this location as an address and displays the location indicated. This feature is found on screens 2.2 and 9.2.

ADDRESS

Address that is displayed on hexadecimal dump format screens and indicates the begin­ning address of the area being accessed. The address does not change unless:

• A new area is accessed
• The programmer types over the address with a location to be accessed
• The USE CONTENTS field is used to retrieve data from a stored location.

Assembler language processor

One of several language processors provided by BMC, this language processor accepts Assembler output, builds sort work records, sorts and merges the records, and merges the records with the listing to produce processor control blocks that can then be used as input to Code Debug CICS and other BMC products.

Basic Direct Access Method (BDAM)

File access method that directly retrieves or updates specified blocks of data on a direct access storage device.

Basic Partitioned Access Method (BPAM)

File access method that can be applied to create program libraries, in direct access storage, for convenient storage and retrieval of programs.

batch

Processing in which jobs are grouped (batched). The jobs are executed sequentially, and each job must be processed to completion before the following job can begin execution.

BDAM

Basic Direct Access Method.

BK-CHAIN

Back chain pointer.

blank

Part of a data medium in which no characters are recorded. Its hexadecimal character repre­sentation is X’40’.

BL cell

Base Locator cell. These cells are used by COBOL programs to provide addressability to data within the working storage section of a program.

BLL cell

Base Linkage Locator cell. These cells are used by COBOL programs to provide addressabil­ity to data within the linkage section of a program.

BLW cell

Base Locator Working Storage cell. These cells are used by COBOL II programs to provide addressability to data within the working storage section of a program.

BPAM

Basic Partitioned Access Method.

breakpoint 

Code Debug CICS method of pausing program execution during debugging. Setting a breakpoint in a program halts execution of the program when a statement is about to be executed. Breakpoints may be set as conditional or unconditional and to occur either before or after the event.

At a breakpoint, the user may view all the tables and areas necessary to solve a problem. After interro­gating the problem, the user may continue normal execution of the system.

channel

Analogous to a parameter list. Containers are grouped together in sets called channels. See also Containers.

CICS

Customer Information Control System.

C language processor

One of several language processors provided by BMC, this language processor accepts C output, builds sort work records, sorts and merges the records, and merges the records with the listing to produce processor control blocks that can then be used as input to Code Debug CICS and other BMC products.

CLC

Compare Logical Character.

CLOT

(DB2 only) CICS Life-of-Task block.

COBOL language processor

One of several language processors provided by BMC, this lan­guage processor accepts COBOL compiler output, builds sort work records, sorts and merges the records, and merges the records with the listing to produce processor control blocks that can then be used as input to Code Debug CICS and other BMC products.

command

Request from a terminal to perform an operation or to execute a program.

COMMAND field

Field that appears in the upper left corner of most Code Debug CICS screens. All Code Debug CICS functions and screens are selected by entering the desired function or screen ID in the COMMAND field.

Compare Logical Character (CLC) instruction

An IBM machine compare instruction.

Common Shared Services (CSS)

A set of components used by several BMC products to provide storage, retrieval, and maintenance for source listings and abend reports.

Conditional breakpoint

For a statement set with a conditional breakpoint, Code Debug CICS interro­gates the condition entered and if true, halts execution of the program and receives control.

Containers 

The “big commarea” containers and channels that IBM introduced in CICS Transaction Server 3.1 as an alternative to commareas. For additional information, refer to “Channels and Con­tainers” in the IBM Knowledge Center.

CSECT field

Field on most Code Debug CICS screens that is used to change the CSECT to be accessed during the session.

dataname

The name of the data item in the working storage section of a COBOL program.

data set

Collection of data treated as a unit that is the primary unit of access and storage. It can be organized in various ways.

DA-KEY

BDAM blocked DAta set, deblocked by KEY.

DA-REL

BDAM blocked DAta set, deblocked by a RELative record.

Database Descriptor (DBD)

Defines the database associated with a PCB. Associated with every PSB is a list of PCBs that define databases that can be accessed via a PSB. Each PCB-accessed database can be identified by its DBD name, which is used during the definition of the database to DL/I.

DA-UNB

Direct Access UNBlocked data set.

DB2

An IBM relational database management system.

DBD

DataBase Descriptor.

DBPA

Transaction used to initiate certain Code Debug CICS functions at system start-up.

DCT

Destination Control Table.

DDIO

A BMC file access method.

DDIO file

A generic name for an Abend-AID report file, or an Code Debug source listing file.

DDIO file member

A generic name for an abend report in an Abend-AID report file, or an Code Debug source listing in a source listing file.

default value

Choice among exclusive alternatives made by the system when no explicit choice is made by the user.

destination

Location at which a block of (lines) records or a single record is being copied or moved. The destination can be specified with an A (After) or B (Before) line command.

Destination Control Table (DCT)

A CICS table describing transient data files.

DFHRPL

Library of CICS and user-written programs that are loaded and executed as part of a CICS system. Programs from this library are loaded into CICS storage for online execution. DFHRPL may be supplemented by LIBRARY resource definitions.

DL/I

Data Language 1.

DMAP

Data division map of a COBOL program. The DMAP COBOL compile option produces a report of all datanames and their associated BL or BLL cell, displacement within the cell, and field description.

DOS

Disk Operating System.

DSECT

Dummy control section. A control section that an Assembler program can use to format an area of storage without producing any object code.

EDT

MVS Eligible Device Table.

EIB

Execute Interface Block.

EIS

Execute Interface Storage.

entry-sequenced data set (ESDS)

VSAM data set whose records are loaded in sequence. Unlike a nor­mal sequential data set, ESDS records can be accessed randomly by their addresses.

ESDS

Entry-Sequenced Data set.

ESS

Embedded Source Support (ESS). Code Debug CICS automatically uses ESS records at view time to provide source support for programs preprocessed or postprocessed with the BMC Language Processor.

external security manager (ESM)

A security product that provides an interface to the z/OS System Authorization Facility (SAF). CA-ACF2, RACF, and CA-Top Secret are examples of ESMs.

Execute Interface Block (EIB)

Block that contains information pertinent to a command-level transaction such as the current time and date, transaction ID, task number, terminal ID, COMMAREA length, attention identifier, function code, and response code.

FCT

File Control Table.

file

Complete organized collection of information.

File Control Table (FCT)

A CICS table defining files that can be accessed by CICS programs. Also used to generically apply to files defined in the CSD.

HELP

Primary command that requests Code Debug’s interactive Help facility.

HEX

Primary command that alternates between symbolic or dump format display.

HEX OFFSET

Hexadecimal value of the location of the retrieved area relative to the beginning of the address. The sum of the ADDRESS field and HEX OFFSET field indicates the actual address of the data displayed.

HEX ON and HEX OFF

Displays data in character and zoned decimal format on the VARIABLE STORAGE screen (2.3). The user may view this same data in a standard hexadecimal dump format by entering HEX ON in the COMMAND field. HEX OFF redisplays the data in character and zoned deci­mal format.

hung task

A task suspended by the system.

hung task analysis

A Code Debug CICS facility for the XPSP user that allows interrogation of a sus­pended task to determine the reason for its suspension. This function is available by using the VIEW SINGLE TASK screen (9.1) and the LIST ALL TASKS (9.3) screen.

IMS

Information Management System.

INRWORK

INput Register Work area.

interactive

Pertaining to an application in which each entry calls forth a response from a system or program.

IP address

A numeric address given to servers and users’ computers connected to the Internet.

ISPF

Interactive System Productivity Facility.

JCL

Job Control Language.

key

Code used to locate a record and establish its position in an index. The key can be part of a field, a full field, or multiple fields duplicated from the record.

Key-Sequenced Data set (KSDS)

VSAM file type whose records are loaded in key sequence. Records are retrieved by key or address using an index. New records are inserted in key sequence by means of distributed free space.

keyword

Reserved word that has special significance.

KSDS

Key-Sequenced Data Set.

line command

Edit command that is entered directly on the line to be processed by overtyping the sequence number at the beginning of the line. Also known as a prefix command.

linkage section

A section of a COBOL program used to describe data that is passed to it from CICS or another program.

MENU

Primary command that ends the current function and returns the user to the SYSTEM MENU.

MODULE field

Field on most Code Debug CICS screens that is used to change the program to be accessed during the session.

MORE

Indicates there is more information to display. This indicator appears only when screen over­flow data is not generally assumed. Use PF7 and PF8 to view the additional data.

MQ

IBM licensed programs that provide message queuing services.

offset

A relative location or position within a data area.

OFL

Optional Features List. Also known as OPFL.

operating system

Software that controls the execution of jobs. It may provide resource allocation and scheduling.

OS

Operating System.

paragraph

Set of one or more COBOL sentences, making a logical processing entity, and preceded by a paragraph name or a paragraph header.

PCB

Program Communication Block.

PLIST

(DB2 only) Parameter List.

PF key

Program Function Key.

PL/I language processor

One of several language processors provided by BMC, this language processor accepts PL/I compiler output, builds sort work records and an incore symbol table of all the identifiers, and produces processor control blocks that can then be used as input to Code Debug CICS and other BMC products.

PLT

Program List Table.

prefix commands

Another name for line commands.

Program Communication Block (PCB)

One of a list of control blocks used by DL/I that define the databases that can be accessed via a particular PSB. Each PCB-accessed database DBD name. For each PCB with a PSB, Code Debug CICS displays the PCB number and DBD name. Code Debug CICS uses the PCB number to identify the PCB to access a DL/I database from the selected PSB.

Program List Table (PLT)

CICS table describing a list of programs to be executed when CICS is in initialization or termination processing.

Program Specification Block (PSB)

DL/I control block that defines a set of DL/I databases that can be accessed from a program. The databases and segments in the databases that can be accessed are defined via a list of PCBs defined in the PSB. To access any DL/I database, always select a PSB.

program storage

Class of CICS storage used for application programs.

primary command

Command that provides a general function. Primary commands are entered in the COMMAND field.

procedure division

Section of a COBOL program that contains executable instructions.

profile

Control block that defines session characteristics applicable to one or more users of Code Debug CICS. Pertinent information in a profile may include PF key settings, default abend trap, trace, storage protection, and footing settings.

profile data set

VSAM KSDS data set containing all profiles available for use during a Code Debug CICS session.

program function (PF) key

Keyboard keys that are numbered from PF1 to PF24 and are pro­grammed to perform functions such as scrolling.

Program Status Word (PSW)

A special control register, in the hardware, defining the current status and location of a program that is executing.

PSB

Program Specification Block.

PSW

Program Status Word.

quick table disable

Method of turning off storage protection monitoring without destroying the current table entries.

RCT

(DB2 only) Resource Control Table.

record

Collection of related data or words treated as a unit.

register

Storage device, having specified storage capacity such as a bit, byte, or a computer word, and usually intended for a special purpose.

register save area

Group of 72 contiguous bytes used for saving registers when one program calls another.

Relative Record Data Set (RRDS)

VSAM data set whose record locations are specified by a number that represents a record’s location in the data set relative to the beginning of the data set.

remote task trapping

Code Debug CICS function that allows one terminal to trap abends, breakpoints, and storage violations that occur on another terminal or in a non-terminal task.

RFN

An abbreviation for RECEIVE FROM NETWORK. RECEIVE FROM NETWORK specifies that the input for an SMP/E RECEIVE command is a GIMZIP package on a TCP/IP connected FTP server.

RRDS

Relative Record Data set.

screen ID

Code entered in the COMMAND field to retrieve information and function screens. The SCREEN ID for each screen appears on every screen immediately preceding the screen title.

SCROLL field

A field on most Code Debug CICS screens that is used to set the default value to be used for those screens that allow scrolling.

Segment Search Argument (SSA)

A control block used by DL/I to access a segment within the hier­archy of a database.

Shared Directory

A variable-length record VSAM RRDS that maintains information about abends and language processing along with the attached database activity. A shared directory can contain Abend-AID for CICS directory records for each region and transaction dump known to a server, Abend-AID directory records for abend report processing, or source listing shared directory records necessary to process source listing database members.

shared storage

Class of CICS storage that can be shared between tasks.

SIT

System Initialization Table.

snap dump

Dump that is taken at a specific point during execution of a program. Processing is gen­erally continued after the dump has been taken.

SQLCA

(DB2 only) SQL Communication Area.

SQLDA

(DB2 only) SQL Descriptor Area.

SSA

Segment Search Argument.

statement number

Sequence numbers provided by compilers and assemblers to provide the pro­grammer with an easy means of identifying a statement within a program.

statement number column

Column on the display where the statement numbers are located. In some cases, commands may be entered into this column.

STCA

System portion of the Task Control Area.

stop

See breakpoint.

storage protection

Method of preventing programs from violating storage within the CICS region, thereby increasing the time that the region remains running.

storage protection exceptions

Code Debug CICS facility for allowing specific actions that are consid­ered to be storage violations to take place.

system labels

Labels that equate to storage locations that may be used by any Code Debug CICS user. Some system labels are predefined by BMC.

table entry ID

Identification command used to directly retrieve the desired CICS table entry for dis­play.

task

Execution of a program or multiple programs within CICS to perform a specific function. Each task is assigned a unique number (task number) by CICS.

TCA

Task Control Area.

TCP/IP

Transmission Control Protocol/Internet Protocol. Set of communication protocols enabling Telnet, FTP, e-mail, and other services.

TCT

Terminal Control Table.

Terminal Control Table (TCT)

CICS table defining terminals used by CICS.

TOGGLE

Primary command that transfers you to the Source Listing (2.L) screen.

trace

Record of the execution of a computer program; it exhibits the sequences in which the instructions were executed.

trace table

CICS storage area into which trace information is placed. This table contains the chronological occurrences of events that take place in CICS, recorded in wraparound fashion within the trace table.

trap 

Code Debug CICS feature. The user may set traps to intercept CICS transaction abends and to view all areas at abend time. Traps may be set to only intercept transaction abends at terminals running Code Debug CICS or designated as remote. Traps may be set to intercept specific transaction’s abends, regardless of the terminal from where they are executed. Traps may also be used to intercept abends occurring in non-terminal tasks.

TSA

Temporary Save Area.

unconditional breakpoint

For a statement set with an unconditional breakpoint, Code Debug CICS receives control and temporarily halts execution of the program before or after this statement.

use address

A feature that is available on the Memory Display screens (2.2 and 9.2). The USE ADDRESS function automatically retrieves an address reference from memory and displays the loca­tion.

user labels

Labels generated by a user that equate to storage locations.

variable

Name of a data item in a PL/I program.

view

Code Debug CICS method of selecting data items for display at a breakpoint or abend.

virtual storage

Storage space that may be regarded as addressable main storage by the user of a computer system in which virtual addresses are mapped into real addresses.

Virtual Storage Access Method (VSAM)

File access method whereby the records in a file on a direct access storage device can be accessed in key-sequence (KSDS), entry-sequence (ESDS), or relative record sequence (RRDS).

VSAM

Virtual Storage Access Method.

VTAM

Virtual Telecommunications Access Method.

working storage

A section of a COBOL program used to define the data items that are used in a pro­gram.

XPED

Transaction code entered to invoke Code Debug CICS. It provides a source-based focus for debugging CICS application programs.

XPND

Transaction code entered to end an Code Debug CICS debugging session.

XPRT

Transaction code entered to invoke Code Debug CICS. XPRT provides a break/abend focus for debugging CICS application programs.

XPSP

Transaction code entered to invoke the XPSP level of Code Debug CICS. This level is to be used only by experienced system programmers authorized to update CICS tables and control areas. System-wide storage protection is set by the XPSP user. This is the only Code Debug CICS level that does not restrict updating.