Queue Parameters 
Queue Parameters
Definition
Before you perform the functions, you must fill the queue parameter string <qparm>. The structure of <qparm> is defined in the Data Dictionary as a table without database QPARM.
Use
The queue parameter string can be considered as a reference to an open queue (command OPEN QUEUE) in the buffer file DOUT. If you want to write to several DOUT queues, you can select which queue to write to.
Structure
The parameter string <qparm> consists of the following groups:
The following topics list these parameters.
Parameters for the Queue Name
The following parameters determine the queue name:
Target system, for which you want to build the CPIC connection.
Transaction program in the target system, which is started via the CPI-C connection (for example, the CICS transaction X1SA if the target system is an R/2 System).
The types of data to be transferred.
The transfer program delivered by SAP supports the following data types:
RODC: |
data is in Remote ODC format. |
CPIC: |
data is unformatted and user-defined. |
SPLD: |
Corresponds to the CPIC format where data is stored intermediately in an SAP spool file instead of the queue. |
Client in the target system
Use this parameter only if the target system is an SAP system.
Name of the ABAP/4 program, in which the form routine to be performed is defined.
Use this parameter only if the target system is an SAP system and the transfer data type is CPIC or SPLD.
Name of the form routine to be performed.
Use this parameter only if the target system is an SAP system and the transfer data type is CPIC or SPLD.
Parameters for the Transfer Program
The following parameters control the transfer program Y1SA.
Queue open mode:
I: open queue for input
O: open queue for output (default)
U: open queue for update
If you do not specify an open mode (blank), the queue is opened for output (default setting).
Currently only this default setting is supported.
Start mode of the transfer programs:
A: Automatic
The transfer program is started after each queue unit. The queue unit is controlled with the parameters QFIRS and QLAST.
M: Manual
You start the transfer program interactively using the start function of the SAP transaction TMQD or TMQM.
Responsibility for correction of a transfer error:
S: Sender
R: Receiver
Currently only receiver correction responsibility is supported.
Synchronous/asynchronous update in the SAP system
S: Synchronous
A: Asynchronous
The values are only permitted if the target system is an SAP system and data type RODC is used:
Start date of the transfer programs
for automatic start in format "YYYMMDD"
Start time of the transfer programs
for automatic start in format "HHMMSS"
You can start the transfer program manually or automatically as well as at a specified start date and time. If the specified start time is before the automatic start time, the SAP transfer program is started immediately.
ID for the first record in a queue unit.
ID for the last record in a queue unit.
Transfer data can be grouped into queue units.
The transfer data in a queue unit is only deleted from the
queue after all the transfer data in the queue unit
has been sent and acknowledged.
If an error occurs, transfer begins with the first unit of the queue unit. A queue unit is identified by the values of the two parameter fields QFIRS, QLAST:
QFIRS QLAST Y N First transfer record
Y Y Only transfer record
N N Middle transfer record
N Y Last transfer record
You must ensure that the queue unit control entries are always closed correctly (with QLAST). An incorrectly identified queue unit will result in data being transferred incorrectly several times.
Name of the transfer program
If no name is specified (blank), the name of the SAP transfer program is automatically used (for example, in CICS environment: Y1SA, in a BS2000 environment RSDRIVER).
If you specify a name, it will be interpreted as the name of a user-defined transfer program.
User-defined transfer programs can be started automatically or manually.
SAP-specific Parameters
It is a good idea to use the SAP-specific parameters if the target system is an SAP system.
User ID in the SAP system.
Enter a user name here in accordance with the data type (RODC/CPIC).
Password for user ID in the SAP system.
The following parameters can be used if the data type RODC is also used.
SAP transaction code
Transaction code of the SAP transaction to be started via RODC (for example, TS02).
Program name of the corresponding transaction
(for example, SAPPG02).
Screen number of the corresponding transaction
(for example, 0041, the first screen in transaction TS02)