The Batch Interface › SYSIN01 Parameters › General SYSIN01 Parameters › LUSER

LUSER

Specifies a user ID on the source system whose access privileges are used to execute the file transfer.

xxxxxxxx

Specifies up to eight alphanumeric characters representing a user ID whose access privileges on the source system are used for the file transfer.

Notes:

• LUSER is mainly used for a third-party transfer: a user on system A requests that system B (source) execute a file transfer to system C (target). While the transfer request is initiated by system A, the file transmission is entirely between system B and system C.

  The only prerequisites for third‑party transfers are:

  • All systems must be identified to VTAM and be running CA XCOM Data Transport Version 2 or higher.
  • The ID entered for LUSER must satisfy the requirements of the security software in effect on the source system.
• If the source system has a default user ID for third‑party file transfers, and you want to use this default, then a null value must be specified for this parameter as LUSER=“ ” with at least one space between the quotes.
• Not all CA XCOM Data Transport platforms support third‑party transfers.
• For conventional file transfers, LUSER can be used to identify the user initiating the transfer. This is useful in performing operator tracking and control functions through the menu interface.
• Do not confuse LUSER with the USERID parameter. USERID refers to the authorization access ID on the target system, both for ordinary file transfers and third‑party initiated transfers.
• You can use symbolic variables with this parameter in batch SYSIN01. For more information, see Symbolic Parameters.

Default: The ID associated with the address space created when the file transfer request is made

DEFAULT_CONVERROR

This parameter identifies the action when the input file contains characters that cannot be converted. The characters are not included within the output character sets character repertoire.

REPLACE

Replace each unconvertible character with the default substitution characters defined for the Unicode character set.

REPLACE#nnnnnnn

Replace each unconvertible character with the Unicode character that the decimal value nnnnnnn identifies. If the specified replacement character cannot be represented in the output character set, then the transfer is failed. This option is not supported for z/OS systems, where the replacement character is defined in the conversion table that is defined to IBM Unicode Services. This option is treated as REPLACE. The replacement character has a valid range of 1 – 1114111.

SKIP

The erroneous data is disregarded, but a warning message is issued at the end of the transfer. The message identifies that this condition occurred and provides a total count of the number of skipped characters. This option is not supported for z/OS systems and is treated as REPLACE.

FAIL

The transfer terminates with an error condition.

Default: The DEFAULT_CONVERROR parameter in the destination member or CA XCOM Data Transport Default Options Table specifies the default.

DEFAULT_INPUTERROR

This parameter identifies the appropriate action when the input file contains data that is not consistent with the specified input character set.

REPLACE

Replace each piece of erroneous data with the default substitution characters defined for the Unicode character set.

REPLACE#nnnnnnn

Replace each piece of erroneous data with the Unicode character that the decimal value nnnnnnn identifies. This option is not supported for z/OS systems, where the replacement character is defined in the conversion table that is defined to IBM Unicode Services. This option is treated as REPLACE. The replacement character has a valid range of 1 – 1114111.

SKIP

The erroneous data is disregarded, but a warning message is issued at the end of the transfer. The message identifies that this condition occurred and provides a total count of the number of ignored bytes. This option is not supported for z/OS systems and is treated as REPLACE.

FAIL

The transfer terminates with an error condition.

Default: The DEFAULT_INPUTERROR parameter in the destination member or CA XCOM Data Transport Default Options Table specifies the default.