Downloading Control Recipes (SAP Library - PP - PI-PCS Interface: Linking of Process Control)

Downloading Control Recipes

To request and receive control recipes from R/3 System, you use the Request method of the ControlRecipe SAP business object.

This method only downloads control recipes that meet the following requirements:

· They have been assigned a destination of type 3 ( Download to an external system, initiated by process control).

· They have not yet been processed, this means, they have status Created.

After the update, the control recipes receive status Sent.

This graphic is explained in the accompanying text

Required Authorizations

Authorization object	Field	Value
C_CREX_WRK	Destination address	RFC destination of the control recipe destination
	Activity	90 (Request control recipe)
	Plant	Plant of the control recipe

When carrying out this method, the system does not check whether the caller and the control recipe destination are identical. For this reason, assign authorizations in such a way that a user can only request control recipes that are intended for his destination address.

Selection Criteria

You can use the following parameter to specify which control recipes R/3 PP-PI is to download:

Table Parameter	Description	Number of Entries
ControlRecipe	Import: Numbers of the requested control recipes	1 / control recipe

Table ControlRecipe

Field	Format	Length	Description
CNTL_REC_ID	NUMC	18	Control recipe number

Control Recipe Download

The R/3 System returns the data of the requested control recipes in the following parameters:

Table Parameter	Description	Number of Entries
CntlRecHeader	Export: Header data of control recipes	1 / control recipe
CntlRecProcInstr	Export: Process instructions of the control recipe	At least 1 / control recipe
CntlRecCharac	Export: Process instruction characteristics	At least 1 / process instruction
CntlRecTextlines	Export: Long texts of process instruction characteristics	At least 1 / long text characteristic

Table CntlRecHeader

For more information on the structure of this table, see Reading Control Recipe Lists, section Returning Control Recipe Data.

Table CntlRecProcInstr

Field	Format	Length	Description
CNTL_REC_ID	NUMC	18	Control recipe number
PROC_INSTR_ NUMBER	NUMC	08	Serial number of the process instruction in the control recipe
PROC_INSTR_TYPE	CHAR	01	Process instruction type: 01 (Process parameter) 02 (Process data request) 03 (Process message subscription) 04 (Process data calculation formula)
PROC_INSTR_ CATEGORY	CHAR	08	Process instruction category
PROC_INSTR_ LINE_NO	CHAR	04	Line number of the process instruction in the process order Can be used to issue error messages
PHASE_NUMBER	CHAR	04	Number of the phase that contains the process instruction

Table CntlRecCharac

Field	Format	Length	Description
CNTL_REC_ID	NUMC	18	Control recipe number
PROC_INSTR_ NUMBER	NUMC	08	Serial number of the process instruction in the control recipe
CHAR_LINE_ NUMBER	NUMC	04	Line number of the process instruction characteristic in the process instruction
NAME_CHAR	CHAR	30	Name of the process instruction characteristic
CHAR_VALUE	CHAR	30	Characteristic values (left-aligned)
DATA_TYPE	CHAR	04	Format of the characteristic value: CHAR (alphanumeric value) NUM (floating point number) DATE (Date: YYYYMMDD) TIME (Time: HHMMSS)
INSTR_CHAR_LINE_ NUMBER	CHAR	04	Line number of process instruction characteristic in the order Can be used to issue error messages

Table CntlRecTextlines

Field	Format	Length	Description
CNTL_REC_ID	NUMC	18	Control recipe number
PROC_INSTR_ NUMBER	NUMC	08	Serial number of the process instruction in the control recipe
CHAR_LINE_ NUMBER	NUMC	04	Line number of the process instruction characteristic in the process instruction
TDFORMAT	CHAR	02	Format key of the text line
TDLINE	CHAR	132	Text line

System Messages

The R/3 System returns system messages on the method call in the Return parameter.

Table Parameter	Description
Return	Export: System messages on the method call

The following system messages may appear:

Type	ID	Number	System message
E	CB1	404	You are not authorized to request control recipes for address &2
E	CB	082	Control recipe & has already been sent
E	CB1	401	Control recipe & not created in the system
E	CB	014	Control recipe & locked
A	CB	201	Further processing not possible (contact system administrator)
E	CB1	207	Characteristic & not created in the system
E	CB1	301	Error when converting value to format &1

For more information on the structure of the Return table, Reading Control Recipe Lists, section System Messages.