mvsprsd utility: starts the MVS download receiver daemon

Syntax

mvsprsd -pPortNumber -d FileSystem [-d FileSystem ...] [n -1] 
[-x ShellScript] [-X Additional exit parameters] [-q destination] [-k] [-B] 
[-H HostCodePage] [-L LocalCodePage][-t] [-w] [-e]

Description

Use the mvsprsd utility to start the MVS Download Receiver daemon. This daemon receives the data that Download for z/OS sends from the Job Entry Subsystem (JES) spool on an MVS system.

You can specify that the mvsprsd daemon starts whenever the system starts by including the mvsprsd command in one of the files that are executed when the AIX or Linux operating system is initialized. The two types of files that are read during AIX or Linux initialization are /etc/rc files and the /etc/inittab files.

If the mvsprsd daemon stops running for some reason, you can restart it by issuing this command:

/usr/lpp/psf/bin/mvsprsd -p PortNumber -d FileSystem -x ShellScript
   -q destination -k

If your job does not print on InfoPrint, you might be able to restart the shell script process with the downloaded file and downloaded print-options string. If you specify the -k flag on the print command, you can use this command to restart the shell script with its required parameter list:

/usr/lpp/pd/bin/mvsprpsm.sh FileName.PRD "$(cat string.JCL)" 
destination
where FileName.PRD represents the file successfully downloaded to InfoPrint as MVS_system_name.jobname.dataset_name.forms_name.yyyyddd.hhmmsstABCD.PRD; and where string.JCL represents the MVS print options string that is saved to a file named in this format: MVS_system_name.jobname.dataset_name.forms_name.yyyyddd.hhmmsstABCD.JCL.

    Note:
  • The string /usr/lpp/pd/bin/mvsprpsm.sh refers to the shell script that is provided with this command. Check to see that your installation has not modified this shell script or added another shell script before specifying this value.
  • Only a person with root user authority or the InfoPrint Manager user can run this command.

Flags

The mvsprsd daemon utility uses these flags:

-p PortNumber
Specifies the socket port number for the daemon in the valid range (5001-64000). Do not use 8251 and 8253, which are used by InfoPrint for the PCL and PostScript data transforms. The port number must be the same as the port number specified in the routing-control data set used by Download for z/OS.
-d FileSystem
Specifies a file system where InfoPrint stores the received file until the shell script you specify in the -x flag processes and deletes the file. The mvsprsd daemon must have write permission for the file system.

You must specify at least one file system. You can specify up to ten file systems. If you specify more than one file system, the file system having the most available space is used. To specify more than one file system, specify the entire flag again:

-d FileSystem1 -d FileSystem2 ...

-n 1
If you are working with multiple data set support, you must specify -n 1 when you start the mvsprsd daemon on AIX or Linux. The -n 1 option restricts the mvsprsd daemon to receive one data set at a time.
If you did not previously specify -n 1 and you received multiple files concurrently, you might wish to start more than one instance of the mvsprsd daemon (using different port numbers) and configure new Download for z/OS printers on MVS to communicate with them.
For more information about the limitations of multiple data set support with Download for z/OS, see the chapter entitled “Printing data sets from an MVS system through MVS Download” in the RICOH InfoPrint Manager for AIX: Procedures or RICOH InfoPrint Manager for Linux: Procedures.
Note: If you enable multiple data set support and you need to configure multiple Download for z/OS FSAs, you must have one mvsprsd daemon/receiver for each Download FSA that is submitting jobs to the InfoPrint Manager server. If you do not do this and two Download for z/OS FSA systems send jobs at the same time, the job data sets can become intermingled and errors or incorrect output can result.
-x ShellScript
Specifies the complete path name and file name for the shell script that the daemon executes to process the files sent by Download for z/OS. You can specify the file name of the shell script without the path name and it will default to the /usr/lpp/pd/bin path.

The daemon forks a child process to execute the shell script after each successfully received file. If you do not specify the path name of a shell script, the received files are not printed and remain on the file system.

InfoPrint provides a shell script, mvsprpsm.sh, which submits a file to the pdpr command for printing and deletes the file if the file prints successfully. This shell script is installed in the /usr/lpp/pd/bin directory.

-X Additional exit parameters
  • If you are using custom exits, consult with the person responsible for the custom exits to determine what to enter here.
  • With InfoPrint Manger for AIX version 4.2, there are scripts that support additional exit parameters. These parameters are not supported on previous versions of the InfoPrint Manager script. They are not supported when custom scripts are used. The options are specified on the –X parameter of mvsprsd and have this syntax:
    failed_job=discard | print
    This parameter only has an effect when the AFP Download Plus is used. The parameter values have this meaning:
    discard
    If AFP Download Plus detected an error in any file in the job, discard the entire job. This is the same behavior as Download for z/OS multiple data set. This behavior is desirable to print