SAP. JCo Configuration. Properties and examples

Transcription

1 SAP JCo Configuration Properties and examples D /1/2008

2 Contents Description... 1 EBNF - Compact... 1 EBNF - Robust... 1 Prefix... 1 Key-Value Separator... 1 Property Separator... 2 JCo Configuration Static Destination Properties... 2 Destination Name... 2 JCo Configuration Dynamic Destination Properties... 2 Application Server Host... 2 System Number... 2 Message Server Host... 2 R3Client Number... 3 R3 SID... 3 Connection Idle Timeout... 3 Logon Group... 3 General Configuration Properties... 3 Number Of Chunks... 3 Buffer Size... 3 Transfer Timeout... 4 Examples... 4 Static Destination... 4 Full Configuration... 4 Minimal Configuration... 4 Dynamic Destination... 4 Full Configuration (Load Balancing ON)... 4 Full Configuration (Load Balancing OFF)... 4 Minimal Configuration (Load Balancing ON)... 4 Minimal Configuration (Load Balancing OFF)... 4

3 Description The first letter (prefix) must be jco: (case insensitive) The values are connected to the keys with = The Properties are separated with, The Properties are case insensitive Spaces are allowed between the Properties, Separators, Keys and Values before and after the Prefix. EBNF - Compact <jcoaddress> ::= jco: { <KV> <Property Separator> } <KV>. <KV> ::= <Key> <Key Value Separator> <Value>. <Key> ::= { <Character> } +. <Value> ::= { <Character> <Number> } +. <Key Value Separator> ::= =. <Property Separator> ::=,. <Character> ::= a b c z. <Number> ::= EBNF - Robust <jcoaddress> ::= { <Space> }* <jco> : ( { <KV> <Property Separator> } + [<KV>] <KV> ). <KV> ::= <Key> <Key Value Separator> <Value>. <Key> ::= { <Character> } +. <Value> ::= { <Character> <Number> } +. <Key Value Separator> ::= =. <Property Separator> ::= {, } +. <Character> ::= <Lower Case> <Upper Case> <Special Character> <Space>. <Number> ::= <Special Character> ::=! $ #. <Space> ::=. <Lower Case> ::= a b c z. <Upper Case> ::= A B C Z. <jco> ::= <J> <C> <O>. <J> ::= J j. <C> ::= C c. <O> ::= O o. Prefix String: jco: Example: jco:properties o MUST be the first String in the property list. o Is case insensitive Key-Value Separator String: = Example: key=value 1 P a g e

4 o Is case insensitive Property Separator String:, Example: key1=value, key2=value, key3=value o none JCo Configuration Static Destination Properties Destination Name Key name: destination Example: jco:destination=mydestination o Use this key if you have set a destination in the Visual Admin / SAP NetWeaver Administrator JCo Configuration Dynamic Destination Properties Application Server Host System Number Key name: ashost Example: jco:ashost=pwdf2318 o This parameter will only be used if also sysnr is set (load balancing off) Key name: sysnr Example: jco:sysnr=20 o This parameter will only be used if also ashost is set (load balancing off) Message Server Host Key name: mshost Example: jco:mshost=pwdf2318 o Only used with if parameters ashost and sysnr are not set (load balancing off) 2 P a g e

5 R3Client Number Key name: client Example: jco:client=001 o none R3 SID Key name: r3name Example: jco:r3name=cts o Only used with if parameters ashost and sysnr are not set (load balancing off) Connection Idle Timeout Logon Group Key name: idletimeout Example: jco:idletimeout=600 Default value: 720 o Timeout in seconds o Min value: 0 Key name: group Example: jco:group=public Default value: PUBLIC o Only used with if parameters ashost and sysnr are not set (load balancing off) General Configuration Properties Number Of Chunks Buffer Size Key name: chunks Example: jco:chunks=4 Default value: 1 Max. value: 100 o A number of chunks greater than 1 splits the file in several chunks and transfers them simultaneously. This can speed up the file transfer. o Min value: 1 o If a file is smaller than 1MB, only one chunk will be used for the transfer regardless the configuration. 3 P a g e

6 Key name: buffersize Example: jco:buffersize= Default value: (500KB) o Buffer size of the InputStream o Given in bytes o Min value: 1 Transfer Timeout Key name: transfertimeout Example: jco:transfertimeout=60000 Default value: (30 minutes) o Transfer timeout for one file o Given in milliseconds o Min value: 0 o Interrupts the transfer if it lasts longer than the value specified, even if it is still running. Examples Static Destination Full Configuration jco:destination = mydestination,,,buffersize= ,chunks=1,transfertimeout= Minimal Configuration Dynamic Destination jco:destination=mydestination Full Configuration (Load Balancing ON) jco:mshost=pwdf2318,client=001,r3name=cts,idletimeout=600,group=publ IC,buffersize=100000,chunks=1,transfertimeout= Full Configuration (Load Balancing OFF) jco:ashost=pwdf2318,client=001,sysnr=20,idletimeout=600,buffersize= ,chunks=1,transfertimeout= Minimal Configuration (Load Balancing ON) jco:mshost=pwdf2318,client=001,r3name=cts Minimal Configuration (Load Balancing OFF) jco:ashost=pwdf2318,client=001,sysnr=20 4 P a g e