IC94012: CONNECT:DIRECT RESTRICTS THE USE OF THE CHARACTERS LISTED BELOW SO THESE CAUSE PARSING ERRORS AND THE PROCESSES DON'T RUN.

Direct links to fixes

APAR status

Closed as program error.

Error description

Special characters that are being used in the paths/filenames
on a Windows system are being passed directly to C:D in
processes.  C:D restricts the use of the characters listed
below so these cause parsing errors and the processes don't run.

These characters can be ignored by the CD parser by
encapsulating them with tildes which are an escape character.
When FA passes variables to a process this is not possible
however.  The enhancement request would be to automatically add
tildes when these characters are encountered in a path/filename.

Local fix

STRRTC - 365252
SF / SF
Circumvention: None

Problem summary

Users Affected:
Sterling Connect:Direct File Agent 1.4.00
Sterling Connect:Direct for Windows 4.6.0

Problem Description:
(a) Sterling Connect:Direct File Agent should automatically
escape special file name characters stored in FA_* variables.
Specifically, ()'~&. The user has no way to manually escape
these because they're only found at runtime, then plugged into
the FA_* variables.
(b) Sterling Connect:Direct for Windows changes single quotes
to double quotes when occurring within cmd() or args() sysopts
in a RUN TASK/JOB on Windows.

Platforms Affected:
Windows

Problem conclusion

Resolution Summary:
(a) Sterling Connect:Direct File Agent:
Added automatic escaping of special characters when connected
to a Windows node. Other platforms not changed yet. This
feature is "On" by default. To disable, start File Agent with
--disableAutoEscape
(b) Sterling Connect:Direct for Windows:
Removed an obsolete workaround for old fixes SR1354034 and
SR769887,

Delivered In:
Sterling Connect:Direct File Agent 1.4.0.0_iFix015
Sterling Connect:Direct for Windows 4.6.0.3_iFix004

Temporary fix

Comments

APAR Information

APAR number
IC94012
Reported component name
STR CD FILE AGE
Reported component ID
5725C9902
Reported release
140
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-07-10
Closed date
2013-10-04
Last modified date
2013-10-04

APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name
STR CD FILE AGE
Fixed component ID
5725C9902

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSHPZT","label":"Sterling Connect:Direct File Agent"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"140","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
08 April 2024

Tips

IC94012: CONNECT:DIRECT RESTRICTS THE USE OF THE CHARACTERS LISTED BELOW SO THESE CAUSE PARSING ERRORS AND THE PROCESSES DON'T RUN.

Direct links to fixes

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name

Fixed component ID

Applicable component levels

Document Information

Share your feedback

Need support?