FCRF gate, BROWSE function

Browse a file in a remote system.

Input Parameters

BROWSE_IDENTIFIER
A token that identifies the browse operation.
READ_BUFFER
The buffer that receives the file record data that is returned from the remote system.
RECORD_ID
Optional Parameter
The record identifier.
REMOTE_FILE_NAME
Optional Parameter
The file name in the remote system.
REMOTE_SYSTEM
Optional Parameter
The SYSID of the remote system.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • DISASTER_PERCOLATION
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
BACKEND_ACCMETH_RETURN_CODE
The return code from the file access method in the remote system.
BACKEND_DUPLICATE_KEY
When the data set is being accessed in the remote system by way of an alternate index path that allows non-unique alternate keys, a binary value that indicates whether further records exist with the same alternate key.
Values for the parameter are:
  • NO
  • YES
BACKEND_LENGTH_ERR_CODE
A value that provides details of a length error that occurred when processing the request in the remote system.
Values for the parameter are:
  • BUFFER_LEN_NOT_FILE_LEN
  • BUFFER_LEN_TOO_SMALL
  • LENGTH_OK
  • RECORD_LEN_NOT_FILE_LEN
  • RECORD_LEN_TOO_LARGE
BACKEND_REASON
The reason code from the file control request in the remote system.
BACKEND_RESPONSE
The response code from the file control request in the remote system.
FULL_RECORD_ID_LENGTH
The length of the record key.
MAXIMUM_RECORD_LENGTH
The length of the longest record in the data set.
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
TERMINATE_REQUEST
A binary value that indicates whether a remote file request should be terminated.
Values for the parameter are:
  • NO
  • YES
TERMINATE_STRING
A binary value that indicates whether the FRTE string should be terminated.
Values for the parameter are:
  • NO
  • YES
UPDATE_TOKEN
Optional Parameter
A token that identifies an update request, and allows subsequent requests to refer to it.


dfhs3_FCRFbrowse.html | Timestamp icon Last updated: Monday, 5 June 2017