Server runtime files

The following table lists all of the CICS® Service Flow Runtime files.

Key to Table 1:
NAME
Descriptive file name.
SHORT NAME
CICS file name.
DESCRIPTION
Explanation of what the file is used for during run time processing.
FILE TYPE
VSAM File Type:
K
Key sequenced data set (KSDS)
E
Entry sequenced data set (ESDS)
COMMENTS
Contains CICS Service Flow Runtime processing information as it relates to the named file.
Table 1. CICS Service Flow Runtime VSAM files
Name Short name Description File type Comments
CICS Service Flow Runtime FEPI Target Interaction

DFHMATIF

Contains target (back-end target CICS application transaction) interaction information (i.e., last screen buffer sent or received using the allocated conversation for the target node).

K

This file is used only in FEPI server adapters.

See CICS Service Flow Runtime FEPI file processing.

CICS Service Flow Runtime FEPI (SLU) Connection

DFHMACOF

Base FEPI connection file. It is used to store allocated FEPI conversation information.

K

This file is used only in FEPI server adapters.

See CICS Service Flow Runtime FEPI file processing.

CICS Service Flow Runtime FEPI (SLU) Connection alternate

DFHMAC1F

This file is used to retrieve or establish active FEPI connections and conversations using the signed on user id and the FEPI pool name as defined in the FEPI server adapter properties.

See FEPI node properties for further information.

K

If your site is using LU assignment processing for non-unique UserIDs, this file is used to establish connections and conversations by a unique tag comprised of the user id, CICS Applid and EIBTASKN of the CICS Service Flow Runtime DPL Stub program (DFHMADPL). See Run time processing of non-unique UserIDs using FEPI adapters for more information.

CICS Service Flow Runtime Error

DFHMAERF

Contains CICS Service Flow Runtime processing errors. Written to by the Error Listener program.

See Error processing for further information.

E

If you want to view the errors, you can run the sample JCL job provided, DFHMAMED, found in the sample library, .SCIZSAMP.

The sample JCL job runs the sample error dump program (DFHMAEUP) also provided in the sample library, .SCIZSAMP. This will provide a formatted error dump. You must however compile the error dump program. See Performing post-installation tasks for further information.

See Server runtime utilities

See also Error file dump for further information regarding error file field definitions.

CICS Service Flow Runtime Link3270 Facility Business State

DFHMAL2F

Contains Link3270 facility business (application) state information for the allocated facility. For example; the last BMS ADS sent and the vector header information.

K
This file is used only in Link3270 server adapters. It is only used if the Link3270 Adapter services are of the following type:
  • Aggregate connector persistence
  • Aggregate connector nonpersistent
  • Single connector persistence

See Managing state information for further information.

CICS Service Flow Runtime Properties

DFHMAMPF

Contains information needed by the DPL Stub program and the server adapters in order to perform adapter request processing.

Each Adapter service modeled, generated and deployed using Service Flow Modeler will have a properties file record for the associated request name and each server adapter that is part of the Adapter service.

K

The Properties file is updated by the generator facility of Service Flow Modeler automatically at build time. It can also be updated manually by running the sample JCL job provided, DFHMAMPU, found in the library .SCIZSAMP.

CICS Service Flow Runtime also provides samples to provide a formatted dump of the Properties file.

See Properties file dump and Server runtime utilities for further information regarding property values definitions and formatted dump processing.

CICS Service Flow Runtime Link3270 Facility Business State

DFHMALSF

See DFHMAL2F description above.

K

This file is used in MQSI Agent for CICS V1.1.3 Link3270 server adapter processing only.

It is used by existing MQSI Agent for CICS deployed Link3270 server adapters that were modeled and deployed using builder tools that existed prior to the release of Service Flow Modeler.

It is provided for upward compatibility only.

CICS Service Flow Runtime Link3270 Repository

DFHMALRF

Contains CICS target application BMS map information. For example, fields, attributes and initial values. K

This file is used in MQSI Agent for CICS V1.1.3 Link3270 server adapter processing only.

It is used by existing MQSI Agent for CICS deployed Link3270 server adapters that were modeled and deployed using builder tools that existed prior to the release of Service Flow Modeler.

It is provided for upward compatibility only.

See Server runtime utilities for further information.

CICS Service Flow Runtime Link3270 Vector Log

DFHMALVF

Contains all Link3270 bridge vector information sent to and received from CICS target application transactions.

The amount of Link3270 bridge vector information stored is configurable based on the Link3270 server adapter vector logging property setting. See Link3270 node properties for further information.

K

This file is optional. It is used in Link3270 server adapter processing only.

It is recommended that this file only be used in development for diagnostics and troubleshooting.

Use caution when implementing vector logging in a production environment, as large amounts of data may be captured and performance may be impacted.

See Analyzing the vector log file dump for further information.