Procedure for installing multiple data set support with Download for z/OS

Use this procedure to install the Download for z/OS multiple data set support:
  1. Install the Download for z/OS user exit 15 program, apsux15m, on MVS. The program must be assembled and linked into a data set referenced in the STEPLIB of your Download for z/OS startup PROC.
  2. Run Download for z/OS on MVS using SEND_REC_LENGTH=YES either by specifying it explicitly in the Download for z/OS Routing Control data set on MVS or by allowing it to default. If you specify SEND_REC_LENGTH=NO, ACIF might be unable to process some variable length line mode data. In these cases ACIF issues a message that it cannot read the input file with a return code of 310.
  3. Because the mvsprpsm.sh sample shell script has been updated, you must update any customized versions of this shell script. Specify the name of the shell script using the "-x" option when you start the mvsprsd daemon:
    mvsprsd -n 1 -qlp -p6250 -d/mvsdl -x/mvsdl/mvsprpsm.sh
  4. Make sure that the PATH environment variable when the mvsprsd daemon is started includes the /usr/lpp/psf/bin directory. You can set default values for environment variables like PATH using the /etc/environment file:
    PATH=/usr/bin:/etc:/usr/sbin:/usr/lpp/pd/bin:/usr/lpp/psf/bin:.
    You must delimit each directory using a colon (:), not a semi-colon (;). Do not include spaces in the assignment. A period designates the current directory.
  5. Make sure that ACIF can locate your resources. It looks in both the /usr/lpp/psf/reslib directory and the directories specified by the PSFPATH environment variable. If you specify resource directories using these attributes, you must specify those same directories in the PSFPATH environment variable:
    • resource-context
    • resource-context-font
    • resource-context-overlay
    • resource-context-page-segment
    • resource-context-page-definition
    • resource-context-form-definition
    You can set default values for environment variables like PSFPATH using the /etc/environment file: 
    PSFPATH=/usr/xyz_corp/reslib:/usr/xyz_corp/fontlib
    You must delimit each directory using a colon (:), not a semi-colon (;). Do not include spaces in the assignment.
  6. Do not specify these attributes either directly or in Initial Value Job or Initial Value Document objects:
    • transform-message-file-name
    • resource-context-page-definition
    You can use the resource-context attribute instead of the resource-context-page-definition attribute.
  7. Specify the -n 1 option when you start the mvsprsd daemon: 
    mvsprsd -n 1 -qlp -p6250 -d/mvsdl -x/mvsdl/mvsprpsm.sh
    This option directs the daemon to create exactly one child process to receive data sets from MVS. Most customers use a shell script to run the mvsprsd daemon and specify its arguments. Using a shell script ensures that the daemon is always started correctly, with the same arguments. You should add the -n 1 option to the shell script.
Parent topic: Using Download for z/OS support for multiple data set jobs