SAP Function RSTS_OPEN_RB - Open TemSe Object in Order to Read in Blocks

Parameter Reference Type Length Default Optional Text
AUTHORITY RSTSTYPE-AUTHCHECKD C 20 ' ' X Who Carried Out Authorization Check
CLIENT RSTSTYPE-CLIENT C 3 SY-MANDT X Client (or Own)
ENQLOCK RSTSTYPE-PROM C 1 'N' X Without ("N"), With ("E"), Shared ("S) Enqueue Lock
NAME RSTSTYPE-NAME C 20 Name of Temse Object
OBJTYPE RSTSTYPE-TYPE C 12 'TEXT' X Data Type
OWN_FBHANDLE RSTSTYPE-WFBHANDLE C 1 ' ' X 'FBHANDLE' is Used
PROM RSTSTYPE-PROM C 1 'E' X Processing Mode

Parameter Reference Type Length Text
FBHANDLE RSTSTYPE-FBHANDLE X 196 Handle for Open Object

Exception Text
ENQ_FOREIGN_LOCK Object Locked by Another User
ENQ_OTHER
ENQ_SYS_FAIL
FB_CALL_HANDLE Error with Handles at CALL Interface
FB_ERROR Function Module Error
FB_RSTS_NOCONV Required Conversion Not Possible
FB_RSTS_OTHER Other Errors Reported by TemSe C System
NO_OBJECT Required TemSe Object Does Not Exist
NO_PERMISSION No Authorization for This Operation

Task of function module "RSTS_OPEN_RB"
TemSe objects save sequential files. Before they can be edited theymust be opened and when editing is finished, they must be closed.
This function module opens a TemSe object to read it row by row using"RSTS_READ". During the read, the data is processed block by block.
After editing is completed, the function module RSTS_CLOSE is called.

Parallel processing and handle concept
This group of function modules is designed for use with several TemSeobjects in parallel. Most of the time, however, only one TemSe objectis edited at one time. The application was therefore simplified for usewith one TemSe object at a time.

Processing only one object at a time
The following parameters do not have to be used if only one object isprocessed at a time:
Function module,,Parameter
RSTS_OPEN_RB,,OWN_FBHANDLE
,,FBHANDLE
RSTS_READ,,FBHANDLE
RSTS_CLOSE,,FBHANDLE
If you want to process multiple objects simultaneously, set"OWN_FBHANDLE" to "X" and use a variable for "FBHANDLE" that can beused for the related calls "RSTS_OPEN_RLC", "RSTS_READ" and"RSTS_CLOSE".

Additional optional parameters

PROM
The processing mode. There are three processing modes:
Mode,,Processing in
"I",,This internal session
"E",,All internal sessions within this external session
"W",,This work process
Note:
There is a limit to the number of TemSe objects that can be opened in adatabase transaction using processing mode "E". If a TemSe objectconsists of multiple parts, each part counts separately.
Only use mode "W" if you understand the consequences completely.

CLIENT
Client in which the TemSe object was saved. This is normally your ownclient.

AUTHORITY
Name of the function or transaction that checked the requiredauthorizations

OBJTYPE
Data type of the object

ENQLOCK
Lock mode of the object. The default value is "Do not use enqueuelock".
Possible values:
"N" Do not use enqueue lock (this is compatible with the previous
implementation)
"E" Set an exclusive enqueue lock
"S" Set a shared enqueue lock
The lock logic assumes that all users use the locks. The RSTS_CLOSEcall resets the lock.