Ansicht
Dokumentation

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

Vendor Master (General Section)   ABAP Short Reference  
This documentation is copyright by SAP AG.

Task of function module "RSTS_OPEN_RLC"

TemSe objects save sequential files. Before they can be edited they must 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 users of 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 TemSe objects in parallel. Most of the time, however, only one TemSe object is edited at one time. The application was therefore simplified for use with 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 is processed 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 be used 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 the beginning that includes the row type for each row read.

If ALLINE is not set to "X", the system reads all normal rows (with data) 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 a database transaction using processing mode "E". If a TemSe object consists 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 own client.

AUTHORITY

Name of the function or transaction that checked the required authorizations

ENQLOCK

Lock mode of the object. The default value is "Do not use enqueue lock".

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_CLOSE call resets the lock.

Parameters

ALLINE
AUTHORITY
CHARCO
CLIENT
ENQLOCK
FBHANDLE
NAME
OBJTYPE
OWN_FBHANDLE
PROM
RECTYP

Exceptions

ENQ_FOREIGN_LOCK
ENQ_OTHER
ENQ_SYS_FAIL
FB_CALL_HANDLE
FB_ERROR
FB_RSTS_NOCONV
FB_RSTS_OTHER
NO_OBJECT
NO_PERMISSION

Function Group

STMS

Fill RESBD Structure from EBP Component Structure   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.

Length: 4188 Date: 20240523 Time: 142111     sap01-206 ( 62 ms )