Overview

This page provides links to detailed information for all configuration options of Universal Connector for Use with SAP® ERP.

The options are listed alphabetically, without regard to any specific operating system.

Configuration Options Information

For each configuration option, these pages provides the following information.

Description

Describes the configuration option and how it is used.

Usage

Provides a table of the following information:

Method	Syntax	IBM i	HP NonStop	UNIX	Windows	z/OS
Command Line, Short Form	<Format / Value>
Command Line, Long Form	<Format / Value>
Environment Variable	<Format / Value>
Configuration File Keyword	<Format / Value>

Method

Identifies the different methods used to specify Universal Connector configuration options:

Command Line Option, Short Form
Command Line Option, Long Form
Environment Variable
Configuration File Keyword

Note

Each option can be specified using one or more methods.

Syntax

Identifies the syntax of each method that can be used to specify the option:

Format: Specific characters that identify the option.
Value: Type of value(s) to be supplied for this method.

Note

If a Method is not valid for specifying the option, the Syntax field contains n/a.

(Operating System)

Identifies the operating systems for which each method of specifying the option is valid:

IBM i
HP NonStop
UNIX
Windows
z/OS

Values

Identifies all possible values for the specified value type.

Defaults are identified in bold type.

<Additional Information>

Identifies any additional information specific to the option.

Command Usage

Provides links to the Universal Connector commands that use the option.

If the option is associated with program execution, not commands, this section provides a link to the appropriate option category in Universal Connector for SAP Configuration Options for Program Execution.

Configuration Options List

The following table identifies all Universal Connector configuration options.

Option	Description
ABAP_NAME	Name of an ABAP program in an SAP system.
ACTIVITY_MONITORING	Specification for whether or not product activity monitoring events are generated.
ALLOW_AUTO_RESTART	Specification for whether or not a RESTART value of *AUTO* will be allowed.
AS_HOST	Host name of an SAP application server for a Type A RFC connection.
BATCH_MONITOR	Causes USAP to perform batch input monitoring for the job being started.
BIF_DIRECTORY	Broker Interface Directory that specifies the location of the Universal Broker interface file.
CFIT	Substitute symbol to use if the ON_CCE option value is 2 (replace the character).
CFT_ABAP_PROGRAM	ABAP program to use for the command ID job step.
CFT_COMMAND_PREFIX	In pre-XBP 2.0 CFT mode, the prefix command required for the operating system of the target host.
CFT_TARGET_HOST	In pre-XBP 2.0 CFT mode, the target host to use for the command ID job step when the command ID option is used.
CLIENT	Host name of a specific SAP application server for a Type A RFC Connection.
CHAIN_DESCRIPTION	Text description mask for process chains to be displayed.
CHAIN_ID	ID mask of process chains to be displayed.
CHAIN_LOG	Specification for whether or not the process chain log will be returned.
CODEPAGE	As documented by SAP: The CODEPAGE option is similar to the PCS option. It is needed only if you want to connect to a non-Unicode back-end using a non-ISO-Latin-1 username or password. The RFC library will then use that codepage for the initial handshake, thus preserving the characters in username/password. \|
COMMAND_ID	Identifier used to identify the unit of work represented by a USAP command and the associated SAP job.
DATA_SOURCE	Data Source mask for which the InfoPackages were created.
DELTA	Specification for whether or not to use delta-manager when serializing / deserializing table parameters passed by using TABLES clause.
DESTINATION	Name of a destination defined in the saprfc.ini file.
DISPLAY_CLIENT	Identify a specific SAP client whose intercepted jobs will be reported.
ENABLE_JOB_STATUS_CHECK	Specification to enable or disable calls to SAP function module BAPI_XBP_JOB_STATUS_CHECK, which are used to synchronize the actual job status with the R/3 stored status.
ENCRYPT_FILE	Name of an encrypted text command file.
ENCRYPTION_KEY	Key used to encrypt the command file.
EVENT_ACTION	Specification for whether or not the status of return events should be changed on the SAP system.
EVENT_GENERATION	Events to be generated as persistent events.
EVENT_ID	Name of the event.
EVENT_PARAMETER	Optional parameter value for the event.
EVENT_SELECT_STATE	Event status of the events which should be read.
EXIT_JOB_ACTIVE	USAP exit code for the SAP job active status.
EXIT_JOB_FINISHED	USAP exit code for the SAP job finished status.
EXIT_JOB_READY	USAP exit code for the SAP job ready status.
EXIT_JOB_RELEASED	USAP exit code for the SAP job released status.
EXIT_JOB_SCHEDULED	USAP exit code for the SAP job scheduled status.
EXIT_JOB_TERMINATED	USAP exit code for the SAP job terminated status.
EXIT_MAX_SPOOL_SIZE_EXCEEDED	Minimum exit code that will be set if an attempt is made to return a spool list that exceeds the maximum size for job logs as specified by the MAX_SPOOL_LIST_SIZE USAP configuration option.
EXIT_QUEUE_BACKGROUND	USAP exit code for the SAP queue state S (in background).
EXIT_QUEUE_CREATED	USAP exit code for the SAP queue state C (to be created).
EXIT_QUEUE_ERROR	USAP exit code for the SAP queue state E (error).
EXIT_QUEUE_FINISHED	USAP exit code for the SAP queue state F (finished).
EXIT_QUEUE_UNPROCESSED	USAP exit code for the SAP queue state [ ] (unprocessed).
EXTERNAL_COMMAND	Complete command name or a mask used to select SAP external commands that match the mask.
FILE_NAME	Name of a plain text command file.
FIRST_PAGE	Starting page from which a spool list will be returned.
FORCE	Specification for whether or not the process chain instance associated with a client fault tolerant process chain job is restarted on the SAP system.
FROM_DATE	Earliest date to use for job selection or syslog request.
FROM_TIME	Earliest time to use for job selection or syslog request.
GROUP	Name of the group of application servers for a Type B RFC connection.
GW_HOST	Host name of the SAP gateway for a Type A RFC connection.
GW_SERV	Service name of the SAP gateway for a Type A RFC connection.
HELP	Displays a description of command line options and their format.
IMMEDIATE_JOB	Causes the job to be started immediately.
INFO_PACKAGE	Name of the mask InfoPackage to select.
INFO_SOURCE	InfoSource mask for which the InfoPackages were created.
INSTALLATION_DIRECTORY	Location in which USAP is installed.
JOB_ID	Job ID of an existing SAP job.
JOB_ID_PATTERN	Locates the header record and determines the offset of the job ID in the RSBDCSUB batch input processing report.
JOB_LOG_CHILD	Controls the writing of job logs for child jobs.
JOB_NAME	Name of an existing SAP job.
JOB_NAME_PATTERN	Locates the header record and determines the offset of the job name in the RSBDCSUB batch input processing report.
JOB_NETWORK_ID	Network identifier for the pre-existing SAP FS job network being started.
JOB_PROCESS_ID	Process ID of an existing SAP FS job network process to start.
JOB_STATUS	SM37-batch-status.
LAST_PAGE	Last page of a spool list to be returned.
LAYOUT_NAME	Complete layout name or a mask used to select printer layouts that match the mask.
LISTEN_INTERVAL	Number of seconds that will elapse between RFC listen calls.
LOG_ID	Log ID for process instance data.
LOGON_LANGUAGE	SAP logon language used for the USAP session.
LOGON_RETRY_COUNT	Number of unsuccessful RFC logon retry attempts that can occur before USAP terminates the logon process and ends unsuccessfully.
LOGON_RETRY_INTERVAL	Number of seconds that will elapse between a failed RFC logon attempt and the retry of that logon attempt.
LONG_DEVICE_NAME	Complete device name or a mask used to select SAP output devices that match the mask.
MASS_ACTIVITY_WAIT	Causes USAP to wait for the SAP mass activity jobs to complete processing.
MAX_CHILD_DEPTH	Controls the maximum relationship depth that will be monitored by USAP.
MAX_HIT_COUNT	Maximum number of ABAP reports to be returned.
MAX_JOB_LOG_SIZE	Maximum size for job logs.
MAX_SPOOL_LIST_SIZE	Maximum size for spool lists.
MAX_XBP	Maximum version of the SAP XBP interface that will be used during USAP execution.
MESSAGE_LANGUAGE	Language in which messages are written.
MESSAGE_LEVEL	Level of messages to written.
MODEL_STATUS	For operations that work with model jobs without providing a job ID to explicitly target a specific job on the SAP system, restricts the model job candidates to the specified job status.
MS_HOST	Host name of the message server for a Type B RFC connection.
MYSAPSSO2	Path to a file containing the credentials to log on with an SSO2 ticket (Single-Sign_On) - instead of USER&PASSWORD - or with an "Assertion" ticket (starting with back-end release 7.00).
NO_COMPRESSION	Specification for whether or not the RC protocol compress tables.
NO_START_DATE	Specification for whether or not to include jobs with no start date in selection criteria.
ON_CCE	Specification for what the NW RFC library will do when it encounters a character that either does not exist in the target codepage, is a broken character or is a control character (0x00 - 0x19).
OPERATING_SYSTEM	Name of the operating system for which external commands are searched.
OUTPUT_FIELD_LIST	Additional fields to write for the select command.
PAGE_LIMIT	Maximum number of pages that can be returned in the syslog report.
PASSWORD	Password for the SAP user ID.
PCS	As documented by SAP: The PCS option specifies a Partner Character Size. It is rarely needed, as during the initial handshake, the RFC library obtains the correct value from the back-end and uses it from then on. However, a rare use case could be that the back-end is Unicode and you want to use a non-ISO-Latin-1 username or password for the initial logon. As the initial handshake is done with ISO-Latin-1, the characters in username/passwd would break, resulting in a refused logon. In that case, set PCS=2 and the RFC library will use Unicode for the initial handshake. \|
PLF_DIRECTORY	Program Lock File directory that specifies the location of the USAP program lock file.
PRINTER_NAME	Name of a printer for which the print formats will be retrieved.
PROCESS_LOGS	Specification for whether or not the process logs will be returned.
PROFILE_ID	ID of the profile.
PROFILE_TYPE	Type of profile.
PURGE_BDC_MAP	Specification for whether or not to delete BDC Batch input session queues that have been processed successfully.
PURGE_CHILD_JOBS	Controls the purging of child jobs.
PURGE_JOB	Purge job that has completed processing from SAP system.
QUEUE_ID	Queue identifier associated with the batch input session.
QUEUE_ID_PATTERN	Locates the header record and determines the offset of the queue ID in the RSBDCSUB batch input processing report.
R3_NAME	System ID of the SAP system to which you want to connect for a Type B RFC connection.
RAW_SPOOL	Specification for whether the SAP spool lists will be returned from the SAP system in raw or plain format.
REQUEST_ID	Request ID for InfoPackage instance for which the status is to be displayed.
RESOLVE_MULTI_MODEL	For operations that work with model jobs without providing a job ID to explicitly target a specific job on the SAP system, controls the behavior when multiple candidate jobs are found.
RESTART	Specification for whether or not this execution of USAP is a restart of a previous client fault tolerant USAP command.
RETRY_CALL_COUNT	Number of unsuccessful RFC call retry attempts that can occur before USAP terminates the RFC call retry process and ends unsuccessfully.
RETRY_CALL_INTERVAL	Number of seconds that will elapse between a failed RFC call and the retry of that call.
RETURN_APPLICATION_LOG	Specification for whether or not the job's application log is returned.
RETURN_APPLICATION_RC	Specification for whether or not the job's application return codes are returned.
RETURN_JOB_LOG	Specification for whether or not the job's job log is returned.
RETURN_SPOOL_LIST	Specification for whether or not the spoollists of all job steps are returned.
RFC_TRACE	Trace level of all connections / destinations.
SAPROUTER	SAPRouter string for the NW RFC connection.
SECURE_CFT	Mode of client fault tolerance to be used for the command invocation.
SERVER_STOP_CONDITIONS	Exit code(s) of the executing Universal Connector process that should trigger the locally running Universal Broker to cancel the corresponding SAP job.
SNC_LIB	Full path and name of a third-party security library to use for SNC communication (authentication, encryption, and signatures).
SNC_MODE	Specification for whether or not SNC should be activated for the SAP RFC connection.
SNC_MYNAME	Token/identifier representing the external RFC program.
SNC_PARTNERNAME	Token/identifier representing the back-end system.
SNC_QOP	Quality of protection level.
SNC_SSO	Specification for whether or not to use SNC single sign-on if SNC is enabled.
SOURCE_SYSTEM	Source system mask for which the InfoPackages were created.
SPOOL_CODEPAGE	Codepage to be used for transferring spool lists from the SAP system.
SPOOL_ID	Spool list request number in an SAP system.
SPOOL_LIST_CHILD	Controls the printing of spoollists for child jobs.
SPOOL_RECEIVE_BUFFER	Size of the blocks (number of pages) used when transferring spool lists.
START	Starts the newly defined job.
STATUS_ABORTED	Specification for whether or not to include jobs with status aborted in selection criteria.
STATUS_CHECK_INTERVAL	Length of time that can elapse, without a change in job status, before a call will be made to synchronize the actual job status with the SAP stored status.
STATUS_FINISHED	Specification for whether or not to include jobs with status finished in selection criteria.
STATUS_READY	Specification for whether or not to include jobs with status ready in selection criteria.
STATUS_RELEASED	Specification for whether or not to include jobs with status released in selection criteria.
STATUS_RUNNING	Specification for whether or not to include jobs with status running in selection criteria.
STATUS_SCHEDULED	Specification for whether or not to include jobs with status scheduled in selection criteria.
STEP_NUMBER	Step number of the SAP job step.
SUBMIT	Defines a job to the SAP system.
SYSLOG	Requests entries from an SAP System syslog for a specified date and time range.
SYSLOG_POST_TIME	Length of time to add to the job end time when calculating the to time for the syslog report.
SYSLOG_PRE_TIME	Length of time to subtract from the job release time when calculating the from time for the syslog report.
SYSTEM_ID	Local Universal Broker with which USAP must register before the Manager performs any request.
SYSTEM_NUMBER	SAP system number of an SAP application server for a Type A RFC connection.
TARGET_JOB_NAME	Name to give the newly created job.
TARGET_SERVER	Server on which the job will run.
TARGET_VARIANT	One or more replacement variants for ABAP program job steps in an SAP job.
TARGET_VARIANTNAME	Name given to a copied VARIANT on an SAP system.
TECHNICAL_DEVICE_NAME	Complete device name or a mask used to select SAP output devices that match the mask.
TIMEOUT_INTERVAL	Number of seconds that can elapse before USAP considers an RFC call to have timed out.
TO_DATE	Latest date to use for job selection or syslog request.
TO_TIME	Latest time to use for job selection or syslog request.
TRACE_DIRECTORY	Directory where RFC trace files will be written.
TRACE_FILE_LINES	Maximum number of lines to write to the trace file.
TRACE_TABLE	Trace table size and under what conditions it is written to a file.
TRANSLATION_TABLE	Spoollist translation table file to use for formatting returned spoollists.
USAP_POLL	Length of time to wait between job status calls to the SAP system.
USE_APPLICATION_RC	Specification for whether or not the job's application return codes are used to determine the exit code of the Universal Connector job.
USE_SYMBOLIC_NAMES	Specification for whether the NW RFC library, during group-logon, should use symbolic service names defined in /etc/services (such as sapgw33, or hard-coded port numbers derived from the instance number (such as 3300).
USER_ID	SAP user ID with which to logon to the SAP system.
USER_NAME	User ID associated with a job.
VARIANT	Pre-existing SAP variant name to use as the model variant.
VARIANT_LANGUAGE	Preferred language in which to return the variant description.
VARIANT_SELECTION	Specification to display either variants available for batch and dialog mode or variants available only for batch mode.
VERSION	Writes USAP version and copyright information.
WAIT	Wait for the SAP job to complete processing.
WAIT_FOR_CHILD_JOBS	Controls the monitoring of child jobs.
WITH_PREDECESSOR	Specification for whether or not to include jobs with start after predecessor in selection criteria.

X509CERT	Path to a file containing the credentials to log on with an X509 certificate ticket instead of USER&PASSWORD.
XMI_AUDIT_LEVEL	Sets the XMI audit level to be used for the execution of the command.