Interface ILocalFile
-
- All Superinterfaces:
ICICSObject
,ICICSResource
,IInstalledCICSResource
,com.ibm.cics.model.meta.ITypedObject
public interface ILocalFile extends ICICSResource, IInstalledCICSResource
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
ILocalFile.AccessMethodValue
Enumeration type for field ACCESSMETHODstatic class
ILocalFile.AddValue
Enumeration type for field ADDstatic class
ILocalFile.BlockFormatValue
Enumeration type for field BLOCKFORMATstatic class
ILocalFile.BrowseValue
Enumeration type for field BROWSEstatic class
ILocalFile.ChangeAgentValue
Enumeration type for field CHANGEAGENTstatic class
ILocalFile.DeleteValue
Enumeration type for field DELETEstatic class
ILocalFile.DispositionValue
Enumeration type for field DISPOSITIONstatic class
ILocalFile.DSTypeValue
Enumeration type for field OBJECTstatic class
ILocalFile.EmptyStatusValue
Enumeration type for field EMPTYSTATUSstatic class
ILocalFile.ExclusiveValue
Enumeration type for field EXCLUSIVEstatic class
ILocalFile.ForwardRecoveryStatusValue
Enumeration type for field FWDRECSTATUSstatic class
ILocalFile.InstallAgentValue
Enumeration type for field INSTALLAGENTstatic class
ILocalFile.OpenStatusValue
Enumeration type for field OPENSTATUSstatic class
ILocalFile.RBATypeValue
Enumeration type for field RBATYPEstatic class
ILocalFile.ReadIntegrityValue
Enumeration type for field READINTEGstatic class
ILocalFile.ReadValue
Enumeration type for field READstatic class
ILocalFile.RecordFormatValue
Enumeration type for field RECORDFORMATstatic class
ILocalFile.RecoveryStatusValue
Enumeration type for field RECOVSTATUSstatic class
ILocalFile.RelativeAddressingTypeValue
Enumeration type for field RELTYPEstatic class
ILocalFile.RLSAccessTypeValue
Enumeration type for field RLSACCESSstatic class
ILocalFile.StatusValue
Enumeration type for field ENABLESTATUSstatic class
ILocalFile.UpdateValue
Enumeration type for field UPDATEstatic class
ILocalFile.VSAMTypeValue
Enumeration type for field VSAMTYPE
-
Field Summary
-
Fields inherited from interface com.ibm.cics.model.ICICSResource
COPYRIGHT
-
Fields inherited from interface com.ibm.cics.model.IInstalledCICSResource
COPYRIGHT
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ILocalFile.AccessMethodValue
getAccessMethod()
Getter for field ACCESSMETHODjava.lang.Long
getActiveStringCount()
Getter for field NUMACTSTRINGILocalFile.AddValue
getAdd()
Getter for field ADDjava.lang.Long
getAddCount()
Getter for field ADDCNTjava.lang.Long
getBasdefinever()
Getter for field BASDEFINEVERjava.lang.String
getBaseDSName()
Getter for field BASEDSNAMEILocalFile.BlockFormatValue
getBlockFormat()
Getter for field BLOCKFORMATjava.lang.Long
getBlockKeyLength()
Getter for field BLOCKKEYLNjava.lang.Long
getBlockSize()
Getter for field BLOCKSIZEILocalFile.BrowseValue
getBrowse()
Getter for field BROWSEjava.lang.Long
getBrowseCount()
Getter for field BROWSECNTjava.lang.Long
getBrowseUpdateCount()
Getter for field BROWUPDCNTILocalFile.ChangeAgentValue
getChangeAgent()
Getter for field CHANGEAGENTjava.lang.String
getChangeAgentRelease()
Getter for field CHANGEAGRELjava.util.Date
getChangeTime()
Getter for field CHANGETIMEjava.lang.String
getChangeUserID()
Getter for field CHANGEUSRIDILocalFileReference
getCICSObjectReference()
java.lang.String
getCloseTime()
Getter for field TIMECLOSEjava.lang.Long
getDataBuffers()
Getter for field NUMDATBUFFjava.lang.Long
getDataOperationCount()
Getter for field DEXCPCNTjava.lang.String
getDefineSource()
Getter for field DEFINESOURCEjava.util.Date
getDefineTime()
Getter for field DEFINETIMEILocalFile.DeleteValue
getDelete()
Getter for field DELETEILocalFile.DispositionValue
getDisposition()
Getter for field DISPOSITIONjava.lang.String
getDSName()
Getter for field DSNAMEjava.lang.String
getDSRecordType()
Getter for field DATASETTYPEILocalFile.DSTypeValue
getDSType()
Getter for field OBJECTILocalFile.EmptyStatusValue
getEmptyStatus()
Getter for field EMPTYSTATUSILocalFile.ExclusiveValue
getExclusive()
Getter for field EXCLUSIVEILocalFile.ForwardRecoveryStatusValue
getForwardRecoveryStatus()
Getter for field FWDRECSTATUSjava.util.Date
getGMTCloseTime()
Getter for field GMTFILECLSjava.util.Date
getGMTOpenTime()
Getter for field GMTFILEOPNjava.lang.Long
getIndexBuffers()
Getter for field NUMINDEXBUFFjava.lang.Long
getIndexOperationCount()
Getter for field IEXCPCNTILocalFile.InstallAgentValue
getInstallAgent()
Getter for field INSTALLAGENTjava.util.Date
getInstallTime()
Getter for field INSTALLTIMEjava.lang.String
getInstallUserID()
Getter for field INSTALLUSRIDjava.lang.Long
getJournalID()
Getter for field JOURNALNUMjava.lang.Long
getKeyLength()
Getter for field KEYLENGTHjava.lang.Long
getKeyPosition()
Getter for field KEYPOSITIONjava.lang.Long
getLocalDeleteCount()
Getter for field LOCDELCNTjava.lang.Long
getLSRPoolID()
Getter for field LSRPOOLIDjava.lang.String
getName()
Getter for field FILEICICSType<ILocalFile>
getObjectType()
ILocalFile.OpenStatusValue
getOpenStatus()
Getter for field OPENSTATUSjava.lang.String
getOpenTime()
Getter for field TIMEOPENjava.lang.Long
getPeakStringWaitCount()
Getter for field WSTRCCURCNTILocalFile.RBATypeValue
getRBAType()
Getter for field RBATYPEILocalFile.ReadValue
getRead()
Getter for field READjava.lang.Long
getReadCount()
Getter for field GETCNTILocalFile.ReadIntegrityValue
getReadIntegrity()
Getter for field READINTEGjava.lang.Long
getReadUpdateCount()
Getter for field GETUPDCNTILocalFile.RecordFormatValue
getRecordFormat()
Getter for field RECORDFORMATjava.lang.Long
getRecordSize()
Getter for field RECORDSIZEILocalFile.RecoveryStatusValue
getRecoveryStatus()
Getter for field RECOVSTATUSILocalFile.RelativeAddressingTypeValue
getRelativeAddressingType()
Getter for field RELTYPEILocalFile.RLSAccessTypeValue
getRLSAccessType()
Getter for field RLSACCESSjava.lang.Long
getRLSTimeoutCount()
Getter for field RLSREQWTTOILocalFile.StatusValue
getStatus()
Getter for field ENABLESTATUSjava.lang.Long
getStringCount()
Getter for field STRINGSjava.lang.Long
getStringWaitCount()
Getter for field NUMSTRINGWTjava.lang.Long
getTotalStringWaitCount()
Getter for field WSTRCNTILocalFile.UpdateValue
getUpdate()
Getter for field UPDATEjava.lang.Long
getUpdateCount()
Getter for field UPDATECNTILocalFile.VSAMTypeValue
getVSAMType()
Getter for field VSAMTYPE-
Methods inherited from interface com.ibm.cics.model.ICICSObject
getCICSType
-
Methods inherited from interface com.ibm.cics.model.ICICSResource
getCICSContainer, getCICSRelease, getRegionName
-
-
-
-
Method Detail
-
getObjectType
ICICSType<ILocalFile> getObjectType()
- Specified by:
getObjectType
in interfaceICICSObject
- Specified by:
getObjectType
in interfacecom.ibm.cics.model.meta.ITypedObject
-
getName
java.lang.String getName()
Getter for field FILEFile ID
The name of the file.
- Specified by:
getName
in interfaceICICSObject
-
getAccessMethod
ILocalFile.AccessMethodValue getAccessMethod()
Getter for field ACCESSMETHODAccess method
The access method used for this file: BDAM, VSAM, DB2 or REMOTE
-
getAdd
ILocalFile.AddValue getAdd()
Getter for field ADDAdd option
Indicates whether new records can be added to the file
Input Values: ADDABLE, NOTADDABLE
Output Values: NOTAPPLIC
-
getBaseDSName
java.lang.String getBaseDSName()
Getter for field BASEDSNAMEBase data set name
For a file defined to CICS as a path, the name of the VSAM base data set. For a file defined as a base, this name is the same as the primary data set name.
-
getBlockFormat
ILocalFile.BlockFormatValue getBlockFormat()
Getter for field BLOCKFORMATBlock format (BDAM only)
Indicates whether records on the file are blocked or unblocked
-
getBlockKeyLength
java.lang.Long getBlockKeyLength()
Getter for field BLOCKKEYLNBlock key length (BDAM only)
For BDAM files, the physical block key length as a decimal number in the range 1 - 255. A value of N/A means the file is not a BDAM file.
-
getBlockSize
java.lang.Long getBlockSize()
Getter for field BLOCKSIZEBlock size (BDAM only)
For BDAM files, the length of a block in bytes. If the blocks are variable-length or are undefined, the value displayed is the maximum block size. A value of N/A means the file is not a BDAM file.
-
getBrowse
ILocalFile.BrowseValue getBrowse()
Getter for field BROWSEBrowse option
Indicates whether records can be sequentially retrieved from the file.
Input Values: BROWSABLE, NOTBROWSABLE
-
getDelete
ILocalFile.DeleteValue getDelete()
Getter for field DELETEDelete option
For VSAM files, indicates whether records can be deleted from the file.
Input Values: DELETABLE, NOTDELETABLE
Output Values: NOTAPPLIC
-
getDisposition
ILocalFile.DispositionValue getDisposition()
Getter for field DISPOSITIONDisposition of file
The disposition of the file.
Input Values: OLD, SHARE
-
getDSName
java.lang.String getDSName()
Getter for field DSNAMEData set name
The name of the data set
-
getEmptyStatus
ILocalFile.EmptyStatusValue getEmptyStatus()
Getter for field EMPTYSTATUSEmpty status
For VSAM files, indicates whether the data set is to be made empty the next time a file that references it is opened (EMPTYREQ or NOEMPTYREQ). This option is valid only for data sets that have been defined as reusable and defined to be used in non-RLS mode.
Input Values: EMPTYREQ, NOEMPTYREQ
-
getStatus
ILocalFile.StatusValue getStatus()
Getter for field ENABLESTATUSEnablement status
Indicates whether the local file is available for access by application programs. The status will be one of the following:
- ENABLED - Available for access.
- DISABLED - Unavailable as a result of a SET DISABLED command.
- DISABLING - Still being accessed after a SET DISABLED or SET CLOSED command.
- UNENABLED - Unavailable as a result of a SET CLOSED command.
- UNENABLING - A request to close the file has been received, but tasks are executing that had previously accessed the file. These tasks are allowed to complete their use of the file, but new tasks are not allowed access.
Input Values: ENABLED, DISABLED
-
getExclusive
ILocalFile.ExclusiveValue getExclusive()
Getter for field EXCLUSIVEBDAM exclusive control status
For BDAM files, indicates whether records on the file are placed under exclusive control when a read for update is issued
Input Values: EXCTL, NOEXCTL, NOTAPPLIC
-
getForwardRecoveryStatus
ILocalFile.ForwardRecoveryStatusValue getForwardRecoveryStatus()
Getter for field FWDRECSTATUSForward recovery option
Indicates, for VSAM files, whether the file is forward-recoverable (FWDRECOVABLE or NOTFWDRCVBLE).
-
getKeyLength
java.lang.Long getKeyLength()
Getter for field KEYLENGTHKey length
For local files associated with a VSAM KSDS, the length of the key. For local files associated with a BDAM data set, the length of the logical key used for deblocking. A value of 0 is returned if the file is not open.
-
getKeyPosition
java.lang.Long getKeyPosition()
Getter for field KEYPOSITIONKey position
The starting position of the key field in each record relative to the beginning of the record. A value of 0 is returned if the file is not open.
-
getDSType
ILocalFile.DSTypeValue getDSType()
Getter for field OBJECTData set type (base or path)
For VSAM files, indicates whether the file is related to a base data set (BASE) or is defined as a path that is accessed by means of an alternate index (PATH).
-
getOpenStatus
ILocalFile.OpenStatusValue getOpenStatus()
Getter for field OPENSTATUSOpen status
Indicates whether the file is open, closed, or in transition. The values are: OPEN, CLOSED, OPENING, CLOSING, CLOSEREQUEST.
Input Values: OPEN, CLOSED
-
getRead
ILocalFile.ReadValue getRead()
Getter for field READRead option
Indicates whether records can be read from the file.
Input Values: READABLE, NOTREADABLE
Output Values: NOTAPPLIC
-
getRecordFormat
ILocalFile.RecordFormatValue getRecordFormat()
Getter for field RECORDFORMATRecord format
The format of the records on the file (FIXED, VARIABLE, or UNDEFINED).
-
getRecordSize
java.lang.Long getRecordSize()
Getter for field RECORDSIZERecord size
For fixed-length records, the actual size of a record. For variable-length records, the maximum size of a record. A value of 0 is returned if the file is not open.
-
getRecoveryStatus
ILocalFile.RecoveryStatusValue getRecoveryStatus()
Getter for field RECOVSTATUSRecovery status
Indicates whether the file is recoverable (RECOVERABLE or NOTRECOVABLE).
-
getRelativeAddressingType
ILocalFile.RelativeAddressingTypeValue getRelativeAddressingType()
Getter for field RELTYPERelative addressing type (BDAM only)
For BDAM files, indicates whether relative or absolute addressing is used to access the file, and if relative, what type of relative addressing is being used in the block reference portion of the file's record identification field. The type is identified as one of the following:
- BLK - Relative block addressing
- DEC - Zoned decimal format
- HEX - Hexadecimal relative track and record format
- NOTAPPLIC - Absolute addressing is being used or the file is a VSAM file
-
getStringCount
java.lang.Long getStringCount()
Getter for field STRINGSNumber of strings
For VSAM files, the number of concurrent operations that can be performed on the file. A value of N/A means the file is not a VSAM file.
Input Values: 1 - 255
-
getVSAMType
ILocalFile.VSAMTypeValue getVSAMType()
Getter for field VSAMTYPEType of VSAM data set
Indicates how the records are organized in the data set associated with this file.
For VSAM files, the type is identified as one of the following:
- ESDS - Entry-sequenced data set
- KSDS - Key-sequenced data set
- RRDS - Relative record data set
- VRRDS - Variable relative record data set
For BDAM files, the type is either KEYED or NOTKEYED.
A value of NOTAPPLIC is returned if the file is not open.
-
getUpdate
ILocalFile.UpdateValue getUpdate()
Getter for field UPDATEUpdate option
Indicates whether records in the file can be updated.
Input Values: UPDATABLE, NOTUPDATABLE
-
getOpenTime
java.lang.String getOpenTime()
Getter for field TIMEOPENLocal time file was opened
The local time at which the file was opened.
-
getCloseTime
java.lang.String getCloseTime()
Getter for field TIMECLOSELocal time file was closed
The local time at which the file was closed.
-
getReadCount
java.lang.Long getReadCount()
Getter for field GETCNTNumber of READ requests
The number of GET requests issued against this local file.
-
getReadUpdateCount
java.lang.Long getReadUpdateCount()
Getter for field GETUPDCNTNumber of READ UPDATE requests
The number of GET UPDATE requests issued against this local file.
-
getBrowseCount
java.lang.Long getBrowseCount()
Getter for field BROWSECNTThe number of READNEXT and READPREV requests
The number of READNEXT and READPREV requests issued against the file.
-
getAddCount
java.lang.Long getAddCount()
Getter for field ADDCNTNumber of WRITE requests
The number of PUT requests issued against this local file.
-
getUpdateCount
java.lang.Long getUpdateCount()
Getter for field UPDATECNTNumber of REWRITE requests
The number of PUT UPDATE requests issued against this local file.
-
getLocalDeleteCount
java.lang.Long getLocalDeleteCount()
Getter for field LOCDELCNTNumber of DELETE requests
The number of DELETE requests issued against this local file.
-
getDataOperationCount
java.lang.Long getDataOperationCount()
Getter for field DEXCPCNTNumber of I/O operations for data records
For VSAM files, the number of I/O operations on the file for data records.
-
getIndexOperationCount
java.lang.Long getIndexOperationCount()
Getter for field IEXCPCNTNumber of I/O operations against index component
For VSAM files, the number of I/O operations on the file for index records.
-
getTotalStringWaitCount
java.lang.Long getTotalStringWaitCount()
Getter for field WSTRCNTTotal requests queued because all strings in use
The total number of requests that were queued because all the strings available to the file were in use.
-
getJournalID
java.lang.Long getJournalID()
Getter for field JOURNALNUMJournal number
The ID of the journal associated with this file, in the range 1 - 99. An ID of 1 identifies the CICS system log. A value of 0 means no automatic journaling is being done because JID=NO was specified in the FCT entry.
-
getPeakStringWaitCount
java.lang.Long getPeakStringWaitCount()
Getter for field WSTRCCURCNTPeak number of tasks waiting for a string
The peak number of requests that were queued at any one time because all the strings available to the file were in use.
-
getLSRPoolID
java.lang.Long getLSRPoolID()
Getter for field LSRPOOLIDLSR Pool number
For VSAM files, the number of the LSR pool associated with the file.
A value of 0 means the file must not share buffers. A value of N/A means the file is not a VSAM file.
Input Values: 0 - 255
-
getDataBuffers
java.lang.Long getDataBuffers()
Getter for field NUMDATBUFFNumber of data buffers
The number of buffers to be used for data.
-
getIndexBuffers
java.lang.Long getIndexBuffers()
Getter for field NUMINDEXBUFFNumber of index buffers
The number of buffers to be used for the index.
-
getActiveStringCount
java.lang.Long getActiveStringCount()
Getter for field NUMACTSTRINGNumber of active strings
The current number of updates to the file.
-
getGMTOpenTime
java.util.Date getGMTOpenTime()
Getter for field GMTFILEOPNGMT file open time
The time at which the file was opened.
-
getGMTCloseTime
java.util.Date getGMTCloseTime()
Getter for field GMTFILECLSGMT file close time
The time at which the file was closed.
-
getStringWaitCount
java.lang.Long getStringWaitCount()
Getter for field NUMSTRINGWTCurrent number of string waits
The current number of requests that are queued because all the strings available to the file were in use
-
getDSRecordType
java.lang.String getDSRecordType()
Getter for field DATASETTYPEData set type
Indicates how the records are organized in the data set associated with the file. For VSAM files, the type is identified as one of the following:
- ESDS - Entry-sequenced data set
- KSDS - Key-sequenced data set
- RRDS - Relative record data set
-
getBrowseUpdateCount
java.lang.Long getBrowseUpdateCount()
Getter for field BROWUPDCNTNumber of browse for update requests
The number of GET NEXT, GET PREV, and PUT UPDATE requests issued against this local file.
-
getReadIntegrity
ILocalFile.ReadIntegrityValue getReadIntegrity()
Getter for field READINTEGDefault level of read integrity
The default level of read integrity active for the file, if a read integrity option is not explicitly coded on an API FILE READ command. The levels are:
- UNCOMMITTED - There is no read integrity specified for this file.
- CONSISTENT - Read requests for this file are subject to consistent read integrity (unless otherwise specified on the read request).
- REPEATABLE - Read Requests for this file are subject to repeatable read integrity (unless otherwise specified on the read request).
- NOTAPPLIC - Read integrity is not applicable for this file.
-
getRLSAccessType
ILocalFile.RLSAccessTypeValue getRLSAccessType()
Getter for field RLSACCESSRecord level sharing (RLS) file access mode
Indicates whether a file is accessed in RLS mode. The values are:
- RLS - The file refers to a data set accessed in RLS mode.
- NOTRLS - The file refers to a data set accessed in non-RLS mode.
- NOTAPPLIC - The file is not eligible to be accessed in RLS mode.
Input Values: RLS, NOTRLS
-
getRLSTimeoutCount
java.lang.Long getRLSTimeoutCount()
Getter for field RLSREQWTTORecord level sharing (RLS) request wait timeouts
The number of RLS file requests that have timed out while awaiting request completion from the VSAM RLS server.
-
getRBAType
ILocalFile.RBATypeValue getRBAType()
Getter for field RBATYPEType of VSAM extended addressing
Indicates whether, for VSAM files, the data set uses extended addressing. The values are:
- EXTENDED - This VSAM data set uses extended relative byte addressing and therefore can hold more than 4 gigabytes of data.
- NOTAPPLIC - One of the following is true:
- The data set is BDAM.
- The file is remote.
- The file is not open.
- NOTEXTENDED - This VSAM data set does not use extended relative byte addressing and therefore cannot hold more than 4 gigabytes of data.
-
getChangeUserID
java.lang.String getChangeUserID()
Getter for field CHANGEUSRIDLast modification user ID
The user ID that made the last modification to the resource definition.
-
getChangeAgent
ILocalFile.ChangeAgentValue getChangeAgent()
Getter for field CHANGEAGENTLast modification agent
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.
- OVERRIDE - Resource was last changed by resource overrides.
- N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
-
getChangeAgentRelease
java.lang.String getChangeAgentRelease()
Getter for field CHANGEAGRELLast modification agent release
The CICS release level of the agent that made the last modification to the resource definition.
-
getChangeTime
java.util.Date getChangeTime()
Getter for field CHANGETIMELast modification time
The local date and time when the definition was last changed.
-
getDefineSource
java.lang.String getDefineSource()
Getter for field DEFINESOURCESource of the resource definition
The source of the definition, depending on which agent made the last change.
-
getDefineTime
java.util.Date getDefineTime()
Getter for field DEFINETIMECreation time
The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
-
getInstallUserID
java.lang.String getInstallUserID()
Getter for field INSTALLUSRIDInstallation user ID
The user ID that installed the resource definition.
-
getInstallTime
java.util.Date getInstallTime()
Getter for field INSTALLTIMEInstallation time
The local date and time when the definition was installed.
-
getInstallAgent
ILocalFile.InstallAgentValue getInstallAgent()
Getter for field INSTALLAGENTInstallation agent
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.
- BUNDLE - The resource was installed by a bundle.
-
getBasdefinever
java.lang.Long getBasdefinever()
Getter for field BASDEFINEVERBAS resource definition version
The BAS version number of this definition.
-
getCICSObjectReference
ILocalFileReference getCICSObjectReference()
- Specified by:
getCICSObjectReference
in interfaceICICSObject
- Specified by:
getCICSObjectReference
in interfaceICICSResource
-
-