SAP Function RSTS_OPEN_RLC - Open TemSe Object To Read Line By Line With Conversion

Parameter Reference Type Length Default Optional Text
ALLINE RSTSTYPE-ALLINE C 1 ' ' X All Lines (or Only Normal Ones)
AUTHORITY RSTSTYPE-AUTHCHECKD C 20 ' ' X Who Carried Out Authorization Check
CHARCO RSTSTYPE-CHARCO N 4 '*' X Character Set (or System Character Set)
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
RECTYP RSTSTYPE-RECTYP C 7 '*' X Record Type

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_RLC"
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". The data is read and then converted into a form that usersof this function module can easily edit.
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_RLC,,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

ALLINE
When ALLINE is set to "X", all rows are read. A column is added at thebeginning that includes the row type for each row read.
If ALLINE is not set to "X", the system reads all normal rows (withdata) and ignores rows with only row type information (but no data).

CHARCO
This specifies the character set to use for the data output. Usually,the system character set is used.

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.

RECTYP
Record type

OBJTYPE
Data type of object

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

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.