S550-0433-05

Monitoring error messages

Monitoring error messages

During processing, AFP Download Plus collects and writes messages to a zFS file when errors occur, and then notifies the job submitter and the operator about the location of the messages. The messages are written to a file in the /var/psf/userinfo/userid directory, where userid is the job submitter's system user ID. The job submitter owns the userid directory and can delete any of the message files in the directory.

The message file name has an extension of MSG. See Figure 15 for the format of the rest of the file name.

Because AFP Download Plus does not delete the message files that it creates, you should periodically delete the message files to conserve disk space. AFP Download Plus provides a sample script, apshhcln.sh, that you can use to delete the message files. The sample script is located in the /usr/lpp/psf/samples directory and the prolog indicates how to use the script.

You can decide to redirect the messages to a new spool data set on AFP Download Plus or to an FSA for printing. Keep in mind though, redirecting messages can make it more difficult to locate and associate the messages with the print application.

You can also decide to notify users other than the job submitter that errors occurred and where the error messages are located.

By default, when errors cause transformation to stop, AFP Download Plus transforms the message data set to a MO:DCA-P file. Then, rather than sending the data set with errors, AFP Download Plus sends the message data set MO:DCA-P file with associated resources to the receiver system. If the messages are only informational, the data set is sent to the receiver but the message data set is not.