The following list shows, for each module:
In general, this list is restricted to non-OCO modules. In the few cases where OCO modules are included, no design details are given.
DFHACPNA
DFHAPRM, DFHAPXME
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.
DFHAICB
User application program
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.
DFHALPNA
DFHCRQ, DFHCRS, DFHICP, DFHTPQ, DFHTPR, DFHTPS, DFHZATI, DFHZISP, DFHZNAC, DFHZTSP
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.
DFHAMPNA
DFHEIP, DFHSII1
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.
DFHAPJCN
User
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.
DFHSIPNA
DFHAPDM
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
DFHEIP, DFHSTST
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:
DFHAPTD
DFHETD, DFHTDA, DFHTDB, ME domain
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
the timer domain to handle NOTIFY calls for the application domain.
The DFHAPTO module looks at the token passed by the timer domain and resumes either the DFHAPTI or DFHAPTIX module, as appropriate.
DFHAPTIM
runs as a system task attached by the DFHSII1 module.
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
runs as a system task attached by the DFHSII1 module.
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.
DFHASVNA
DFHCSVC
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
DFHTBSxx
DFHBSIB3 adds BMS 3270 support to a TCT table entry.
DFHBSIZ1
DFHTBSxx
DFHBSIZ1 adds SCS support to a TCT table entry.
DFHBSIZ3
DFHTBSxx
DFHBSIZ3 adds DFHZCP 3270 support to a TCT table entry.
DFHBSMIR
DFHTBSxx
DFHBSMIR builds a TCT table entry for a session.
DFHBSMPP
DFHTBSxx
DFHBSMPP builds a TCT table entry for a pipeline pool entry.
DFHBSM61
DFHTBSxx
DFHBSM61 builds sessions for an LU6.2 mode group.
DFHBSM62
DFHTBSxx
DFHBSM62 builds the mode entry for an LU6.2 mode group.
DFHBSS
DFHTBSxx
DFHBSS adds a new connection (system entry) to a CICS system.
DFHBSSA
DFHTBSxx
DFHBSSA initializes DFHKCP support in a new TCT system entry.
DFHBSSF
DFHTBSxx
DFHBSSF initializes the statistics counters in a new TCT system entry.
DFHBSSS
DFHTBSxx
DFHBSSS builds security support for a new TCT system entry.
DFHBSSZ
DFHTBSxx
DFHBSSZ builds VTAM interface support for a new TCT system entry.
DFHBSSZB
DFHTBSxx
DFHBSSZB adds a new batch interregion connection to a CICS system.
DFHBSSZG
DFHTBSxx
DFHBSSZG adds a new advanced program-to-program communication (APPC) single-session connection to a CICS system.
DFHBSSZI
DFHTBSxx
DFHBSSZI adds an indirect terminal control system table entry to a CICS system.
DFHBSSZL
DFHTBSxx
DFHBSSZL adds a local terminal control system table entry to a CICS system.
DFHBSSZM
DFHTBSxx
DFHBSSZM introduces a new connection (system) to ZCP.
DFHBSSZP
DFHTBSxx
DFHBSSZP builds an advanced program-to-program communication (APPC) parallel-session connection to a CICS system.
DFHBSSZR
DFHTBSxx
DFHBSSZR builds an MRO session entry.
DFHBSSZS
DFHTBSxx
DFHBSSZS builds an advanced program-to-program communication (APPC) session entry.
DFHBSSZ6
DFHTBSxx
DFHBSSZ6 builds an LU6.1 connection entry.
DFHBST
DFHTBSxx
DFHBST performs TCTTE initialization common to terminals, pipeline pool entries, and sessions for IRC and ISC.
DFHBSTB
DFHTBSxx
DFHBSTB adds support for BMS to a new TCT terminal or session entry.
DFHBSTBL
DFHTBSxx
DFHBSTBL adds support for logical device components (LDCs).
DFHBSTB3
DFHTBSxx
DFHBSTB3 adds partition support to a new TCT terminal or session entry.
DFHBSTC
DFHTBSxx
DFHBSTC performs those operations that are executed after the installation of a terminal.
DFHBSTD
DFHTBSxx
DFHBSTD adds data interchange program (DFHDIP) support for a new TCT table entry.
DFHBSTE
DFHTBSxx
DFHBSTE adds EXEC diagnostic facility (EDF) support for a new TCT table entry.
DFHBSTH
DFHTBSxx
DFHBSTH initializes EXEC interface fields for a new TCT table entry.
DFHBSTI
DFHTBSxx
DFHBSTI adds interval control program (DFHICP) support for a new TCT table entry.
DFHBSTM
DFHTBSxx
DFHBSTM adds message generation program (DFHMGP) support for a new TCT table entry.
DFHBSTP3
DFHTBSxx
DFHBST adds 3270-copy support for a new TCT table entry.
DFHBSTS
DFHTBSxx
DFHBSTS adds signon program (DFHSNP) support for a new TCT table entry.
DFHBSTT
DFHTBSxx
DFHBSTT adds task control program (DFHKCP) support for a new TCT table entry.
DFHBSTZ
DFHTBSxx
DFHBSTZ builds a session or terminal resource.
DFHBSTZA
DFHTBSxx
DFHBSTZA adds DFHZCP activity scan support to a new TCT terminal or session entry.
DFHBSTZB
DFHTBSxx
DFHBSTZB appends or deletes a BIND image for a TCT terminal or session entry.
DFHBSTZC
DFHTBSxx
DFHBSTZC adds a single-session LU6.2 system as an advanced program-to-program communication (APPC) terminal.
DFHBSTZE
DFHTBSxx
DFHBSTZE sets error message writer fields for a new TCT table entry.
DFHBSTZH
DFHTBSxx
DFHBSTZH adds an interregion (IRC) batch session to a CICS system.
DFHBSTZL
DFHTBSxx
DFHBSTZL adds logical device code support to a new TCT terminal or session entry.
DFHBSTZO
DFHTBSxx
DFHBSTZO adds an MVS console to a CICS system.
DFHBSTZP
DFHTBSxx
DFHBSTZP adds a pipeline pool entry to a CICS system.
DFHBSTZR
DFHTBSxx
DFHBSTZR adds an interregion (IRC) session to a CICS system.
DFHBSTZS
DFHTBSxx
DFHBSTZS adds an advanced program-to-program communication (APPC) session to the terminal control program.
DFHBSTZV
DFHTBSxx
DFHBSTZV adds the parts of a terminal or session TCT table entry that are special to VTAM and IRC.
DFHBSTZZ
DFHTBSxx
DFHBSTZZ adds a non-APPC session to the TCT. (APPC is advanced program-to-program communication.)
DFHBSTZ1
DFHTBSxx
DFHBSTZ1 adds support for a remote terminal to a CICS system.
DFHBSTZ2
DFHTBSxx
DFHBSTZ2 adds support for a remote advanced program-to-program communication (APPC) connection.
DFHBSXGS
DFHBSMIR, DFHZTSP
DFHBSXGS generates a unique session name for an LU6.2 TCTTE.
DFHBSZZ
DFHTBSxx
DFHBSZZ adds a terminal or session to the TCT.
DFHBSZZS
DFHTBSxx
DFHBSZZS adds a new session to LU6.2 support.
DFHBSZZV
DFHTBSxx
DFHBSZZV adds a VTAM terminal or session to the TCT.
DFHCAPNA
DFHTCRP
DFHCAPB processes command analysis for VTAM terminal definitions contained in a load module table DFHRDTxx for TCT migration.
DFHCCNV
DFHCHS, DFHMIRS
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.
DFHCMPNA
DFHETR
The CICS monitoring compatibility module is invoked by the old event monitoring point of EXEC CICS ENTER TRACEID to interface to the monitoring domain.
DFHCPYNA
DFHPRK
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.
DFHCRCNA
MVS
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.
DFHCRNNA
DFHCRSP, dispatcher
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.
DFHCRQNA
transaction CRSQ
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.
DFHCRRNA
DFHCRNP
The interregion session recovery program performs session recovery on behalf of primary or secondary IRC sessions.
DFHCRSNA
transaction CRSR
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.
DFHCRSNA
DFHEIP, DFHSIJ1
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).
DFHCRTNA
transaction CXRT
DFHCRT is the relay program used when a transaction attempts to allocate a conversation to a remote advanced program-to-program (APPC) terminal.
DFHCSANA
Not applicable
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.
DFHCUCNA
MVS
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.
DFHCSSNA
DFHSIJ1, DFHSNSN, DFHSUSN, DFHTCRP, DFHZCUT
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
MVS
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.
Type 3 SVC
DFHCUCA
DFHCAPB
The resource definition online command analyzer interprets a VTAM resource definition in command form and produces a parameter list.
DFHCUCB
DFHCUCP
The resource definition online command builder receives commands and transforms them to a format for use by the command processors.
DFHCUCC
DFHCAPB
This program extracts a single entry from a loaded RDT table containing VTAM resource definitions for TCT migration.
DFHCUCD
DFHCAPB
The resource definition online command default values program modifies the parameter list produced by DFHCUCAB by inserting the default values.
DFHCWTNA
CWTO transaction
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.
AENTRY
DFHERM, IMS database resource adapter (DRA).
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
DFHDBME
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
DFHSII1 via attach
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
DFHDBCTX, DFHDBAT
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
DFHDBAT
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
DFHDBCT
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
DFHDBCT, DFHDBME
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
CDBI transaction
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
CDBC transaction
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
DFHDBAT
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.
DFHDBPNA
DFHAPRC
This program invokes DWE processors when a UOW backs out.
DFHDBREX
DFHDBAT
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
DFHDBAT
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
DFHDBAT
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
DFHDBAT
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
DFHDBAT
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
DFHDBCT, DFHDBDSC
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.
DFHDCPNA
DFHDC macro, DFHEDC
DFHDCP translates DFHDC macro requests for a transaction dump to DU domain TRANSACTION_DUMP calls.
DFHDESNA
DFHZEV1, DFHZEV2, DFHZOPN
DFHDES performs data encryption and bind-time security.
DFHDIPNA
DFHACP, DFHDI macro, DFHEDI, DFHKCP, DFHMCP, DFHTOM, DFHZEMW, DFHZRSP, DFHZSUP
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.
DFHDLINA
User application, DFHMIRS, DFHSPP
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.
ASMTDLI, CBLTDLI, PLITDLI
User application using DL/I CALL interface
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
DFHDLI
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
DFHDLI
DFHDLIRP is the remote call processor. It services DL/I calls that are function-shipped to another CICS system.
DFHDMPNA
DFHAMP, DFHCSDUP
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.
DFHDRPNA
DFHEIP
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.
DFHDSBNA
DFHPBP
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.
DFHDUPNA
MVS
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
DFHDBCR, DFHDBCT
DFHDXACH is a stub that is also MVS-attached, and which branches to an input address.
DFHDXSTM
DFHDBCT, DFHDBCR
DFHDXSTM is used to attach, detach, and inquire on MVS subtasks attached by DFHDBCR and DFHDBCT.
DFHDYP
DFHAPRT
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.
DFHEI1
User application
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.
The 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:
The statements are put into a temporary file that is concatenated
before the assembled application program in the LKED step of the procedure.
DFHEAI0
User application
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.
PREPROC
The assembler-language translator module performs the following functions:
0 - no message
4 - warning
8 - error
12 - severe error
16 - translator failure.
DFHEBFNA
DFHEIP
DFHEBF is the EXEC interface processor for the field edit built-in function, DEEDIT.
DFHEBUNA
DFHETL, DFHETC
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.
DFHEI1
User application
This is a link-edit stub similar to DFHEAI, except that it is used for COBOL application programs.
DFHEIN01
DFHECIP
The command interpreter module analyzes CECI commands, and manages its displays. It uses the EXEC interface to invoke other CICS functions.
DFHEIN00
CECI transaction
The command interpreter program performs preliminary validation and initialization for the CECI transaction, and links to DFHECID.
PREPROC
The COBOL translator module performs the following functions:
0 - no message
4 - warning
8 - error
12 - severe error
16 - translator failure.
DFHESP01
DFHEDAP
The resource definition online (RDO) transactions module analyzes the commands, and manages the displays for CEDA, CEDB, and CEDC. It uses the EXEC interface.
DFHESP00
CEDA, CEDB, CEDC transaction
The resource definition online (RDO) transactions program performs preliminary validation and initialization for CEDA, and links to DFHEDAD.
DFHEIP
DFHEDCNA
DFHEIP
DFHEDC is the EXEC interface processor for dump commands.
DFHEDFBR
CEBR transaction, DFHEDFD
The temporary-storage browse transaction browses, copies, or deletes entries in a temporary-storage queue. It interprets commands and PF key actions.
DFHEDFD
DFHEDFP
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.
DFHEDFNA
transaction CEDF
The EDF main program is the control program for EDF. DFHEDFP can be invoked in one of two ways:
DFHEDFP is also attached by DFHEDFX as the main program of the EDF task.
DFHEDFNA
Not applicable
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.
DFHEDFNA
DFHACP, DFHEIP, program manager
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.
DFHEDINA
DFHEIP
DFHEDI is the EXEC interface processor for data interchange commands.
DFHEDPNA
DFHERM
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.
PREPROC
The C translator module performs the following functions:
0 - no message
4 - warning
8 - error
12 - severe error
16 - translator failure.
DFHEEINA
DFHEIP
DFHEEI is the EXEC interface processor for DFHEIP ADDRESS, ASSIGN, PUSH, POP, and HANDLE commands.
DFHEEXNA
DFHETC
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
DFHDBP, DFHSPP
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.
DFHEGLNA
DFHEIP
DFHEGL is the EXEC interface processor for unmapped LU6.2 commands.
DFHEICNA
DFHEIP
DFHEIIC is the EXEC interface processor for interval control commands.
DFHEIDTI
DFHEIP
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.
DFHEIPNA
application programs
DFHEIP is the main EXEC interface module. See EXEC interface for further information.
DFHEIPAN
DFHEAI0
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
DFHEIP
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
DFHEDI, DFHEGL, DFHEIQMS, DFHEMS, DFHEOP, DFHETC, DFHETL, DFHTDB, DFHXFFC, DFHXFX
DFHEISR obtains buffers and copies data for the calling EXEC interface modules, at the location and in the storage key required by the application.
DFHEJCNA
DFHEIP
DFHEJC is the EXEC interface processor for journaling commands.
DFHEKCNA
DFHEIP
DFHEKC is the EXEC interface processor for task control commands.
DFHEI1
User application
This is a link-edit stub similar to DFHEAI, except that it is used for C application programs.
DFHEMSNA
DFHEIP
DFHEMS is the EXEC interface processor for BMS commands.
DFHEMT00
User application
The master terminal programmed interface program is a special version of DFHEMTP that a user application can link to for master terminal services.
DFHEMT01
DFHEMTA, DFHEMTP, DFHEOTP, DFHESTP
The master terminal module analyzes the commands, and manages displays for CEMT, CEOT, and CEST transactions. It uses the EXEC interface.
DFHEMT00
CEMT transaction
The master terminal program performs preliminary validation and initialization for the CEMT transaction, and links to DFHEMTD.
DFHEMT00
CEOT transaction
The master terminal program performs preliminary validation and initialization for the CEOT transaction, and links to DFHEMTD.
DFHEPCNA
DFHEIP
DFHEPC is the EXEC interface processor for program control commands.
DFHEI1
User application
This is a link-edit stub similar to DFHEAI, except that it is used for PL/I application programs.
PREPROC
The PL/I translator module performs the following functions:
0 - no message
4 - warning
8 - error
12 - severe error
16 - translator failure.
DFHEPSNA
DFHEIP
DFHEPS is the link between DFHEIP and the JES interface program, DFHPSP.
DFHERMNA
DFHEIP
DFHERM is called by DFHEIP on behalf of the other components of CICS to manage the connection between CICS and non-CICS products.
DFHESCNA
DFHEIP
DFHESC is the EXEC interface processor for storage control commands.
DFHESPNA
DFHEIP
DFHEISP is the EXEC interface processor for syncpoint commands.
DFHEMT00
CEST transaction
The master terminal program performs preliminary validation and initialization for the CEST transaction, and links to DFHEMTD.
DFHETCNA
DFHEIP
DFHETC is the EXEC interface processor for terminal control commands.
DFHETDNA
DFHEIP
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.
DFHETLNA
DFHETC
DFHETL is the EXEC interface processor for mapped LU6.2 commands.
DFHETRNA
DFHEIP
DFHETR is the EXEC interface processor for trace commands.
DFHETSNA
DFHEIP
DFHETS is the EXEC interface processor for temporary-storage commands.
DFHEXINA
DFHZARQ
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
DFHFCDN, DFHFCN
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
DFHFCFR
DFHFCBD handles BDAM file control requests except for OPEN and CLOSE.
DFHFCDN
DFHAMFC, DFHAMPFI, DFHEIQDN, DFHEIQDS, DFHFCLF, DFHFCMT, DFHFCN, DFHFCRC, DFHFCRO, DFHFCRD, DFHFCRP
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
DFHFCFR
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
DFHAPLI, DFHAPSM, DFHDTLX, DFHDMPCA, DFHEIFC, DFHERM, DFHFCDTS, DFHFCFR, DFHFCFS, DFHFCRC, DFHFCRP, DFHUEH
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
DFHAMFC, DFHDMPCA, DFHDMRM, DFHDTLX, DFHEIQDS, DFHFCDTS, DFHFCFR, DFHFCLF, DFHFCQU, DFHFCRC, DFHFCRD, DFHFCRU, DFHFCSD, DFHFCU, DFHFCVS
DFHFCFS changes the state of a file. It invokes DFHFCN to open, or close, files.
DFHFCLNA
DFHFCN
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).
DFHFCMNA
DFHFCFS
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
DFHAFMT, DFHAMFC, DFHAMPFI, DFHDMPCA, DFHEDFX, DFHEIQDS
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.
DFHFCNNA
DFHFCFS
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
DFHAMFC
DFHFCRL modifies SHRCTL blocks (describing VSAM LSR pools) in response to CEDA requests.
DFHFCRP
DFHFCIN2
The file control restart program builds the file control environment and initializes file control.
DFHFCSD
DFHSTP
DFHFCSD is called during CICS controlled shutdown processing to close all open files managed by CICS file control.
DFHFCST
DFHSTFC, DFHSTLS
DFHFCST is called to collect or reset file or LSRPOOL statistics on request from DFHSTFC or DFHSTLS.
DFHFCUNA
CSFU transaction
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, UPADEXIT
DFHFCBD, DFHFCFR, DFHFCVR, DFHFCVS, VSAM
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
DFHFCDTS, DFHFCFR
DFHFCVS handles requests for file control services made against VSAM files. These services include:
DFHFDPNA
DFHFD macro
DFHFDP translates DFHFD macro requests for a system dump to DU domain SYSTEM_DUMP calls.
DFHFEPNA
CSFE transaction
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.
DFHGMMNA
DFHKCP
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).
IGCnnn
DFHZHPSR (via an SVC call)
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.
MVS
DFHICPNA
DFHEIIC, DFHIC macro
The interval control program is used for time management and has two main functions:
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.
DFHIIPNA
DFHMCP
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.
DFHIRPNA
DFHCRC, DFHCRNP, DFHCRSP, DFHDRPD, DFHDRPE, DFHDRPF, DFHSRP, DFHSTP, DFHZCX
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.
As defined in interest ladder 8
DFHIRP, DFHXMP
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.
DFHISPNA
DFHDLI, DFHEIP, DFHEIFC
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.
DFHJCPNA
DFHEJC, DFHJC macro
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
DFHJUPNA
MVS
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.
DFHKCPNA
DFHEKC, DFHKC macro
This is a startup routine that passes control to either DFHXCP or DFHXCPC. It also deals with some ENQ and DEQ calls.
DFHKCQNA
DFHXCPC
DFHKCQ processes DFHKC INITIALIZE, REPLACE, WAITINIT, and DISCARD macro calls to the transaction manager.
DFHKCRP
DFHKCP (attaches DFHKCRP as a CICS task)
DFHKCRP is the task control restart program.
DFHKCSC
DFHKCQ
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.
DFHKCSPA, DFHKCSPI, DFHKCSPD, DFHKCSPF, DFHKCSPP
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.
DFHLINA
DFHEDFX, DFHEIP, DFHPCPS, DFHSIJ1, DFHSTP
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.
DFHLUPNA
DFHLUP is the LU6.2 services manager. It initializes and shuts down a network, and resynchronizes flows.
DFHMCPNA
DFHBMS macro, DFHEMS
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).
DFHMCXNA
DFHMCP
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:
DFHMGPNA
DFHACP, DFHCRQ, DFHCRT, DFHEOP, DFHFEP, DFHRTC, DFHRTE, DFHZEMW, DFHZERH, DFHZIS1, DFHZTSP, DFHZXRL
The message generation program provides an interface for sending CICS messages to the terminal end user.
DFHMGTNA
DFHMGP
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.
DFHMIRNA
Task initiation
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.
DFHML1NA
DFHMCP, DFHPBP
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:
DFHMRONA
DFHCRNP, DFHCRSP
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).
DFHMSPNA
CMSG transaction
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.
DFHMXPNA
Automatic transaction initiation
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.
DFHM32NA
DFHMCP, DFHPBP
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.
DFHPBPNA
DFHMCP
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:
DFHPD640
MVS IPCS program
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.
DFHPEPNA
DFHACP
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.
DFHPHPNA
DFHMCP, DFHTOM
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.
The PL/I interface module contains the following routines:
DFHPRKNA
DFHZATT
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.
DFHPSPNA
DFHEPS
DFHPSP is the system spooling interface control module.
DFHPSPDW
DFHSPP
DFHPSPDW is the system spooling interface DWE.
DFHPSPSS
DFHPSP
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
DFHPSPSS
DFHPSPST is the system spooling JES interface control module.
DFHPSSNA
DFHPSPSS, DFHPSPST
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.
DFHPUPNA
DFHAMP, DFHCSDUP
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.
DFHP32NA
CSPP transaction, DFHTCP, DFHZCP
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
DFHALP, DFHTCTI, DFHZATT
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
DFHFCBP, DFHTCBP, DFHUSBP
DFHRCEX enables the global user exits for emergency restart processing.
DFHRKBNA
DFHCPY
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
DFHXMTA
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.
DFHRLRNA
DFHMCP
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.
DFHRMSNA
DFHERMSP, DFHERMRS
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.
DFHRTCNA
CSSF transaction
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.
DFHRTENA
transaction CRTE, DFHSNTU
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
CESF trans.
The sign-off program signs off the user who invoked the CESF transaction.
DFHSIANA
DFHAPSIP
The DFHSIA1 system initialization program loads and initializes the CSA.
DFHSIBNA
DFHAPSIP
The DFHSIB1 system initialization program loads the CICS nucleus.
DFHSICNA
DFHAPSIP
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.
DFHSIDNA
DFHAPSIP
The DFHSID1 system initialization program performs the following functions:
DFHSIFNA
DFHAPSIP
The DFHSIF1 system initialization program initializes terminal control. DFHSIF1:
DFHSIGNA
DFHAPSIP
The DFHSIG1 system initialization program opens the dump data set.
DFHSIHNA
DFHAPSIP
The DFHSIH1 system initialization program:
DFHSIINA
DFHAPSIP
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:
DFHSIJNA
DFHAPSIP
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:
DFHKESIP
MVS
DFHSIP initializes CICS and also contains code for the following domains:
DFHSKMNA, DFHSKC, DFHSKE
MVS, DFHFCL, DFHFCM, DFHFCN, DFHPSPSS, DFHSTP, DFHXSMX
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
DFHSC macro
The storage control program is called as a result of DFHSC GETMAIN and FREEMAIN macro requests issued from CICS modules.
DFHSNAT
DFHCRNP, DFHZISP, DFHZSUP (via DFHSUSN)
The attach-time signon/sign off interface program provides support for the signon and sign off of LU6.2 sessions.
DFHSNNFY
IRRDPR10
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
MVS
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
CESN transaction
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
DFHCSSC, DFHSNAT (via DFHSUSN)
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
IRRDPR02
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
IRRDPR02
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
IRRDPR02
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
IRRDPR02
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.
DFHSPPNA
DFHESP, DFHSP macro
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
DFHSRP
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.
DFHSRPNA
AP domain recovery routines
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
MVS subsystem interface
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
DFHCSVC, DFHSSEN (through the subsystem interface)
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
MVS master scheduler initialization
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
DFHSSIN
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.)
DFHSSMNA
DFHSSMGP
The subsystem interface message table contains the text of messages that are issued by DFHSSMGP.
DFHSSWTA
MVS console support
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
DFHSSWT
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
DFHSSWT
This module inserts the CICS region’s applid into all DFH messages issued under a CICS TCB whose applid can be determined.
DFHSTDT
DFHAPST
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
DFHAPST
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
DFHAPST
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
DFHAPST
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
DFHAPST
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
DFHAPST
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.
DFHSTPNA
DFHEMTP
The main function of the system termination program is to shut down CICS. In sequence, DFHSTP performs the following functions (according to options specified):
MVS
DFHSTSZ
DFHAPST
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
DFHAPST
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
DFHAPST
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
DFHAPST
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
DFHAPST
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
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
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
DFHTCRPU, DFHZXCU, DFHSUSN
DFHSUSX provides tracking for SNTTEs. This module is responsible for:
DFHSUWT
DFHMEME, DFHSUWT
The DFHSUWT module provides the following support for executing MVS WTO and WTOR SVCs:
For further information about DFHSUWT, see WTO and WTOR.
DFHSUZX
DFHBSTZV, DFHEIQSC, DFHEIQST, DFHEIQTR
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.
DFHTACNA
DFHTCP
The terminal abnormal condition program is invoked by DFHTCP and performs the following functions:
DFHTAJNA
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
DFHZCQIS
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
DFHTBSB, DFHTBSBP
DFHTBSBP is the recursive part of DFHTBSB.
DFHTBSD
DFHZCQDL
DFHTBSD deletes a node in a CICS terminal network.
DFHTBSDP
DFHTBSD, DFHTBSDP
DFHTBSDP is the recursive part of DFHTBSD.
DFHTBSL
DFHTBSR, DFHZCQCH
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
DFHTBSL, DFHTBSLP, DFHTBSSP
DFHTBSLP is the recursive part of DFHTBSL.
DFHTBSQ
DFHZCQIQ
DFHTBSQ is called to retrieve the parameters that were supplied to a TCT table entry at build time.
DFHTBSQP
DFHTBSQ
DFHTBSQP is called by DFHTBSQ to retrieve parameters that were supplied to a TCT table entry at build time.
DFHTBSR
DFHZCQRS
DFHTBSR takes a table-builder recovery record and re-creates the corresponding table entry. It is called during warm or emergency restart.
DFHTBSSP
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.
DFHTBS
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.
DFHTCBNA
The terminal control backout program restores TCTTEs and other ISC state data during emergency restart.
DFHTCPNA
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:
DFHTCRP
DFHTCRP initializes and recovers terminal control definitions and protected messages. It is run as a task during CICS initialization.
DFHTCRPC
DFHZXQO
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
DFHTCRP
DFHTCRPL installs TCT resources defined by the TCT macros.
DFHTCRPS
DFHZXQO
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
DFHZXQO
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.
DFHTDANA
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
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.
DFHTDBNA
DFHTDA
DFHTDB, which is link-edited with RMODE(ANY), handles DFHTD macro requests for intrapartition queues. In particular, DFHTDB:
EX11RTNE
QSAM
DFHTDEXL contains the DCB abend exit routine used for extrapartition processing.
DFHTDANA
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
DFHTDP is a load module link-edited from object modules for DFHTDA, DFHTDEXL, and DFHTDX.
DFHTDBNA
DFHTDA
DFHTDQ is a load module link-edited from object modules for DFHTDB.
DFHTDRM
DFHDBP
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.
DFHTDRNA
DFHTDX
DFHTDRP handles transient data recovery during CICS initialization. In particular, DFHTDRP:
DFHTDTM
DFHALP, DFHEIQMS, DFHEIQSQ, DFHESE, DFHSZRPM, DFHTDRP
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.
DFHTDXNA
Task initiation
DFHTDX is the initial program invoked by the transient data recovery task. It links to program DFHTDRP.
DFHTEPNA
DFHTACP
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.
DFHTMPNA
DFHTM macro
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.
DFHTONNA
DFHDBP, DFHSPP
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.
DFHTORNA
DFHAMP, DFHTON
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.
DFHTORNA
DFHSII1
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.
DFHTPPNA
DFHDSB, DFHM32
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.
DFHPBP
DFHTPQNA
DFHICP, DFHMCP, DFHTCP
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.
DFHTPRNA
DFHMCP, DFHTCP
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.
DFHTPSNA
DFHICP, DFHMCP
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:
DFHTRANA
DFHTRPT
The FE global trap/trace exit is provided for diagnostic use only under the guidance of service personnel.
DFHTRPRG
IPCS
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.
DFHTRPNA
Many AP domain modules
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
CEDA transaction, DFHTCRP, DFHTOR
DFHTRZCP builds a terminal builder parameter set.
DFHTRZIP
CEDA transaction, DFHTCRP, DFHTOR
DFHTRZIP builds a chain of builder parameter sets for sessions.
DFHTRZPP
CEDA transaction, DFHTCRP, DFHTOR
DFHTRZPP builds a pool builder parameter set.
DFHTRZXP
CEDA transaction, DFHTCRP, DFHTOR
DFHTRZXP builds a connection builder parameter set.
DFHTRZYP
CEDA transaction, DFHTCRP, DFHTOR
DFHTRZYP builds a TYPETERM builder parameter set.
DFHTRZZP
CEDA transaction, DFHTCRP, DFHTOR
DFHTRZZP merges a TYPETERM builder parameter set into a terminal builder parameter set.
DFHTSPNA
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
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).
DFHTRPRA
MVS
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
DFHCCNV
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.
DFHUEHNA
CICS management modules containing exit points
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.
DFHUEMNA
DFHEIP
The EXEC interface processor for the ENABLE, DISABLE, and EXTRACT user exit commands.
DFHUSBNA
DFHRCRP
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
Many CAVM modules
DFHWCCS provides common services for the CAVM:
MVS abend, caller
DFHWCGNA
DFHWCGNT is the entry point list for CAVM modules above the 16MB line.
DFHWDATT
DFHWDINA, DFHWMG1, DFHWMP1, DFHWSXPI
DFHWDATT creates the CAVM process.
DFHWDINA
DFHWSRTR
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.
DFHWDISP
DFHWDISP, DFHWDIND
DFHWDWAT, DFHWDINA
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.
Dispatched process, caller of DFHWDINA
DFHWDSRP
DFHWDINA, CAVM program check/abend
DFHWDSRP establishes the ESPIE/ESTAE CAVM process. It performs CAVM process error handling for processes with ESPIE or ESTAE routines.
DFHWDWAT
Many CAVM modules
DFHWDWAT causes the current CAVM process to wait for specific events.
DFHWDISP
DFHWKPNA
DFHSTP
DFHWKP takes a warm keypoint at the normal termination of CICS. This program is part of the restart component.
DFHWLFRE
Many CAVM modules
DFHWLFRE frees the LIFO stack entry for CAVM modules running above the 16MB line.
DFHWLGET
Many CAVM modules
DFHWLGET gets the LIFO stack entry for CAVM modules running above the 16MB line.
DFHWMG1
DFHWMI, DFHWDISP, DFHWDSRP
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
DFHWSXPI
DFHWMI allocates the CAVM message-manager communication area. It calls each of the main message-manager modules, which then initialize themselves.
DFHWMMT
DFHWMRD, DFHWMWR
DFHWMMT provides VSAM GET and PUT services for the CAVM message data set.
DFHWMPG
DFHWMP1, DFHWMWR
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
DFHWMI, DFHWDISP, DFHWDSRP
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
DFHWMS20
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
DFHWMG1, DFHWMQG
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
DFHWMS20
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
DFHWMP1, DFHWMWR
The CAVM message-manager message output queue handler provides services to select the next work item to process, and posts items complete.
DFHWMRD
DFHWMG1
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.
DFHWMSNA
Users of CAVM message services
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
The CAVM message manager services interface selects the request type and passes requests to DFHWMQP (PUTMSG, PUTREQ, PUTRSP) or DFHWMQG (GETMSG).
DFHWMWR
DFHWMP1
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.
DFHWOSNA
The overseer startup module loads DFHWOSA and passes control to it.
DFHWOSNA
DFHWOS
The overseer services initialization module processes control parameters, loads DFHWOSB, and sets up entry points for overseer services.
DFHWOSNA
Overseer program
The overseer service module processes requests from the overseer program which are issued by the DFHWOSM macro.
DFHWSMNA
DFHXRA, MVS after attach of new TCB
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.
DFHWSSNA
DFHXRA
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
DFHWSRTR
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
DFHWSSN2
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
MVS recovery/termination manager
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
DFHWDISP
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
DFHWDISP
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
DFHWDISP
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
DFHWDISP
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
DFHWSTI
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.
DFHWTINA
DFHCSVC from: DFHWSSN2, DFHWSTKV, DFHZXSTS
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
Many CAVM modules
DFHWTRP makes a trace entry in the CAVM main-memory trace table.
DFHXCPNA
DFHKCP
DFHXCP processes DFHKC CANCEL, CHAP, RESUME, SUSPEND, and WAIT macro calls to the transaction manager.
DFHXCPC
DFHKCP
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
DFHXCPC
DFHXCP1 finds a new range of free transaction numbers when the current range has been used up.
DFHXFPNA
DFHISP, DFHMIRS
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.
DFHXFQNA
DFHXEPRH
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.
DFHXFXNA
DFHISP, DFHMIRS
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.
DFHXMPNA
DFHDRPE, DFHZCX
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.
DFHXRANA
DFHAPDM, DFHCSSC, DFHCXCU, DFHDBCR, DFHDBCT, DFHSIC1, DFHSII1, DFHSTP, DFHTCRP, DFHTDRP, DFHXRCP, DFHXRSP, DFHZNAC, DFHZOPN, DFHZSLS
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.
DFHXRBNA
DFHWDSRP, DFHWMQH, DFHWMRD, DFHWSSR, DFHWSTKV
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.
DFHXRCNA
DFHWSSN2, DFHWSTI
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.
DFHXRCNA
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.
DFHXRENA
DFHPCP
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.
DFHXRANA
Not applicable
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.
DFHXRSNA
DFHXRA
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.
DFHXSMNA
DFHBSTS, DFHCRNP, DFHDLIDP, DFHDLIRP, DFHEDFP, DFHEIPSE, DFHSII1, DFHSUSN, DFHSUXS, DFHTACP, DFHZSUP
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.
DFHXSMNA
DFHXSMN
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.
DFHXSSNA
DFHCSVC
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
DFHXSS
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
DFHXSMN
DFHXSWM passes and retrieves messages to and from the XRF alternate system to see if security initialization is required in the XRF environment.
DFHXTCI
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.
DFHXTPNA
DFHTPS, DFHZTSP, DFHZXRL, DFHZXRT
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.
DFHZABD1
TC CTYPE= requests
If a TC CTYPE request is issued when ZCP has been generated without VTAM support, DFHZABD is invoked to abend the transaction.
DFHZACT1
DFHZDSP
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.
DFHZAIT1
DFHSIF1
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.
DFHZAND1
DFHZARQ
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
DFHZARL, DFHZARR, DFHZARRA
DFHZARER tidies up after an LU6.2 protocol error or session failure has been detected. For some errors, it calls DFHZNAC.
DFHZARL1
DFHACP, DFHCPCBA, DFHCPCLC, DFHCRS, DFHEGL, DFHETL, DFHLUP, DFHXFP, DFHXTP, DFHZARL, DFHZARM, DFHZERH, DFHZISP, DFHZLUS, DFHZSUP, DFHZTSP, DFHZXRL, DFHZXRT
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.
DFHZARM1
DFHZARQ, DFHETL, DFHZISP
DFHZARM handles DFHTC macros for LU6.2 sessions.
DFHZARQ1
DFHETC, DFHTC macro
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
DFHZARL
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
DFHZARL, DFHZARR
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
DFHZARR
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
DFHZARR
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.
DFHZASX1
VTAM
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
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
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
DFHZATA, DFHZATD
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.
DFHZATI1
DFHZACT
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
DFHZATMF
This program deletes all remote terminal definitions that are flagged (by DFHZATMF) for deletion.
DFHZATMF
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
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
The remote autoinstall program runs as the following four transactions:
DFHZATT1
DFHZACT
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
DFHZOPN
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.
DFHZBKT1
DFHZSDL, DFHZSLX, DFHZRLX, DFHZLUS
DFHZBKT maintains the bracket state for LU6.2.
DFHZBLX
DFHZSCX
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.
DFHZCANA
See component submodules
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.
DFHZCBNA
See component submodules
DFHZCB is the name of the load module created when the following modules are link-edited together:
DFHZCCNA
See component submodules
DFHZCC is the name of the load module created when the following modules are link-edited together:
DFHZCHS1
DFHZRLX, DFHZSDL, DFHZSLX
DFHZCHS maintains the chain state for LU6.2.
DFHZCLS1
DFHZACT
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.
DFHZCLX1
VTAM
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.
DFHZCNA1
DFHZDSP
The system console activity control program is responsible for CICS system requests. It performs the following functions:
DFHZCNR1
DFHZARQ
The system console application request program performs READ, WRITE, and CONVERSE operations to an MVS system console that is used as a terminal.
DFHZCNT1
DFHZLUS, DFHZRLX
DFHZCNT maintains the contention state for LU6.2.
DFHZCPNA
See component submodules
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
DFHAMTP, DFHCRS, DFHQRY, DFHTCRP, DFHWKP, DFHZATA, DFHZATD, DFHZTSP, DFHZXCU
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
DFHZCQ00, DFHZNAC, RDO
DFHZCQDL dynamically deletes a TCT entry when the entry is quiesced. This module is part of DFHZCQ.
DFHZCQIN
DFHTCRP
DFHZCQIN initializes DFHZCQ for all its operations. This module is part of DFHZCQ.
DFHZCQIQ
DFHZTSP
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
DFHZCQIS installs a TCTTE. If the resource already exists, the old resource is deleted.
DFHZCQIT
DFHZCQIT adds a macro-generated TCTTE to a CICS system.
DFHZCQRS
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.
DFHZCRQ1
TC CTYPE requests
The CTYPE request module analyzes DFHTC CTYPE commands, and calls or links to the appropriate send module.
DFHZCRT1
DFHZACT, DFHZARL, DFHZFRE, DFHZNAC, DFHZRAC, DFHZRLP, DFHZRVL, DFHZSDL, DFHZSHU, DFHZSTU, DFHZTPX
DFHZCRT maintains the RPL_B state for LU6.2.
DFHZCUT
DFHCSSC, DFHLUP, DFHSNAT, DFHTCPLR
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.
DFHZCWNA
See component submodules
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.
DFHZCXNA
See component submodules
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.
DFHZCXRA
See component submodules
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.
DFHZCYNA
See component submodules
DFHZCY is the name of the load module created when the following modules are link-edited together:
DFHZCZNA
See component submodules
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.
DFHZDET1
DFHZACT, DFHZISP
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.
DFHZDSP1
DFHSII1
The dispatcher module handles the dispatching of modules for execution, and gives control to VTAM modules of ZCP using DFHZACT.
DFHZDST1
DFHZRVX, DFHZSDS
The data stream translator module translates data between EBCDIC and ASCII code while that data is being sent and received on VTAM sessions.
DFHZEMW1
DFHACP, DFHZDET, DFHZNAC, DFHZRAC
The error message writer module handles all requests for error messages on VTAM supported terminals/LUs. According to the request flags, it:
DFHZERH1
DFHZARL, DFHZARRF
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.
DFHZEV11
DFHZEV1 is the LU6.2 bind-time security encryption validation program, part 1.
DFHZEV21
DFHZEV2 is the LU6.2 bind-time security encryption validation program, part 2.
DFHZFRE1
DFHZACT, DFHZEMW, DFHZCLS, DFHZCLX
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.
DFHZGET1
DFHZACT, DFHZARL, DFHZATI, DFHZATT, DFHZCLS, DFHZISP, DFHZOPN, DFHZRAC, DFHZRST, DFHZRSY, DFHZRVL, DFHZRVS, DFHZSDA, DFHZSDL, DFHZSDR, DFHZSDS, DFHZSES, DFHZSKR
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.
DFHZHPNA
DFHKCSP (via DFHZHPSR and DFHKCP)
In authorized path SRB mode, DFHZHPRX issues VTAM EXECRPL.
DFHZHPS1
DFHZRVS, DFHZSDS
DFHZHPSR is the SEND and RECEIVE module for the HPO environment.
DFHZISP1
DFHISP, DFHKCP
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.
DFHZIS11
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.
DFHZIS21
DFHZARQ, DFHZIS1
The intersystem program provides services for CICS system code that wants to use intersystem or interregion (IRC) function requests:
DFHZLEX1
VTAM
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.
DFHZLGX1
VTAM
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.
DFHZLOC1
DFHTC CTYPE=LOCATE
The locate module provides two functions:
DFHZLRP1
DFHZARQ, DFHZSUP
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.
DFHZLTX1
VTAM
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:
DFHZNANA
DFHZACT
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.
DFHZNENA
DFHZNAC
The user-replaceable node error program provides:
DFHZNSP1
VTAM
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.
DFHZOPA1
DFHEIQVT
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.
DFHZOPN1
DFHZACT
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.
DFHZOPX1
VTAM
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.
DFHZQUE1
All ZCP exits called by VTAM, DFHTCQUE macro
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.
DFHZRAC1
DFHZDSP
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.
DFHZRAQ1
DFHZARQ, DFHZSYN
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.
DFHZRAR1
DFHZARQ
The read-ahead retrieval module is called to retrieve data previously saved in temporary storage by DFHZRAQ.
DFHZRAS1
DFHZRAC
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.
DFHZRLNA
DFHZACT
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.
DFHZRLP1
DFHZDSP
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.
DFHZRLX1
VTAM
DFHZRLX is a VTAM exit routine that queues the completed RPL for (post-VTAM) processing by DFHZRLP.
DFHZRRX1
VTAM
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.
DFHZRSNA
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.
DFHZRST1
DFHZACT, DFHZATI, DFHZCRQ, DFHZDET, DFHZEMW, DFHZERH, DFHZNAC, DFHZRAC, DFHZRSY, DFHZSTU
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.
DFHZRSY1
DFHZACT
The resynchronize module resynchronizes CICS and other nodes of the network. DFHZRSY checks whether inbound and outbound sequence numbers are valid.
DFHZRVL1
DFHZARL, DFHZARRL
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.
DFHZRVS1
DFHZACT
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.
DFHZRVX1
VTAM
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.
DFHZSAX1
VTAM
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.
DFHZSCX1
VTAM
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.
DFHZSDA1
DFHZACT, DFHZSDS
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.
DFHZSDL1
DFHZARL
DFHZSDL processes SEND commands for LU6.2 sessions, using the RPL addressed by field TCTERPLA in the TCTTE.
DFHZSDR1
DFHZACT, DFHZCRQ, DFHZDET, DFHZRVS, DFHZSDA, DFHZSDS
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.
DFHZSDS1
DFHZACT, DFHZARQ, DFHZATI, DFHZATT, DFHZDET
The send data synchronous module sets up and issues the appropriate VTAM send macro for requests of "send data" or an SNA synchronous command.
DFHZSDX1
VTAM
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.
DFHZSES1
DFHZACT, DFHZRSY
The session control module is entered whenever a session control command is requested by CICS. It sets up and issues the VTAM SESSIONC command.
DFHZSEX1
VTAM
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.
DFHZSHU1
DFHZDSP
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.
DFHZSIM1
DFHZACT
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.
DFHZSIX1
VTAM
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.
DFHZSKR1
DFHZACT
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.
DFHZSLS1
DFHZDSP, DFHZOPA
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.
DFHZSLX1
VTAM
DFHZSLX is a VTAM exit routine that handles the completion of LU6.2 SEND requests.
DFHZSSX1
VTAM
The send data flow synchronous exit module receives control when the send of a DFSYN command has been completed.
DFHZSTA1
DFHEGL, DFHETC, DFHETL
DFHZSTAP determines the state of an MRO or LU6.2 conversation from an application viewpoint.
DFHZSTU1
DFHTC CTYPE=STATUS, DFHEIQMT, DFHEIQSC, DFHEIQST
DFHZSTU changes the status of TCTTEs and TCTSEs. It can change the following statuses:
DFHZSUP1
DFHKCP
The startup task module is the entry point for all terminal-related tasks. DFHZSUP performs the following functions:
DFHZSYN1
DFHDBP
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.
DFHZSYX1
VTAM
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.
DFHZTAX1
VTAM
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.
DFHZTPX1
VTAM
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.
DFHZTRA1
DFHZACT, DFHZDET, DFHZRAC, DFHZRLP, DFHZRVS, DFHZSDL, DFHZSDR, DFHZSDS
DFHZTRA creates VIO trace entries.
DFHZTSP1
DFHAPRT, DFHISP, DFHRTE, DFHTPS, DFHZARQ, DFHZCQ, DFHZSUP
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.
DFHZUCT1
DFHAPRT, DFHZARQ, DFHZCNA, DFHZRAC, DFHZRVX, DFHZSUP
The uppercase translate module converts a VTAM 3270 data stream into uppercase.
DFHZUIX1
DFHZACT, DFHZRAC, DFHZRVX
The user input exit module is called directly (by DFHZRAC) or indirectly (by DFHZRVX via DFHZACT) to link to the user’s XZCIN exit.
DFHZUSR1
DFHACP, DFHETL, DFHZARER, DFHZARL, DFHZARM, DFHZARR, DFHZARRF, DFHZERH, DFHZOPX, DFHZSTAP, DFHZSUP, DFHZUSR, DFHZXRL, DFHZXRT
DFHZUSR maintains the conversation state for LU6.2.
DFHZXCU
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
DFHTCRP, DFHZXST
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.
DFHZXRC1
DFHZACT
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
System
DFHZXRE0 runs the CXRE transaction to perform autoconnect and XRF reconnect processing. It also starts the acquire process for terminals with flag TCTEXRE set.
DFHZXRL1
DFHZARL, DFHZISP
DFHZXRL is executed in an application-owning region. It routes LU6.2 commands to the terminal-owning region.
DFHZXRT1
DFHZTSP
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
DFHETC, DFHSIJ1, DFHTCRP, DFHTCRPS, DFHZNAC, DFHZOPA, DFHZXCU
XRF ZCP session-state tracking is called by: