Remote files - REMFILE

The Remote files (REMFILE) views display information about remote CICS files. Remote files are files that are defined to the local CICS system, but reside in another CICS system.

Supplied views

To access from the main menu, click:

CICS operations views > File operations views > Remote files

Table 1. Views in the supplied Remote files (REMFILE) view set
View Notes
Remote files

EYUSTARTREMFILE.DETAIL1

Detailed information about the resource signature.
Remote files

EYUSTARTREMFILE.DETAILED

Detailed information about a selected remote file.
Remote files

EYUSTARTREMFILE.DISCARD

Discard a remote file from the local CICS system.
Remote files

EYUSTARTREMFILE.TABULAR

Tabular information about remote files in CICS systems.

Actions

Table 2. Actions available for REMFILE views
Action Description
DISCARD Discard a remote file from the local CICS system.

Fields

Table 3. Fields in REMFILE views
Field Attribute name Description
Number of WRITE requests ADDCNT The number of PUT requests issued against this remote file.
BAS resource definition version BASDEFINEVER The BAS version number of this definition.
The number of READNEXT and READPREV requests BROWSECNT The number of READNEXT and READPREV requests issued against the file.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • TABLE - The resource was last changed by a CICSPlex table definition.
  • SYSTEM - The resource was last changed by the CICS or CICSPlex SM system.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Enable status ENABLESTATUS Indicates whether the remote file is available for access by application programs. The status will be one of the following:
  • ENABLED - Available for access.
  • DISABLED - Unavailable for access as a result of a SET DISABLED command.
  • DISABLING - Still being accessed after a SET DISABLED or SET CLOSED command.
  • UNENABLED - Unavailable for access as a result of a SET CLOSED command.
  • NOTAPPLIC - The file is a remote file.
File ID FILE The name of the file as known to the local CICS system.
Number of READ requests GETCNT The number of GET requests issued against this remote file.
Number of READ UPDATE requests GETUPDCNT The number of GET UPDATE requests issued against this remote file.
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • TABLE - The resource was last installed by a CICSPlex table definition.
  • SYSTEM - The resource was last installed by the CICS system.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
Key length KEYLENGTH For remote files associated with a VSAM KSDS, the length of the key. For remote files associated with a BDAM data set, the length of the logical key used for deblocking.
Number of DELETE requests REMDELCNT The number of DELETE requests issued against this remote file.
Remote file name REMOTENAME The name by which this file is known in the remote system.
Remote system name REMOTESYSTEM The name of the CICS system where the remote file resides.
Number of REWRITE requests UPDATECNT The number of PUT UPDATE requests issued against this remote file.


eyua3tt.html | Timestamp icon Last updated: Sunday, 4 June 2017