mvsprsd utility: starts the MVS download receiver daemon
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]
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)" destinationwhere 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.
- 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
rootuser authority or the InfoPrint Manager user can run this command.
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:
- 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