CICS executable modules

The following list shows, for each module:

  1. The name of the module
  2. Its entry points
  3. Callers of the module
  4. A brief description of the module
  5. Where the module returns to. This information is omitted where the module returns to its caller (the normal situation).

In general, this list is restricted to non-OCO modules. In the few cases where OCO modules are included, no design details are given.

DFHACP
Entry points:

DFHACPNA

Called by:

DFHAPRM, DFHAPXME

Description:

The abnormal condition program writes a message to the terminal and to the CSMT destination if a transaction abends or cannot be started. Subject to tests on the type of terminal, DFHACP invokes DFHMGP to output the message. It calls DFHPEP and, depending on the result, may disable the transaction. For each error, there is an entry in a table which contains the number of the message to be written to the principal facility (terminal) and the number of the message to be written to CSMT. If, in either case, there is no message, zero is entered.

The main subroutines of DFHACP are:

ABCSMTWT - Write to CSMT
ACPCALMG - Use DFHMGP to output a message
ACPCLPEP - Invoke DFHPEP
ACPFENTY - Identify message for terminal
TERMERR  - Terminal error.
DFHAICBP
Entry points:

DFHAICB

Called by:

User application program

Description:

The application interface control block program acts both as a control block and, for compatibility with early releases of CICS/VS, as executable code. DFHAICBP provides addressability between application programs and CICS entry points, namely those of the EXEC interface and the common programming interface. DFHAICBP is link-edited with the EXEC interface programs (DFHEIP and DFHEIPA), and the common programming interface program (DFHCPI) to form the application interface program (DFHAIP) load module.

DFHALP
Entry points:

DFHALPNA

Called by:

DFHCRQ, DFHCRS, DFHICP, DFHTPQ, DFHTPR, DFHTPS, DFHZATI, DFHZISP, DFHZNAC, DFHZTSP

Description:

The terminal allocation program contains the logic to allocate TCTTE resources to requesting transactions. The request operates in a multiple exchange between the requesting transaction and terminal control. DFHALP passes a SCHEDULE request to terminal control as an ATI terminal control, then responds with an AVAIL command. The requests are represented by AIDs (AID chain manipulations being performed by calls to DFHALP). For LU6.2, DFHALP issues a terminal control allocate mode name macro.

DFHAMP
Entry points:

DFHAMPNA

Called by:

DFHEIP, DFHSII1

Description:

The allocation management program is invoked by the CEDA transaction. It analyzes commands and calls the definition file management program, DFHDMP, to process changes to records in the CSD. For the INSTALL command, DFHAMP also calls program manager, transaction manager, and DFHSPP. DFHPUP is called to convert data between address list format and the CSD record format.

DFHAPJC
Entry points:

DFHAPJCN

Called by:

User

Description:

The AP domain journal control gate service module handles WRITE_JOURNAL_DATA calls made by the user exit’s XPI. It gets a TCA if the task doesn’t currently have one, and also a JCA. If the task already has a JCA, this is stacked. It then copies the parameter list passed in the domain call, to the JCA, and then issues one of four journal writes, depending on the request. Finally the return code from the JC write is copied into the domain parameter list, and the JCA and TCA are released if they were obtained by DFHAPJC.

DFHAPSIP
Entry points:

DFHSIPNA

Called by:

DFHAPDM

Description:

The main AP domain initialization program provides DFHWTO support and common subroutines used by DFHSIA1 through DFHSIJ1. In sequence, DFHAPSIP performs the following functions:

The main subroutines of DFHAPSIP are:

CHKRLVLR - Check release level
OVERLSUP - Overlay supervisor
SIGETCOR - Storage allocation
SILOADR  - Program loader
SIPCONS  - Console WRITE.
DFHAPST
Entry points:

DFHAPST

Called by:

DFHEIP, DFHSTST

Description:

The supervisory statistics program within the AP domain accepts a request for and then supervises the copying/resetting of statistics counters in the AP domain by calling the appropriate DFHSTxx modules to access the counters.

This module is called when:

Thus, this module is called only by the statistics domain or by DFHEIP.

This module provides two functions:

COLLECT_STATISTICS
collects statistics for all resources in the AP domain and calls the statistics domain to write them out to the SMF data set.
COLLECT_RESOURCE_STATS
collects statistics for the named resource type (optionally qualified by the resource identifier) and either copies them to a buffer available through the API, or causes them to be written to the SMF data set.
DFHAPTD
Entry points:

DFHAPTD

Called by:

DFHETD, DFHTDA, DFHTDB, ME domain

Description:

DFHAPTD handles DFHTDTDM macro requests; as such, it provides the transient data gate into the AP domain. DFHTDTDM macro requests are routed from DFHAPTD to DFHTDP using the corresponding DFHTD CTYPE requests.

DFHAPTI
Entry points:

DFHAPTI

Called by:

the timer domain to handle NOTIFY calls for the application domain.

Description:

The DFHAPTO module looks at the token passed by the timer domain and resumes either the DFHAPTI or DFHAPTIX module, as appropriate.

DFHAPTIM
Entry points:

DFHAPTIM

Called by:

runs as a system task attached by the DFHSII1 module.

Description:

The DFHAPTIM module is part of the interval control mechanism. When it first gets control, it suspends itself to wait for an interval control ICE to expire. Interval control uses the timer domain to handle time intervals. When the timer domain detects the expiry of an interval control related interval, it calls the DFHAPTI module, which in turn resumes the DFHAPTIM module. The DFHAPTIM module then makes an "expiry analysis" call to the DFHICP module, which processes any expired ICEs. On return, the DFHAPTIM module suspends itself again to wait for the next ICE to expire.

DFHAPTIX
Entry points:

DFHAPTIX

Called by:

runs as a system task attached by the DFHSII1 module.

Description:

The DFHAPTIX module is part of the interval control mechanism. When it first gets control, it tells the timer domain that it wants to be told every time it is midnight. It then suspends itself to wait for the next midnight. When that occurs, the timer domain calls the DFHAPTI module, which resumes the DFHAPTIX module, which in turn calls the DFHICP module to do midnight processing.

DFHASV
Entry points:

DFHASVNA

Called by:

DFHCSVC

Description:

DFHASV is one of the modules that run under the CICS type 3 SVC. On entry to DFHASV, register 0 contains one of the following request codes:

  0 - Paging request
  8 - SRB termination
  9 - HPO initialization
 24 - Monitoring services
 64 - Authorize general purpose subtask TCB
 80 - Issue SDUMP
136 - Bind AP domain.
DFHBSIB3
Entry points:

DFHBSIB3

Called by:

DFHTBSxx

Description:

DFHBSIB3 adds BMS 3270 support to a TCT table entry.

DFHBSIZ1
Entry points:

DFHBSIZ1

Called by:

DFHTBSxx

Description:

DFHBSIZ1 adds SCS support to a TCT table entry.

DFHBSIZ3
Entry points:

DFHBSIZ3

Called by:

DFHTBSxx

Description:

DFHBSIZ3 adds DFHZCP 3270 support to a TCT table entry.

DFHBSMIR
Entry points:

DFHBSMIR

Called by:

DFHTBSxx

Description:

DFHBSMIR builds a TCT table entry for a session.

DFHBSMPP
Entry points:

DFHBSMPP

Called by:

DFHTBSxx

Description:

DFHBSMPP builds a TCT table entry for a pipeline pool entry.

DFHBSM61
Entry points:

DFHBSM61

Called by:

DFHTBSxx

Description:

DFHBSM61 builds sessions for an LU6.2 mode group.

DFHBSM62
Entry points:

DFHBSM62

Called by:

DFHTBSxx

Description:

DFHBSM62 builds the mode entry for an LU6.2 mode group.

DFHBSS
Entry points:

DFHBSS

Called by:

DFHTBSxx

Description:

DFHBSS adds a new connection (system entry) to a CICS system.

DFHBSSA
Entry points:

DFHBSSA

Called by:

DFHTBSxx

Description:

DFHBSSA initializes DFHKCP support in a new TCT system entry.

DFHBSSF
Entry points:

DFHBSSF

Called by:

DFHTBSxx

Description:

DFHBSSF initializes the statistics counters in a new TCT system entry.

DFHBSSS
Entry points:

DFHBSSS

Called by:

DFHTBSxx

Description:

DFHBSSS builds security support for a new TCT system entry.

DFHBSSZ
Entry points:

DFHBSSZ

Called by:

DFHTBSxx

Description:

DFHBSSZ builds VTAM interface support for a new TCT system entry.

DFHBSSZB
Entry points:

DFHBSSZB

Called by:

DFHTBSxx

Description:

DFHBSSZB adds a new batch interregion connection to a CICS system.

DFHBSSZG
Entry points:

DFHBSSZG

Called by:

DFHTBSxx

Description:

DFHBSSZG adds a new advanced program-to-program communication (APPC) single-session connection to a CICS system.

DFHBSSZI
Entry points:

DFHBSSZI

Called by:

DFHTBSxx

Description:

DFHBSSZI adds an indirect terminal control system table entry to a CICS system.

DFHBSSZL
Entry points:

DFHBSSZL

Called by:

DFHTBSxx

Description:

DFHBSSZL adds a local terminal control system table entry to a CICS system.

DFHBSSZM
Entry points:

DFHBSSZM

Called by:

DFHTBSxx

Description:

DFHBSSZM introduces a new connection (system) to ZCP.

DFHBSSZP
Entry points:

DFHBSSZP

Called by:

DFHTBSxx

Description:

DFHBSSZP builds an advanced program-to-program communication (APPC) parallel-session connection to a CICS system.

DFHBSSZR
Entry points:

DFHBSSZR

Called by:

DFHTBSxx

Description:

DFHBSSZR builds an MRO session entry.

DFHBSSZS
Entry points:

DFHBSSZS

Called by:

DFHTBSxx

Description:

DFHBSSZS builds an advanced program-to-program communication (APPC) session entry.

DFHBSSZ6
Entry points:

DFHBSSZ6

Called by:

DFHTBSxx

Description:

DFHBSSZ6 builds an LU6.1 connection entry.

DFHBST
Entry points:

DFHBST

Called by:

DFHTBSxx

Description:

DFHBST performs TCTTE initialization common to terminals, pipeline pool entries, and sessions for IRC and ISC.

DFHBSTB
Entry points:

DFHBSTB

Called by:

DFHTBSxx

Description:

DFHBSTB adds support for BMS to a new TCT terminal or session entry.

DFHBSTBL
Entry points:

DFHBSTBL

Called by:

DFHTBSxx

Description:

DFHBSTBL adds support for logical device components (LDCs).

DFHBSTB3
Entry points:

DFHBSTB3

Called by:

DFHTBSxx

Description:

DFHBSTB3 adds partition support to a new TCT terminal or session entry.

DFHBSTC
Entry points:

DFHBSTC

Called by:

DFHTBSxx

Description:

DFHBSTC performs those operations that are executed after the installation of a terminal.

DFHBSTD
Entry points:

DFHBSTD

Called by:

DFHTBSxx

Description:

DFHBSTD adds data interchange program (DFHDIP) support for a new TCT table entry.

DFHBSTE
Entry points:

DFHBSTE

Called by:

DFHTBSxx

Description:

DFHBSTE adds EXEC diagnostic facility (EDF) support for a new TCT table entry.

DFHBSTH
Entry points:

DFHBSTH

Called by:

DFHTBSxx

Description:

DFHBSTH initializes EXEC interface fields for a new TCT table entry.

DFHBSTI
Entry points:

DFHBSTI

Called by:

DFHTBSxx

Description:

DFHBSTI adds interval control program (DFHICP) support for a new TCT table entry.

DFHBSTM
Entry points:

DFHBSTM

Called by:

DFHTBSxx

Description:

DFHBSTM adds message generation program (DFHMGP) support for a new TCT table entry.

DFHBSTO
Entry points:

DFHBSTO

Called by:

DFHTBSxx

Description:

DFHBSTO is the spooler builder.

DFHBSTP3
Entry points:

DFHBSTP3

Called by:

DFHTBSxx

Description:

DFHBST adds 3270-copy support for a new TCT table entry.

DFHBSTS
Entry points:

DFHBSTS

Called by:

DFHTBSxx

Description:

DFHBSTS adds signon program (DFHSNP) support for a new TCT table entry.

DFHBSTT
Entry points:

DFHBSTT

Called by:

DFHTBSxx

Description:

DFHBSTT adds task control program (DFHKCP) support for a new TCT table entry.

DFHBSTZ
Entry points:

DFHBSTZ

Called by:

DFHTBSxx

Description:

DFHBSTZ builds a session or terminal resource.

DFHBSTZA
Entry points:

DFHBSTZA

Called by:

DFHTBSxx

Description:

DFHBSTZA adds DFHZCP activity scan support to a new TCT terminal or session entry.

DFHBSTZB
Entry points:

DFHBSTZB

Called by:

DFHTBSxx

Description:

DFHBSTZB appends or deletes a BIND image for a TCT terminal or session entry.

DFHBSTZC
Entry points:

DFHBSTZC

Called by:

DFHTBSxx

Description:

DFHBSTZC adds a single-session LU6.2 system as an advanced program-to-program communication (APPC) terminal.

DFHBSTZE
Entry points:

DFHBSTZE

Called by:

DFHTBSxx

Description:

DFHBSTZE sets error message writer fields for a new TCT table entry.

DFHBSTZH
Entry points:

DFHBSTZH

Called by:

DFHTBSxx

Description:

DFHBSTZH adds an interregion (IRC) batch session to a CICS system.

DFHBSTZL
Entry points:

DFHBSTZL

Called by:

DFHTBSxx

Description:

DFHBSTZL adds logical device code support to a new TCT terminal or session entry.

DFHBSTZO
Entry points:

DFHBSTZO

Called by:

DFHTBSxx

Description:

DFHBSTZO adds an MVS console to a CICS system.

DFHBSTZP
Entry points:

DFHBSTZP

Called by:

DFHTBSxx

Description:

DFHBSTZP adds a pipeline pool entry to a CICS system.

DFHBSTZR
Entry points:

DFHBSTZR

Called by:

DFHTBSxx

Description:

DFHBSTZR adds an interregion (IRC) session to a CICS system.

DFHBSTZS
Entry points:

DFHBSTZS

Called by:

DFHTBSxx

Description:

DFHBSTZS adds an advanced program-to-program communication (APPC) session to the terminal control program.

DFHBSTZV
Entry points:

DFHBSTZV

Called by:

DFHTBSxx

Description:

DFHBSTZV adds the parts of a terminal or session TCT table entry that are special to VTAM and IRC.

DFHBSTZZ
Entry points:

DFHBSTZZ

Called by:

DFHTBSxx

Description:

DFHBSTZZ adds a non-APPC session to the TCT. (APPC is advanced program-to-program communication.)

DFHBSTZ1
Entry points:

DFHBSTZ1

Called by:

DFHTBSxx

Description:

DFHBSTZ1 adds support for a remote terminal to a CICS system.

DFHBSTZ2
Entry points:

DFHBSTZ2

Called by:

DFHTBSxx

Description:

DFHBSTZ2 adds support for a remote advanced program-to-program communication (APPC) connection.

DFHBSTZ3
Entry points:

DFHBSTZ3

Called by:

DFHTBSxx

Description:

DFHBSTZ3 adds a 3270 to the TCT.

DFHBSXGS
Entry points:

DFHBSXGS

Called by:

DFHBSMIR, DFHZTSP

Description:

DFHBSXGS generates a unique session name for an LU6.2 TCTTE.

DFHBSZZ
Entry points:

DFHBSZZ

Called by:

DFHTBSxx

Description:

DFHBSZZ adds a terminal or session to the TCT.

DFHBSZZS
Entry points:

DFHBSZZS

Called by:

DFHTBSxx

Description:

DFHBSZZS adds a new session to LU6.2 support.

DFHBSZZV
Entry points:

DFHBSZZV

Called by:

DFHTBSxx

Description:

DFHBSZZV adds a VTAM terminal or session to the TCT.

DFHCAPB
Entry points:

DFHCAPNA

Called by:

DFHTCRP

Description:

DFHCAPB processes command analysis for VTAM terminal definitions contained in a load module table DFHRDTxx for TCT migration.

DFHCCNV
Entry points:

DFHCCNV

Called by:

DFHCHS, DFHMIRS

Description:

DFHCCNV provides conversion of user data from ASCII to EBCDIC and from EBCDIC to ASCII for function-shipped requests from CICS OS/2 users. It is called from either the LU2 remote server program DFHCHS or the mirror program DFHMIRS, for EXEC CICS requests and replies originating from the identified server or mirror. For any function-shipped request it is invoked twice, once on the inbound side and once on the outbound path. DFHCCNV is passed the EXEC CICS parameter list by its caller. On the request side, this occurs after DFHCHS or DFHMIRS has called transformer 2 but before DFHEIP is invoked. On the response side, this occurs after DFHEIP returns to DFHCHS or DFHMIRS but before transformer 3 is invoked. External reference is made to a pregenerated CICS OS/2 conversion table, DFHCNV.

DFHCMP
Entry points:

DFHCMPNA

Called by:

DFHETR

Description:

The CICS monitoring compatibility module is invoked by the old event monitoring point of EXEC CICS ENTER TRACEID to interface to the monitoring domain.

DFHCPY
Entry points:

DFHCPYNA

Called by:

DFHPRK

Description:

The 3270 copy program (transaction CSCY) causes data to be copied from screen to printer in a (VTAM) 3270 system. DFHCPY is invoked by DFHPRK (only if the 3270 has the copy feature) and issues a DFHTC TYPE=COPY macro to the printer. DFHCPY then initiates DFHRKB.

DFHCRC
Entry points:

DFHCRCNA

Called by:

MVS

Description:

The interregion abnormal exit module is a CICS module that contains an ESTAE exit to terminate interregion communication in abnormal conditions. DFHCRC issues a CLEAR request to the interregion SVC.

DFHCRNP
Entry points:

DFHCRNNA

Called by:

DFHCRSP, dispatcher

Description:

DFHCRNP, the connection manager (transaction CSNC), controls IRC connections. It establishes and breaks these connections and processes inbound requests to attach tasks (for example, mirror) to communicate with connected systems.

DFHCRQ
Entry points:

DFHCRQNA

Called by:

transaction CRSQ

Description:

The remote schedule page program is invoked periodically to delete requests to attach a transaction on a remotely owned terminal if those requests have been outstanding for more than the ATI purge delay interval.

DFHCRR
Entry points:

DFHCRRNA

Called by:

DFHCRNP

Description:

The interregion session recovery program performs session recovery on behalf of primary or secondary IRC sessions.

DFHCRS
Entry points:

DFHCRSNA

Called by:

transaction CRSR

Description:

The remote scheduler program builds and ships AIDs for automatic transaction initiation when the terminal is in a remote address space. It receives requests to schedule an AID shipped to it from a remote address space.

DFHCRSP
Entry points:

DFHCRSNA

Called by:

DFHEIP, DFHSIJ1

Description:

The interregion communication startup module can be invoked, either at system initialization or by a CEMT request, in order to make the CICS address space available for communication by other address spaces. DFHCRSP issues a logon request to the interregion communication SVC routine and attaches transaction CSNC (DFHCRNP).

DFHCRT
Entry points:

DFHCRTNA

Called by:

transaction CXRT

Description:

DFHCRT is the relay program used when a transaction attempts to allocate a conversation to a remote advanced program-to-program (APPC) terminal.

DFHCSA
Entry points:

DFHCSANA

Called by:

Not applicable

Description:

The DFHCSA module contains the common system area (CSA) and CSA optional features list, the queue control area (QCA) and, for HPO systems, the SRB interface control area.

DFHCSDUP
Entry points:

DFHCUCNA

Called by:

MVS

Description:

The CSD utility program is an offline program that provides services for the CSD. The utility command processor (DFHCUCP) validates commands and invokes the appropriate routine to execute the requested function. DFHCSDUP calls DFHDMP to access the CSD.

DFHCSSC
Entry points:

DFHCSSNA

Called by:

DFHSIJ1, DFHSNSN, DFHSUSN, DFHTCRP, DFHZCUT

Description:

DFHCSSC, the signon time-out program, is invoked as a system task by DFHSIJ1 and DFHTCRP to perform XRF takeover sign-off time-out processing. It is invoked elsewhere as the CSSC transaction for time-out processing of the following:

The CSSC transaction is scheduled when task termination determines that a time-out is necessary. When DFHCSSC is executed, it examines all signed-on terminals, all entries in the SNT managed by DFHTMP, and all entries in the LUITs. It signs off or deletes expired entries as appropriate, and then reschedules itself to perform later time-outs if required.

DFHCSVC
Entry points:

DFHCSVC

Called by:

MVS

Description:

This module is a type 3 SVC that passes control to the various required routines, dependent on the parameter passed to it. On a first request for a particular function, it loads the required module and puts its address in the AFCB and then branches to that code. Further calls result in the address in the AFCB being branched to.

Returns to:

Type 3 SVC

DFHCUCAB
Entry points:

DFHCUCA

Called by:

DFHCAPB

Description:

The resource definition online command analyzer interprets a VTAM resource definition in command form and produces a parameter list.

DFHCUCB
Entry points:

DFHCUCB

Called by:

DFHCUCP

Description:

The resource definition online command builder receives commands and transforms them to a format for use by the command processors.

DFHCUCCB
Entry points:

DFHCUCC

Called by:

DFHCAPB

Description:

This program extracts a single entry from a loaded RDT table containing VTAM resource definitions for TCT migration.

DFHCUCDB
Entry points:

DFHCUCD

Called by:

DFHCAPB

Description:

The resource definition online command default values program modifies the parameter list produced by DFHCUCAB by inserting the default values.

DFHCWTO
Entry points:

DFHCWTNA

Called by:

CWTO transaction

Description:

The console write-to-operator module is a CICS-supplied transaction that allows an operator to send a message to the console operator. DFHCWTO issues SVC 35 (WTO) to pass the message to the operator’s console.

DFHDBAT
Entry points:

AENTRY

Called by:

DFHERM, IMS database resource adapter (DRA).

Description:

This program provides a mapping between the external architectures of CICS (the resource manager interface (RMI) and of DBCTL (the database resource adapter (DRA)). Both are independently defined and different. DFHDBAT is part of the support for the CICS-DBCTL interface and runs in an application program environment. DFHDBAT is invoked by a DFHRMCAL request through the CICS RMI. The RMI supplies DFHDBAT with a parameter list from which DFHDBAT constructs the DRA INIT, DRA TERM, and DRA THREAD parameter lists. It must also transform the DRA parameter list back, after a DL/I call to the format expected by CICS. Thus, DFHDBAT is also referred to as the CICS-DBCTL adapter-transformer.

DFHDBCON
Entry points:

DFHDBCON

Called by:

DFHDBME

Description:

This program issues a CICS-DBCTL interface connection request to the CICS-DBCTL adapter-transformer, DFHDBAT. DFHDBCON is part of the support for the CICS-DBCTL interface and runs in an application program environment.

DFHDBCR
Entry points:

DFHDBCR

Called by:

DFHSII1 via attach

Description:

DFHDBCR is the CICS/DBCTL XRF tracking program. DFHDBCR runs in an alternate CICS system during the tracking phase. DFHDBCR receives messages from the active CICS system regarding the state of the connection to DBCTL, and drives the XXDFB and XXDTO exits and takes appropriate action.

DFHDBCT
Entry points:

DFHDBCT

Called by:

DFHDBCTX, DFHDBAT

Description:

This program processes any elements placed on the CICS-DBCTL control work element (CWE) chain. DFHDBCT is part of the support for the CICS-DBCTL interface and runs in an application program environment. It is invoked when the CICS-DBCTL connection program, DFHDBCON, attempts to connect to DBCTL. The program then issues a wait. The DFHDBCT program is posted whenever an element is placed on the CWE chain.

DFHDBCTX
Entry points:

DFHDBCTX

Called by:

DFHDBAT

Description:

This program notifies the CICS-DBCTL control transaction of changes in the state of the CICS-DBCTL interface. DFHDBCTX is part of the support for the CICS-DBCTL interface. It does not run in a CICS environment and thus does not use any CICS services. This exit is invoked by the DBCTL adapter on behalf of the DBCTL DRA.

DFHDBDI
Entry points:

DFHDBDI

Called by:

DFHDBCT

Description:

This program disables the CICS-DBCTL adapter program and cleans up the storage used by the CICS-DBCTL interface programs. DFHDBDI is part of the support for the CICS-DBCTL interface and runs in an application program environment. DFHDBDI is invoked by the CICS/VS DBCTL control program, DFHDBCT, just before it terminates.

DFHDBDSC
Entry points:

DFHDBDSC

Called by:

DFHDBCT, DFHDBME

Description:

This program issues a CICS-DBCTL interface disconnection request to the CICS-DBCTL adapter-transformer. DFHDBDSC is part of the support for the CICS-DBCTL interface and runs in an application program environment.

DFHDBIQ
Entry points:

DFHDBIQ

Called by:

CDBI transaction

Description:

This program is the CDBI CICS-supplied transaction. Its function is to inquire on the current status of the CICS-DBCTL interface. DFHDBIQ is part of the support for the CICS-DBCTL interface.

DFHDBME
Entry points:

DFHDBME

Called by:

CDBC transaction

Description:

This program is the CDBC CICS-supplied transaction. Its function is to provide a front end for making certain changes to the status of the CICS-DBCTL interface. DFHDBME is part of the support for the CICS-DBCTL interface.

DFHDBMOX
Entry points:

DFHDBMOX

Called by:

DFHDBAT

Description:

This program outputs monitoring information supplied by DBCTL to the monitoring domain, using monitoring domain services. The information is supplied by DBCTL when it has processed a PSB schedule request and a thread termination request. This exit forms part of the support for the CICS-DBCTL interface. It runs in a CICS application environment. This exit is invoked by the CICS-DBCTL adapter.

DFHDBP
Entry points:

DFHDBPNA

Called by:

DFHAPRC

Description:

This program invokes DWE processors when a UOW backs out.

DFHDBREX
Entry points:

DFHDBREX

Called by:

DFHDBAT

Description:

This program is the CICS-DBCTL resume exit. The resume exit is driven whenever the adapter or the DRA requires to resume a task which they have suspended. This exit forms part of the support for the CICS-DBCTL interface. It does not run in a CICS environment and thus cannot use CICS services.

DFHDBSPX
Entry points:

DFHDBSPX

Called by:

DFHDBAT

Description:

This program is the CICS-DBCTL suspend exit. The suspend exit is driven whenever the adapter or the DRA requires to suspend a task. DFHDBSPX forms part of the support for the CICS-DBCTL interface. It runs in a CICS application environment.

DFHDBSSX
Entry points:

DFHDBSSX

Called by:

DFHDBAT

Description:

DFHDBSSX is the CICS/DBCTL status exit. In the event of a DRA thread failure, DFHDBSSX is called to transfer ownership of PCB storage to CICS. When the task ends, DFHDBSSX is called to release this storage.

DFHDBSTX
Entry points:

DFHDBSTX

Called by:

DFHDBAT

Description:

This program is the CICS-DBCTL statistics exit. The exit outputs CICS-DBCTL session termination statistics to the statistics domain. DFHDBSTX forms part of the support for the CICS-DBCTL interface. It runs in a CICS application environment, but it can also be invoked during CICS orderly termination. This exit is invoked by the CICS-DBCTL adapter.

DFHDBTOX
Entry points:

DFHDBTOX

Called by:

DFHDBAT

Description:

This program is the CICS-DBCTL token exit. The function of this exit is to provide the CICS-DBCTL adapter with task tokens for tasks that have not been through the DBCTL call processor ,DFHDLIDP, or the DBCTL connection program, DFHDBCON, or the DBCTL disconnection program, DFHDBDSC, where task tokens are usually generated. DFHDBTOX forms part of the support for the CICS-DBCTL interface. It runs in a CICS application environment. This exit is invoked by the CICS-DBCTL adapter.

DFHDBUEX
Entry points:

DFHDBUEX

Called by:

DFHDBCT, DFHDBDSC

Description:

DFHDBUEX is the user-replaceable CICS-DBCTL exit program. It is invoked whenever CICS successfully connects to DBCTL and whenever CICS disconnects from DBCTL. DFHDBUEX forms part of the support for the CICS-DBCTL interface. It runs in a CICS application environment.

DFHDCP
Entry points:

DFHDCPNA

Called by:

DFHDC macro, DFHEDC

Description:

DFHDCP translates DFHDC macro requests for a transaction dump to DU domain TRANSACTION_DUMP calls.

DFHDES
Entry points:

DFHDESNA

Called by:

DFHZEV1, DFHZEV2, DFHZOPN

Description:

DFHDES performs data encryption and bind-time security.

DFHDIP
Entry points:

DFHDIPNA

Called by:

DFHACP, DFHDI macro, DFHEDI, DFHKCP, DFHMCP, DFHTOM, DFHZEMW, DFHZRSP, DFHZSUP

Description:

The data interchange program acts as a function manager when transactions want to communicate with batch devices using SNA support. DFHDIP builds and receives FMHs, which control the data set selection and function currently being performed by the batch device.

The main subroutines of DFHDIP are:

DESTCHEK - Destination change
D1ABORTE - Abort
D1CONRTE - Continue
D1ENDRTE - End
D1INARTE - Transaction attach
D1INPRTE - Input
D1NOTRTE - Note
D1QUERTE - Query.
DFHDLI
Entry points:

DFHDLINA

Called by:

User application, DFHMIRS, DFHSPP

Description:

DFHDLI is the DL/I call router program. It decides which call processor is to be used for the request: DBCTL or REMOTE. It then invokes the appropriate processor: DFHDLIDP or DFHDLIRP.

DFHDLIAI
Entry points:

ASMTDLI, CBLTDLI, PLITDLI

Called by:

User application using DL/I CALL interface

Description:

This module is used by the CICS-DL/I interface. It is link-edited with the application program to provide D/I communication between the application and the CICS-DL/I interface routine DFHDLI. Calls for DL/I to the ASMTDLI, CBLTDLI, or PLITDLI entry points are resolved by this processor.

DFHDLIDP
Entry points:

DFHDLIDP

Called by:

DFHDLI

Description:

DFHDLIDP is the DBCTL call processor. It services DL/I calls for PSBs that are owned by a DBCTL subsystem, and invokes the DL/I task-related user exit (adapter) to interface with DBCTL.

DFHDLIRP
Entry points:

DFHDLIRP

Called by:

DFHDLI

Description:

DFHDLIRP is the remote call processor. It services DL/I calls that are function-shipped to another CICS system.

DFHDMP
Entry points:

DFHDMPNA

Called by:

DFHAMP, DFHCSDUP

Description:

The definition file management program handles physical changes to the CSD. The main processes in DFHDMP are:

BUILDKWA (DM16)  - Build key work area
CONNECT (DM01)   - CONNECT
CREATSET (DM11)  - Create SET
DELETE (DM05)    - DELETE
DISCONN (DM02)   - DISCONNECT
ENDBRO (DM10)    - End BROWSE
ERASESET (DM12)  - Delete SET
GETNEXT (DM09)   - Get next record
LOCK (DM06)      - LOCK
QUERYSET (DM13)  - QUERYSET
READ (DM04)      - Read CSD control records
RELSEKWA (DM17)  - Free key work area
SETBRO (DM08)    - Set browse
UNLOCK (DM06)    - UNLOCK
WRITE (DM03)     - WRITE.
DFHDRPG
Entry points:

DFHDRPNA

Called by:

DFHEIP

Description:

DFHDRPG is the EXEC interface processor for EXEC DLI commands for database sharing. It receives the parameters of the command and from them builds a list that is appropriate to call DFHDRPE, the program request handler. On return from DFHDRPE, the status code in the PCB is examined. For some codes, an MVS abend is executed; the other codes are passed back to the application program.

DFHDSBA$, DFHDSB1$
Entry points:

DFHDSBNA

Called by:

DFHPBP

Description:

The data stream build program produces the final device-dependent data stream for each page of BMS output. It is invoked only for processing data streams that are not in 3270 format. DFHDSB removes blanks from the ends of lines, converts logical new-line characters into the device-dependent equivalents (adding idle characters where necessary), and inserts horizontal and vertical tab characters if supported.

DFHDU640
Entry points:

DFHDUPNA

Called by:

MVS

Description:

The dump utility program formats and prints transaction dumps from a CICS transaction dump data set (DFHDMPA or DFHDMPB). The transaction dumps are written to the data set by the dump domain. They contain information about the state of a particular transaction at the time of a transaction abend or user-requested dump.

DFHDXACH
Entry points:

DFHDXACH

Called by:

DFHDBCR, DFHDBCT

Description:

DFHDXACH is a stub that is also MVS-attached, and which branches to an input address.

DFHDXSTM
Entry points:

DFHDXSTM

Called by:

DFHDBCT, DFHDBCR

Description:

DFHDXSTM is used to attach, detach, and inquire on MVS subtasks attached by DFHDBCR and DFHDBCT.

DFHDYP
Entry points:

DFHDYP

Called by:

DFHAPRT

Description:

This is the system-provided (default) dynamic routing program invoked from the CICS relay program (DFHAPRT) when a remote transaction is defined as being dynamic.

DFHEAI
Entry points:

DFHEI1

Called by:

User application

Description:

This is a stub that is link-edited with an assembler-language application program to provide communication with DFHEIP. The command-language translator turns each EXEC CICS command into a call statement. The external entry point invoked by the call is resolved to an entry point in this stub. The address of the entry point in DFHEIP (DFHEIPCN) is found through a chain of system and CICS control blocks.

Start of changeThe DFHEAI stub must be included at the beginning of the program in the output from the link edit. To achieve this, ORDER and INCLUDE statements for DFHEAI must be in the link-edit step of your JCL. When you use the CICS-supplied assembler procedure DFHEITAL in the SDFHPROC library to translate, assemble, and link-edit application programs written in assembler language, the COPYLINK step of this procedure copies SDFHMAC(DFHEILIA). DFHEILIA contains the following statements that must be included:End of change

Start of change   ORDER DFHEAI
   INCLUDE SYSLIB(DFHEAI)End of change

Start of changeThe statements are put into a temporary file that is concatenated before the assembled application program in the LKED step of the procedure.End of change

DFHEAI0
Entry points:

DFHEAI0

Called by:

User application

Description:

This is a stub that is link-edited with an assembler-language application program to provide communication with DFHEIPA, part of the EXEC interface layer, for the prolog and epilog calls generated by the command-language translator in the application program. The external entry point invoked by the calls is resolved to an entry point in this stub. The address of the entry point in DFHEIPA (DFHEIPAN) is found using a chain of system and CICS control blocks.

DFHEAP1$
Entry points:

PREPROC

Description:

The assembler-language translator module performs the following functions:

DFHEBF
Entry points:

DFHEBFNA

Called by:

DFHEIP

Description:

DFHEBF is the EXEC interface processor for the field edit built-in function, DEEDIT.

DFHEBU
Entry points:

DFHEBUNA

Called by:

DFHETL, DFHETC

Description:

The EXEC function management header (FMH) construction module is called by DFHETC when a SEND or CONVERSE command is being processed, and ATTACH function management headers have to be built and concatenated ahead of user data.

DFHECI
Entry points:

DFHEI1

Called by:

User application

Description:

This is a link-edit stub similar to DFHEAI, except that it is used for COBOL application programs.

DFHECID
Entry points:

DFHEIN01

Called by:

DFHECIP

Description:

The command interpreter module analyzes CECI commands, and manages its displays. It uses the EXEC interface to invoke other CICS functions.

DFHECIP
Entry points:

DFHEIN00

Called by:

CECI transaction

Description:

The command interpreter program performs preliminary validation and initialization for the CECI transaction, and links to DFHECID.

DFHECP1$
Entry points:

PREPROC

Description:

The COBOL translator module performs the following functions:

DFHEDAD
Entry points:

DFHESP01

Called by:

DFHEDAP

Description:

The resource definition online (RDO) transactions module analyzes the commands, and manages the displays for CEDA, CEDB, and CEDC. It uses the EXEC interface.

DFHEDAP
Entry points:

DFHESP00

Called by:

CEDA, CEDB, CEDC transaction

Description:

The resource definition online (RDO) transactions program performs preliminary validation and initialization for CEDA, and links to DFHEDAD.

Returns to:

DFHEIP

DFHEDC
Entry points:

DFHEDCNA

Called by:

DFHEIP

Description:

DFHEDC is the EXEC interface processor for dump commands.

DFHEDFBR
Entry points:

DFHEDFBR

Called by:

CEBR transaction, DFHEDFD

Description:

The temporary-storage browse transaction browses, copies, or deletes entries in a temporary-storage queue. It interprets commands and PF key actions.

DFHEDFD
Entry points:

DFHEDFD

Called by:

DFHEDFP

Description:

The EDF display program is invoked from DFHEDFP to analyze and display the current status of the user program. DFHEDFD stores control information about a temporary-storage message queue and uses BMS to format the display screen. DFHEDFD interfaces with other CICS control programs using the EXEC interface.

DFHEDFM
Description:

The EDF map set contains BMS maps used by DFHEDFD to format the EDF display.

DFHEDFP
Entry points:

DFHEDFNA

Called by:

transaction CEDF

Description:

The EDF main program is the control program for EDF. DFHEDFP can be invoked in one of two ways:

  1. Directly from the EDF display terminal by entering the CEDF transaction identification
  2. By pressing the user-defined PF key.

DFHEDFP is also attached by DFHEDFX as the main program of the EDF task.

DFHEDFR
Entry points:

DFHEDFNA

Called by:

Not applicable

Description:

The EDF response table contains a description of the exception responses for each EXEC command and the abend codes associated with error responses. DFHEDFR is used by DFHEDFD to interpret the responses obtained from an EXEC command.

DFHEDFX
Entry points:

DFHEDFNA

Called by:

DFHACP, DFHEIP, program manager

Description:

The EDF task switch program is invoked from DFHACP, DFHEIP, or program manager when a program is running in debug mode. DFHEDFX suspends the user task and attaches the debugging task, passing it information about the user task in the TWA of the debugging task.

DFHEDI
Entry points:

DFHEDINA

Called by:

DFHEIP

Description:

DFHEDI is the EXEC interface processor for data interchange commands.

DFHEDP
Entry points:

DFHEDPNA

Called by:

DFHERM

Description:

DFHEDP converts command-level DL/I statements into a call parameter list acceptable to DL/I. In addition, it provides 31-bit application support by moving segment I/O areas above and below the 16MB line as required.

DFHEDP1$
Entry points:

PREPROC

Description:

The C translator module performs the following functions:

DFHEEI
Entry points:

DFHEEINA

Called by:

DFHEIP

Description:

DFHEEI is the EXEC interface processor for DFHEIP ADDRESS, ASSIGN, PUSH, POP, and HANDLE commands.

DFHEEX
Entry points:

DFHEEXNA

Called by:

DFHETC

Description:

The EXEC function management header (FMH) extraction module is called by DFHETC when a RECEIVE or CONVERSE command is being processed, and when data has to be extracted from ATTACH function management headers.

DFHEFRM
Entry points:

DFHEFRM

Called by:

DFHDBP, DFHSPP

Description:

DFHEFRM is the EXEC interface file control syncpoint processor. At syncpoint commit or rollback time, DFHEFRM deletes the FFLE entries that were created by DFHFCEI for the task.

DFHEGL
Entry points:

DFHEGLNA

Called by:

DFHEIP

Description:

DFHEGL is the EXEC interface processor for unmapped LU6.2 commands.

DFHEIIC
Entry points:

DFHEICNA

Called by:

DFHEIP

Description:

DFHEIIC is the EXEC interface processor for interval control commands.

DFHEIDTI
Entry points:

DFHEIDTI

Called by:

DFHEIP

Description:

DFHEIDTI is the EXEC interface processor for ASKTIME and FORMATTIME. DFHEIDTI updates the time and date fields in the EIB and certain time fields in the CSA, and returns the current time, or date, to the application.

DFHEIP
Entry points:

DFHEIPNA

Called by:

application programs

Description:

DFHEIP is the main EXEC interface module. See EXEC interface for further information.

DFHEIPA
Entry points:

DFHEIPAN

Called by:

DFHEAI0

Description:

DFHEIPA is part of the EXEC interface layer. It acquires and partially initializes the DFHEISTG dynamic storage when called from the DFHEIENT macro in an assembler-language application program. It frees this storage when called from the DFHEIRET macro.

DFHEIFC
Entry points:

DFHEIFC

Called by:

DFHEIP

Description:

DFHEIFC is the file control EXEC interface module, providing an interface between DFHEIP and file control. It locates the AFCTE, and performs the security check. For a remote file, DFHEIFC passes the request to a transformer, which then ships the request to the other system. For a local file, DFHEIFC converts the EXEC argument list to an FCFR parameter list (as defined by the DFHFCFRA DSECT) and calls DFHFCFR, the file control file request handler. After the request completes, DFHEIFC builds return code information in the EIB.

DFHEISR
Entry points:

DFHEISR

Called by:

DFHEDI, DFHEGL, DFHEIQMS, DFHEMS, DFHEOP, DFHETC, DFHETL, DFHTDB, DFHXFFC, DFHXFX

Description:

DFHEISR obtains buffers and copies data for the calling EXEC interface modules, at the location and in the storage key required by the application.

DFHEJC
Entry points:

DFHEJCNA

Called by:

DFHEIP

Description:

DFHEJC is the EXEC interface processor for journaling commands.

DFHEKC
Entry points:

DFHEKCNA

Called by:

DFHEIP

Description:

DFHEKC is the EXEC interface processor for task control commands.

DFHELII
Entry points:

DFHEI1

Called by:

User application

Description:

This is a link-edit stub similar to DFHEAI, except that it is used for C application programs.

DFHEMS
Entry points:

DFHEMSNA

Called by:

DFHEIP

Description:

DFHEMS is the EXEC interface processor for BMS commands.

DFHEMTA
Entry points:

DFHEMT00

Called by:

User application

Description:

The master terminal programmed interface program is a special version of DFHEMTP that a user application can link to for master terminal services.

DFHEMTD
Entry points:

DFHEMT01

Called by:

DFHEMTA, DFHEMTP, DFHEOTP, DFHESTP

Description:

The master terminal module analyzes the commands, and manages displays for CEMT, CEOT, and CEST transactions. It uses the EXEC interface.

DFHEMTP
Entry points:

DFHEMT00

Called by:

CEMT transaction

Description:

The master terminal program performs preliminary validation and initialization for the CEMT transaction, and links to DFHEMTD.

DFHEOTP
Entry points:

DFHEMT00

Called by:

CEOT transaction

Description:

The master terminal program performs preliminary validation and initialization for the CEOT transaction, and links to DFHEMTD.

DFHEPC
Entry points:

DFHEPCNA

Called by:

DFHEIP

Description:

DFHEPC is the EXEC interface processor for program control commands.

DFHEPI
Entry points:

DFHEI1

Called by:

User application

Description:

This is a link-edit stub similar to DFHEAI, except that it is used for PL/I application programs.

DFHEPP1$
Entry points:

PREPROC

Description:

The PL/I translator module performs the following functions:

DFHEPS
Entry points:

DFHEPSNA

Called by:

DFHEIP

Description:

DFHEPS is the link between DFHEIP and the JES interface program, DFHPSP.

DFHERM
Entry points:

DFHERMNA

Called by:

DFHEIP

Description:

DFHERM is called by DFHEIP on behalf of the other components of CICS to manage the connection between CICS and non-CICS products.

DFHESC
Entry points:

DFHESCNA

Called by:

DFHEIP

Description:

DFHESC is the EXEC interface processor for storage control commands.

DFHEISP
Entry points:

DFHESPNA

Called by:

DFHEIP

Description:

DFHEISP is the EXEC interface processor for syncpoint commands.

DFHESTP
Entry points:

DFHEMT00

Called by:

CEST transaction

Description:

The master terminal program performs preliminary validation and initialization for the CEST transaction, and links to DFHEMTD.

DFHETC
Entry points:

DFHETCNA

Called by:

DFHEIP

Description:

DFHETC is the EXEC interface processor for terminal control commands.

DFHETD
Entry points:

DFHETDNA

Called by:

DFHEIP

Description:

DFHETD is the EXEC interface processor for transient data commands. The EXEC requests are routed from DFHETD to DFHTDP using the corresponding DFHTD CTYPE requests.

DFHETL
Entry points:

DFHETLNA

Called by:

DFHETC

Description:

DFHETL is the EXEC interface processor for mapped LU6.2 commands.

DFHETR
Entry points:

DFHETRNA

Called by:

DFHEIP

Description:

DFHETR is the EXEC interface processor for trace commands.

DFHETS
Entry points:

DFHETSNA

Called by:

DFHEIP

Description:

DFHETS is the EXEC interface processor for temporary-storage commands.

DFHEXI
Entry points:

DFHEXINA

Called by:

DFHZARQ

Description:

The exceptional input program is invoked from DFHZCP when unexpected input is received from a VTAM 3270 terminal that has a task attached. DFHEXI checks whether the input is the result of a 3270 print function key being pressed; if so, DFHEXI issues a DFHTC TYPE=PRINT macro, and then unlocks the keyboard; in any case, DFHEXI then passes control back to DFHZCP.

DFHFCAT
Entry points:

DFHFCAT

Called by:

DFHFCDN, DFHFCN

Description:

DFHFCAT processes inquire and update requests on the state of the backup while open (BWO) attributes in the ICF catalog for VSAM data sets, and inquires on the quiesce state in the ICF catalog.

DFHFCBD
Entry points:

DFHFCBD

Called by:

DFHFCFR

Description:

DFHFCBD handles BDAM file control requests except for OPEN and CLOSE.

DFHFCDN
Entry points:

DFHFCDN

Called by:

DFHAMFC, DFHAMPFI, DFHEIQDN, DFHEIQDS, DFHFCLF, DFHFCMT, DFHFCN, DFHFCRC, DFHFCRO, DFHFCRD, DFHFCRP

Description:

DFHFCDN builds data set name blocks at cold start or in response to CEDA requests. It also examines or modifies data set name blocks in response to EXEC CICS INQUIRE or EXEC CICS SET commands.

DFHFCDTS
Entry points:

DFHFCDTS

Called by:

DFHFCFR

Description:

DFHFCDTS processes file control requests to access data table records for READ-ONLY requests against CICS-maintained tables, and for all record requests against user-maintained tables. It calls data table services to retrieve or modify table records, calls DFHFCVS to retrieve data from the VSAM source data set if it is not in the table, and calls DFHFCDTX to function ship requests that cannot be satisfied by sharing.

DFHFCFR
Entry points:

DFHFCFR

Called by:

DFHAPLI, DFHAPSM, DFHDTLX, DFHDMPCA, DFHEIFC, DFHERM, DFHFCDTS, DFHFCFR, DFHFCFS, DFHFCRC, DFHFCRP, DFHUEH

Description:

DFHFCFR is the central module in the file control component. It handles file control requests issued by DFHFCEI (requests from application programs), or by other CICS modules (internal file control requests). DFHFCFR ensures that the file is both opened and enabled, acquires an FRTE as necessary, performs request validity checking, and then routes the request to the appropriate access-method dependent module (DFHFCBD for BDAM, DFHFCVS for non-RLS VSAM and also for update or browse requests against a CICS-maintained data table, DFHFCRS for RLS VSAM, and DFHFCDTS for all other data table requests).

DFHFCFS
Entry points:

DFHFCFS

Called by:

DFHAMFC, DFHDMPCA, DFHDMRM, DFHDTLX, DFHEIQDS, DFHFCDTS, DFHFCFR, DFHFCLF, DFHFCQU, DFHFCRC, DFHFCRD, DFHFCRU, DFHFCSD, DFHFCU, DFHFCVS

Description:

DFHFCFS changes the state of a file. It invokes DFHFCN to open, or close, files.

DFHFCL
Entry points:

DFHFCLNA

Called by:

DFHFCN

Description:

DFHFCL is a file control program that is link-edited into DFHFCFS. DFHFCL builds and deletes VSAM LSR pools. It is called by DFHFCN with a parameter list that specifies the pool number (1 through 8) and the action to be taken (build or delete).

DFHFCM
Entry points:

DFHFCMNA

Called by:

DFHFCFS

Description:

DFHFCM is a file control program that is link-edited into DFHFCFS. When records are added via a VSAM path, DFHFCM is called to open the base associated with the path.

DFHFCMT
Entry points:

DFHFCMT

Called by:

DFHAFMT, DFHAMFC, DFHAMPFI, DFHDMPCA, DFHEDFX, DFHEIQDS

Description:

DFHFCMT builds file control table entries in response to CEDA commands. It also examines or modifies FCT entries in response to EXEC CICS INQUIRE or EXEC CICS SET commands.

DFHFCN
Entry points:

DFHFCNNA

Called by:

DFHFCFS

Description:

DFHFCN is a file control program that is link-edited into DFHFCFS. DFHFCN opens and closes files. If a file has not been allocated, DFHFCN allocates it, and frees it on closure.

DFHFCRL
Entry points:

DFHFCRL

Called by:

DFHAMFC

Description:

DFHFCRL modifies SHRCTL blocks (describing VSAM LSR pools) in response to CEDA requests.

DFHFCRP
Entry points:

DFHFCRP

Called by:

DFHFCIN2

Description:

The file control restart program builds the file control environment and initializes file control.

DFHFCSD
Entry points:

DFHFCSD

Called by:

DFHSTP

Description:

DFHFCSD is called during CICS controlled shutdown processing to close all open files managed by CICS file control.

DFHFCST
Entry points:

DFHFCST

Called by:

DFHSTFC, DFHSTLS

Description:

DFHFCST is called to collect or reset file or LSRPOOL statistics on request from DFHSTFC or DFHSTLS.

DFHFCU
Entry points:

DFHFCUNA

Called by:

CSFU transaction

Description:

DFHFCU issues an OPEN for files specified in the file control table (FCT). This program examines the FCT, and calls DFHFCFS to open all specified files.

DFHFCVR
Entry points:

DFHFCVR, UPADEXIT

Called by:

DFHFCBD, DFHFCFR, DFHFCVR, DFHFCVS, VSAM

Description:

DFHFCVR is a file control program that is link-edited into DFHFCVS. It handles requests to VSAM, and also contains the VSAM UPAD exit.

DFHFCVS
Entry points:

DFHFCVS

Called by:

DFHFCDTS, DFHFCFR

Description:

DFHFCVS handles requests for file control services made against VSAM files. These services include:

DFHFDP
Entry points:

DFHFDPNA

Called by:

DFHFD macro

Description:

DFHFDP translates DFHFD macro requests for a system dump to DU domain SYSTEM_DUMP calls.

DFHFEP
Entry points:

DFHFEPNA

Called by:

CSFE transaction

Description:

The FE terminal test program can be used to send a complete character set to a terminal or to echo input or to turn tracing on or off. This program is an application program and does not exit to any other CICS modules. However it does use CICS facilities.

DFHGMM
Entry points:

DFHGMMNA

Called by:

DFHKCP

Description:

The "good morning" program is invoked by the CSGM system transaction to write a "good morning" message to VTAM logical units when a satisfactory OPNDST has occurred (and if the message has been requested in the TCT TYPE=TERMINAL entry).

DFHHPSVC
Entry points:

IGCnnn

Called by:

DFHZHPSR (via an SVC call)

Description:

This is a type 6 SVC module used only on MVS. Its sole purpose is to cause MVS to dispatch an SRB. DFHHPSVC provides part of the CICS high performance option (HPO) code, and is invoked only if HPO is in use. In the entry point name, nnn is the number of the SVC.

Returns to:

MVS

DFHICP
Entry points:

DFHICPNA

Called by:

DFHEIIC, DFHIC macro

Description:

The interval control program is used for time management and has two main functions:

  1. Services DFHIC macros under the control of a requesting task’s TCA
  2. Detects the expiration of time-dependent events, as defined in ICEs.

The main subroutines of DFHICP are:

ICCANCLN - Cancel a time-ordered request
ICEXPANL - Time expiration analysis
ICGTIMEN - Current time of day
ICGTTTDM - Data retrieval
ICICECRN - Build basic ICE
ICPCTSN  - Task initiation
ICPOSTN  - Signal expiration of a specified time
ICRESETN - Time of day clock reset support
ICSCHEDN - ICE schedule
ICWAITN  - Delay processing of a task.
DFHIIPA$, DFHIIP1$
Entry points:

DFHIIPNA

Called by:

DFHMCP

Description:

The non-3270 input mapping program performs all BMS input mapping functions for all devices except the 3270. On exit from the module, the input data has been mapped into a newly acquired TIOA that is returned to the application program and is then addressable using BMS DSECTs in the application.

The main subsections of DFHIIP are:

IIMID  - GETMAINs TIOA to return to user, and maps
         page buffer into it using specified map.
IIREAD - Reads input data, issuing DFHTC or DFHDI
         requests to get data from the terminal.
IISCAN - Scans data stream for device-dependent
         control characters and creates page
         buffer.
DFHIRP
Entry points:

DFHIRPNA

Called by:

DFHCRC, DFHCRNP, DFHCRSP, DFHDRPD, DFHDRPE, DFHDRPF, DFHSRP, DFHSTP, DFHZCX

Description:

The interregion communication program is used to pass data from one region to another in the same CEC. The programs being run in the regions are usually CICS programs, but DFHIRP does not assume this.

DFHIRW10
Entry points:

As defined in interest ladder 8

Called by:

DFHIRP, DFHXMP

Description:

The interregion work exit delivers work to the IRC control task (CSNC). DFHIRW10 is called whenever DFHIRP or DFHXMP has work to deliver to a system that logged on with DFHIRW10 as its interregion work exit. This module checks whether the work being delivered to the target system requires that work be enqueued on CSNC; if so, it enqueues the work and posts CSNC. DFHIRW10 is invoked in access register (AR) mode and user key.

DFHISP
Entry points:

DFHISPNA

Called by:

DFHDLI, DFHEIP, DFHEIFC

Description:

The intersystem communication program is invoked when a request to access resource has to be shipped to a remote system (through ISC or MRO).

The requests passed to DFHISP are:

DFHISP controls the acquisition, use, and freeing of a session to the remote system, and invokes DFHXFP or DFHXFX to process requests and replies. Two user exits are provided in DFHISP: XISCONA can be used to control the queuing of requests from DFHISP to allocate intersystems sessions, and XISLCLQ can be used to override the LOCALQ option of the transaction attributes. XISCONA is invoked for any function-shipping requests that cannot be processed immediately. XISLCLQ is provided to support the local queuing of function-shipped START NOCHECK requests when the link to the remote system is out of service. If a START NOCHECK request is queued, DFHISP starts the CMPX transaction when the link is brought in to service.

DFHJCP
Entry points:

DFHJCPNA

Called by:

DFHEJC, DFHJC macro

Description:

The journal control program (DFHJCP) either processes a request to get a JCA control block, or has been called to write to a journal. In the latter case it examines the information in the JCA that is passed with the request and decides whether to call the recovery manager or the log manager based on whether it finds journalname DFHLOG in the JCA or not. There are three separate calls to the DFHLGGL gate of the log manager: one for a write, a put or a wait request. The same is true for the recovery manager calls, which use the DFHRMRE gate. In addition there is a call to this gate for requests which have keypoint record data with them.

When control returns from either of these domains, the domain's outcome is mapped onto a valid return code which is put into the JCA before control returns back to the calling program

DFHJUP
Entry points:

DFHJUPNA

Called by:

MVS

Description:

The journal print utility program examines, selects, and displays data in QSAM data sets, such as the CICS and IMS logs. Data selection is controlled by input parameters, and an optional user exit. DFHJUP provides access to the MVS log streams via the SUBSYS keyword in the JCL.

DFHKCP
Entry points:

DFHKCPNA

Called by:

DFHEKC, DFHKC macro

Description:

This is a startup routine that passes control to either DFHXCP or DFHXCPC. It also deals with some ENQ and DEQ calls.

DFHKCQ
Entry points:

DFHKCQNA

Called by:

DFHXCPC

Description:

DFHKCQ processes DFHKC INITIALIZE, REPLACE, WAITINIT, and DISCARD macro calls to the transaction manager.

DFHKCRP
Entry points:

DFHKCRP

Called by:

DFHKCP (attaches DFHKCRP as a CICS task)

Description:

DFHKCRP is the task control restart program.

DFHKCSC
Entry points:

DFHKCSC

Called by:

DFHKCQ

Description:

This module forms part of the transaction manager. It provides the QUERY_TRANSACTION and QUERY_PROFILE functions for use in determining whether the transaction or profile specified on a DISCARD TRANSACTION or DISCARD PROFILE command respectively can validly be discarded. For the QUERY_TRANSACTION function, DFHKCSC examines the ICE chain, the AID chains, and the SIT, looking for references to the transaction that is the subject of the DISCARD. For the QUERY_PROFILE function, DFHKCSC examines the PCT for a reference to the profile that is the subject of the DISCARD.

DFHKCSP
Entry points:

DFHKCSPA, DFHKCSPI, DFHKCSPD, DFHKCSPF, DFHKCSPP

Description:

The task SRB control program is part of the high performance option (HPO) code available on CICS on MVS. It runs in SRB mode and resides in protected storage.

DFHLIP
Entry points:

DFHLINA

Called by:

DFHEDFX, DFHEIP, DFHPCPS, DFHSIJ1, DFHSTP

Description:

The language interface program acts as a single point of contact between CICS and AD/Cycle Language Environment/370, and also between CICS and the language environments for VS COBOL II and C/370. To invoke a Run-Time Language Interface (RTLI) or Extended Run-Time Language Interface (ERTLI) function, the requesting module calls DFHLIP by issuing a DFHCEE FUNCTION= macro. DFHLIP performs all the interface work with the language, including the handling of any errors.

The interface functions driven by DFHLIP and the modules that call DFHLIP for those functions are as follows. An asterisk (*) after a function name shows that the function call is handled entirely within DFHLIP itself, and control remains in DFHLIP upon successful completion of the thread initialization function.

Unless otherwise indicated, each function is used for all three environments. Where alternative function names are given, the name applicable to Language Environment/370 is used in the requesting module’s DFHCEE macro call regardless of the language environment.

DFHEDFX - Determine working storage
                  (Language Environment/370)
          OR Working storage locate
                  (VS COBOL II and C/370)
DFHEIP  - Perform GOTO
                  (Language Environment/370 only)
DFHPCPS - Establish ownership type
                  (Language Environment/370)
          OR Determine program type
                  (VS COBOL II and C/370)
        - Thread initialization
        - Run-unit initialization *
        - Run-unit begin invocation *
                  (Language Environment/370 only)
        - Run-unit end invocation
                  (Language Environment/370 only)
        - Run-unit termination
        - Thread termination
DFHSIJ1 - Partition initialization
DFHSTP  - Partition termination.
DFHLUP
Entry points:

DFHLUPNA

Description:

DFHLUP is the LU6.2 services manager. It initializes and shuts down a network, and resynchronizes flows.

DFHMCPA$, DFHMCPE$, DFHMCP1$
Entry points:

DFHMCPNA

Called by:

DFHBMS macro, DFHEMS

Description:

The mapping control program processes DFHBMS macro requests and completes the processing of a logical message when a task terminates without issuing a DFHBMS TYPE=PAGEOUT. DFHMCP’s main function is to analyze DFHBMS requests and to pass control to the appropriate modules. Other functions include the loading of maps and partition sets, and scheduling of output messages transmitted by temporary storage.

The main subsections of DFHMCP are:

MCPCPO   - Completes logical message build message
           control record for temporary storage
MCPDWEXT - DWE processing, invoked by DFHKCP to
           complete BMS processing at application
           termination
MCPINPT  - Handles all input requests
MCPIN    - TYPE=IN (EXEC CICS RECEIVE MAP)
MCPMAPLO - Loads map set and locates map
MCPPGBLD - TYPE=PAGEBLD|TEXTBLD (EXEC SEND TEXT)
MCPPGOUT - TYPE=PAGEOUT (EXEC CICS SEND PAGE)
MCPPURGE - TYPE=PURGE (EXEC CICS PURGE MESSAGE)
MCPROUTE - TYPE=ROUTE (EXEC CICS ROUTE).
DFHMCX
Entry points:

DFHMCXNA

Called by:

DFHMCP

Description:

DFHMCX is the BMS fast path module for standard and full-function BMS, and the program for minimum BMS support. It is called by DFHMCP if the request satisfies one of the following conditions:

DFHMGP
Entry points:

DFHMGPNA

Called by:

DFHACP, DFHCRQ, DFHCRT, DFHEOP, DFHFEP, DFHRTC, DFHRTE, DFHZEMW, DFHZERH, DFHZIS1, DFHZTSP, DFHZXRL

Description:

The message generation program provides an interface for sending CICS messages to the terminal end user.

DFHMGT
Entry points:

DFHMGTNA

Called by:

DFHMGP

Description:

The message prototype control table, or message generation table, consists of a series of copybooks, DFHMGTnn, each of which contains up to 100 messages that are issued by DFHMGP.

DFHMIRS
Entry points:

DFHMIRNA

Called by:

Task initiation

Description:

The mirror program is invoked when a request to access a resource is received from a remote ISC system or from a remote MRO system. DFHMIRS may be thought of as returning the answer to the requesting actions of DFHISP. It is DFHMIRS that controls the receipt of requests and transmission of replies.

DFHMIRS processes requests from:

The input to DFHMIRS consists of a TCTTE representing the session between CICS and its session partner, and a TIOA containing the function shipping request.

The TIOA is passed to DFHXFP (transformer 2) for conversion of the request from transmission format to the parameter list format required for DFHEIP or DFHDLI. If the data requires conversion (transaction CPMI), an EXEC CICS LINK is used to link to the data conversion program DFHCCNV, passing a COMMAREA that contains the EXEC CICS parameter list for the request where applicable. DFHMIRS then passes the request to DFHEIP or DFHDLI for execution.

On return from DFHEIP or DFHDLI the data conversion program is called to convert the reply (if applicable), and then the transformer program DFHXFP (transformer 3) is called to convert the reply parameter list to transmission format. DFHMIRS then determines the DFC to send with the reply and transmits the reply to the requesting system. If the mirror task has modified protected resources, it continues receiving requests and transmitting replies until a syncpoint request is received from the remote system.

A mirror task on an IRC link suspends itself on completion of a request and it is then available for use by any other MRO function-shipped request. The dispatcher terminates the mirror task if it is not reused within ten seconds.

DFHML1
Entry points:

DFHML1NA

Called by:

DFHMCP, DFHPBP

Description:

The SCSPRT logical unit type 1 output mapping routine is called by DFHPBP to build a page of data stream from a chain of map and application data structure copies. The data contains only features that the TTP says are supported by the target terminal. This routine is called when NLEOM is specified for 3270 printers or LU3 printers.

The main subsections of DFHML1 are:

ML1SPACE
Calculate space for chaining and mapping
ML1FMCA
Format the chains that describe the maps
ML1PF
Process map fields
DFHMROQP
Entry points:

DFHMRONA

Called by:

DFHCRNP, DFHCRSP

Description:

The MRO work queue enable/disable program is invoked by the DFHMROQM macro for ENABLE and DISABLE requests (other requests are processed by an inline expansion). DFHMROQP is called by DFHCRSP to enable the MRO work queues when starting interregion communication, and by either DFHCRSP or DFHCRNP to disable the work queues when stopping interregion communication. MRO work queues are used to deliver work to the IRC control task (CSNC).

DFHMSP
Entry points:

DFHMSPNA

Called by:

CMSG transaction

Description:

The message switching program routes a message entered at the terminal to one or more operator-defined terminals or to other operators. DFHMSP can be used in conversational mode to process operands entered from separate input operations. In this case the operands already processed are preserved in temporary storage.

The main sections and subroutines of DFHMSP are:

MSBMSRT  - Check for complete operands
MSCNVRS  - Issue conversational response
MSCONTIN - Process conversational response
MSMSG4   - MSG operand
MSNTRY   - Process operands
MSROUTE  - Route operand.
DFHMXP
Entry points:

DFHMXPNA

Called by:

Automatic transaction initiation

Description:

The local queuing shipper provides the means of transferring to a remote system a START request that has been temporarily deferred by use of the local queuing option.

DFHM32A$, DFHM321$
Entry points:

DFHM32NA

Called by:

DFHMCP, DFHPBP

Description:

For a BMS output request, the 3270 mapping program generates the appropriate data stream for a 3270 device, and returns control to DFHPBP which invokes the DFHTPP module to send the data to the appropriate destination, which is either to the direct terminal, or to temporary storage, or back to the caller. For a BMS input request, the data stream from a 3270 device is examined and mapped into a user application TIOA format.

The main subsections of DFHM32 are:

BMFMHTST - Create beginning of 3270 data stream
           (FMH cursor positioning)
BMMID    - Input mapping
BMMMS    - Merge maps (output mapping)
M32PF    - Process field.
DFHPBPA$, DFHPBP1$
Entry points:

DFHPBPNA

Called by:

DFHMCP

Description:

The page and text build program positions maps or text, including header or trailer maps or text, within a page of output. For non-3270 devices, the module creates a page buffer containing the user’s data which is then passed to DFHDSB to produce a device-dependent data stream. When mapping, this includes merging the data supplied by the application with the constant data included in the map. For 3270 devices, copies of the maps and application-supplied data for a page are chained together, to be processed by module DFHM32, to produce a 3270 data stream. The page and text build program creates dummy maps, and chains them in the same way for 3270 text building. For LU1 printers with extended attributes, copies of the maps and application-supplied data for a page are chained together, to be processed by module DFHML1 to produce an SCS data stream. The page and text build program creates dummy maps, and chains them in the same way for text building. After the maps have been processed by DFHDSB, DFHM32, or DFHML1, DFHPBP calls DFHTPP to write them out.

The main subroutines of DFHPBP are:

PBDOUTPT
Mapping/text build complete, decide whether to call data stream generator and which one (DFHDSB or DFHM32). Return to caller (DFHMCP)
PBD00005
Main control logic, request analysis.
PBD01000
Map placement logic (3270 and non-3270 mapping).
PBD01130
Non-3270 mapping.
PBD10000
Pageout routine.
PBD11000
Modify field positions within map (used by 3270 and non-3270 mapping).
PBD20000
Text processing (3270 and non-3270).
PBD30000
3270 mapping.
PBFMHBLD
Build FMH if FMHPARM specified (non-3270 text and map processing).
DFHPD640
Entry points:

DFHPD640

Called by:

MVS IPCS program

Description:

DFHPD640 runs as an exit from the MVS IPCS program. It formats an MVS system dump (SDUMP) using the IPCS service routines to extract data and print output, including interpreted trace.

DFHPEP
Entry points:

DFHPEPNA

Called by:

DFHACP

Description:

The program error program is CICS-supplied and establishes a base register, establishes addressability to the COMMAREA passed from DFHACP using a DFHPC CTYPE=LINK_URM macro call, and returns control to DFHACP. DFHPEP can be modified by the user to perform further recovery operations.

DFHPHP
Entry points:

DFHPHPNA

Called by:

DFHMCP, DFHTOM

Description:

The partition handling program has one entry point, and starts with a branch table that passes control to the required routine according to the request.

The main routines of DFHPHP are:

PHPPSI - Loads a partition set
PHPPSC - Destroys any existing partitions and
         creates new partitions
PHPPIN - Extracts the AID, cursor position, and
         partition ID
PHPPXE - Activates the appropriate partition if
         data is received from an unexpected
         partition.
DFHPL1OI
Description:

The PL/I interface module contains the following routines:

DFHPL1N
Initial entry point for PL/I programs under CICS
DFHPL1I
CICS macro service interface
DFHPL1C
Set the CSA address
IBMBOCLA/B/C
Startup routines for open/close functions.
DFHPRK
Entry points:

DFHPRKNA

Called by:

DFHZATT

Description:

The 3270 print key program (transaction CSPK) is invoked when, under VTAM, the 3270 program access key designated as the print key is pressed and no task is attached to the terminal. If the 3270 hardware copy feature is present, DFHPRK attaches task CSCY to the printer designated in the TCTTE, and DFHCPY is executed. If the copy feature is not present, DFHPRK executes a DFHTC TYPE=PRINT macro.

DFHPSP
Entry points:

DFHPSPNA

Called by:

DFHEPS

Description:

DFHPSP is the system spooling interface control module.

DFHPSPDW
Entry points:

DFHPSPDW

Called by:

DFHSPP

Description:

DFHPSPDW is the system spooling interface DWE.

DFHPSPSS
Entry points:

DFHPSPSS

Called by:

DFHPSP

Description:

The system spooling JES interface subtask module attaches a subtask to check whether a writer name and a token have been supplied. It opens and closes JES data sets, reads a record, and writes a record.

DFHPSPST
Entry points:

DFHPSPST

Called by:

DFHPSPSS

Description:

DFHPSPST is the system spooling JES interface control module.

DFHPSSVC
Entry points:

DFHPSSNA

Called by:

DFHPSPSS, DFHPSPST

Description:

DFHPSSVC is the system spooling interface module that retrieves a data set name for a given external writer name, dynamically allocates it, and returns its DDNAME.

DFHPUP
Entry points:

DFHPUPNA

Called by:

DFHAMP, DFHCSDUP

Description:

The parameter utility program transforms the definition data of the CSD. In the CSD, the data is held in a compacted form and each field is self-identifying. Elsewhere in the processing, these fields are handled in parameterized form, using an argument address list. It also serves to transform the resource definition to the original high-level command.

DFHP3270
Entry points:

DFHP32NA

Called by:

CSPP transaction, DFHTCP, DFHZCP

Description:

The 3270 print program prints 3270 data received from a screen on a 3270 printer. The data is compressed where possible and then transmitted to the printer.

DFHQRY
Entry points:

DFHQRY

Called by:

DFHALP, DFHTCTI, DFHZATT

Description:

The query transaction (DFHQRY) sends a READ PARTITION QUERY structured field to a 3270, analyzes the response, and completes information in the corresponding TCTTE. DFHQRY can be attached by DFHALP, DFHTCTI, or DFHZATT.

DFHRCEX
Entry points:

DFHRCEX

Called by:

DFHFCBP, DFHTCBP, DFHUSBP

Description:

DFHRCEX enables the global user exits for emergency restart processing.

DFHRKB
Entry points:

DFHRKBNA

Called by:

DFHCPY

Description:

The release 3270 keyboard program is initiated by DFHCPY to release a 3270 keyboard. It does this by issuing a DFHTC TYPE=WRITE macro that sends a 3270 write control character.

DFHREST
Entry points:

DFHREST

Called by:

DFHXMTA

Description:

The transaction restart program, DFHREST, is a user-replaceable module that helps you to determine whether or not a transaction is restarted. The default DFHREST module requests a transaction restart under certain conditions; for example, for a program isolation deadlock, one of the tasks is backed out and automatically restarted, and the other is allowed to complete its update.

DFHRLRA$, DFHRLR1$
Entry points:

DFHRLRNA

Called by:

DFHMCP

Description:

The route list resolution program builds a terminal type parameter (TTP) control block for each type of terminal for which a message is to be built. A TTP is acquired for each terminal type in the user route list and the direct terminal if there is one.

The main subsections of DFHRLR are:

RLRALL   - Routing with ROUTE=ALL specified in
           application
RLRLIST  - Routing with route list specified in
           application
RLROPCL  - Routing with OPCLASS= specified in
           application
RLRRTEBY - Nonrouting, non-LDC device (that is
           direct terminal)
RLR3601  - Nonrouting LDC device.
DFHRMSY
Entry points:

DFHRMSNA

Called by:

DFHERMSP, DFHERMRS

Description:

The purpose of task-related user exit resynchronization is to resolve any in-doubt LUWs. Task-related user exit resynchronization is called by DFHERMRS during execution of the RESYNC command to restore the CICS end of the thread that was interrupted by the failure of the connection with the resource manager.

It is also called by DFHERMSP when a wait is unshunted and requires RMI resynchronization with a resource manager.

DFHRTC
Entry points:

DFHRTCNA

Called by:

CSSF transaction

Description:

The CSSF transaction is invoked on the remote system when a CRTE routing session is to be canceled. CSSF runs the CRTE cancel command processor, DFHRTC, to sign off the user and terminate the extended routing session. DFHRTC calls DFHSUSN to sign off the surrogate.

DFHRTE
Entry points:

DFHRTENA

Called by:

transaction CRTE, DFHSNTU

Description:

The transaction routing program establishes a transaction routing session with a remote region specified by the user. Subsequent input is analyzed by DFHRTE, the transaction code extracted, and a request issued to DFHZTSP to route the transaction to the required system.

DFHSFP
Entry points:

DFHSFP

Called by:

CESF trans.

Description:

The sign-off program signs off the user who invoked the CESF transaction.

DFHSIA1
Entry points:

DFHSIANA

Called by:

DFHAPSIP

Description:

The DFHSIA1 system initialization program loads and initializes the CSA.

DFHSIB1
Entry points:

DFHSIBNA

Called by:

DFHAPSIP

Description:

The DFHSIB1 system initialization program loads the CICS nucleus.

DFHSIC1
Entry points:

DFHSICNA

Called by:

DFHAPSIP

Description:

The DFHSIC1 system initialization program initializes the transaction manager and the storage manager domain’s macro compatibility interface, acquires a TCA for LIFO functions during initialization, initializes user exits, and processes the START parameter.

DFHSID1
Entry points:

DFHSIDNA

Called by:

DFHAPSIP

Description:

The DFHSID1 system initialization program performs the following functions:

DFHSIF1
Entry points:

DFHSIFNA

Called by:

DFHAPSIP

Description:

The DFHSIF1 system initialization program initializes terminal control. DFHSIF1:

DFHSIG1
Entry points:

DFHSIGNA

Called by:

DFHAPSIP

Description:

The DFHSIG1 system initialization program opens the dump data set.

DFHSIH1
Entry points:

DFHSIHNA

Called by:

DFHAPSIP

Description:

The DFHSIH1 system initialization program:

DFHSII1
Entry points:

DFHSIINA

Called by:

DFHAPSIP

Description:

The DFHSII1 system initialization program establishes AP domain recovery routines in DFHSRP and calls DFHICRC to initialise Interval Control services. It attaches the CPLT transaction to run the first stage PLTPI programs, the CSTP transaction (the TCP task) and a system transaction to run the rest of AP initialization (the III task). The rest of DFHSII1, running as the III task:

DFHSIJ1
Entry points:

DFHSIJNA

Called by:

DFHAPSIP

Description:

DFHSIJ1 is the last to be executed in the process of system initialization. It issues the message ‘CONTROL IS BEING GIVEN TO CICS’ and passes control back to DFHAPSIP. DFHSIJ1:

DFHSIP
Entry points:

DFHKESIP

Called by:

MVS

Description:

DFHSIP initializes CICS and also contains code for the following domains:

DFHSKP
Entry points:

DFHSKMNA, DFHSKC, DFHSKE

Called by:

MVS, DFHFCL, DFHFCM, DFHFCN, DFHPSPSS, DFHSTP, DFHXSMX

Description:

DFHSKP consists of these modules, which are link-edited together:

DFHSKM - subtask manager
DFHSKC - subtask control program
DFHSKE - subtask execution program.

DFHSKM calls and, if necessary, attaches DFHSKC to process the created work queue element (WQE). DFHSKM also causes termination of the subtask when requested, and handles DWE processing and task cancel requests. DFHSKC starts an operating system subtask, DFHSKE, and waits for its completion. DFHSKE processes WQEs, looking at in-progress and waiting queues on a first-in, first-out basis. DFHSKE intercepts program checks and operating system abends.

DFHSMSCP
Entry points:

DFHSMSCP

Called by:

DFHSC macro

Description:

The storage control program is called as a result of DFHSC GETMAIN and FREEMAIN macro requests issued from CICS modules.

DFHSNAT
Entry points:

DFHSNAT

Called by:

DFHCRNP, DFHZISP, DFHZSUP (via DFHSUSN)

Description:

The attach-time signon/sign off interface program provides support for the signon and sign off of LU6.2 sessions.

DFHSNNFY
Entry points:

DFHSNNFY

Called by:

IRRDPR10

Description:

The CICS segment notify exit is called by RACF whenever a change is made to a user’s CICS segment in the RACF database.

DFHSNMIG
Entry points:

DFHSNMIG

Called by:

MVS

Description:

The signon table migration utility program produces a CLIST file containing ADDUSER and ALTUSER commands that provide RACF with all the user attributes for each user entry in the signon table (SNT). This CLIST file is run by a TSO user to migrate the user information to RACF.

DFHSNP
Entry points:

DFHSNP

Called by:

CESN transaction

Description:

The signon program is called in response to a CESN signon request. DFHSNP interprets the signon parameters, prompts the operator for more parameters if needed, and passes the values to the security manager for verification.

DFHSNSN
Entry points:

DFHSNSN

Called by:

DFHCSSC, DFHSNAT (via DFHSUSN)

Description:

The optimized signon/sign off interface program provides a mechanism for optimizing calls to the security manager. It achieves this optimization using the signon table (SNT).

DFHSNVCL
Entry points:

DFHSNVCL

Called by:

IRRDPR02

Description:

The OPCLASS validation exit is called by RACF to validate the operands of the OPCLASS subparameter of the CICS parameter in the ADDUSER or ALTUSER TSO commands. DFHSNVCL checks whether the operands are in the range 1 through 24.

DFHSNVID
Entry points:

DFHSNVID

Called by:

IRRDPR02

Description:

The OPIDENT validation exit is called by RACF to validate the operand of the OPIDENT subparameter of the CICS parameter in the ADDUSER or ALTUSER TSO commands.

DFHSNVPR
Entry points:

DFHSNVPR

Called by:

IRRDPR02

Description:

The OPPRTY validation exit is called by RACF to validate the operand of the OPPRTY subparameter of the CICS parameter in the ADDUSER or ALTUSER TSO commands. DFHSNVPR checks whether the operand is in the range 0 through 255.

DFHSNVTO
Entry points:

DFHSNVTO

Called by:

IRRDPR02

Description:

The TIMEOUT validation exit is called by RACF to validate the operand of the TIMEOUT subparameter of the CICS parameter in the ADDUSER or ALTUSER TSO commands. DFHSNVTO checks whether the operand is in the range 1 through 60.

DFHSPP
Entry points:

DFHSPPNA

Called by:

DFHESP, DFHSP macro

Description:

The syncpoint program is invoked during a user-specified syncpoint (by a DFHSP macro) or at task termination. For a rollback request only, DFHSPP calls DFHDBP to restore recoverable resources. It scans the DWE chain invoking the appropriate DWE processors, and performs the necessary syncpoint logging. It dequeues all resources enqueued by the transaction. DFHSPP processes any DWEs connected with the resource manager, and processes the RESYNC command.

The main subroutines of DFHSPP are:

SPP00005 - Write DWE log data
SPP02020 - Build a DWE chain that can be logged
SPP03000 - End.
DFHSRLI
Entry points:

DFHSRLI

Called by:

DFHSRP

Description:

DFHSRLI is called during recovery processing after a system abend has occurred, to build the SRP_ERROR_DATA block and pass control to the XSRAB global user exit.

DFHSRP
Entry points:

DFHSRPNA

Called by:

AP domain recovery routines

Description:

The system recovery program deals with program check interrupts, system abends, and runaway tasks in the AP domain. For a program check, DFHSRP abends the task with abend code ASRA. For a system abend, DFHSRP searches the SRT for the abend code that has arisen and, if a match is found, calls DFHSRLI to invoke the XSRAB global user exit (if active). Afterwards, DFHSRP can either abend CICS or attempt to keep it running with only the faulty task abended (ASRB). For a runaway task, DFHSRP abends the task with abend code AICA.

DFHSSEN
Entry points:

DFHSSEN

Called by:

MVS subsystem interface

Description:

The subsystem end-of-memory routine is invoked by the MVS subsystem interface at all end-of-task (EOT) and end-of-memory (EOM) events when the CICS subsystem has been initialized by module DFHSSIN. It cleans up any subsystem control blocks owned by the terminating CICS region.

DFHSSGC
Entry points:

DFHSSGC

Called by:

DFHCSVC, DFHSSEN (through the subsystem interface)

Description:

The subsystem generic connect routine records the existence of active CICS address spaces. When the first CICS address space becomes active in an MVS image, DFHSSGC enables the subsystem broadcast facility of MVS console management. When the last CICS address space becomes inactive in an MVS image, it disables the broadcast facility.

DFHSSIN
Entry points:

DFHSSIN

Called by:

MVS master scheduler initialization

Description:

The CICS subsystem initialization routine reads subsystem parameters from SYS1.PARMLIB, and creates a subsystem vector table (SSVT) for the CICS subsystem. DFHSSIN loads modules DFHSSEN, DFHSSGC, and DFHSSWT into MVS common storage, and saves their addresses in the SSVT.

DFHSSMGP
Entry points:

DFHSSMGP

Called by:

DFHSSIN

Description:

The subsystem interface message program provides message formatting support for the subsystem interface routines, analogous to DFHMGP within CICS. (Neither DFHMGP nor the message domain can be used in this environment because CICS is not active.)

DFHSSMGT
Entry points:

DFHSSMNA

Called by:

DFHSSMGP

Description:

The subsystem interface message table contains the text of messages that are issued by DFHSSMGP.

DFHSSWT
Entry points:

DFHSSWTA

Called by:

MVS console support

Description:

The subsystem interface WTO router is invoked for all MVS console messages when the console message broadcast facility has been enabled by DFHSSGC. DFHSSWT routes DFH messages to DFHSSWTO, and routes MODIFY command text to DFHSSWTF.

DFHSSWTF
Entry points:

DFHSSWTF

Called by:

DFHSSWT

Description:

This module suppresses signon passwords that are supplied on CESN transactions entered through MODIFY commands on an MVS console. Any passwords are replaced by eight asterisks.

DFHSSWTO
Entry points:

DFHSSWTO

Called by:

DFHSSWT

Description:

This module inserts the CICS region’s applid into all DFH messages issued under a CICS TCB whose applid can be determined.

DFHSTDT
Entry points:

DFHSTDT

Called by:

DFHAPST

Description:

This module is called by DFHAPST to collect or reset dynamic transaction backout statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTFC
Entry points:

DFHSTFC

Called by:

DFHAPST

Description:

This module is called by DFHAPST to collect or reset file control statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTIB
Entry points:

DFHSTIB

Called by:

DFHAPST

Description:

This module and called by DFHAPST to collect or reset IRC batch system connected statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTJC
Entry points:

DFHSTJC

Called by:

DFHAPST

Description:

This module is called by DFHAPST to collect or reset journal control statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTLK
Entry points:

DFHSTLK

Called by:

DFHAPST

Description:

This module is called by DFHAPST to collect or reset ISC/IRC statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTLS
Entry points:

DFHSTLS

Called by:

DFHAPST

Description:

This module is called by DFHAPST to collect or reset LSRPOOL statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTP
Entry points:

DFHSTPNA

Called by:

DFHEMTP

Description:

The main function of the system termination program is to shut down CICS. In sequence, DFHSTP performs the following functions (according to options specified):

  1. Collects statistics now if immediate shutdown
  2. Shuts down the resource managers
  3. Terminates subsystem interface
  4. Resumes suspended tasks
  5. Executes the programs defined in the first part of DFHPLT
  6. Rebuilds AIDs for paging sessions
  7. Breaks the ICE and AID chains
  8. Quiesces IRC
  9. Executes the programs defined in the second part of DFHPLT
  10. Closes all open files managed by CICS file control
  11. Synchronize with Recovery Manager shutdown keypoint
  12. Call WKP to catalog terminals and profiles
  13. Terminate extra partition TD
  14. Signs off from the CAVM
  15. Terminates general-purpose subtasking facility
  16. Calls the kernel to terminate the system.
Returns to:

MVS

DFHSTSZ
Entry points:

DFHSTSZ

Called by:

DFHAPST

Description:

DFHSTSZ is called by DFHAPST to collect or reset FEPI statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTTD
Entry points:

DFHSTTD

Called by:

DFHAPST

Description:

DFHSTTD is called by DFHAPST to collect or reset transient data statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTTM
Entry points:

DFHSTTM

Called by:

DFHAPST

Description:

DFHSTTM is called by DFHAPST to collect or reset table manager statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTTR
Entry points:

DFHSTTR

Called by:

DFHAPST

Description:

DFHSTTR is called by DFHAPST to collect or reset terminal statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSTTS
Entry points:

DFHSTTS

Called by:

DFHAPST

Description:

DFHSTTS is called by DFHAPST to collect or reset temporary-storage statistics. Statistics are written to the SMF data set or made available on the API according to the type of request.

DFHSUSN
Entry points:

DFHSUSN

Called by:

DFHACP, DFHBSTS, DFHCRNP, DFHCSSC, DFHEEI, DFHEIQST, DFHERM, DFHESN, DFHMGPME, DFHMGP00, DFHRTC, DFHSUSX, DFHTCTI, DFHTPQ, DFHTPR, DFHXSMN, DFHZCUT, DFHZEV1, DFHZEV2, DFHZISP, DFHZIS2, DFHZNAC, DFHZOPN, DFHZSUP, DFHZTSP, DFHZXCU

Description:

DFHSUSN is used to create, destroy, and query the contents of a signon table element (SNTTE). It calls DFHSUSX to notify the XRF alternate system of the creation and destruction of SNTTEs. It also provides an interface for the creation and validation of encrypted passwords used in LU6.2 bind password processing.

DFHSUSX
Entry points:

DFHSUSX

Called by:

DFHTCRPU, DFHZXCU, DFHSUSN

Description:

DFHSUSX provides tracking for SNTTEs. This module is responsible for:

Entry points:

DFHSUWT

Called by:

DFHMEME, DFHSUWT

Description:

The DFHSUWT module provides the following support for executing MVS WTO and WTOR SVCs:

For further information about DFHSUWT, see WTO and WTOR.

DFHSUZX
Entry points:

DFHSUZX

Called by:

DFHBSTZV, DFHEIQSC, DFHEIQST, DFHEIQTR

Description:

The ZC trace controller is responsible for actioning set, cancel, and inquire requests for the CICS VTAM exit tracing facility. It sets or unsets the control flags and gets or releases the storage used by the DFHZETR function located in the ACB and RPL exits.

DFHTACP
Entry points:

DFHTACNA

Called by:

DFHTCP

Description:

The terminal abnormal condition program is invoked by DFHTCP and performs the following functions:

DFHTAJP
Entry points:

DFHTAJNA

Description:

The time adjustment program calls DFHICP to reset the CSA’s time fields according to the host-supplied time-of-day. DFHTAJP then scans the ICE chain and adjusts the expiry time of interval-controlled ICEs. Time-controlled ICEs are not adjusted but the ICE chain is reordered so that it is left in order by expiry time. Times held in the TCT and CSATCNDT are decreased, and negative times are made zero. Lastly, DFHTAJP writes a message.

DFHTBSB
Entry points:

DFHTBSB

Called by:

DFHZCQIS

Description:

DFHTBSB adds a node to the control-block structure. It is called during the dynamic installation of TCT resources, and calls routines in the control block builder.

DFHTBSBP
Entry points:

DFHTBSBP

Called by:

DFHTBSB, DFHTBSBP

Description:

DFHTBSBP is the recursive part of DFHTBSB.

DFHTBSD
Entry points:

DFHTBSD

Called by:

DFHZCQDL

Description:

DFHTBSD deletes a node in a CICS terminal network.

DFHTBSDP
Entry points:

DFHTBSDP

Called by:

DFHTBSD, DFHTBSDP

Description:

DFHTBSDP is the recursive part of DFHTBSD.

DFHTBSL
Entry points:

DFHTBSL

Called by:

DFHTBSR, DFHZCQCH

Description:

DFHTBSL creates the recovery record for a node during the dynamic installation of a TCT table entry using the CEDA INSTALL command, for example, and calls routines in the control-block builder.

DFHTBSLP
Entry points:

DFHTBSLP

Called by:

DFHTBSL, DFHTBSLP, DFHTBSSP

Description:

DFHTBSLP is the recursive part of DFHTBSL.

DFHTBSQ
Entry points:

DFHTBSQ

Called by:

DFHZCQIQ

Description:

DFHTBSQ is called to retrieve the parameters that were supplied to a TCT table entry at build time.

DFHTBSQP
Entry points:

DFHTBSQP

Called by:

DFHTBSQ

Description:

DFHTBSQP is called by DFHTBSQ to retrieve parameters that were supplied to a TCT table entry at build time.

DFHTBSR
Entry points:

DFHTBSR

Called by:

DFHZCQRS

Description:

DFHTBSR takes a table-builder recovery record and re-creates the corresponding table entry. It is called during warm or emergency restart.

DFHTBSRP
Entry points:

DFHTBSRP

Called by:

DFHTBSR

Description:

DFHTBSRP is called by DFHTBSR.

DFHTBSSP
Entry points:

DFHTBSSP

Description:

DFHTBSSP performs a commit or rollback action for a previous table-builder change according to the outcome of a logical unit of work. Each action is dequeued from a DWE.

DFHTBS00
Entry points:

DFHTBS

Description:

DFHTBS00 is the main routine for DFHTBS and holds the addresses of the modules used to build control blocks for the dynamic installation of TCT resources.

DFHTCBP
Entry points:

DFHTCBNA

Description:

The terminal control backout program restores TCTTEs and other ISC state data during emergency restart.

DFHTCP
Entry points:

DFHTCPNA

Description:

DFHTCP is the terminal control program. The terminal control task is attached during system initialization and remains until termination. DFHTCP manages all non-VTAM terminals, which involves:

The modules and subsections of DFHTCP are:

DFHTCAM
Terminal control TCAM device dependent
DFHTCCLC
Terminal control line control scan routine
DFHTCCOM
Terminal control common logic
DFHTCCSS
Terminal control start-stop common logic
DFHTCDEF
Terminal control symbol definition
DFHTCORS
Terminal control storage handling
DFHTCSAM
Terminal control sequential terminal device dependent
DFHTCTI
Terminal control task initiation
DFHTCTRN
Terminal control translate tables
DFHTCRP
Entry points:

DFHTCRP

Description:

DFHTCRP initializes and recovers terminal control definitions and protected messages. It is run as a task during CICS initialization.

DFHTCRPC
Entry points:

DFHTCRPC

Called by:

DFHZXQO

Description:

DFHTCRPC is the XRF tracking interface for TCT contents. It is one of a set of routines called by DFHZXQO from the same CALL statement, the entry point address having been passed to DFHZXQO. This routine calls ZC RESTORE to add or delete a TCT entry based on information from another CICS system using the log, the catalog, or the XRF tracking queues.

DFHTCRPL
Entry points:

DFHTCRPL

Called by:

DFHTCRP

Description:

DFHTCRPL installs TCT resources defined by the TCT macros.

DFHTCRPS
Entry points:

DFHTCRPS

Called by:

DFHZXQO

Description:

DFHTCRPS is the XRF tracking interface for ZCP sessions. It is one of a set of routines called by DFHZXQO from the same CALL statement, the entry point address having been passed to DFHZXQO. This routine calls DFHZXST (through DFHZXS) to make changes to the session state.

DFHTCRPU
Entry points:

DFHTCRPU

Called by:

DFHZXQO

Description:

DFHTCRPU is the XRF tracking interface for signon table elements (SNTTEs). It is one of a set of routines called by DFHZXQO from the same CALL statement, the entry point address having been passed to DFHZXQO. This routine calls DFHSUSX to add or delete tracked SNTTEs, and to make changes to the signed-on state.

DFHTDA
Entry points:

DFHTDANA

Called by:

DFHAKP, DFHAMCSD, DFHAPTD, DFHCRNP, DFHCRQ, DFHDBP, DFHEIQMS, DFHEIQSQ, DFHESE, DFHETD, DFHJCP, DFHMCP, DFHMGP00, DFHRCRP, DFHRUP, DFHSII1, DFHSTP, DFHSTTD, DFHTCAP, DFHTDRP, DFHTEPM, DFHTPQ, DFHTRP, DFHTSRP, DFHWKP, DFHZNAC

Description:

DFHTDA, which is link-edited with RMODE(24), handles DFHTD macro requests. In particular:

CICS® Transaction Server for z/OS®, Version 3 Release 1 uses QSAM GL|PL mode processing, unlike previous CICS releases which used QSAM GL|PM mode processing.

DFHTDB
Entry points:

DFHTDBNA

Called by:

DFHTDA

Description:

DFHTDB, which is link-edited with RMODE(ANY), handles DFHTD macro requests for intrapartition queues. In particular, DFHTDB:

DFHTDEXL
Entry points:

EX11RTNE

Called by:

QSAM

Description:

DFHTDEXL contains the DCB abend exit routine used for extrapartition processing.

DFHTDP
Entry points:

DFHTDANA

Called by:

DFHAKP, DFHAMCSD, DFHAPTD, DFHCRNP, DFHCRQ, DFHDBP, DFHEIQMS, DFHEIQSQ, DFHESE, DFHETD, DFHMCP, DFHMGP00, DFHRCRP, DFHRUP, DFHSII1, DFHSTP, DFHSTTD, DFHTACP, DFHTDRP, DFHTEPM, DFHTPQ, DFHTRP, DFHTSRP, DFHWKP, DFHZNAC

Description:

DFHTDP is a load module link-edited from object modules for DFHTDA, DFHTDEXL, and DFHTDX.

DFHTDQ
Entry points:

DFHTDBNA

Called by:

DFHTDA

Description:

DFHTDQ is a load module link-edited from object modules for DFHTDB.

DFHTDRM
Entry points:

DFHTDRM

Called by:

DFHDBP

Description:

DFHTDRM is the transient data recovery manager processor. If transient data has any outstanding resources, DFHTDRM is called at phase 1 syncpoint (or backout). For phase 1 syncpoint (or backout) requests, DFHTDRM issues a request to mainline transient data(DFHTDA) to reset any resources that have not yet been released.

DFHTDRP
Entry points:

DFHTDRNA

Called by:

DFHTDX

Description:

DFHTDRP handles transient data recovery during CICS initialization. In particular, DFHTDRP:

DFHTDTM
Entry points:

DFHTDTM

Called by:

DFHALP, DFHEIQMS, DFHEIQSQ, DFHESE, DFHSZRPM, DFHTDRP

Description:

DFHTDTM manages the entries in the destination control table. It is used to add, update and delete entries in this table and records images of each entry on the global catalog for use during a warm start or emergency restart. It allows table entries to be inquired upon.

DFHTDX
Entry points:

DFHTDXNA

Called by:

Task initiation

Description:

DFHTDX is the initial program invoked by the transient data recovery task. It links to program DFHTDRP.

DFHTEP
Entry points:

DFHTEPNA

Called by:

DFHTACP

Description:

The terminal error program is invoked by DFHTACP using a DFHPC CTYPE=LINK_URM macro. The sample DFHTEP (invoked only if there is no customer-supplied version) puts a terminal out of service if the number of terminal errors detected by DFHTACP exceeds default values contained in DFHTEP tables.

DFHTMP
Entry points:

DFHTMPNA

Called by:

DFHTM macro

Description:

The table management program performs locates, adds, deletes, locks, and unlocks to entries in certain CICS tables. DFHTMP uses a hash table for these operations.

The main subroutines of DFHTMP are:

CHKTTC     - Check table type code
COMMIT     - Commit table changes
CRTCLE     - Create a change list element
CRTDWE     - Create deferred work element
DELDWE     - Cancel deferred work element
DEQALLDE   - Dequeue on directory element
DEQUEUE    - Dequeue on table modification
DYNHASH    - Dynamic re-hash
ENQDEQDE   - Enqueue/dequeue on directory element
ENQUEUE    - Enqueue on table modification
GET_STORAGE - Get storage from the CICS shared subpool
GET_TASK_STORAGE - Get task lifetime 31-bit storage
GET_TASK_STORAGE_COND - Get task lifetime 31-bit storage
                        (conditionally)
GET_STORAGE_FAILURE - Get storage failure routine
FREE_STORAGE - Release storage from the CICS shared subpool
FREE_TASK_STORAGE - Release task lifetime 31-bit storage
LOCATE_PREVIOUS_DE - Locate previous directory
             element in collating series
LOCATETE   - Locate a table/directory entry
LOCFDIRE   - Locate a free directory element
NOTERL     - Note Read Lock
SETABORD   - Set up alphabetic ordering pointer
             for a given table type
TMFINDLOCK - Find a read lock
TMPDWEEP   - Deferred work element processor
TMSETLOCK  - Set a read lock
TMUNLOCK   - Release a read lock
UNQUIES    - Unquiesce a directory element.
DFHTON
Entry points:

DFHTONNA

Called by:

DFHDBP, DFHSPP

Description:

The terminal object resolution module is called by DFHDBP or DFHSPP during DWE processing for DFHTOR. It calls DFHTOR with end-LUW-cancel or end-LUW-commit code to perform cancel or commit of changes to TERMINAL, TYPETERM, CONNECTION, or SESSIONS definitions.

DFHTOR
Entry points:

DFHTORNA

Called by:

DFHAMP, DFHTON

Description:

DFHTOR is the terminal object resolution program. DFHAMP calls DFHTOR for a TERMINAL, TYPETERM, CONNECTION, or SESSIONS object in a CICS system definition (CSD) file that is being installed, or when DFHAMP encounters an end-of-group. DFHTOR processes the objects and passes them to the terminal control builder program (DFHZCQ). The DFHTON entry is used for DWE processing.

DFHTORP
Entry points:

DFHTORNA

Called by:

DFHSII1

Description:

DFHTORP is the terminal object recovery program. It is called during CICS initialization to purge TYPETERM and model terminal definitions from the catalog on a cold start, and to recover these definitions on an emergency restart.

DFHTPPA$, DFHTPP1$
Entry points:

DFHTPPNA

Called by:

DFHDSB, DFHM32

Description:

The terminal page processor program handles DFHBMS TYPE=OUT, STORE, and RETURN requests. If OUT, DFHTPP sends the complete page using DFHTC macro requests; if STORE, the page is sent to temporary storage; and if RETURN, no output operation takes place but the page is returned to the application program.

The main subroutines of DFHTPP are:

TPNODDS - TYPE=STORE (PAGING) requests
TPOUT   - TYPE=OUT (TERMINAL) requests (the macro
          DFHTOM is used by both DFHTPP and DFHTPR
          to handle output to terminals)
TPRETPG - TYPE=RETURN (SET) requests.
Returns to:

DFHPBP

DFHTPQ
Entry points:

DFHTPQNA

Called by:

DFHICP, DFHMCP, DFHTCP

Description:

The undelivered messages cleanup program is initiated periodically in order to cancel the delivery of BMS messages that have been placed in temporary storage, but have remained undelivered for an interval exceeding the purge delay time interval specified by the PRGDLAY system initialization parameter, if this has a nonzero value.

DFHTPR
Entry points:

DFHTPRNA

Called by:

DFHMCP, DFHTCP

Description:

The terminal page retrieval program (transaction CSPG) is invoked:

If the message is autopaged, DFHTPR retrieves the pages of the message in order, transmits them to the terminal, and then purges the message. Otherwise DFHTPR runs pseudo-conversationally. All further input is passed to DFHTPR, until the message is purged explicitly or implicitly. If the input is a valid paging command (page retrieval, page copy, page purge, or page chaining), it is processed. It is rejected if explicit purge is required, or passed back to normal task initiation if automatic purge is allowed.

The main subsections of DFHTPR are:

DFHMSPUT - Send error message to terminal
TPENCCHN - Encode and execute page chain
TPENCCOP - Encode and execute page copy
TPENCPUR - Execute page purge
TPENCRET - Encode page retrieval
TPERETA  - Reset to autopaging
TPERETQ  - Page query
TPEXIT   - Exit from program
TPEXPUR  - Execute page purge
TPEXRET  - Execute page retrieval
TPTSGET  - Get MCR or page from temporary storage.
DFHTPS
Entry points:

DFHTPSNA

Called by:

DFHICP, DFHMCP

Description:

The terminal page scheduling program (transaction CSPS) is invoked for each terminal type to which a BMS logical message built with TYPE=STORE is to be sent. For each terminal designated by the originating application program, DFHTPR is scheduled to display the first page of the logical message if the terminal is in paging status, or the complete message if it is in autopage status. DFHTPS contains the following major subsections, each dealing with a separate function:

DFHTPS contains the following subroutine:

DFHTRAP
Entry points:

DFHTRANA

Called by:

DFHTRPT

Description:

The FE global trap/trace exit is provided for diagnostic use only under the guidance of service personnel.

DFHTR640/AMDUSREF
Entry points:

DFHTRPRG

Called by:

IPCS

Description:

The CICS GTF trace formatting routine is invoked by IPCS processing of the GTFTRACE keyword when a CICS entry (USR F6C, format ID X'EF') is encountered. For each entry, it writes a line containing the job name and then formats the entry in the same form as DFHTU640 does for an auxiliary trace print. AMDUSREF is defined as an alias for DFHTR640 because IPCS looks for a program called AMDUSRxx to format entries with format ID xx.

DFHTRP
Entry points:

DFHTRPNA

Called by:

Many AP domain modules

Description:

The trace control program translates DFHTR, DFHTRACE, and DFHLFM macro requests to write trace entries into TR domain TRACE_PUT requests. DFHTRP collects the data required in the trace for the specified trace ID into a standard layout and issues the TRACE_PUT call. For requests to change the various trace flags that control tracing, DFHTRP issues KEDD format calls to the kernel domain.

DFHTRZCP
Entry points:

DFHTRZCP

Called by:

CEDA transaction, DFHTCRP, DFHTOR

Description:

DFHTRZCP builds a terminal builder parameter set.

DFHTRZIP
Entry points:

DFHTRZIP

Called by:

CEDA transaction, DFHTCRP, DFHTOR

Description:

DFHTRZIP builds a chain of builder parameter sets for sessions.

DFHTRZPP
Entry points:

DFHTRZPP

Called by:

CEDA transaction, DFHTCRP, DFHTOR

Description:

DFHTRZPP builds a pool builder parameter set.

DFHTRZXP
Entry points:

DFHTRZXP

Called by:

CEDA transaction, DFHTCRP, DFHTOR

Description:

DFHTRZXP builds a connection builder parameter set.

DFHTRZYP
Entry points:

DFHTRZYP

Called by:

CEDA transaction, DFHTCRP, DFHTOR

Description:

DFHTRZYP builds a TYPETERM builder parameter set.

DFHTRZZP
Entry points:

DFHTRZZP

Called by:

CEDA transaction, DFHTCRP, DFHTOR

Description:

DFHTRZZP merges a TYPETERM builder parameter set into a terminal builder parameter set.

DFHTSP
Entry points:

DFHTSPNA

Called by:

DFHACP, DFHAKP, DFHALP, DFHCRQ, DFHDBP, DFHDIP, DFHEDFP, DFHESE, DFHETS, DFHICP, DFHMCP, DFHMSP, DFHRTE, DFHSII1, DFHSTP, DFHTCBP, DFHTPP, DFHTPQ, DFHTPR, DFHTPS, DFHTSBP, DFHTSP, DFHTSRP, DFHZISP, DFHZRAQ, DFHZRAR, DFHZRSP

Description:

The temporary-storage program services DFHTS requests. It maintains the tables, directories, and maps necessary to keep track of every temporary-storage record and of available space on the VSAM auxiliary storage or in main storage. The main subroutine of DFHTSP is DFHTSPAM, which manages auxiliary storage (including multiple buffers and strings).

DFHTU640
Entry points:

DFHTRPRA

Called by:

MVS

Description:

The trace utility program formats and prints trace records stored on the auxiliary trace data set. This utility program is run as a separate job, and extracts selected trace entries as specified on parameter statements supplied as part of the input to the program.

DFHUCNV
Entry points:

DFHUCNV

Called by:

DFHCCNV

Description:

DFHUCNV is a sample program for CICS OS/2 user data conversion. Users can write their own version of DFHUCNV to apply any conversion. If specified, a user-supplied conversion is applied before the standard conversion. DFHUCNV is invoked for each EXEC CICS request and reply that has resulted from a CICS OS/2 function shipping request and may require conversion of user data from ASCII to EBCDIC (inbound from CICS OS/2) or from EBCDIC to ASCII (outbound). DFHCCNV issues an EXEC CICS LINK to DFHUCNV before attempting any standard conversions. This allows a user program to convert data of type USERDATA, as defined in the CICS OS/2 conversion macros (DFHCNV).

The sample program obtains addressability to the COMMAREA passed to it, and checks that the request is a temporary-storage (TS) request. Then it checks that DFHCCNV managed to locate a conversion template for the resource (a TS queue) with this name, and scans and checks the template using the supplied template pointer and length. If the check is successful, the program translates the user data field as appropriate.

DFHUEH
Entry points:

DFHUEHNA

Called by:

CICS management modules containing exit points

Description:

The user exit handler is the link between an exit point in a CICS management module in the AP domain, and the user code. DFHUEH invokes in turn each started exit program for that exit point, passing a parameter list defined in the CICS management module.

DFHUEM
Entry points:

DFHUEMNA

Called by:

DFHEIP

Description:

The EXEC interface processor for the ENABLE, DISABLE, and EXTRACT user exit commands.

DFHUSBP
Entry points:

DFHUSBNA

Called by:

DFHRCRP

Description:

The user backout program sends records, journaled by the user to the system log, to a user exit during emergency restart. The records are extracted by DFHRUP from the restart data set. They may exist for any logical unit of work, whether in flight or not, depending on the JCRSTRID value specified when the record was written.

DFHWCCS
Entry points:

DFHWCCS

Called by:

Many CAVM modules

Description:

DFHWCCS provides common services for the CAVM:

Returns to:

MVS abend, caller

DFHWCGNT
Entry points:

DFHWCGNA

Description:

DFHWCGNT is the entry point list for CAVM modules above the 16MB line.

DFHWDATT
Entry points:

DFHWDATT

Called by:

DFHWDINA, DFHWMG1, DFHWMP1, DFHWSXPI

Description:

DFHWDATT creates the CAVM process.

DFHWDINA
Entry points:

DFHWDINA

Called by:

DFHWSRTR

Description:

DFHWDINA attaches the initial CAVM process. It sets up lock tables, the dispatcher control area, the LIFO control area, and the dispatcher ESPIE and ESTAE exits.

Returns to:

DFHWDISP

DFHWDISP
Entry points:

DFHWDISP, DFHWDIND

Called by:

DFHWDWAT, DFHWDINA

Description:

DFHWDISP is the CAVM process dispatcher. It dispatches the next ready CAVM process, or waits for an external event. It dispatches the initial CAVM process.

Returns to:

Dispatched process, caller of DFHWDINA

DFHWDSRP
Entry points:

DFHWDSRP

Called by:

DFHWDINA, CAVM program check/abend

Description:

DFHWDSRP establishes the ESPIE/ESTAE CAVM process. It performs CAVM process error handling for processes with ESPIE or ESTAE routines.

DFHWDWAT
Entry points:

DFHWDWAT

Called by:

Many CAVM modules

Description:

DFHWDWAT causes the current CAVM process to wait for specific events.

Returns to:

DFHWDISP

DFHWKP
Entry points:

DFHWKPNA

Called by:

DFHSTP

Description:

DFHWKP takes a warm keypoint at the normal termination of CICS. This program is part of the restart component.

DFHWLFRE
Entry points:

DFHWLFRE

Called by:

Many CAVM modules

Description:

DFHWLFRE frees the LIFO stack entry for CAVM modules running above the 16MB line.

DFHWLGET
Entry points:

DFHWLGET

Called by:

Many CAVM modules

Description:

DFHWLGET gets the LIFO stack entry for CAVM modules running above the 16MB line.

DFHWMG1
Entry points:

DFHWMG1

Called by:

DFHWMI, DFHWDISP, DFHWDSRP

Description:

DFHWMG1 is the main module of the CAVM message manager GET MESSAGE service. It is called by DFHWMI to initialize service, and attach itself as a message-reader CAVM process; by DFHWDISP to run as a message-reader CAVM process that reads messages and stores them; and by DFHWDSRP to handle ESPIE/ESTAE exits for the message reader.

DFHWMI
Entry points:

DFHWMI

Called by:

DFHWSXPI

Description:

DFHWMI allocates the CAVM message-manager communication area. It calls each of the main message-manager modules, which then initialize themselves.

DFHWMMT
Entry points:

DFHWMMT

Called by:

DFHWMRD, DFHWMWR

Description:

DFHWMMT provides VSAM GET and PUT services for the CAVM message data set.

DFHWMPG
Entry points:

DFHWMPG

Called by:

DFHWMP1, DFHWMWR

Description:

DFHWMPG copies message data into the buffer provided by the user of PUTMSG, PUTREQ, PUTRSP, and CAVM message-manager services. It provides an ESPIE routine to handle program checks occurring during the copying.

DFHWMP1
Entry points:

DFHWMP1

Called by:

DFHWMI, DFHWDISP, DFHWDSRP

Description:

DFHWMP1 is the main module of the CAVM message-manager PUT MESSAGE service. It is called by DFHWMI to initialize service, and attach itself as a message-writer CAVM process; by DFHWDISP to run as a message-writer CAVM process that writes messages to the CAVM message data set; and by DFHWDSRP to handle ESPIE and ESTAE exits for the message writer.

DFHWMQG
Entry points:

DFHWMQG

Called by:

DFHWMS20

Description:

DFHWMQG runs under the CICS TCB above the 16MB line. It processes GETMSG CAVM message-manager requests. It waits for a message to arrive, then copies from the main-memory message queue created by the CAVM message-reader process.

DFHWMQH
Entry points:

DFHWMQH

Called by:

DFHWMG1, DFHWMQG

Description:

The CAVM message-manager message input queue handler locates or creates message-queue anchor blocks, and adds copies of messages read by the CAVM reader process to the main-memory message queues.

DFHWMQP
Entry points:

DFHWMQP

Called by:

DFHWMS20

Description:

DFHWMQP runs under the CICS TCB above the 16MB line. It processes CAVM message-manager PUTMSG, PUTREQ, and PUTRSP requests; places the request in the appropriate queue; and posts the queue to awaken CAVM process to handle request, waits for completion, and returns response to the caller.

DFHWMQS
Entry points:

DFHWMQS

Called by:

DFHWMP1, DFHWMWR

Description:

The CAVM message-manager message output queue handler provides services to select the next work item to process, and posts items complete.

DFHWMRD
Entry points:

DFHWMRD

Called by:

DFHWMG1

Description:

The CAVM message-manager message read routine reads messages from the CAVM message data set, taking account of the position of the active write cursor, and creates message blocks for copies of messages that have been read.

DFHWMS
Entry points:

DFHWMSNA

Called by:

Users of CAVM message services

Description:

The CAVM message-manager service interface routine runs under the CICS TCB above the 16MB line. It builds a dummy CAVM process block, so that subsequent modules can run in an XRF LIFO environment, and calls DFHWMS20 to process a request passed by the caller.

DFHWMS20
Entry points:

DFHWMS20

Description:

The CAVM message manager services interface selects the request type and passes requests to DFHWMQP (PUTMSG, PUTREQ, PUTRSP) or DFHWMQG (GETMSG).

DFHWMWR
Entry points:

DFHWMWR

Called by:

DFHWMP1

Description:

The CAVM message-manager message write routine takes data from PUTMSG requests and copies them into CI buffers to be written to the CAVM message data sets.

DFHWOS
Entry points:

DFHWOSNA

Description:

The overseer startup module loads DFHWOSA and passes control to it.

DFHWOSA
Entry points:

DFHWOSNA

Called by:

DFHWOS

Description:

The overseer services initialization module processes control parameters, loads DFHWOSB, and sets up entry points for overseer services.

DFHWOSB
Entry points:

DFHWOSNA

Called by:

Overseer program

Description:

The overseer service module processes requests from the overseer program which are issued by the DFHWOSM macro.

DFHWSRTR
Entry points:

DFHWSMNA

Called by:

DFHXRA, MVS after attach of new TCB

Description:

The CAVM state-management request router and subtask entry point is the initial entry point for a CAVM task attached by DFHWSSN1 to process the CAVM SIGNON command. It calls DFHWSSN2 to continue the processing of the SIGNON request and, if it is accepted, calls DFHWDINA to attach the tick generator module DFHWSTI as the first and highest-priority CAVM process. It is called under the CICS TCB to queue the CAVM TAKEOVER command for processing by the CAVM task, and to initiate processing of the CAVM SIGNOFF command by detaching the CAVM task. DFHWSRTR is the initial entry point for MVS subtasks attached by the CAVM task to perform various functions, such as issuing requests for CSVC services, or formatting new CAVM data sets when they are used for the first time.

DFHWSSN1
Entry points:

DFHWSSNA

Called by:

DFHXRA

Description:

DFHWSSN1 is the CAVM state management SIGNON initial entry point. The CICS task issues an MVS LINK, specifying load module DFHWSSON to perform a CAVM SIGNON request. DFHWSSN1 attaches the CAVM task to execute the request, waits to see if it is successful, detaches the task and, if it is not successful, reports the result to CICS.

DFHWSSN2
Entry points:

DFHWSSN2

Called by:

DFHWSRTR

Description:

The CAVM state management SIGNON request handler is entered under the CAVM TCB to process a CAVM SIGNON request. It allocates storage for, and initializes, key CAVM control blocks, sets up DFHWSSOF as an ESTAE exit, calls DFHWSSN3 to OPEN the CAVM data sets, reads the state management record from the control data set, uses the JES inquire-job-status CSVC service provided by DFHWTI, and looks for surveillance signals from other CAVM users to check whether the environment is such that the requested SIGNON can be accepted. It prompts the operator for job status information if necessary. If SIGNON is accepted, it updates the state management record and status CIs to record that this job has signed on to the CAVM. When possible, it also cleans up out-of-date information in the CAVM data sets left behind by jobs that were unable to sign off properly before terminating.

DFHWSSN3
Entry points:

DFHWSSN3

Called by:

DFHWSSN2

Description:

The CAVM state management data set initialization routine builds ACBs, and opens and validates the CAVM control and message data sets for CAVM SIGNON. It builds the reserve parameter list for serializing accesses to the control data set. If new CAVM data sets are being used for the first time, it attaches an MVS subtask to record relevant information in each data set’s control interval, and to format the CIs needed by state management.

DFHWSSOF
Entry points:

DFHWSSOF

Called by:

MVS recovery/termination manager

Description:

DFHWSSOF is the CAVM state management SIGNOFF request handler. During SIGNON processing, this module is established as an ESTAE exit for the CAVM task. It purges outstanding I/O requests, reads the state management record from the control data set, and searches it to see if this job has signed on to the CAVM. If so, it updates the status CI and state management record to indicate that the job has signed off. It makes the TAKEOVER message available to DFHWSRTR when an active system signs off after takeover has started.

DFHWSSR
Entry points:

DFHWSSR

Called by:

DFHWDISP

Description:

The CAVM surveillance status reader runs as a process controlled by the XRF dispatcher, DFHWDISP. It reads the status CI of the partner system from the control data set or the message data set, generates internal CAVM events, and drives the NOTIFY exit when the partner’s status changes, or its surveillance signals cease. For an alternate system, it monitors and records the time-of-day clock difference when the active system is running in a different CEC.

DFHWSSW
Entry points:

DFHWSSW

Called by:

DFHWDISP

Description:

The CAVM surveillance status writer runs as a CAVM process controlled by the CAVM dispatcher, DFHWDISP. It writes a system’s current status to its status CI in the control data set, or the message data set, to make it available to its partner and to provide a surveillance signal; generates an internal CAVM event when a status write completes; and puts the current time-of-day clock reading in the status CI to permit DFHWSSR to deduce the time-of-day clock difference when the active system and the alternate system are running in different CECs.

DFHWSTI
Entry points:

DFHWSTI

Called by:

DFHWDISP

Description:

The CAVM surveillance tick generator and CICS status monitor runs as a CAVM process controlled by the CAVM dispatcher DFHWDISP. It issues an MVS STIMER for the surveillance interval and, when this expires, generates an internal CAVM clock-tick event, calls the inquire-CICS-status exit, and schedules the surveillance status writer processes, to cause a surveillance signal reporting this system’s current status to be written to the control data set or the message data set.

DFHWSTKV
Entry points:

DFHWSTKV

Called by:

DFHWDISP

Description:

The CAVM state management TAKEOVER request handler runs as a CAVM process controlled by the CAVM dispatcher DFHWDISP. When a new active SIGNON has been detected, it reads the state management record from the control data set and attaches an MVS subtask to invoke DFHWTI’s validate-CLT CSVC service. When a TAKEOVER command has been issued, it reads the state management record, validates the TAKEOVER request, and attaches an MVS subtask to use DFHWTI’s JES inquire-job-status service to determine the current state of the active system.

If the active system is still signed on to CAVM, it updates the state management record to indicate that a takeover is in progress, places the TAKEOVER message for the active system in the alternate system’s status, and attaches an MVS subtask to invoke DFHWTI’s TAKEOVER-initiate service.

After the active system has signed off (or terminated), it requests DFHWSSR to read the active system’s final status, quiesces surveillance processing, and updates the state management record and status CIs to indicate the stage reached by takeover. It then arranges for surveillance processing to be resumed in active mode. It attaches an MVS subtask to invoke DFHWTI’s process-CLT CSVC service if necessary.

When the active system has finally terminated, it updates the state management record to take its place as the new active system, generates internal CAVM events, and calls the NOTIFY exit to report the progress of the TAKEOVER request, including acceptability of the time-of-day clock reading. It terminates by returning to DFHWDISP.

DFHWSXPI
Entry points:

DFHWSXPI

Called by:

DFHWSTI

Description:

The CAVM state management CAVM process initialization runs under the tick generator CAVM process towards the end of SIGNON. It attaches the TAKEOVER CAVM process (alternate systems only), two status writer CAVM processes, and two status reader CAVM processes, and then calls the CAVM message management initialization module.

DFHWTI
Entry points:

DFHWTINA

Called by:

DFHCSVC from: DFHWSSN2, DFHWSTKV, DFHZXSTS

Description:

Takeover initiation is the primary function of this module, and is requested by CAVM state management at takeover to terminate the CICS active system issue commands in the CLT, and wait until the CICS active system terminates. Other XRF services provided by this module are to determine whether a job is running, to issue the operator commands for the overseer program, to issue MODIFY USERVAR to VTAM, to validate the CLT, and to process the CLT.

DFHWTRP
Entry points:

DFHWTRP

Called by:

Many CAVM modules

Description:

DFHWTRP makes a trace entry in the CAVM main-memory trace table.

DFHXCP
Entry points:

DFHXCPNA

Called by:

DFHKCP

Description:

DFHXCP processes DFHKC CANCEL, CHAP, RESUME, SUSPEND, and WAIT macro calls to the transaction manager.

DFHXCPC
Entry points:

DFHXCPC

Called by:

DFHKCP

Description:

DFHXCPC processes DFHKC ATTACH, CHANGE, DEQ, DEQALL, ENQ, and SRB macro calls to the transaction manager. It receives DFHKC INITIALIZE, REPLACE, and WAITINIT macro calls to the transaction manager and passes them on to DFHKCQ.

DFHXCP1
Entry points:

DFHXCP1

Called by:

DFHXCPC

Description:

DFHXCP1 finds a new range of free transaction numbers when the current range has been used up.

DFHXFP
Entry points:

DFHXFPNA

Called by:

DFHISP, DFHMIRS

Description:

The online data transformation program takes data addressed from a parameter list (command-level or DL/I), and constructs an FMH suitable for transmission to a remote ISC or MRO system; DFHXFP also performs the reverse transformation.

DFHXFQ
Entry points:

DFHXFQNA

Called by:

DFHXEPRH

Description:

The batch data transformation program executes in an EXCI region. DFHXFQ takes data addressed from a DPL parameter list and constructs an FMH suitable for passing to the online region; DFHXFQ also performs the reverse transformation.

DFHXFX
Entry points:

DFHXFXNA

Called by:

DFHISP, DFHMIRS

Description:

DFHXFX performs the same logical transformations of function shipping requests as DFHXFP but in a manner that is optimized for the MRO environment. It is not used for the transformation of DL/I requests; these are processed by DFHXFP.

DFHXMP
Entry points:

DFHXMPNA

Called by:

DFHDRPE, DFHZCX

Description:

The cross-memory program is invoked by a program call (PC) instruction and uses MVS cross-memory services to pass data from one subsystem to another within the same processing unit. The communicating subsystems are usually in CICS address spaces, but DFHXMP does not assume this.

DFHXRA
Entry points:

DFHXRANA

Called by:

DFHAPDM, DFHCSSC, DFHCXCU, DFHDBCR, DFHDBCT, DFHSIC1, DFHSII1, DFHSTP, DFHTCRP, DFHTDRP, DFHXRCP, DFHXRSP, DFHZNAC, DFHZOPN, DFHZSLS

Description:

DFHXRA is the program that executes the DFHXR macro. It runs under the CICS TCB in AMODE(24). In general, it uses CICS macros to invoke other services. Exceptions are MVS LINK to DFHWSSON to sign on to the CAVM, and MVS LOAD and DELETE for DFHWSMS to sign off from the CAVM, and to initiate takeover. It invokes global user exit XXRSTAT, which can lead to the abend 208.

DFHXRB
Entry points:

DFHXRBNA

Called by:

DFHWDSRP, DFHWMQH, DFHWMRD, DFHWSSR, DFHWSTKV

Description:

DFHXRB is the XRF notify exit program. Its address is passed to the CAVM when CICS signs on to the CAVM. It runs under the CAVM TCB in AMODE(31); reacts to events detected by various CAVM modules; and creates a queue of work elements (chained from XRWECHN) to be processed by DFHXRSP.

DFHXRC
Entry points:

DFHXRCNA

Called by:

DFHWSSN2, DFHWSTI

Description:

DFHXRC is the CICS-status exit program. Its address is passed to the CAVM when CICS signs on to the CAVM. It runs under the CAVM TCB in AMODE(31), and returns the latest CICS-status data to be written to the state management data set.

DFHXRCP
Entry points:

DFHXRCNA

Description:

The XRF console communication task runs under the CICS TCB in AMODE(24). It processes MODIFY commands received by CICS during initialization of the alternate system. It initiates takeover, shuts down the active system, and manages trace and dump as required.

DFHXRE
Entry points:

DFHXRENA

Called by:

DFHPCP

Description:

The XRF startup program is the entry point for the system task attached by DFHXRA. It links to DFHXRE, whichever module was indicated by DFHXRA.

DFHXRP
Entry points:

DFHXRANA

Called by:

Not applicable

Description:

DFHXRP consists of six object modules link-edited together:

DFHXRA - XRF request processor
DFHXRB - XRF NOTIFY exit program
DFHXRC - XRF inquire status exit program
DFHXRE - XRF startup program
DFHXRF - XRF CAVM sign-off interface
DFHWMS - CAVM message manager service interface.

It is loaded by DFHSIB1.

DFHXRSP
Entry points:

DFHXRSNA

Called by:

DFHXRA

Description:

DFHXRSP is the XRF surveillance program, which runs as a program under a CICS transaction. It runs under the CICS TCB in AMODE(31); processes the queue of work elements created by DFHXRB; attaches the catch-up transaction CXCU, initiates takeover, and shuts down CICS as required; and can issue abends 206 and 207.

DFHXSMN
Entry points:

DFHXSMNA

Called by:

DFHBSTS, DFHCRNP, DFHDLIDP, DFHDLIRP, DFHEDFP, DFHEIPSE, DFHSII1, DFHSUSN, DFHSUXS, DFHTACP, DFHZSUP

Description:

The security manager is invoked by the DFHSEC macro, and provides an interface to the external security manager (ESM). DFHXSMN validates the parameters passed, then calls DFHXSMX as a general-purpose subroutine to invoke the ESM.

DFHXSMX
Entry points:

DFHXSMNA

Called by:

DFHXSMN

Description:

DFHXSMX is the subroutine used by the security manager to invoke the external security manager (ESM). For resource checking, this routine first issues the MVS RACROUTE REQUEST=FASTAUTH macro, which calls the ESM in problem state. All other security functions require the caller to be in supervisor state. For these functions, and for a failed FASTAUTH call that requires logging, the CICS SVC is issued under a general purpose subtask, entered by the DFHSK macro, to shield the main CICS task from any imbedded waits that may occur in the ESM.

DFHXSS
Entry points:

DFHXSSNA

Called by:

DFHCSVC

Description:

DFHXSS invokes the external security manager (ESM) for all functions that need to be invoked while authorized, except for the EXTRACT functions for which it passes control to DFHXSSB.

DFHXSSB
Entry points:

DFHXSSB

Called by:

DFHXSS

Description:

This module extracts data from the ESM’s database. DFHXSSB extracts userid-related data at signon time, and session key information at LU6.2 session bind time. It uses the MVS RACROUTE REQUEST=EXTRACT macro.

DFHXSWM
Entry points:

DFHXSWM

Called by:

DFHXSMN

Description:

DFHXSWM passes and retrieves messages to and from the XRF alternate system to see if security initialization is required in the XRF environment.

DFHXTCI
Entry points:

DFHXTCI

Description:

DFHXTCI is the transaction invoked when the alternate system begins a takeover. It examines the TCT to locate the terminals with XRF backup sessions, and queues these TCTTEs to DFHZSES for the SESSIONC CONTROL=SWITCH command.

DFHXTP
Entry points:

DFHXTPNA

Called by:

DFHTPS, DFHZTSP, DFHZXRL, DFHZXRT

Description:

The terminal sharing transformation program comprises four logical modules (known as transformers 1 through 4). DFHXTP transforms routing requests into the LU type 6 format for shipping to a remote CICS address space.

DFHZABD
Entry points:

DFHZABD1

Called by:

TC CTYPE= requests

Description:

If a TC CTYPE request is issued when ZCP has been generated without VTAM support, DFHZABD is invoked to abend the transaction.

DFHZACT
Entry points:

DFHZACT1

Called by:

DFHZDSP

Description:

The activate scan routine scans the four TCTTE activity queues: activate, log, wait, and NACP. DFHZACT scans the activate queue for request bits that may be set in the TCTTEs; for each request, DFHZACT calls the appropriate module. If no requests are outstanding, the TCTTE is removed from the queue. If the NACP queue is not empty, DFHZACT attaches DFHZNAC (if not already attached). Similarly, if the log queue is not empty, DFHZACT attaches DFHZRLG. DFHZACT scans the wait queue. If automatic resource definition is in the system, DFHZACT looks for any corresponding work elements. For each work element, DFHZATA is attached.

DFHZAIT
Entry points:

DFHZAIT1

Called by:

DFHSIF1

Description:

The attach initialization tables routine initializes local tables used by the mainline task-attach routine, DFHZATT. DFHZAIT generates the page command table from information supplied by the system initialization table, modifying it for use by DFHZATT. DFHZAIT also initializes the transaction code delimiter table.

DFHZAND
Entry points:

DFHZAND1

Called by:

DFHZARQ

Description:

The abend control block builder is used to assist in building the transaction abend block when an abend has occurred in an interconnected system. Its function is to extract the error sense bytes, and the diagnostic message sent by the other system, and to copy these into the block. As an initial step in its processing, DFHZAND acquires storage for the block itself.

DFHZARER
Entry points:

DFHZARER

Called by:

DFHZARL, DFHZARR, DFHZARRA

Description:

DFHZARER tidies up after an LU6.2 protocol error or session failure has been detected. For some errors, it calls DFHZNAC.

DFHZARL
Entry points:

DFHZARL1

Called by:

DFHACP, DFHCPCBA, DFHCPCLC, DFHCRS, DFHEGL, DFHETL, DFHLUP, DFHXFP, DFHXTP, DFHZARL, DFHZARM, DFHZERH, DFHZISP, DFHZLUS, DFHZSUP, DFHZTSP, DFHZXRL, DFHZXRT

Description:

DFHZARL is called via the DFHLUC macro, which passes the LU6.2 request in a parameter list mapped by the DFHLUCDS DSECT. If the request is for a remote APPC device, DFHZARL passes the parameter list to DFHZXRL for processing. (APPC is advanced program-to-program communication.) Otherwise, it examines the parameter list to determine the function required. Most functions are processed by DFHZARL. However, it calls the following modules as indicated:

DFHZARER - Protocol errors and exceptions
DFHZARR  - RECEIVE requests
DFHZARRA - FREE-STORE requests
DFHZERH  - Handling FMH7s and negative responses
DFHZISP  - ALLOCATE and FREE requests
DFHZRVL  - Receiving SNA indicators from VTAM
DFHZSDL  - Sending data to VTAM.

It also manages the logical receive buffer pointers TCTERBLA and TCTERBLL in a consistent manner with the physical receive buffer pointers TCTERBA and TCTERBDL, as (address, length) pairs.

DFHZARM
Entry points:

DFHZARM1

Called by:

DFHZARQ, DFHETL, DFHZISP

Description:

DFHZARM handles DFHTC macros for LU6.2 sessions.

DFHZARQ
Entry points:

DFHZARQ1

Called by:

DFHETC, DFHTC macro

Description:

The application request interface module analyzes the terminal control request from the application. For a VTAM terminal, it sets the appropriate flags and calls the required module or adds the TCTTE to the activate chain.

DFHZARR
Entry points:

DFHZARR

Called by:

DFHZARL

Description:

DFHZARR controls the receive function for LU6.2 application requests. It calls DFHZARRC to decide what to process next, or whether it is necessary to call its inline subroutine DFHZARR1 to receive more data. Then it processes the returned item, and decides whether the receive is complete. If the receive is not complete, DFHZARR loops, calling DFHZARRC and processing the returned item, until enough data has been received. DFHZARR uses the inline subroutine DFHZARR0 and the DFHZARRA module to control various receive buffers. It also uses DFHZARRF to receive FMH7s and negative responses, DFHZUSR to control the conversation state, and the inline subroutine DFHZARR1 to handle the type of receive and how much data is to be received.

DFHZARR0 is responsible for updating the logical buffer pointers TCTERBLA and TCTERBLL, shifting up data in the LU6.2 receive buffer, and resetting associated indicators, for example, TCTECCDR in the TCTTE LUC extension.

DFHZARR1 is responsible for setting fields TCTEMINL and TCTEMAXL in the TCTTE LUC extension to inform DFHZRVL how much data to receive and whether the request is a receive immediate or a receive and wait. DFHZARR1 calls DFHZARR0 to shift up data in the LU6.2 receive buffer, and then calls DFHZRVL to receive RUs from VTAM by placing requests on the active chain.

DFHZARRA
Entry points:

DFHZARRA

Called by:

DFHZARL, DFHZARR

Description:

DFHZARRA controls all functions concerned with the LU6.2 application receive buffer. These include GETMAIN and FREEMAIN of buffers, copying data into a buffer, and updating the pointer to the next free slot.

DFHZARRC
Entry points:

DFHZARRC

Called by:

DFHZARR

Description:

DFHZARRC is responsible for examining what has been received from VTAM on a particular session (for example, data, PS headers, FMH7s, and indicators), and for deciding what should be processed next on behalf of the application. The result is returned to DFHZARR.

DFHZARRF
Entry points:

DFHZARRF

Called by:

DFHZARR

Description:

DFHZARRF receives LU6.2 FMH7s and negative responses. It calls the DFHZARR0 subroutine to shift up data in the LU6.2 receive buffer, and then calls DFHZERH.

DFHZASX
Entry points:

DFHZASX1

Called by:

VTAM

Description:

The asynchronous command exit module is called by VTAM if an asynchronous command is received. The only such commands are request shutdown, quiesce at end of chain, release quiesce, and signal. DFHZASX sets up the TCTTE appropriately and returns control to VTAM.

DFHZATA
Entry points:

DFHZATA

Called by:

DFHZACT

Description:

The autoinstall program runs as the CATA transaction and performs operations necessary to INSTALL autoinstallable terminals. It requests information from a user program where appropriate.

DFHZATD
Entry points:

DFHZATD

Called by:

DFHZACT, DFHZNAC

Description:

The autoinstall delete program runs as the CATD transaction and performs operations necessary to DELETE autoinstalled terminals. It requests information from a user program where appropriate.

DFHZATDX
Entry points:

DFHZATDX

Called by:

DFHZATA, DFHZATD

Description:

DFHZATDX is the user program for autoinstall. It is called when:

For INSTALL, DFHZATDX selects a model name and the corresponding TRMIDNT to be used by the terminal control builder program (DFHTBSxx). This program can be used as a model for a user program.

DFHZATI
Entry points:

DFHZATI1

Called by:

DFHZACT

Description:

The automatic task initiation module checks for stress conditions, calls DFHZSIM if the node is not in session, acquires an RPL if necessary, and issues a conditional DFHKC TYPE=AVAIL macro. DFHZATI initiates bid protocols to decide whether the LU is available.

DFHZATMD
Entry points:

DFHZATMD

Called by:

DFHZATMF

Description:

This program deletes all remote terminal definitions that are flagged (by DFHZATMF) for deletion.

DFHZATMF
Entry points:

DFHZATMF

Called by:

Description:

This program flags remote terminals for Mass-deletion (by DFHZATMD). It is a part of the transaction routing component, and is started to flag all skeletons that have been unused for more than the terminal latency period for deletion.

DFHZATR
Entry points:

DFHZATR

Called by:

DFHZATR, DFHZXRE0

Description:

The autoinstall restart program runs as the CATR transaction at CICS startup after the time period specified in the AIRDELAY parameter. DFHZATR scans all autoinstalled terminals, and causes the CATD transaction to be called to delete any autoinstalled terminals that have not been used during the AIRDELAY interval.

DFHZATS
Entry points:

DFHZATS

Called by:

DFHZTSP, DFHCRS

Description:

The remote autoinstall program runs as the following four transactions:

CITS
The remote autoinstall function that is attached by DFHZTSP.
CDTS
The remote delete function that is attached by DFHZTSP or DFHCRS.
CFTS
The remote reset function that flags terminals for mass deletion after a CICS restart and is attached by DFHZTSP or DFHCRS.
CMTS
The mass delete function of remote terminals that is attached by DFHZATS transaction CFTS if it finds any terminals for deletion.
DFHZATT
Entry points:

DFHZATT1

Called by:

DFHZACT

Description:

The task attach module checks for stress conditions, allocates an RPL if necessary, and determines the task to be attached either from the data, or from the TCTTE (if the previous transaction specified TRANID), or from the AID (for a 3270). DFHZATT also checks for paging commands (having been modified by DFHZAIT). Finally a conditional ATTACH is issued. The module is applicable for VTAM, SRL, and MVS console support.

DFHZBAN
Entry points:

DFHZBAN

Called by:

DFHZOPN

Description:

The terminal control bind analysis program checks that a bind is valid and supportable and, if requested, sets the TCTTE information that supports the session parameters.

DFHZBKT
Entry points:

DFHZBKT1

Called by:

DFHZSDL, DFHZSLX, DFHZRLX, DFHZLUS

Description:

DFHZBKT maintains the bracket state for LU6.2.

DFHZBLX
Entry points:

DFHZBLX

Called by:

DFHZSCX

Description:

DFHZBLX is the part of of SCIP exit which processes LU6.2 binds. It matches a TCTTE to the BIND and schedules DFHZOPN to complete the BIND process. This module returns to VTAM.

DFHZCA
Entry points:

DFHZCANA

Called by:

See component submodules

Description:

DFHZCA is the name of the load module created when the following modules are link-edited together:

DFHZACT  - Activate scan
DFHZFRE  - FREEMAIN request
DFHZGET  - GETMAIN request
DFHZQUE  - Chaining
DFHZRST  - RESETSR.
DFHZCB
Entry points:

DFHZCBNA

Called by:

See component submodules

Description:

DFHZCB is the name of the load module created when the following modules are link-edited together:

DFHZATI
Automatic task initiation
DFHZDET
Task detach
DFHZHPSR
HPO send/receive
DFHZLRP
Logical record presentation
DFHZRAC
Receive-any completion
DFHZRAS
Receive-any slowdown processing
DFHZRVS
Receive specific
DFHZRVX
Receive specific exit
DFHZSDR
Send response
DFHZSDS
Send DFSYN
DFHZSDX
Send DFSYN data exit
DFHZSSX
Send DFSYN exit
DFHZUIX
User input exit
DFHZCC
Entry points:

DFHZCCNA

Called by:

See component submodules

Description:

DFHZCC is the name of the load module created when the following modules are link-edited together:

DFHZARER
LU6.2 protocol error and exception handler
DFHZARL
LU6.2 application request logic
DFHZARM
LU6.2 migration logic
DFHZARR
LU6.2 application receive request logic
DFHZARRA
LU6.2 application receive buffer support
DFHZARRC
LU6.2 classify what next to receive
DFHZARRF
LU6.2 receive FMH7 and ER1
DFHZBKT
LU6.2 bracket state machine
DFHZCHS
LU6.2 chain state machine
DFHZCNT
LU6.2 contention state machine
DFHZCRT
LU6.2 RPL_B state machine
DFHZRLP
LU6.2 post-VTAM receive logic
DFHZRLX
LU6.2 receive exit program
DFHZRVL
LU6.2 pre-VTAM receive logic
DFHZSDL
LU6.2 send logic
DFHZSLX
LU6.2 send exit program
DFHZSTAP
MRO or LU6.2 conversation state determination
DFHZUSR
LU6.2 conversation state machine
DFHZCHS
Entry points:

DFHZCHS1

Called by:

DFHZRLX, DFHZSDL, DFHZSLX

Description:

DFHZCHS maintains the chain state for LU6.2.

DFHZCLS
Entry points:

DFHZCLS1

Called by:

DFHZACT

Description:

The close destination module obtains an RPL if necessary, issues CLSDST to VTAM, and checks if it was accepted. The CLSDST exit handles the completion of the request. DFHZCLS performs a normal closedown procedure according to the LU type (for example, LU6 sends SBI and BIS). In the case of an abnormal closedown, DFHZCLS performs immediate termination, using CLSDST or TERMSESS commands. If the terminal was automatically defined, it is put out of service.

DFHZCLX
Entry points:

DFHZCLX1

Called by:

VTAM

Description:

The close destination exit module receives control from VTAM when a CLSDST or TERMSESS request completes. If the CLSDST or TERMSESS was successful, DFHZCLX cleans up TCTTE and returns to VTAM; otherwise it enqueues the TCTTE to DFHZNAC and then returns to VTAM.

DFHZCNA
Entry points:

DFHZCNA1

Called by:

DFHZDSP

Description:

The system console activity control program is responsible for CICS system requests. It performs the following functions:

DFHZCNR
Entry points:

DFHZCNR1

Called by:

DFHZARQ

Description:

The system console application request program performs READ, WRITE, and CONVERSE operations to an MVS system console that is used as a terminal.

DFHZCNT
Entry points:

DFHZCNT1

Called by:

DFHZLUS, DFHZRLX

Description:

DFHZCNT maintains the contention state for LU6.2.

DFHZCP
Entry points:

DFHZCPNA

Called by:

See component submodules

Description:

DFHZCP is the name of the load module created when the following modules are link-edited together:

DFHZARQ  - Application request handler
DFHZATT  - Attach routine
DFHZCNA  - System console activity control
DFHZDSP  - Dispatcher
DFHZISP  - Allocate/free/point routine
DFHZSUP  - Startup task
DFHZUCT  - 3270 uppercase translation.
DFHZCQ
Entry points:

DFHZCQ

Called by:

DFHAMTP, DFHCRS, DFHQRY, DFHTCRP, DFHWKP, DFHZATA, DFHZATD, DFHZTSP, DFHZXCU

Description:

DFHZCQ is the control program for all requests for the dynamic add and delete of terminal control table entries. It is called by resource definition online (RDO) to:

The main subroutines of DFHZCQ are:

DFHZCQCH - Catalog a TCT element
DFHZCQDL - Delete
DFHZCQIN - Initialize DFHZCQ
DFHZCQIQ - Inquire about TCTTE
DFHZCQIS - Install TCTTE
DFHZCQIT - Add macro-generated TCTTE
DFHZCQRS - Restore ZC resource.
DFHZCQDL
Entry points:

DFHZCQDL

Called by:

DFHZCQ00, DFHZNAC, RDO

Description:

DFHZCQDL dynamically deletes a TCT entry when the entry is quiesced. This module is part of DFHZCQ.

DFHZCQIN
Entry points:

DFHZCQIN

Called by:

DFHTCRP

Description:

DFHZCQIN initializes DFHZCQ for all its operations. This module is part of DFHZCQ.

DFHZCQIQ
Entry points:

DFHZCQIQ

Called by:

DFHZTSP

Description:

DFHZCQIQ obtains the parameters for a TCT resource and is called by DFHZTSP in the terminal-owning node as part of the process of shipping a TCT definition to a remote system. This module is part of DFHZCQ.

DFHZCQIS
Entry points:

DFHZCQIS

Description:

DFHZCQIS installs a TCTTE. If the resource already exists, the old resource is deleted.

DFHZCQIT
Entry points:

DFHZCQIT

Description:

DFHZCQIT adds a macro-generated TCTTE to a CICS system.

DFHZCQRS
Entry points:

DFHZCQRS

Description:

During emergency restart or warm start, DFHTCRP restores terminal control resources to the state they were in before the last shutdown of CICS, using the restart data set.

DFHZCRQ
Entry points:

DFHZCRQ1

Called by:

TC CTYPE requests

Description:

The CTYPE request module analyzes DFHTC CTYPE commands, and calls or links to the appropriate send module.

DFHZCRT
Entry points:

DFHZCRT1

Called by:

DFHZACT, DFHZARL, DFHZFRE, DFHZNAC, DFHZRAC, DFHZRLP, DFHZRVL, DFHZSDL, DFHZSHU, DFHZSTU, DFHZTPX

Description:

DFHZCRT maintains the RPL_B state for LU6.2.

DFHZCUT
Entry points:

DFHZCUT

Called by:

DFHCSSC, DFHLUP, DFHSNAT, DFHTCPLR

Description:

DFHZCUT manages the persistent verification signed-on-from list, also known as the local userid table (LUIT). There is one LUIT per connection supporting persistent verification.

DFHZCW
Entry points:

DFHZCWNA

Called by:

See component submodules

Description:

DFHZCW is the name of the load module created when the following modules are link-edited together:

DFHZERH  - LU6.2 error program
DFHZEV1  - LU6.2 BIND security
DFHZEV2  - LU6.2 BIND security
DFHZLUS  - LU6.2 session management program.
DFHZCX
Entry points:

DFHZCXNA

Called by:

See component submodules

Description:

DFHZCX is the name of the load module created when the following modules are link-edited together:

DFHZABD  - Abend routine for incorrect requests
DFHZAND  - Build TACB before issuing PC abends
DFHZCNR  - System console application request
DFHZIS1  - ISC or IRC syncpoint
DFHZIS2  - IRC internal requests
DFHZLOC  - Locate TCTTE and ATI requests
DFHZSTU  - Terminal control status change.
DFHZCXR
Entry points:

DFHZCXRA

Called by:

See component submodules

Description:

DFHZCXR is the generic name allocated to a composite module that is not called by any other code. It includes the following transaction-routing related modules:

DFHZTSP  - Terminal-sharing program
DFHZXRL  - Routes LU6.2 commands to TOR
DFHZXRT  - Receives LU6.2 commands from AOR.
DFHZCY
Entry points:

DFHZCYNA

Called by:

See component submodules

Description:

DFHZCY is the name of the load module created when the following modules are link-edited together:

DFHZASX
DFASY exit
DFHZDST
SNA-ASCII translation
DFHZLEX
LERAD exit
DFHZLGX
LOGON exit
DFHZLTX
LOSTERM exit
DFHZNSP
Network services exit
DFHZOPA
Open VTAM ACB
DFHZRRX
Release request exit
DFHZRSY
Resynchronization
DFHZSAX
Send synchronous command exit
DFHZSCX
SESSION control input exit
DFHZSDA
Send synchronous command
DFHZSES
SESSIONC
DFHZSEX
SESSIONC exit
DFHZSHU
Shutdown VTAM
DFHZSIM
SIMLOGON
DFHZSIX
SIMLOGON exit
DFHZSKR
Send response to command
DFHZSLS
Set logon start
DFHZSYN
Handle CTYPE=SYNC or CTYPE=RECOVER request
DFHZSYX
SYNAD exit
DFHZTPX
TPEND exit
DFHZTRA
Create ZCP or VIO trace requests
DFHZXRC
XRF session state data analysis
DFHZCZ
Entry points:

DFHZCZNA

Called by:

See component submodules

Description:

DFHZCZ is the name of the load module created when the following modules are link-edited together:

DFHZCLS  - CLSDST
DFHZCLX  - CLSDST exit
DFHZCRQ  - Command request
DFHZEMW  - Error message writer
DFHZOPN  - OPNDST
DFHZOPX  - OPNDST exit
DFHZRAQ  - Read-ahead queuing
DFHZRAR  - Read-ahead retrieval
DFHZTAX  - Turnaround exit.
DFHZDET
Entry points:

DFHZDET1

Called by:

DFHZACT, DFHZISP

Description:

The task detach module receives control when a detach request is issued by DFHZISP. If a WRITE is pending (deferred write or any write), the SEND routine is called. If the SEND cannot complete, the DETACH request is left on the activate queue. If requests are queued then DFHZACT drives DFHZDET when the operation is complete. If the node is in between bracket state, an end bracket is sent.

DFHZDSP
Entry points:

DFHZDSP1

Called by:

DFHSII1

Description:

The dispatcher module handles the dispatching of modules for execution, and gives control to VTAM modules of ZCP using DFHZACT.

DFHZDST
Entry points:

DFHZDST1

Called by:

DFHZRVX, DFHZSDS

Description:

The data stream translator module translates data between EBCDIC and ASCII code while that data is being sent and received on VTAM sessions.

DFHZEMW
Entry points:

DFHZEMW1

Called by:

DFHACP, DFHZDET, DFHZNAC, DFHZRAC

Description:

The error message writer module handles all requests for error messages on VTAM supported terminals/LUs. According to the request flags, it:

DFHZERH
Entry points:

DFHZERH1

Called by:

DFHZARL, DFHZARRF

Description:

DFHZERH handles the sending and receiving of LU6.2 FMH7s and negative responses. It also manages the logical receive buffer pointers TCTERBLA and TCTERBLL in a consistent manner with the physical receive buffer pointers TCTERBA and TCTERBDL, as (address, length) pairs.

DFHZEV1
Entry points:

DFHZEV11

Description:

DFHZEV1 is the LU6.2 bind-time security encryption validation program, part 1.

DFHZEV2
Entry points:

DFHZEV21

Description:

DFHZEV2 is the LU6.2 bind-time security encryption validation program, part 2.

DFHZFRE
Entry points:

DFHZFRE1

Called by:

DFHZACT, DFHZEMW, DFHZCLS, DFHZCLX

Description:

The FREEMAIN module is used to free storage (RPLs, NIBs, bind areas, TIOAs, buffer lists, LUC send/receive buffers, and extract logon data) acquired by ZC modules. Some storage is also freed by other ZC modules.

DFHZGET
Entry points:

DFHZGET1

Called by:

DFHZACT, DFHZARL, DFHZATI, DFHZATT, DFHZCLS, DFHZISP, DFHZOPN, DFHZRAC, DFHZRST, DFHZRSY, DFHZRVL, DFHZRVS, DFHZSDA, DFHZSDL, DFHZSDR, DFHZSDS, DFHZSES, DFHZSKR

Description:

The GETMAIN module is used to acquire an RPL, NIB, bind area, TIOA, buffer list, or LUC send/receive buffer. DFHZGET also sets up the dynamic NIB using the information in the NIB descriptor block. Normally, when a ZC module requires some of the above storage, it invokes DFHZGET to obtain the storage; if this is unsuccessful, it may queue the request, and then DFHZACT calls DFHZGET on behalf of the caller.

DFHZHPRX
Entry points:

DFHZHPNA

Called by:

DFHKCSP (via DFHZHPSR and DFHKCP)

Description:

In authorized path SRB mode, DFHZHPRX issues VTAM EXECRPL.

DFHZHPSR
Entry points:

DFHZHPS1

Called by:

DFHZRVS, DFHZSDS

Description:

DFHZHPSR is the SEND and RECEIVE module for the HPO environment.

DFHZISP
Entry points:

DFHZISP1

Called by:

DFHISP, DFHKCP

Description:

The intersystem program services ISC requests to free, or point to, a particular TCTTE within a specified system, or to allocate a TCTTE within a specified system. DFHZISP also handles ATI requests, and checks for a terminal time-out.

DFHZIS1
Entry points:

DFHZIS11

Description:

DFHZIS1 handles the transmissions control CTYPE requests of Prepare, Syncpoint Request (SPR), Commit, and Abort. Each request is translated into the appropriate ISC/IRC action and is transmitted to the connected system.

DFHZIS2
Entry points:

DFHZIS21

Called by:

DFHZARQ, DFHZIS1

Description:

The intersystem program provides services for CICS system code that wants to use intersystem or interregion (IRC) function requests:

RECEIVE
Is invoked when DFHCRNP gets input data as a result of a ‘switch first’ SVC request.
IOR
The IRC input/output routine. This interfaces with the IRC SVC in order to send data to the other end of the connection, or await data from there.
GETDATA
Is used to fetch input data into a TIOA.
DISCONNECT
Disconnects a given IRC link.
STOP
Quiesces interregion activity, either for connections to a given system, or for the whole of IRC.
LOGOFF
Issues a logoff request to the IRC SVC. This completes IRC activity for this CICS system.
OPERATIVE
Allows connections to be made to a given system.
RECABRT
processes input abend FMHs (FMH07).
DFHZLEX
Entry points:

DFHZLEX1

Called by:

VTAM

Description:

The logical error address (LERAD) exit module receives control from VTAM when a logical error is detected. Logical errors are usually the result of an incorrectly defined terminal table.

DFHZLGX
Entry points:

DFHZLGX1

Called by:

VTAM

Description:

The logon exit module receives control from VTAM when a terminal logs on to the network. DFHZLGX scans the CICS NIBs and, if a match is found, sets an OPNDST request in the corresponding TCTTE and places it on the activate queue. If no match is found, DFHZLGX defines a terminal automatically, if possible, by allocating an autodefine work element which holds the CINIT_RU. The work element is then queued for activate scan processing. Otherwise, a dummy TCTTE is placed on the NACP queue to write an error message.

DFHZLOC
Entry points:

DFHZLOC1

Called by:

DFHTC CTYPE=LOCATE

Description:

The locate module provides two functions:

DFHZLRP
Entry points:

DFHZLRP1

Called by:

DFHZARQ, DFHZSUP

Description:

The logical record presentation module handles deblocking of input data. The delimiters that are recognized are new line (NL), interchange record separator (IRS), and transparent (TRN). One logical record is returned for each DFHTC TYPE=READ request.

DFHZLTX
Entry points:

DFHZLTX1

Called by:

VTAM

Description:

The lost terminal (LOSTERM) exit module receives control when VTAM detects a loss of contact with a node. There are three possible return codes set by VTAM on entry to this routine:

node lost, recovery in progress
The terminal is placed out of service with no further action taken.
node lost, recovery successful
The TCTTE is queued to the NACP queue with a ‘successful’ error code set; NACP issues a CLSDST, schedules a SIMLOGON, and issues an information message.
node lost, no recovery or unsuccessful recovery
The TCTTE is queued to the NACP queue with an ‘unsuccessful’ error code set; NACP issues a CLSDST and also the appropriate message.
DFHZLUS
Entry points:

DFHZLUS1

Description:

DFHZLUS handles session management for LU6.2 sessions.

DFHZNAC
Entry points:

DFHZNANA

Called by:

DFHZACT

Description:

The node abnormal condition program is attached by DFHZACT when an error in communication with a logical unit occurs. DFHZNAC performs the following functions:

DFHZNAC consists of the following copybooks:

DFHZNCA  - Primary error action table and exits
DFHZNCE  - Take action routine
DFHZNCS  - Sense decode routine
DFHZNCV  - VTAM return code routine.
DFHZNEP
Entry points:

DFHZNENA

Called by:

DFHZNAC

Description:

The user-replaceable node error program provides:

DFHZNSP
Entry points:

DFHZNSP1

Called by:

VTAM

Description:

The network service program is invoked when VTAM detects a network service error; for example, when attempting to connect two nodes together, or when the link between two nodes is broken unexpectedly. This module receives control from the VTAM NSEXIT.

DFHZOPA
Entry points:

DFHZOPA1

Called by:

DFHEIQVT

Description:

The open VTAM ACB module is invoked by DFHEIQVT when the master terminal command VTAM OPEN is issued. The ACB is opened and DFHZSLS is called to accept logon requests.

DFHZOPN
Entry points:

DFHZOPN1

Called by:

DFHZACT

Description:

The open destination module acquires storage for an RPL and NIB and BIND areas if the TCTTE does not have these resources already, and sets up the BIND image if required. DFHZOPN then issues a VTAM OPNDST macro (or OPNSEC macro if secondary, to respond to an incoming BIND) to establish a session between CICS and the remote LU.

DFHZOPX
Entry points:

DFHZOPX1

Called by:

VTAM

Description:

The open destination exit module receives control from VTAM on completion of the OPNDST macro in DFHZOPN. If the OPNDST was successful, it indicates in the TCTTE that SDT (start data transfer) is to be sent and checks whether a "good morning" message should be triggered. It then returns to VTAM.

DFHZQUE
Entry points:

DFHZQUE1

Called by:

All ZCP exits called by VTAM, DFHTCQUE macro

Description:

The queue manipulation module processes all requests to add or remove a TCTTE to or from a ZCP activate queue. Additions to the activate queue made by mainline modules use compare-and-swap (CS), because an exit routine may also be adding to the queue asynchronously.

DFHZRAC
Entry points:

DFHZRAC1

Called by:

DFHZDSP

Description:

The receive-any completion module processes the completion of receive-any requests, sets up the TIOA to be passed to attach, and reissues the RECEIVE_ANY macro.

DFHZRAQ
Entry points:

DFHZRAQ1

Called by:

DFHZARQ, DFHZSYN

Description:

The read-ahead queuing module is used to save the inbound data stream in temporary storage when an interlock is caused by both the host and the terminal wanting to send data at the same time.

DFHZRAR
Entry points:

DFHZRAR1

Called by:

DFHZARQ

Description:

The read-ahead retrieval module is called to retrieve data previously saved in temporary storage by DFHZRAQ.

DFHZRAS
Entry points:

DFHZRAS1

Called by:

DFHZRAC

Description:

The receive-any slowdown processing module issues RECEIVE SPEC NQs on LU6.2 sessions for connections and modegroups for which there are ALLOCATE requests queued. This is only done on sessions considered most likely to lead to freeing a "flooding" situation that occurred when LU6.2 connections were reestablished after a failure.

DFHZRLG
Entry points:

DFHZRLNA

Called by:

DFHZACT

Description:

The response logger program logs responses received for protected data sent to an APB. DFHZRLG processes TCTTEs on the log queue when attached by DFHZACT.

DFHZRLP
Entry points:

DFHZRLP1

Called by:

DFHZDSP

Description:

DFHZRLP handles the completion of LU6.2 RECEIVE requests, using the receive RPL addressed by field TCTERPLB in the TCTTE LUC extension. It also manages the logical receive buffer pointers TCTERBLA and TCTERBLL in a consistent manner with the physical receive buffer pointers TCTERBA and TCTERBDL, as (address, length) pairs.

DFHZRLX
Entry points:

DFHZRLX1

Called by:

VTAM

Description:

DFHZRLX is a VTAM exit routine that queues the completed RPL for (post-VTAM) processing by DFHZRLP.

DFHZRRX
Entry points:

DFHZRRX1

Called by:

VTAM

Description:

The release request exit module receives control from VTAM when another application program has requested connection to a terminal currently connected to CICS. If the terminal is not busy, a CLSDST request is queued to the activate chain. Otherwise the release request indicator is set and the request is processed later by module DFHZDET.

DFHZRSP
Entry points:

DFHZRSNA

Description:

The resynchronization send program performs 3614-dependent actions and is also used to retransmit committed output messages. The message is retrieved from temporary storage if necessary.

DFHZRST
Entry points:

DFHZRST1

Called by:

DFHZACT, DFHZATI, DFHZCRQ, DFHZDET, DFHZEMW, DFHZERH, DFHZNAC, DFHZRAC, DFHZRSY, DFHZSTU

Description:

The RESETSR module changes the mode of a session with a terminal and cancels unsatisfied RECEIVE requests. The mode that is set can be Continue Any (CA) or Continue Specific (CS) and RTYPE=DFSYN, DFASY, or RESP.

DFHZRSY
Entry points:

DFHZRSY1

Called by:

DFHZACT

Description:

The resynchronize module resynchronizes CICS and other nodes of the network. DFHZRSY checks whether inbound and outbound sequence numbers are valid.

DFHZRVL
Entry points:

DFHZRVL1

Called by:

DFHZARL, DFHZARRL

Description:

DFHZRVL processes RECEIVE commands for LU6.2 sessions, using the receive RPL (RPL_B) addressed by field TCTERPLB in the TCTTE LUC extension. The processing state of the receive RPL is held in the RPL_B state machine field TCTERPBS, also in the TCTTE LUC extension.

DFHZRVS
Entry points:

DFHZRVS1

Called by:

DFHZACT

Description:

The receive specific module initiates a DFSYN receive specific to obtain the next logical record from a node when a user application issues a RECEIVE command.

DFHZRVX
Entry points:

DFHZRVX1

Called by:

VTAM

Description:

The receive specific exit module receives control from VTAM when a receive specific is completed. If the data received is too long for the TIOA provided, the overlength data flag is turned on in the TCTTE and the TCTTE is put back on the activate chain. Otherwise, the response is checked and marked in the TCTTE. The data length is set in the TIOA and the FMH is removed.

DFHZSAX
Entry points:

DFHZSAX1

Called by:

VTAM

Description:

The send DFASY exit module receives control from VTAM when an asynchronous command has completed. It places the TCTTE on the NACP queue if recovery is needed.

DFHZSCX
Entry points:

DFHZSCX1

Called by:

VTAM

Description:

The SCIP exit module is entered whenever the following asynchronous commands are received:

The module correlates BINDs to a TCTTE and schedules DFHZOPN to complete the BIND process. For the other commands, it takes appropriate action and then schedules DFHZNAC using the NACP queue. This module calls DFHZBLX to process LU6.2 binds.

DFHZSDA
Entry points:

DFHZSDA1

Called by:

DFHZACT, DFHZSDS

Description:

The send data flow asynchronous module handles asynchronous command requests. It ensures that an RPL is allocated, primes the RPL for the requested command, and issues the VTAM asynchronous send macro.

DFHZSDL
Entry points:

DFHZSDL1

Called by:

DFHZARL

Description:

DFHZSDL processes SEND commands for LU6.2 sessions, using the RPL addressed by field TCTERPLA in the TCTTE.

DFHZSDR
Entry points:

DFHZSDR1

Called by:

DFHZACT, DFHZCRQ, DFHZDET, DFHZRVS, DFHZSDA, DFHZSDS

Description:

The send response module sends responses to nodes when a synchronization request for a terminal is made and a response is outstanding from a previous operation. If errors occur during task initiation, this module is responsible for the negative response.

DFHZSDS
Entry points:

DFHZSDS1

Called by:

DFHZACT, DFHZARQ, DFHZATI, DFHZATT, DFHZDET

Description:

The send data synchronous module sets up and issues the appropriate VTAM send macro for requests of "send data" or an SNA synchronous command.

DFHZSDX
Entry points:

DFHZSDX1

Called by:

VTAM

Description:

The send data synchronous exit module receives control from VTAM when a SEND request is complete. It checks the RPL for successful completion of the message sent and takes appropriate action.

DFHZSES
Entry points:

DFHZSES1

Called by:

DFHZACT, DFHZRSY

Description:

The session control module is entered whenever a session control command is requested by CICS. It sets up and issues the VTAM SESSIONC command.

DFHZSEX
Entry points:

DFHZSEX1

Called by:

VTAM

Description:

The SESSIONC exit module receives control from VTAM when a SESSIONC command has completed. If the command was successful, it turns off the corresponding flags and enqueues the TCTTE on the activate chain. If the completion was not successful, the TCTTE is placed on the NACP queue for recovery processing.

DFHZSHU
Entry points:

DFHZSHU1

Called by:

DFHZDSP

Description:

The close VTAM ACB module is invoked whenever CICS and VTAM are being uncoupled. This may be as a result of DFHZTPX being driven as the result of a VTAM halt command or the issue of the master terminal command SET VTAM,CLOSE|IMMCLOSE. The status of all sessions is checked and, when all are inactive, the ACB is closed.

DFHZSIM
Entry points:

DFHZSIM1

Called by:

DFHZACT

Description:

The simulate logon module is entered to issue a VTAM SIMLOGON or REQSESS (if secondary) request to place a node in session without the operator having to logon. LU6.2 can be selected by mode name.

DFHZSIX
Entry points:

DFHZSIX1

Called by:

VTAM

Description:

Whenever a SIMLOGON or REQSESS command has been completed, this exit routine is scheduled by VTAM. On successful completion, it turns off the SIMLOGON requested flag and enqueues the TCTTE or TCTME on the activate chain or, if NACP is required, for NACP processing.

DFHZSKR
Entry points:

DFHZSKR1

Called by:

DFHZACT

Description:

The send command response module sends responses to VTAM commands including response to BIND, STSN, and SDT. A positive or negative response can be sent. The module is for secondary LU support only.

DFHZSLS
Entry points:

DFHZSLS1

Called by:

DFHZDSP, DFHZOPA

Description:

The SETLOGON start module issues SETLOGON to cause VTAM to accept automatic logon requests, and issues the initial RECEIVE ANYs for RPLs in the receive-any pool. DFHZSLS also examines the SIT to determine whether autodefine is used. If it is, the appropriate system initialization parameters are copied to the TCT prefix.

DFHZSLX
Entry points:

DFHZSLX1

Called by:

VTAM

Description:

DFHZSLX is a VTAM exit routine that handles the completion of LU6.2 SEND requests.

DFHZSSX
Entry points:

DFHZSSX1

Called by:

VTAM

Description:

The send data flow synchronous exit module receives control when the send of a DFSYN command has been completed.

DFHZSTAP
Entry points:

DFHZSTA1

Called by:

DFHEGL, DFHETC, DFHETL

Description:

DFHZSTAP determines the state of an MRO or LU6.2 conversation from an application viewpoint.

DFHZSTU
Entry points:

DFHZSTU1

Called by:

DFHTC CTYPE=STATUS, DFHEIQMT, DFHEIQSC, DFHEIQST

Description:

DFHZSTU changes the status of TCTTEs and TCTSEs. It can change the following statuses:

DFHZSUP
Entry points:

DFHZSUP1

Called by:

DFHKCP

Description:

The startup task module is the entry point for all terminal-related tasks. DFHZSUP performs the following functions:

DFHZSYN
Entry points:

DFHZSYN1

Called by:

DFHDBP

Description:

DFHZSYN handles CTYPE=SYNC and RECOVER requests. For protected message support, DFHSPP issues CTYPE=SYNC to clear protected messages. For RECOVER requests, DFHZSYN ensures that no further I/O is issued to that session, and that UNBIND flows.

DFHZSYX
Entry points:

DFHZSYX1

Called by:

VTAM

Description:

The SYNAD exit module receives control from VTAM when a catastrophic error is encountered. DFHZSYX determines the type of error and the appropriate action to be taken, and schedules NACP using the NACP queue to complete the recovery processing.

DFHZTAX
Entry points:

DFHZTAX1

Called by:

VTAM

Description:

The turnaround exit module is called by VTAM on completion of the SEND operation initiated by DFHZRVS in order to perform a turnaround in flip-flop protocol.

DFHZTPX
Entry points:

DFHZTPX1

Called by:

VTAM

Description:

The TPEND exit module receives control when VTAM is terminating. It schedules a CLSDST for each active session if quick shutdown is required, and sets bits in the TCT prefix so that DFHZSHU is invoked.

DFHZTRA
Entry points:

DFHZTRA1

Called by:

DFHZACT, DFHZDET, DFHZRAC, DFHZRLP, DFHZRVS, DFHZSDL, DFHZSDR, DFHZSDS

Description:

DFHZTRA creates VIO trace entries.

DFHZTSP
Entry points:

DFHZTSP1

Called by:

DFHAPRT, DFHISP, DFHRTE, DFHTPS, DFHZARQ, DFHZCQ, DFHZSUP

Description:

The terminal sharing program acquires a TCTTE for a link to a remote CICS address space, and transfers request data to that space. DFHZTSP also receives requests from the remote address space.

DFHZUCT
Entry points:

DFHZUCT1

Called by:

DFHAPRT, DFHZARQ, DFHZCNA, DFHZRAC, DFHZRVX, DFHZSUP

Description:

The uppercase translate module converts a VTAM 3270 data stream into uppercase.

DFHZUIX
Entry points:

DFHZUIX1

Called by:

DFHZACT, DFHZRAC, DFHZRVX

Description:

The user input exit module is called directly (by DFHZRAC) or indirectly (by DFHZRVX via DFHZACT) to link to the user’s XZCIN exit.

DFHZUSR
Entry points:

DFHZUSR1

Called by:

DFHACP, DFHETL, DFHZARER, DFHZARL, DFHZARM, DFHZARR, DFHZARRF, DFHZERH, DFHZOPX, DFHZSTAP, DFHZSUP, DFHZUSR, DFHZXRL, DFHZXRT

Description:

DFHZUSR maintains the conversation state for LU6.2.

DFHZXCU
Entry points:

DFHZXCU

Description:

The VTAM XRF catch-up program is used to send messages that allow a new alternate system to catch up with the current state of the active system for:

The program is invoked when a new alternate system signs on.

DFHZXQO
Entry points:

DFHZXQO

Called by:

DFHTCRP, DFHZXST

Description:

The XRF ZCP tracking queue organizer allows pending XRF tracking activity to be stored in a way that honors interdependencies, while allowing such requests to be met as soon as all their prerequisites are fulfilled. This component consists of a data structure and accessing program that uses the CICS catalog key structure to identify all the actions for a single resource and the dependencies between them. Actions are put into the structure on receipt in DFHTCRP, and removed by DFHTCRP and at the end of DFHZNAC processing for standby BIND and CLSDST completion. The structure is freed at the end of DFHTCRP tracking.

DFHZXRC
Entry points:

DFHZXRC1

Called by:

DFHZACT

Description:

DFHZXRC analyzes the data received in response to the SESSIONC CONTROL=SWITCH command. It determines the state of the session at the point when it was switched, and initiates the necessary action to clean up and recover the session.

DFHZXRE0
Entry points:

DFHZXRE0

Called by:

System

Description:

DFHZXRE0 runs the CXRE transaction to perform autoconnect and XRF reconnect processing. It also starts the acquire process for terminals with flag TCTEXRE set.

DFHZXRL
Entry points:

DFHZXRL1

Called by:

DFHZARL, DFHZISP

Description:

DFHZXRL is executed in an application-owning region. It routes LU6.2 commands to the terminal-owning region.

DFHZXRT
Entry points:

DFHZXRT1

Called by:

DFHZTSP

Description:

DFHZXRT executes in a terminal-owning region. It receives LU6.2 commands from the application-owning region, and issues them to an APPC device.

DFHZXST
Entry points:

DFHZXST

Called by:

DFHETC, DFHSIJ1, DFHTCRP, DFHTCRPS, DFHZNAC, DFHZOPA, DFHZXCU

Description:

XRF ZCP session-state tracking is called by:


8.
Interest ladder: ladder within DFHIRW10 that expresses interest in all types of MRO work.

[[ Contents Previous Page | Next Page Index ]]