vUNIX user name

vA copy of the Sterling Connect:Direct copy control block

vA copy of the Sterling Connect:Direct parsed sysopts structure (the copy control block contains the actual raw version from the process)

FILE_OPEN_OUTPUT_REPLY_MSG

The user exit program sends a reply message to the Sterling Connect:Direct FILE_OPEN_OUTPUT_MSG. The FILE_OPEN_OUTPUT_REPLY_MSG contains:

vStatus value of zero for successful or non zero for failure

vStatus text message (if status value is failure, status text message is included in the error message)

vPipe pid (for pipe I/O, the UNIX process ID of the shell process that is performing the shell command for pipe I/O)

vActual file name opened (to be used in statistics log messages)

If the status value is zero for successful, the user exit program must immediately call send_exit_file() or send_exit_file_c() to send the file descriptor of the opened file to Sterling Connect:Direct.

FILE_OPEN_INPUT_MSG

During the copy statement Process, Sterling Connect:Direct sends a

FILE_OPEN_INPUT_MSG to the user exit program to open the source file. The FILE_OPEN_INPUT_MSG contains:

vThe open function oflag parameter (for example, O_RDONLY)

vThe open function mode parameter, which controls file permissions

vUNIX user ID that will own the file

vUNIX group ID that will own the file

vUNIX user name

vA copy of the Sterling Connect:Direct copy control block

vA copy of the Sterling Connect:Direct parsed sysopts structure (the copy control block contains the actual raw version from the Process)

FILE_OPEN_INPUT_REPLY_MSG

This message type is used when the user exit program sends a reply message to the Sterling Connect:Direct FILE_OPEN_INPUT_MSG. The FILE_OPEN_INPUT_REPLY_MSG contains:

vStatus value of zero for success or non zero for failure

vStatus text message (if status value is failure, status text message is included in the error message)

vPipe pid (for pipe I/O, the UNIX process ID of the shell process that is performing the shell command for pipe I/O)

vActual file name opened (used in statistics log messages)

Security Exit Messages

The security exit contains four types of messages:

vGENERATE_MSG

vGENERATE_REPLY_MSG

80Sterling Connect:Direct for UNIX: User Guide

Page 86
Image 86
IBM 4J manual Security Exit Messages, Fileopenoutputreplymsg